Claude-skill-registry add-note
Use this skill whenever important information is learned during a task or when the user explicitly asks to store something. Use when users ask to remember. Triggers on "remember this", "update memory", "share" or any persistent storage request.
git clone https://github.com/majiayu000/claude-skill-registry
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/add-note" ~/.claude/skills/majiayu000-claude-skill-registry-add-note && rm -rf "$T"
skills/data/add-note/SKILL.mdBe proactive, but intentional:
- Store CLI commands, API endpoints, error resolutions, operational gotchas, patterns, and internal processes
- Prefer small, focused, reusable notes
- If the information would save time if recalled later, it likely belongs here
What this skill does
Stores a structured knowledge note in Qdrant for retrieval by AI coding agents.
This skill uses the Qdrant MCP server via the
tool.qdrant-add-note
Collection
All notes are stored in the following collection:
notes-hybrid
Storage guardrails (IMPORTANT)
These rules must be followed exactly:
- Do not store test notes unless they contain a concrete, reusable learning
- Context is required unless the text is completely self-explanatory
- Only use the fields supported by the
toolqdrant-add-note - All required fields must be provided
If any rule is violated, do not store the note.
Minimum acceptable note
A note must meet at least this standard:
Required parameters:
: concrete command, endpoint, or learningtext
: when or why this is usefulcontext
: one oftype
,cli
,api
,learning
, orsnippetpattern
: ISO-8601 timestampcreated_at
If you cannot fill in all required fields meaningfully, do not store the note.
Fields and how to use them
text (required)
The primary knowledge content.
- One command, endpoint, rule, or learning
- Must be understandable without chat history
Good examples:
kubectl rollout restart deployment my-app -n prodAvoid using async forEach in Node.js; it does not await promises
Bad examples:
testing the note systemthis worked
context (required unless self-explanatory)
Explains when, why, or how the text is useful. Include:
- Conditions
- Warnings
- Operational context
If you cannot explain the usefulness, do not store the note.
type (required)
Choose exactly one:
cliapilearningsnippetpattern
tool (optional but recommended)
The tool, system, or service involved.
Examples:
kubectlawsterraforminternal-apigithub-actions
tags (optional)
Array of short, lowercase keywords describing concepts or domains.
Examples:
["kubernetes", "deployments"]["auth", "debugging"]["terraform", "aws"]
language (optional)
Use for code or CLI-related notes.
Examples:
bashpythonyamljson
source (optional)
Where this knowledge applies.
Examples:
personal-notesrepo:infraservice:billingteam:platform
created_at (required)
ISO-8601 timestamp. Use the current date/time if not explicitly provided.
Tool usage
Use the
MCP tool with the following parameters:qdrant-add-note
Required:
(string)text
(string)context
(string:type
|cli
|api
|learning
|snippet
)pattern
(string: ISO-8601 timestamp)created_at
Optional:
(string)tool
(array of strings)tags
(string)language
(string)source
The tool handles vector generation and storage automatically.
Pre-store quality checklist
Before storing, confirm:
- Would another agent benefit from this in 30 days?
- Is the note understandable without chat history?
- Does
clearly explain when or why it applies?context - Is this more than a test or confirmation?
If any answer is no, do not store the note.
Agent reminder
When in doubt:
Check existing notes first. Store only what improves future decisions.