acreadiness-assess

Name: acreadiness-assess
Author: github

37kstars4.6kforks

How to install acreadiness-assess?

github/awesome-copilot/acreadiness-assess

$npx -y skills add github/awesome-copilot --skill acreadiness-assess

Installs into the current project.

Summary

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-specif

Files · 1

View on GitHub

SKILL.md

1	# /acreadiness-assess — AI-readiness assessment
2
3	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.
4
5	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.
6
7	## Steps
8
9	1. Confirm prerequisites. Node 20+ must be on PATH. If unsure, run `node --version`.
10
11	2. Decide on a policy (optional but encouraged):
12	- If the user provided `--policy <source>`, capture it.
13	- Otherwise check `agentrc.config.json` for a `policies` array.
14	- If neither, run with no policy (built-in defaults).
15	- For a primer on policies, suggest the `acreadiness-policy` skill.
16
17	3. Run the readiness scan in the repo root with structured output:
18	```bash
19	npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]
20	```
21	The `CommandResult<T>` JSON envelope is your input for the next step.
22
23	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:
24	- Reads the bundled `report-template.html` and substitutes placeholders with real data.
25	- Inlines all CSS, ships a single static file (works under `file://`).
26	- Renders maturity level, overall score, grade, pass-rate vs threshold.
27	- 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.
28	- Tags every pillar with an AI relevance badge (High / Medium / Low).
29	- Surfaces Extras separately (they never affect the score).
30	- Shows the Active Policy including any disabled/overridden criteria and thresholds.
31	- Produces a Prioritised Remediation Plan (🔴 Fix First / 🟡 Fix Next / 🔵 Plan).
32	- Embeds the raw AgentRC JSON for reuse.
33
34	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).
35
36	## Notes
37
38	- 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.
39	- For CI gating, recommend `agentrc readiness --fail-level <n>` (1–5).
40	- The skill never modifies repository files other than creating `reports/index.html`.

People who liked this also viewed

6 picks

Type

acreadiness-assess

37kstars4.6kforks

View on GitHub

How to install acreadiness-assess?

github/awesome-copilot/acreadiness-assess

$npx -y skills add github/awesome-copilot --skill acreadiness-assess

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# /acreadiness-assess — AI-readiness assessment
2
3	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.
4
5	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.
6
7	## Steps
8
9	1. Confirm prerequisites. Node 20+ must be on PATH. If unsure, run `node --version`.
10
11	2. Decide on a policy (optional but encouraged):
12	- If the user provided `--policy <source>`, capture it.
13	- Otherwise check `agentrc.config.json` for a `policies` array.
14	- If neither, run with no policy (built-in defaults).
15	- For a primer on policies, suggest the `acreadiness-policy` skill.
16
17	3. Run the readiness scan in the repo root with structured output:
18	```bash
19	npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]
20	```
21	The `CommandResult<T>` JSON envelope is your input for the next step.
22
23	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:
24	- Reads the bundled `report-template.html` and substitutes placeholders with real data.
25	- Inlines all CSS, ships a single static file (works under `file://`).
26	- Renders maturity level, overall score, grade, pass-rate vs threshold.
27	- 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.
28	- Tags every pillar with an AI relevance badge (High / Medium / Low).
29	- Surfaces Extras separately (they never affect the score).
30	- Shows the Active Policy including any disabled/overridden criteria and thresholds.
31	- Produces a Prioritised Remediation Plan (🔴 Fix First / 🟡 Fix Next / 🔵 Plan).
32	- Embeds the raw AgentRC JSON for reuse.
33
34	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).
35
36	## Notes
37
38	- 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.
39	- For CI gating, recommend `agentrc readiness --fail-level <n>` (1–5).
40	- The skill never modifies repository files other than creating `reports/index.html`.

People who liked this also viewed

6 picks

Type