CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A compact, well-structured instruction skill with a clear workflow and a copy-paste-ready core command. The main gaps are a missing validation checkpoint on the scan output, slight prose padding in Notes, and a bundled-template reference that is not verifiable in the skill's bundle.

Suggestions

Add an explicit validation checkpoint after the readiness scan (e.g. check the CommandResult envelope for errors / non-zero exit before handing off to the reporter agent).

Trim the Notes prose — drop the 'code review vs metrics dump' metaphor and the Measure→Generate→Maintain framing unless they change what Claude does.

Confirm `report-template.html` ships in this skill's bundle (e.g. under assets/) or reword the reference so the claimed bundled file is actually present and discoverable.

DimensionReasoningScore

Conciseness

The body is mostly lean and actionable, but the Notes section adds mild padding ('closer to a code review than a metrics dump') and the Measure→Generate→Maintain framing is context Claude largely does not need.

4 / 5

Actionability

Provides a copy-paste-ready command (`npx -y github:microsoft/agentrc readiness --json [--policy <source>] [--per-area]`) and a prereq check, but the most complex step (HTML rendering) is delegated to a custom agent rather than given as executable code.

4 / 5

Workflow Clarity

A clear five-step sequence with a prerequisite check; the operation is non-destructive (only writes reports/index.html) so the destructive-cap does not apply, but there is no explicit validation of the scan's JSON output before the handoff.

4 / 5

Progressive Disclosure

Under 50 lines with well-organized Steps/Notes sections and clearly signaled one-level-deep pointers to sibling skills and a bundled template; minor gap is that the referenced `report-template.html` is not present in this skill's bundle directories.

4 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that states concrete actions, an explicit output artifact, and a clear 'Use when…' trigger clause in third person. Minor room only in broadening natural trigger-term synonyms.

DimensionReasoningScore

Specificity

Names multiple concrete actions — 'Run the AgentRC readiness assessment', 'produce a static HTML dashboard at reports/index.html', 'Wraps `npx github:microsoft/agentrc readiness`', 'hands off rendering to the @ai-readiness-reporter custom agent', 'Supports policies (--policy)' — with comprehensive coverage and a specific output path.

5 / 5

Completeness

Explicitly states what it does (run assessment, produce dashboard at a named path, wrap a specific command, hand off rendering, support policies) and when to use it ('Use when asked to assess, audit, or score the AI readiness of a repo') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Covers natural user phrases ('assess, audit, or score the AI readiness of a repo', 'AI-readiness assessment') with verb synonyms, but stops short of exhaustive natural-term coverage (e.g. 'evaluate', 'review', 'check').

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (AgentRC AI-readiness assessment of a repository) with distinct triggers tied to a specific tool, so overlap with other skills is minimal.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

github/awesome-copilot

Path

skills/acreadiness-assess/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.