williamlimasilva/acreadiness-assess
skills/acreadiness-assess/SKILL.md
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.
development
Updated May 5, 2026
$ install --global
skillsauthnpx skillsauth add williamlimasilva/.copilot acreadiness-assessInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 5, 2026, 2:07 AM97.2s1 file scanned
SKILL.md
- name:
- acreadiness-assess
- 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.
- argument-hint:
- [--policy <path-or-pkg>] [--per-area] — e.g. /acreadiness-assess, /acreadiness-assess --policy ./policies/strict.json
/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.
Related Skills
williamlimasilva/workshop-create
tools
VerifiedTrustedCommunity
Create a new workshop or use an existing directory as one. Handles two paths: (A) use an existing local directory the operator points at, or (B) create a new private GitHub repo in the signed-in account. Never creates a repo inside another repo.
SKILL.mdUpdated Jul 22, 2026
williamlimasilva/vcpkg
development
VerifiedTrustedCommunity
Guide for setting up vcpkg in C++ projects, managing dependency versions, and cross-compiling. Covers manifest initialization, CMake and Visual Studio integration, classic-to-manifest migration, version pinning, baselines, overrides, triplets, and cross-compilation. Use when a user is working with vcpkg project setup, installation, version management, or cross-platform builds. For specialized tasks, additional references cover custom registries and overlay ports (references/registries.md), CI/CD and binary caching (references/ci.md), and troubleshooting and dependency lifecycle (references/troubleshooting.md).
SKILL.mdUpdated Jul 22, 2026
williamlimasilva/signal-write
testing
VerifiedTrustedCommunity
Emit structured agent signals — hands-up, blocked, done, checkpoint, partnership. Signals are written as JSON to .signals/ for dashboard consumption and noted in the journal for persistence.
SKILL.mdUpdated Jul 22, 2026
williamlimasilva/markstream-install
development
VerifiedTrustedCommunity
Install and configure Markstream streaming Markdown renderers for Vue, React, Svelte, Angular, Nuxt, and Vue 2 applications. Use for package selection, minimal peer dependencies, CSS order, SSR boundaries, streaming mode, and renderer setup.
SKILL.mdUpdated Jul 22, 2026