skilld
All skills
github avatar

/acreadiness-assess

@865d50f official
by githubgithub/awesome-copilot40k stars
5,040

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/github/awesome-copilot/acreadiness-assess

This session only. Nothing lands on disk.

SKILL.md

≈95 tokens always: the name and description. ≈706 when used: this file.

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

Source: SKILL.md on GitHub

Third-party checks

No alerts14d3 checks · Risk SAFE
  • Gen Agent Trust Hub14d

    This skill performs an AI-readiness assessment using a trusted tool from Microsoft's official GitHub repository. It generates a local HTML report to visualize repository health and AI compatibility. The skill follows secure practices by using reputable external resources and standard reporting methods.

  • Socket14d

    No alerts

  • Snyk14d

    Risk: LOW · No issues

Provenance

Signed by skilld at 865d50f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 18 hours ago.

Activeupdated 5 months ago

Capability

Other metadata
argument-hint
[--policy <path-or-pkg>] [--per-area] — e.g. /acreadiness-assess, /acreadiness-assess --policy ./policies/strict.json

Topics

  • TypeScript
  • agentrc
  • readiness
  • ai-readiness
  • assessment
  • audit
  • dashboard
  • html
  • policy

README badge

README badge for github/awesome-copilot/acreadiness-assess

What it does

Runs the AgentRC readiness assessment on a repository and generates a static HTML dashboard at reports/index.html, visualizing AI-readiness across 9 pillars (repo health and AI setup) with maturity levels, pass-rates, and a prioritized remediation plan. Supports org-specific scoring policies via the agentrc.config.json or --policy flag.

Generated from the current SKILL.md.

Frequently asked

What Node version does this skill require?
Node 20 or higher must be on PATH. You can check with `node --version` before running the skill.
Can I use custom scoring policies with this skill?
Yes. Pass `--policy <path-or-pkg>` to use a custom policy file, or the skill will check `agentrc.config.json` for a policies array. If neither is provided, it runs with built-in defaults.
What does the output look like?
A static HTML dashboard at `reports/index.html` with overall score, maturity level, breakdowns of 9 pillars (8 repo health, 1 AI setup), AI relevance badges, remediation priorities, and the raw AgentRC JSON embedded.
Will this skill modify my repository files?
No. The skill only creates `reports/index.html` and does not modify any other repository files.
What is the relationship between this skill and acreadiness-generate-instructions?
This skill measures AI readiness and produces a report. After running it, the `acreadiness-generate-instructions` skill is typically the next step to generate targeted fixes for the identified issues.

Generated from the current SKILL.md. These answers refresh after source changes.