Agents Md

1---
2name: agents-md
3description: This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Guides discovery of local skills and enforces minimal documentation style.
4---
5 
6# Maintaining AGENTS.md
7 
8AGENTS.md is the canonical agent-facing documentation. Keep it minimal—agents are capable and don't need hand-holding.
9 
10## File Setup
11 
121. Create `AGENTS.md` at project root
132. Create symlink: `ln -s AGENTS.md CLAUDE.md`
14 
15## Before Writing
16 
17Discover local skills to reference:
18 
19```bash
20find .claude/skills -name "SKILL.md" 2>/dev/null
21ls plugins/*/skills/*/SKILL.md 2>/dev/null
22```
23 
24Read each skill's frontmatter to understand when to reference it.
25 
26## Writing Rules
27 
28- **Headers + bullets** - No paragraphs
29- **Code blocks** - For commands and templates
30- **Reference, don't duplicate** - Point to skills: "Use `db-migrate` skill. See `.claude/skills/db-migrate/SKILL.md`"
31- **No filler** - No intros, conclusions, or pleasantries
32- **Trust capabilities** - Omit obvious context
33- **Skill updates** - ALWAYS use `/skill-creator` when creating or updating skills
34 
35## Required Sections
36 
37### Package Manager
38Which tool and key commands only:
39```markdown
40## Package Manager
41Use **pnpm**: `pnpm install`, `pnpm dev`, `pnpm test`
42```
43 
44### Commit Attribution
45Always include this section. Agents should use their own identity:
46```markdown
47## Commit Attribution
48AI commits MUST include:
49```
50Co-Authored-By: (the agent model's name and attribution byline)
51```
52Example: `Co-Authored-By: Claude Sonnet 4 <noreply@example.com>`
53```
54 
55### Key Conventions
56Project-specific patterns agents must follow. Keep brief.
57 
58### Local Skills
59Reference each discovered skill:
60```markdown
61## Database
62Use `db-migrate` skill for schema changes. See `.claude/skills/db-migrate/SKILL.md`
63 
64## Testing
65Use `write-tests` skill. See `.claude/skills/write-tests/SKILL.md`
66```
67 
68## Optional Sections
69 
70Add only if truly needed:
71- API route patterns (show template, not explanation)
72- CLI commands (table format)
73- File naming conventions
74 
75## Anti-Patterns
76 
77Omit these:
78- "Welcome to..." or "This document explains..."
79- "You should..." or "Remember to..."
80- Content duplicated from skills (reference instead)
81- Obvious instructions ("run tests", "write clean code")
82- Explanations of why (just say what)
83- Long prose paragraphs
84 
85## Example Structure
86 
87```markdown
88# Agent Instructions
89 
90## Package Manager
91Use **pnpm**: `pnpm install`, `pnpm dev`
92 
93## Commit Attribution
94AI commits MUST include:
95```
96Co-Authored-By: (the agent model's name and attribution byline)
97```
98 
99## API Routes
100[Template code block]
101 
102## Database
103Use `db-migrate` skill. See `.claude/skills/db-migrate/SKILL.md`
104 
105## Testing
106Use `write-tests` skill. See `.claude/skills/write-tests/SKILL.md`
107 
108## CLI
109| Command | Description |
110|---------|-------------|
111| `pnpm cli sync` | Sync data |
112```
113