Source profileQuality 74/100Review permissions

github/awesome-copilot/skills/acreadiness-assess/SKILL.md

acreadiness-assess

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.

Source repository stars
37,126
Declared platforms
0
Static risk flags
2
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

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.

Best for

  • Use when asked to assess, audit, or score the AI readiness of a repo.

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/github/awesome-copilot --skill "skills/acreadiness-assess"
Safe inspection promptEditorial

Inspect the Agent Skill "acreadiness-assess" from https://github.com/github/awesome-copilot/blob/9933dcad5be5caeb288cebcd370eeeb2fc2f1685/skills/acreadiness-assess/SKILL.md at commit 9933dcad5be5caeb288cebcd370eeeb2fc2f1685. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Steps

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

    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 , capture it.
  2. 02

    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 t…

    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 t…For CI gating, recommend agentrc readiness --fail-level (1–5).The skill never modifies repository files other than creating reports/index.html.

Permission review

Static risk signals and limitations

Reads files

low · line 5

The documentation asks the agent to read local files, directories, or repositories.

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.

Reads files

low · line 17

The documentation asks the agent to read local files, directories, or repositories.

**Run the readiness scan** in the repo root with structured output:

Runs scripts

medium · line 19

The documentation asks the agent to run terminal commands or scripts.

npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score74/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars37,126SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
github/awesome-copilot
Skill path
skills/acreadiness-assess/SKILL.md
Commit
9933dcad5be5caeb288cebcd370eeeb2fc2f1685
License
MIT
Collected
2026-07-28
Default branch
main
View the original SKILL.md

/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:

    npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]
    

    The CommandResult<T> JSON envelope is your input for the next step.

  4. 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:

    • Reads the bundled report-template.html and 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.
  5. 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 the acreadiness-generate-instructions skill).

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.