Captive Note
Productivitycaptive-noteCaptive Note is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Write content to a Captive note (Today.md, Week.md, etc.) with validation and backup.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/productivity/captive-note/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/captive-note, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Write Captive Note
This sub-skill writes content to a Captive note in the vault, with validation to prevent accidental data loss.
Input Arguments
Arguments are passed as key-value pairs:
path: Full path to the note (e.g.,{{VAULT}}/00_Brain/Captive/Today.md)content: Markdown content to write
Instructions
1. Validate Path
Verify the path is within the Captive directory:
$VAULT/00_Brain/Captive/
If path is outside Captive, return error:
Error: Path must be within Captive directory. Got: {path}
2. Check Existing Content
If the file already exists:
- Read current content
- If content is non-empty and different from new content:
- Create a backup at
{filename}.backup.mdin the same directory - Log: "Backed up existing content to {backup_path}"
- Create a backup at
3. Write Content
Write the new content to the specified path.
4. Verify Write
Read back the file to confirm write succeeded.
Output
Return structured JSON:
{
"success": true,
"path": "/Users/.../00_Brain/Captive/Today.md",
"backup_created": true,
"backup_path": "/Users/.../00_Brain/Captive/Today.backup.md",
"bytes_written": 2048
}
Or on error:
{
"success": false,
"error": "Description of what went wrong",
"path": "/Users/.../00_Brain/Captive/Today.md"
}
Error Cases
| Condition | Error Message |
|---|---|
| Path outside Captive | "Path must be within Captive directory" |
| Vault not found | "Vault directory does not exist: {vault}" |
| Write failed | "Failed to write file: {system_error}" |
| Verification failed | "Write verification failed: content mismatch" |
Safety
- Always validate path is within Captive before writing
- Always backup existing non-empty content before overwriting
- Never write to Periodic or Semantic directories (use archive sub-skills for those)