# AI Readiness Assessment

Runs the AgentRC readiness assessment and renders a repository dashboard.

- Repository: https://github.com/github/awesome-copilot (40669 stars)
- Category: DevOps
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add github/awesome-copilot --skill acreadiness-assess -g -a claude-code -y`
Codex: `npx skills add github/awesome-copilot --skill acreadiness-assess -g -a codex -y`
Cursor: `npx skills add github/awesome-copilot --skill acreadiness-assess -g -a cursor -y`
Gemini CLI: `npx skills add github/awesome-copilot --skill acreadiness-assess -g -a gemini-cli -y`

## Description

Run the AgentRC readiness assessment on the current repository and produce a static HTML dashboard at reports/index.html. Wraps `npx github:microsoft/agentrc readiness` and hands off rendering to the @ai-readiness-reporter custom agent. Supports policies (--policy) for org-specific scoring. Use when asked to assess, audit, or score the AI readiness of a repo.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# /acreadiness-assess, AI-readiness assessment

Use 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.

This 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.

## Steps

1. **Confirm prerequisites.** Node 20+ must be on PATH. If unsure, run `node --version`.

2. **Decide on a policy** (optional but encouraged):
   - If the user provided `--policy <source>`, capture it.
   - Otherwise check `agentrc.config.json` for a `policies` array.
   - If neither, run with no policy (built-in defaults).
   - For a primer on policies, suggest the `acreadiness-policy` skill.

3. **Run the readiness scan** in the repo root with structured output:
   ```bash
   npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]
   ```
   The `CommandResult<T>` JSON envelope is your input for the next step.

The rest: https://github.com/github/awesome-copilot/blob/HEAD/skills/acreadiness-assess/SKILL.md
