asymmetric-al/core/repo-entry

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.

1. For canonical task skills maintained by this repo, use `docs/ai/skills/*/SKILL.md` and `docs/ai/rules/agent-skill-routing.md`.
2. After changing skills under docs/ai/skills/, run `bun run skills:sync` and ensure `bun run skills:verify` passes before committing.
3. 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