Repository agent instructions (entry)

This skill is the maintenance entrypoint for the instruction and skill system. Root AGENTS.md already provides ordinary repository orientation.

When to use

• You are auditing or changing AGENTS.md, rule/skill routing, or instruction budgets.
• A tool or workflow only surfaced a root SKILL.md and you need the full picture.
• You changed or added something under docs/ai/skills/ and must refresh mirrors.

Workflow

1. Read and follow root AGENTS.md, the nearest scoped instructions, and openspec/specs/agent-instruction-system/spec.md.
2. For canonical task skills maintained by this repo, use docs/ai/skills/*/SKILL.md and docs/ai/rules/agent-skill-routing.md.
3. After changing skills under docs/ai/skills/, run bun run skills:sync and ensure bun run skills:verify passes before committing.
4. Optional tool-specific or ecosystem skills may originate under .agents/skills/ and be mirrored into .cursor/skills/ and .claude/skills/; use them only when their SKILL.md description matches and they remain subordinate to canonical repo guidance.

Checklist

• Root and scoped instruction sources opened for the maintenance task.
• Relevant docs/ai/skills/<topic>/SKILL.md files loaded per docs/ai/rules/agent-skill-routing.md.
• If docs/ai/skills/ was edited: bun run skills:sync and bun run skills:verify run and clean.

See also

• Discover / install skills: docs/ai/skills/find-skills/SKILL.md
• Instruction contract: openspec/specs/agent-instruction-system/spec.md