tag-notes

View and update persistent notes attached to tags in the CALM memory database.

3|1|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/isizono/calm --skill tag-notes-isizono
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tag-notes
Source: https://github.com/isizono/calm/tree/main/skills/tag-notes
Command: npx skills add https://github.com/isizono/calm --skill tag-notes-isizono

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tags in the CALM memory system carry standing notes that are automatically injected into AI sessions, but editing them safely requires content-type judgment, length limits, and demotion of oversized sections. This Skill guides the review and update of tag notes so only durable lessons and environment knowledge are stored. ## Core Features & Use Cases - Notes Review: Search a tag with search_tags and inspect its current notes before editing. - Content-Type Judgment: Classify new content as lessons, pitfalls, or environment knowledge, keeping spec snapshots and procedures as one-line pointers. - Capacity Management: Demote oversized sections to materials with demote_tag_notes when notes approach the 4,000-character ceiling, then write the full updated text via update_tag. - Use Case: When a user says "update the notes for the api-design tag", the Skill drafts merged content, confirms it with the user, and writes it back while respecting suppression markers and length rules. ## Quick Start Show me the notes for the backend tag and append a lesson about retry handling.

Frequently Asked Questions about tag-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update notes attached to a tag in CALM?▼

Search the tag with search_tags using include_notes=True, draft merged content that passes content-type judgment, confirm the draft with the user, then write the full text with update_tag since it uses overwrite semantics.

What content is allowed in tag notes?▼

Tag notes accept only behavior-changing lessons, pitfalls, and tag-specific environment knowledge written in full. Spec snapshots, operational procedures, and history records must be one-line pointers to code, docs, decisions, or materials.

Why was my tag notes update rejected?▼

Writes that increase length beyond the 4,000-character ceiling are rejected by a ratchet rule. Run demote_tag_notes to move existing sections into materials first, then retry the shorter write.

How do I retire a tag instead of editing its notes?▼

Call update_tag with archived=True and an archived_reason, without passing notes since the two parameters are mutually exclusive. Archiving excludes the tag from automatic notes injection and lowers it in search results, and it can be reversed with archived=False.

How do suppression markers in tag notes work?▼

A marker like #recompose-skipped alone suppresses a hint permanently, while appending -until:YYYY-MM-DD makes it expire after that date. Invalid dates fail open, and #notes-over-budget-ack only accepts the dated form.