repo-entry

name	repo-entry
description	Default orientation skill for work in this monorepo. Pointer to AGENTS.md, canonical skills under docs/ai/skills/, and the skills:sync / skills:verify workflow for mirror directories.
metadata	{"owner":"core","last_updated":"2026-04-28T00:00:00.000Z","status":"active","version":"1.0.0"}

Repository agent instructions (entry)

This skill is the compact entry point for the instruction and skill system. It is not a substitute for reading AGENTS.md.

When to use

• You are starting or resuming work in this repo and need the authoritative map of rules and skills.
• 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 (Next.js managed block, routing, Nia, MCP, monorepo commands).
2. For canonical task skills maintained by this repo, use docs/ai/skills/*/SKILL.md and the Skill Routing section in AGENTS.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

• AGENTS.md opened for the current task’s domain (rules, Nia scoping, checks).
• Relevant docs/ai/skills/<topic>/SKILL.md files loaded per Skill Routing.
• 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
• Copilot entrypoint: .github/copilot-instructions.md (points at AGENTS.md)