Runs an AI-readiness assessment on a repository and generates a static HTML dashboard report.
- GitHub stars
- 41,038
- Files
- 2
- Last commit
- Nov 11, 2026
- License
- MIT
- Allowed tools
- —
What does the acreadiness-assess skill do?
acreadiness-assess runs an AI-readiness assessment on a repository and generates a static HTML dashboard report.
Summary generated from the skill's SKILL.md.
About the acreadiness-assess skill
Evaluating how prepared a codebase is for AI integration is the primary function of this skill. It serves developers and organizations that need to audit, score, or assess the AI readiness of a specific repository. By wrapping the npx github:microsoft/agentrc readiness command, the tool performs a structured scan of the repository to measure maturity across nine pillars, including repo health and AI setup.
An agent should load this skill when a user requests a readiness check or an audit. The process relies on Node 20+ and can utilize organization-specific scoring by passing a path to a policy via the --policy argument. After the scan, the skill hands the data to the ai-readiness-reporter custom agent, which uses a bundled report-template.html to generate a single, static HTML dashboard located at reports/index.html. This dashboard includes a prioritized remediation plan and maturity levels without modifying any existing repository files.
What an agent can do with it
- 1Apply custom organizational scoringExecute a readiness scan using a specific JSON policy file.
- 2Generate a visual maturity dashboardCreate a static HTML report that displays scores and remediation steps.
- 3Identify high-priority fixesGet a prioritized list of actions to improve AI readiness.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the acreadiness-assess skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the acreadiness-assess skill in Claude Code
~/.claude/skills/acreadiness-assess/SKILL.md
$ npx degit github/awesome-copilot/skills/acreadiness-assess ~/.claude/skills/acreadiness-assessInstall the acreadiness-assess skill in Claude Code (project)
.claude/skills/acreadiness-assess/SKILL.md
$ npx degit github/awesome-copilot/skills/acreadiness-assess .claude/skills/acreadiness-assessInstall the acreadiness-assess skill in Codex
~/.agents/skills/acreadiness-assess/SKILL.md
$ npx degit github/awesome-copilot/skills/acreadiness-assess ~/.agents/skills/acreadiness-assessInstall the acreadiness-assess skill in Gemini CLI
~/.gemini/skills/acreadiness-assess/SKILL.md
$ npx degit github/awesome-copilot/skills/acreadiness-assess ~/.gemini/skills/acreadiness-assessInstall the acreadiness-assess skill in Claude.ai
npx degit github/awesome-copilot/skills/acreadiness-assess acreadiness-assess && zip -r acreadiness-assess.zip acreadiness-assess # claude.ai → Customize → Skills → + → Create skill → Upload a skill → acreadiness-assess.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work
- Source repository linked and reachablegithub/awesome-copilot/skills/acreadiness-assess is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/acreadine ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-11github.com/github/awesome-copilot/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/acreadine ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/acreadine ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 47 linesgithub.com/github/awesome-copilot/blob/HEAD/skills/acreadine ↗Pass
SKILL.md
View on GitHub/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
-
Confirm prerequisites. Node 20+ must be on PATH. If unsure, run
node --version. -
Decide on a policy (optional but encouraged):
- If the user provided
--policy <source>, capture it. - Otherwise check
agentrc.config.jsonfor apoliciesarray. - If neither, run with no policy (built-in defaults).
- For a primer on policies, suggest the
acreadiness-policyskill.
- If the user provided
-
Run the readiness scan in the repo root with structured output:
npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]The
CommandResult<T>JSON envelope is your input for the next step. -
Hand off to the
ai-readiness-reportercustom agent to interpret the JSON and producereports/index.html. The agent renders via the bundled templatereport-template.html(shipped alongside this skill) so every report has an identical look & feel. The agent:- Reads the bundled
report-template.htmland substitutes placeholders with real data. - Inlines all CSS, ships a single static file (works under
file://). - Renders maturity level, overall score, grade, pass-rate vs threshold.
- Breaks down all 9 pillars across Repo Health (8) and AI Setup (1) with what it measures, why it matters for AI, current state, and a specific recommendation.
- Tags every pillar with an AI relevance badge (High / Medium / Low).
- Surfaces Extras separately (they never affect the score).
- Shows the Active Policy including any disabled/overridden criteria and thresholds.
- Produces a Prioritised Remediation Plan (🔴 Fix First / 🟡 Fix Next / 🔵 Plan).
- Embeds the raw AgentRC JSON for reuse.
- Reads the bundled
-
Tell the user where the report lives (
reports/index.html) and how to open it. Summarise in chat: maturity level, overall score, top three lowest pillars, and the single highest-leverage next action (almost always: run theacreadiness-generate-instructionsskill).
Notes
- AgentRC also has a built-in HTML renderer (
--visual/--output report.html) but its output is intentionally generic. This skill produces a tailored, opinionated dashboard via the custom agent — closer to a code review than a metrics dump. - For CI gating, recommend
agentrc readiness --fail-level <n>(1–5). - The skill never modifies repository files other than creating
reports/index.html.
Files in this skill
2acreadiness-assess skill questions
How do I install the acreadiness-assess skill in Claude Code?
Run npx degit github/awesome-copilot/skills/acreadiness-assess ~/.claude/skills/acreadiness-assess. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the acreadiness-assess skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What is the output of the assessment?
The skill produces a self-contained static HTML dashboard located at reports/index.html which can be opened via file://.
Can I use a custom policy for scoring?
Yes, you can specify a policy using the --policy flag or by checking the agentrc.config.json file.
Does this skill modify my repository files?
No, the skill only creates the reports/index.html file and does not change any other files.