Skip to content
cccskills
FreePublished on GitHub

acreadiness-assess

Assess a repository’s readiness for AI agents with AgentRC and generate a standalone HTML dashboard. Review scores across nine areas, see prioritized improvements, and optionally apply scoring policies tailored to an organization.

OriginalShow the original 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.

See how to install

Good for

  • Assessing a repository’s readiness for AI agents
  • Prioritizing improvements from assessment results
  • Reviewing scores under an organization’s own policy
  • Sharing assessment results as an HTML dashboard

Files included (2)

  • SKILL.md3.3 KB
  • report-template.html11.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Map an existing codebase into seven documents covering its technology, structure, architecture, conventions, integrations, tests, and concerns. Link findings to file evidence, mark unknowns, and highlight differences between stated plans and the actual implementation.

  • Get oriented in an unfamiliar codebase
  • Prepare documentation for a project handover
  • Compare documented architecture with implementation
github/awesome-copilot40.2KUpdated Oct 17, 2026

Generate coding agent instruction files from a project's actual code using AgentRC. Capture detected languages, frameworks, and conventions in one shared file or split rules by topic and project area, with a preview before writing.

  • Create project instructions for VS Code Copilot
  • Refresh agent rules after project changes
  • Split monorepo instructions by project area
github/awesome-copilot40.2KUpdated Oct 17, 2026

Customize AgentRC readiness assessments to match team or organization standards. Choose or create policies that adjust check importance, disable irrelevant checks, set pass thresholds, and define requirements for automated checks in CI workflows.

  • Set shared readiness standards across an organization
  • Focus assessments on AI tooling
  • Adjust the importance of individual checks
github/awesome-copilot40.2KUpdated Oct 17, 2026

Analyze supplied ad performance data to identify wasted spend, strong campaigns, and next tests. Compare channels, assess whether test differences are meaningful, and produce budget reallocation recommendations with a prioritized action plan.

  • Identify ads and keywords to pause
  • Find campaigns and audiences worth scaling
  • Assess whether A/B test results are meaningful
github/awesome-copilot40.2KUpdated Oct 17, 2026

Turn code files into learning resources by adding comments that explain syntax, programming concepts, and design choices. Adjust explanation depth and repetition to the reader’s knowledge while preserving file structure, encoding, and syntax.

  • Add beginner-friendly explanations to existing code
  • Document the reasoning behind syntax and design choices
  • Adjust comment depth for readers with different experience
github/awesome-copilot40.2KUpdated Oct 17, 2026

Create and fix Adobe Illustrator automation scripts using ExtendScript, Adobe’s JavaScript-based scripting language. Automate changes to artwork, text, layers, and artboards, process multiple files, and prepare exports such as PDF, SVG, and PNG.

  • Automate repeated changes to artwork and text
  • Export multiple Illustrator files
  • Generate artwork variations from data
github/awesome-copilot40.2KUpdated Oct 17, 2026

See all skills by github

Report a problem with this skill