This skill should be used when the user says "discover tools", "infra discover", "arn infra discover", "arn-infra-discover", "audit tools", "check installed tools", "what tools do I have", "scan for MCPs", "check provider tools", "tool discovery", "discover infrastructure tools", "check my setup", "infra tooling", or wants to audit their installed infrastructure tools (MCPs, CLIs, Claude Code plugins), check authentication state, search for new official tools online, and produce a tooling manifest for the infrastructure workflow.
64
76%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-infra/skills/arn-infra-discover/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description is strong on trigger terms and completeness, providing an extensive list of natural phrases users might say and clearly covering both what the skill does and when to use it. Its main weakness is that the capabilities are somewhat buried in a run-on sentence structure rather than being clearly enumerated as distinct concrete actions. The description could also benefit from slightly more structured formatting to improve readability.
Suggestions
Restructure the capabilities into a clearer list format, e.g., 'Audits installed infrastructure tools (MCPs, CLIs, Claude Code plugins), checks authentication state, searches for new official tools online, and produces a tooling manifest.' followed by the trigger guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (infrastructure tools/MCPs) and lists some actions like 'audit installed infrastructure tools', 'check authentication state', 'search for new official tools online', and 'produce a tooling manifest', but these are somewhat buried in a long sentence and could be more clearly enumerated. | 2 / 3 |
Completeness | The description explicitly answers both 'what' (audit installed infrastructure tools, check authentication state, search for new official tools online, produce a tooling manifest) and 'when' (extensive list of trigger phrases plus contextual description of when to use it). The 'Use when' guidance is effectively provided through the opening clause and trigger list. | 3 / 3 |
Trigger Term Quality | The description includes extensive natural trigger terms that users would actually say: 'discover tools', 'audit tools', 'check installed tools', 'what tools do I have', 'scan for MCPs', 'check my setup', 'infra tooling', plus variations like 'arn infra discover' and 'arn-infra-discover'. This provides excellent coverage of natural language variations. | 3 / 3 |
Distinctiveness Conflict Risk | The description carves out a very specific niche around infrastructure tool discovery, MCP scanning, and tooling manifests. The trigger terms are highly specific to this domain ('discover tools', 'scan for MCPs', 'check provider tools') and unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is highly actionable with excellent workflow clarity, clear phased sequencing, comprehensive error handling, and specific executable commands throughout. However, it is significantly over-verbose — inlining extensive recommendation templates, output table formats, confidence rating definitions, and provider-specific details that should be in reference files. The content would benefit greatly from aggressive trimming and offloading detail into the referenced files it already mentions.
Suggestions
Move the confidence rating definitions, recommendation templates, and output table formats into reference files (e.g., `references/output-format.md`) and reference them from the main skill to reduce inline verbosity.
Remove explanatory prose like 'This skill is proactive: it does not just check what is installed...' — Claude doesn't need motivation or design rationale, just instructions.
Consolidate the per-provider CLI detection and auth-check command lists into the existing cli-registry.md reference rather than enumerating them inline in the skill body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~200+ lines with significant redundancy. It explains concepts Claude already knows (what MCPs are, what CLIs do, what authentication means), repeats patterns across providers, and includes extensive prose that could be condensed. The recommendation templates, priority tagging explanations, and confidence rating definitions add bulk that could be in a reference file. | 1 / 3 |
Actionability | The skill provides highly concrete, executable guidance: specific CLI commands for detection (e.g., `aws --version`, `aws sts get-caller-identity`), exact JSON snippets for MCP configuration, specific file paths, and clear install command patterns. The workflow steps are copy-paste actionable. | 3 / 3 |
Workflow Clarity | The four-phase workflow (Detect → Online Check → Recommendations → Manifest) is clearly sequenced with explicit sub-steps. Error handling covers all failure modes with specific recovery actions. The D.4 step includes user confirmation before destructive writes, and re-running safety is explicitly noted. | 3 / 3 |
Progressive Disclosure | The skill references external files appropriately (mcp-registry.md, cli-registry.md, plugin-registry.md, tooling-manifest-schema.md, experience-derivation.md) with clear navigation signals. However, the main SKILL.md itself is monolithic — the detailed recommendation templates, confidence rating definitions, and output table formats could be split into reference files to keep the main skill leaner. No bundle files were provided to verify references exist. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
b9084b6
Table of Contents
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.