OpenParable
Skip to content
← Back to skills

Captive Note

Productivity
captive-note

Captive 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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:

  1. Read current content
  2. If content is non-empty and different from new content:
    • Create a backup at {filename}.backup.md in the same directory
    • Log: "Backed up existing content to {backup_path}"

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

ConditionError 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)