agentmemory skills follow one tiered format so they stay skimmable, accurate, and current. Match it exactly.
Directory layout
plugin/skills//
SKILL.md (required, under 100 lines)
REFERENCE.md (optional, dense facts; auto-generate data tables)
EXAMPLES.md (optional, worked transcripts)
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.
Cross-references link one level deep only. Shared recovery steps live in
../_shared/TROUBLESHOOTING.md
, never inlined.
Show more
Installs
502
Repository
rohitg00/agentmemory
GitHub Stars
22.1K
First Seen
3 days ago