Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

write-agentmemory-skill — Claude Code skill: how it works

Sets structure and formatting rules for agentmemory skills. Use it when creating a new SKILL.md or reviewing an existing skill for consistency.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rohitg00/agentmemory --skill write-agentmemory-skill -a claude-code
Open on GitHub

What write-agentmemory-skill does

The skill standardises the file layout inside plugin/skills/<name>/. Every skill requires a SKILL.md kept strictly under 100 lines. Dense technical tables belong in REFERENCE.md, and sample sessions go into EXAMPLES.md. Shared recovery instructions stay in TROUBLESHOOTING.md, which the generator copies directly into each skill root directory.

The frontmatter section accepts name, description, an optional argument-hint, and user-invocable. Reference skills must keep user-invocable: false. The description is capped at 1024 characters and requires exactly two sentences: the first explains capability, while the second starts with "Use when" to declare real triggers. The text body follows a fixed section order that includes workflow gates and a WRONG versus RIGHT anti-pattern block.

Do not type tool names or REST endpoints by hand. Any manual edits will fail npm run skills:check in CI; run npm run skills:gen instead.

What it helps with

  • format a new SKILL.md under the 100 lines threshold
  • extract heavy tables into REFERENCE.md and transcripts into EXAMPLES.md
  • validate frontmatter description triggers before pushing to CI
  • keep tool parameters and REST endpoints in sync using npm run skills:gen

Example prompts for the agent

  • Write a new agentmemory skill following the house style and under 100 lines limit
  • Review this SKILL.md and check the frontmatter description triggers
  • Restructure this skill directory to move raw reference data into REFERENCE.md

How to install write-agentmemory-skill

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/write-agentmemory-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/write-agentmemory-skill/

From the same set11

The whole set →
remember rohitg00 Saves insights, decisions, and learnings to agentmemory long-term storage with concept tags so agents can retrieve them later. Claude Code CX Codex Cursor +1 14,000installs recall rohitg00 Searches past observations, sessions, and learnings through agentmemory. Use it to recover context when you need to know what a project already covered. Claude Code CX Codex Cursor +1 13,900installs forget rohitg00 Deletes selected durable memories from agentmemory after explicit confirmation. Useful when scrubbing secrets or obsolete notes. Claude Code CX Codex Cursor +1 13,800installs session-history rohitg00 Shows recent project sessions as a clean timeline. Use it to recover past decisions, observations, and session status. Claude Code CX Codex Cursor +1 13,800installs commit-history rohitg00 Lists git commits linked to agent sessions with optional filters for branch, repo, and limit. Claude Code CX Codex Cursor +1 13,700installs handoff rohitg00 Resumes the latest agent session for the current directory and surfaces any unanswered questions first. Claude Code CX Codex Cursor +1 13,400installs agentmemory-agents rohitg00 Guides coding agents on linking the memory server via agentmemory connect. It safely merges host configurations without wiping existing MCP servers. Claude Code CX Codex Cursor +1 11,000installs agentmemory-mcp-tools rohitg00 Index of every agentmemory MCP tool with its parameters and workflows. Helps agents pick the right memory tool and format valid arguments. Claude Code CX Codex Cursor +1 10,900installs

Similar

flags react This skill runs React's feature-flag command and explains the results. Use it to compare release channels when a feature behaves differently between them. Claude Code CX Codex Cursor +1 1,100installs flow react Runs Flow type checking in a React project and reports errors with file locations. Useful when you edit code and don't want to look up the right renderer flag each time. Claude Code CX Codex Cursor +1 1,100installs task-management official anthropics Tracks commitments, active work, and follow-ups in a local TASKS.md file. Useful when managing project to-dos directly from the AI coding chat. Claude Code CX Codex Cursor +1 7,200installs security-ownership-map official openai Builds a people-to-file map from git history, computes bus factor, and flags sensitive code with too few active owners. Claude Code CX Codex Cursor +1 3,800installs weekly-digests thedotmack Splits a claude-mem timeline into per-ISO-week files and produces one narrative chapter per week. Use it when you want a serial story, not a single report. Claude Code CX Codex Cursor +1 4,000installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs

Questions about write-agentmemory-skill

How to install write-agentmemory-skill in Claude Code?

Run npx skills add rohitg00/agentmemory --skill write-agentmemory-skill -a claude-code in your terminal. This downloads the skill into ~/.claude/skills/write-agentmemory-skill/SKILL.md.

What does write-agentmemory-skill do?

It enforces formatting rules and directory layouts for skills in the agentmemory repository. It ensures consistent structure, strict line caps, and automated drift prevention.

Can I invoke write-agentmemory-skill directly via slash command?

No, its frontmatter defines user-invocable: false. The AI agent loads it automatically in the background when you create, update, or review an agentmemory skill.

Source text

SKILL.md · Apache-2.0
---
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

```text
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](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.

© rohitg00 · Apache-2.0 · rohitg00/agentmemory

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor