- name
- acreadiness-generate-instructions
- description
- Generate tailored AI agent instruction files via AgentRC instructions command. Produces .github/copilot-instructions.md (default, recommended for Copilot in VS Code) plus optional per-area .instructions.md files with applyTo globs for monorepos. Use after running /acreadiness-assess to close gaps in the AI Tooling pillar.
- argument-hint
- [--output .github/copilot-instructions.md|AGENTS.md] [--strategy flat|nested] [--areas | --area <name>] [--apply-to <glob>] [--claude-md] [--dry-run]
/acreadiness-generate-instructions — write AI agent instructions
Use this skill whenever the user wants to create, regenerate, or refresh their custom instructions for AI coding agents (Copilot, Claude, etc.). This is the Generate step in AgentRC's Measure → Generate → Maintain loop and the single highest-leverage action for the AI Tooling pillar.
Output options
VS Code recognises several instruction file types — AgentRC generates the most common ones:
Strategies
flat(default) — single.github/copilot-instructions.mdat the chosen path. Simple, easy to review.nested— hub at.github/copilot-instructions.md+ per-topic detail files at.github/instructions/<topic>.instructions.md, each with anapplyToglob so VS Code only loads the topic when it's relevant. Better for large or multi-stack repos.
Why
.github/instructions/and not.agents/? AgentRC's default nested layout writes to.agents/, which is the right home for agent-agnostic repos (Copilot + Claude + Cursor readingAGENTS.md). For VS Code Copilot specifically, the native location is with frontmatter — that's what Copilot auto-discovers. This skill rewrites AgentRC's nested output to the VS Code-native location whenever the main output is . If you instead chose , nested keeps AgentRC's default layout.