acreadiness-assess

Runs AgentRC readiness scans and renders a static HTML dashboard report.

38.5k|4.9k|Updated Jun 11, 2025
One-click install
npx skills add https://github.com/github/awesome-copilot --skill acreadiness-assess
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acreadiness-assess
Source: https://github.com/github/awesome-copilot/tree/main/skills/acreadiness-assess
Command: npx skills add https://github.com/github/awesome-copilot --skill acreadiness-assess

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams adopting AI coding agents lack a concrete way to measure how well their repository supports those agents. This Skill runs the AgentRC readiness assessment on the current repository and turns the raw JSON output into a self-contained HTML dashboard with scores, pillar breakdowns, and a remediation plan.

Core Features & Use Cases

  • Automated readiness scan: Wraps npx github:microsoft/agentrc readiness --json to score the repo across 9 pillars spanning Repo Health and AI Setup, mapped to a 5-level maturity model.
  • Policy support: Accepts --policy <path-or-pkg> to apply org-specific scoring rules, thresholds, and disabled criteria, with defaults read from agentrc.config.json.
  • Static HTML dashboard: Hands off to the ai-readiness-reporter agent, which fills the bundled report-template.html to produce reports/index.html with KPIs, per-pillar recommendations, AI relevance badges, and a prioritised remediation plan.
  • Use Case: Before rolling out Copilot to a team, run the assessment to get a maturity level, overall score, and a Fix First / Fix Next / Plan list of concrete improvements.

Quick Start

Ask the assistant to run an AI-readiness assessment on this repository and generate the HTML report, optionally passing a policy file with --policy.

Frequently Asked Questions about acreadiness-assess

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assess my repository's AI readiness for coding agents?

Run the readiness assessment, which executes `npx github:microsoft/agentrc readiness --json` in the repo root and renders the results as a static HTML dashboard at reports/index.html. The report shows maturity level, overall score, and per-pillar recommendations.

How do I apply a custom scoring policy to an AgentRC readiness scan?

Pass `--policy <path-or-pkg>` when invoking the assessment, or define a `policies` array in `agentrc.config.json`. The policy can disable criteria, override thresholds, and is displayed in the report's Active Policy section.

What are the requirements to run the AgentRC readiness assessment?

Node.js 20 or later must be on PATH so npx can fetch and run github:microsoft/agentrc. The scan runs in the repository root and only writes reports/index.html, leaving other files untouched.

Can I use the readiness score as a CI gate?

Yes. Use `agentrc readiness --fail-level <n>` (levels 1-5) in CI to fail the pipeline when the repository drops below a maturity threshold, preventing regressions in AI readiness.

What does the AI readiness report contain?

The dashboard shows maturity level, overall score, grade, pass rate versus threshold, breakdowns of 8 Repo Health pillars and 1 AI Setup pillar with AI relevance badges, informational extras, a prioritised remediation plan, and the embedded raw AgentRC JSON.