take-note - SKILL.md Agent Skill

name: take-note description: Save a quick personal note to the user's notes log. Use whenever the user dictates or types something they want recorded as a note — e.g. "save a note…", "jot down…", "note that…", "take a note…", "remember this…", "add to my notes…", "log this thought…". Captures the spoken/typed content verbatim and appends it to the log. Use for capturing a thought, NOT for the user asking to read, search, or summarize existing notes (use find-notes for that).

Take Note

Append a quick personal note to the user's append-only notes log.

Storage

Toolkit (bundled in this plugin): ${CLAUDE_PLUGIN_ROOT}/scripts/
Log location: $NOTES_LOG if set, otherwise ~/technical-notes/notes.jsonl. The directory is created automatically on first note.

The log is JSON Lines: one operation object per line (add/edit/delete). Appending never rewrites existing lines.

How to save a note

Take the note content — the user's words, minus the trigger phrase. (If they say "note that the deploy failed," the note is "the deploy failed.") Keep it verbatim; do not summarize, expand, or correct unless asked.
Append it by piping the text via stdin (never as a shell argument — stdin avoids quoting/escaping problems with the apostrophes, quotes, and punctuation common in dictation):
```
printf '%s' "the note text here" | python3 "${CLAUDE_PLUGIN_ROOT}/scripts/add-note.py"
```
For multi-sentence or multi-line dictation, a heredoc is safest:
```
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/add-note.py" <<'NOTE'
the full note text,
possibly spanning lines
NOTE
```
The script prints Saved [id] at <timestamp> (plus tags=… if any). Confirm to the user with the id and a one-line echo of what was saved, so they know it landed.

Hashtag auto-tagging

Any #hashtag tokens in the dictated text are automatically extracted as tags by add-note.py — no extra flags needed. If the user says "note that the build is flaky #ci", save the text exactly as spoken; #ci becomes a searchable tag. (Mid-token #, e.g. C#, is not treated as a tag.)

Editing and deleting notes

Notes can be corrected or removed after the fact:

Edit: python3 "${CLAUDE_PLUGIN_ROOT}/scripts/edit-note.py" <id> "corrected text" — or pipe new text via stdin.
Delete: python3 "${CLAUDE_PLUGIN_ROOT}/scripts/delete-note.py" <id>

To edit or delete, first look up the note's 8-char id with read-notes.py (see the find-notes skill). Both operations append a new record; the original line is never rewritten.

Notes

Just append — do not create new files or change the log format.
If the note is empty after removing the trigger phrase, ask the user what they'd like to record rather than saving a blank entry.
This skill is for capturing notes. To read back, search, filter, or export, use the find-notes skill.