write-agentmemory-skill

Agent Skills › rohitg00/agentmemory › write-agentmemory-skill

write-agentmemory-skill

GitHub

定义 agentmemory 技能的编写规范与格式标准，涵盖目录结构、元数据规则、内容组织及生成流程。用于新增、重构技能或审查贡献时确保一致性与准确性。

plugin/skills/write-agentmemory-skill/SKILL.md rohitg00/agentmemory

触发场景

新增 Agent 技能重构现有技能结构审查技能贡献一致性

安装

npx skills add rohitg00/agentmemory --skill write-agentmemory-skill -g -y

更多选项

非标准路径

npx skills add https://github.com/rohitg00/agentmemory/tree/main/plugin/skills/write-agentmemory-skill -g -y

不安装直接使用

npx skills use rohitg00/agentmemory@write-agentmemory-skill

指定 Agent (Claude Code)

npx skills add rohitg00/agentmemory --skill write-agentmemory-skill -a claude-code -g -y

安装 repo 全部 skill

npx skills add rohitg00/agentmemory --all -g -y

预览 repo 内 skill

npx skills add rohitg00/agentmemory --list

SKILL.md

Frontmatter

{
    "name": "write-agentmemory-skill",
    "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.",
    "user-invocable": false
}

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.

版本历史

e01540e 当前 2026-10-19 02:23
引入 TROUBLESHOOTING.md 作为生成的支持文件并链接到根目录；更新交叉引用规则为仅深层链接一级；明确共享恢复指令由生成器复制到各技能根目录。
a8e7d19 2026-07-24 11:39

元信息

文件数: 0
版本: e01540e
Hash: 5838e514
收录时间: 2026-07-24 11:39

write-agentmemory-skill