kramme:agents-md
This skill should be used when the user asks to "update AGENTS.md", "add to AGENTS.md", "maintain agent docs", or needs to add guidelines to agent instructions. Guides discovery of local skills and enforces structured, keyword-based documentation style.
npx skills add majiayu000/claude-skill-registry --skill kramme-agents-md --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Adding to AGENTS.md AGENTS.md is the canonical agent-facing documentation. Each rule should be minimal, but many rules are OK. ## Before Writing Discover local skills to reference: ```bash find .claude/skills -name "SKILL.md" 2>/dev/null ls plugins/*/skills/*/SKILL.md 2>/dev/null ``` Read each skill's frontmatter to understand when to reference it. ## Guideline Keywords Use these keywords to indicate requirement strength: - **ALWAYS** — Mandatory requirement - **NEVER** — Strong prohibition - **PREFER** — Strong recommendation, exceptions allowed - **CAN** — Optional, developer's discretion - **NOTE** — Context or clarification - **EXAMPLE** — Illustrative example Strictness hierarchy: ALWAYS/NEVER > PREFER > CAN > NOTE/EXAMPLE ## Writing Rules - **Existing sections first** - Only propose new sections if no appropriate existing section exists - **One rule per bullet** - Keep each guideline minimal and atomic - **Start with keyword** - Every rule begins with ALWAYS/NEVER/PREFER/CAN/NOTE - **Headers + bullets** - No paragraphs - **Code blocks** - For commands and templates - **Reference, don't duplicate** - Point to skills: "See `.claude/skills/db-migrate/SKILL.md`" - **No filler**
- Before Writing
- Guideline Keywords
- Writing Rules
- Common Sections
- When Stuck
- Git Commits
- Issue Management
- Package Manager
- Local Skills
- Domain-Specific Sections
- Anti-Patterns
find .claude/skills -name "SKILL.md" 2>/dev/null ls plugins/*/skills/*/SKILL.md 2>/dev/null
What does the kramme:agents-md skill do?
This skill should be used when the user asks to "update AGENTS.md", "add to AGENTS.md", "maintain agent docs", or needs to add guidelines to agent instructions. Guides discovery of local skills and enforces structured, keyword-based documentation style.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill kramme-agents-md --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.