acreadiness-assess

1# /acreadiness-assess — AI-readiness assessment
2 
3Use this skill whenever the user asks for an **AI-readiness assessment**, a **readiness check**, an **audit**, or wants to **see how AI-ready** their repository is.
4 
5This skill is the *Measure* step in AgentRC's **Measure → Generate → Maintain** loop. The result is a self-contained HTML dashboard the user can open with `file://` or commit to the repo.
6 
7## Steps
8 
91. **Confirm prerequisites.** Node 20+ must be on PATH. If unsure, run `node --version`.
10 
112. **Decide on a policy** (optional but encouraged):
12   - If the user provided `--policy <source>`, capture it.
13   - Otherwise check `agentrc.config.json` for a `policies` array.
14   - If neither, run with no policy (built-in defaults).
15   - For a primer on policies, suggest the `acreadiness-policy` skill.
16 
173. **Run the readiness scan** in the repo root with structured output:
18   ```bash
19   npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]
20   ```
21   The `CommandResult<T>` JSON envelope is your input for the next step.
22 
234. **Hand off to the `ai-readiness-reporter` custom agent** to interpret the JSON and produce `reports/index.html`. The agent renders via the bundled template `report-template.html` (shipped alongside this skill) so every report has an identical look & feel. The agent:
24   - Reads the bundled `report-template.html` and substitutes placeholders with real data.
25   - Inlines all CSS, ships a single static file (works under `file://`).
26…