klh-agents-md

Maintaining AGENTS.md

Part of klh/skills — personal agent skills by Klaus L. Hougesen. Install: npx skills add klh/skills --skill klh-agents-md

Overview

Guides creation and maintenance of AGENTS.md files, keeping agent instructions concise and referencing local skills.

When to Use

• When asked to "create AGENTS.md" or "update AGENTS.md"
• When asked to "maintain agent docs" or "set up CLAUDE.md"
• When needing to keep agent instructions concise

AGENTS.md is the canonical agent-facing documentation. Keep it minimal—agents are capable and don't need hand-holding.

File Setup

1. Create AGENTS.md at project root
2. Create symlink: ln -s AGENTS.md CLAUDE.md

Before Writing

Discover local skills to reference:

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.

Writing Rules

• Headers + bullets - No paragraphs
• Code blocks - For commands and templates
• Reference, don't duplicate - Point to skills: "Use db-migrate skill. See .claude/skills/db-migrate/SKILL.md"
• No filler - No intros, conclusions, or pleasantries
• Trust capabilities - Omit obvious context

Required Sections

Package Manager

Which tool and key commands only:

## Package Manager

Use **pnpm**: `pnpm install`, `pnpm dev`, `pnpm test`

Commit Attribution

Always include this section. Agents should use their own identity:

## Commit Attribution

AI commits MUST include:

Co-Authored-By: (the agent model's name and attribution byline)

Example: `Co-Authored-By: Claude Sonnet 4 <[email protected]>`

Key Conventions

Project-specific patterns agents must follow. Keep brief.

Local Skills

Reference each discovered skill:

## Database

Use `db-migrate` skill for schema changes. See `.claude/skills/db-migrate/SKILL.md`

## Testing

Use `write-tests` skill. See `.claude/skills/write-tests/SKILL.md`