Skip to content
cccskills
FreePublished on GitHub

write-agentmemory-skill

Create, update, or review agentmemory skills using a shared format. It guides document structure, supporting files, and generated reference data so contributions follow consistent rules and stay aligned with the source code.

OriginalShow the original description

The house format and rules for writing or updating an agentmemory skill. Use when adding a new skill, restructuring an existing one, or reviewing a skill contribution for consistency.

See how to install

Good for

  • Creating a new agentmemory skill
  • Restructuring an existing skill
  • Reviewing skill contributions for consistency
  • Updating reference data from source code

Files included (2)

  • SKILL.md2.4 KB
  • TROUBLESHOOTING.md3.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

agentmemory skills follow one tiered format so they stay skimmable, accurate, and current. Match it exactly.

Directory layout

plugin/skills/<name>/
  SKILL.md      (required, under 100 lines)
  REFERENCE.md  (optional, dense facts; auto-generate data tables)
  EXAMPLES.md   (optional, worked transcripts)
  TROUBLESHOOTING.md (generated support file)

SKILL.md rules

  • Frontmatter: name, description, optional argument-hint, and user-invocable. Set user-invocable: true only for skills the user runs as a slash command; reference and knowledge skills are false.
  • Description is two sentences and the only thing the agent sees when deciding to load the skill. Sentence one states the capability. Sentence two starts "Use when" and lists concrete triggers. Keep it distinct from sibling skills, under 1024 chars, third person.
  • Body order: Quick start (one concrete example), Why (the governing principle), Workflow (numbered steps with decision gates), Anti-patterns (a WRONG vs RIGHT callout for the top mistake), Checklist, See also (cross-link siblings), Reference or Troubleshooting pointer.
  • Stay under 100 lines. Move dense facts to REFERENCE.md and examples to EXAMPLES.md.
  • Keep supporting files inside the skill directory so each skill works when installed separately. Link TROUBLESHOOTING.md; the generator copies shared recovery instructions into each skill root.

Keep it current

Facts that exist in source (tool names and parameters, REST endpoints, env vars, connect adapters, hook events) are generated, never hand-typed. Edit the source, then run npm run skills:gen. CI runs npm run skills:check and fails on drift, so generated tables cannot fall behind the code.

Style

No external or competitor product names. No emojis. No em-dashes. No filler. State the thing and stop.

Checklist

  • Description has a "Use when" sentence with real triggers.
  • SKILL.md is under 100 lines.
  • No time-sensitive claims and no duplicated troubleshooting block.
  • Concrete example present; generated facts come from the generator.
  • Cross-links resolve and go one level deep.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Connect agentmemory to coding agents such as Claude Code and Codex while preserving existing server settings. It guides configuration, host restarts, and checks that memory tools are available and can save and retrieve information.

  • Connecting agentmemory to a coding agent
  • Checking supported agents and connection methods
  • Investigating an incorrect configuration path
rohitg00/agentmemory29.7KUpdated Oct 18, 2026

Explain how agentmemory stores and retrieves coding agents’ memories, including its engine, search methods, memory lifecycle, ports, and web viewer. Useful for understanding the system or planning extensions to its functions.

  • Understand how agent memories are stored and retrieved
  • Plan extensions to agentmemory
  • Check memory capture in the web viewer
rohitg00/agentmemory29.7KUpdated Oct 18, 2026

Set up and troubleshoot a local agentmemory server by checking MCP connections, authentication, ports, and environment settings. Understand which optional memory features require additional configuration, model downloads, or token usage before enabling them.

  • Set up a local agentmemory connection
  • Diagnose MCP connection failures
  • Review authentication and custom ports
rohitg00/agentmemory29.7KUpdated Oct 18, 2026

Understand how agentmemory automatically records tool activity, prompts, and session boundaries through hooks, actions triggered by session events. Use it to check integration setup, investigate missing records, and distinguish capture from optional summaries and context injection.

  • Understanding automatic session recording
  • Investigating missing observations
  • Checking capture and summary settings
rohitg00/agentmemory29.7KUpdated Oct 18, 2026

Helps agents choose the right agentmemory tool through MCP, a protocol for connecting agents to tools. It explains tool roles and points to parameter references for saving, retrieving, organizing, and maintaining stored knowledge.

  • Choosing a tool to save or retrieve knowledge
  • Checking tool names and required parameters
  • Reviewing available memory management operations
rohitg00/agentmemory29.7KUpdated Oct 18, 2026

Guides HTTP integration with the agentmemory server for saving and searching knowledge. It explains authentication, request conventions, and endpoint references, including how to connect systems that do not support MCP, the agent tool connection protocol.

  • Saving and searching knowledge over HTTP
  • Connecting a host that does not support MCP
  • Checking authentication and response conventions
rohitg00/agentmemory29.7KUpdated Oct 18, 2026

See all skills by rohitg00

Report a problem with this skill