# Repo Entry

> Audit or update Core's repository instruction system and skill mirrors. Use for AGENTS.md architecture, canonical skill ownership, skills:sync, or skills:verify; do not invoke for ordinary application work.

- Skill: `asymmetric-al/repo-entry-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add asymmetric-al/repo-entry-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/asymmetric-al/repo-entry-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: asymmetric-al (https://skillmd.com/u/asymmetric-al)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/asymmetric-al/repo-entry-2

---


# 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`