SKILL.md
getnote-tag Skill
Add, list, and remove tags on notes.
Prerequisites
getnoteCLI installed and authenticated (getnote auth statusshould show "Authenticated")
Commands
List tags on a note
getnote tag list <note_id>
Returns all tags with their IDs and types.
Tag types:
ai— auto-generated by AI
manual— added by the user
system— system tag (cannot be deleted)
getnote tag list 1896830231705320746
getnote tag list 1896830231705320746 -o json
Add a tag
getnote tag add <note_id> <tag>
getnote tag add 1896830231705320746 工作
Remove a tag
getnote tag remove <note_id> <tag_id>
⚠️ Requires tag ID (integer from tag list), not tag name.
⚠️ system type tags cannot be removed.
# Step 1: get tag IDs
getnote tag list 1896830231705320746 -o json
# Step 2: remove by tag ID
getnote tag remove 1896830231705320746 123
Agent Usage Notes
tag list -o jsonreturns{"note_id":"...","tags":[{"id":"...","name":"...","type":"..."}]}(flat, nosuccesswrapper).
tag removetakes a numeric tag ID, not a name — always calltag listfirst.
- To replace all tags at once, use
getnote note update --tag "tag1,tag2"instead.
- Exit code
0= success; non-zero = error. Error details go to stderr.