This skill should be used when the user says "verify deployment", "verify infra", "check deployment", "arn infra verify", "infra verify", "health check", "check health", "verify staging", "verify production", "is my deployment healthy", "check if deployment worked", "run health checks", "deployment verification", "check infrastructure", "validate deployment", "verify environment", "post-deployment check", "infra health", "check dns", "check ssl", "verify endpoints", "smoke test", "integration test", or wants to validate that a deployed environment is healthy and its resources match the expected state. This skill runs health checks, DNS verification, SSL validation, resource state comparison, and updates issue labels and environments.md with verification results.
62
73%
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-verify/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that excels at trigger term coverage with an extensive list of natural phrases users would say. It clearly communicates both what the skill does and when to use it. The only minor weakness is that the heavy front-loading of trigger terms makes it slightly harder to parse the capability summary, but the information is all present and accurate.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'runs health checks, DNS verification, SSL validation, resource state comparison, and updates issue labels and environments.md with verification results.' | 3 / 3 |
Completeness | Clearly answers both 'what' (runs health checks, DNS verification, SSL validation, resource state comparison, updates labels/environments.md) and 'when' (extensive explicit trigger phrases plus the general condition 'wants to validate that a deployed environment is healthy'). Has explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including many variations users would actually say: 'verify deployment', 'check health', 'is my deployment healthy', 'smoke test', 'check dns', 'check ssl', 'verify endpoints', etc. Covers both formal and casual phrasings. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche focused on post-deployment infrastructure verification. The combination of deployment health checks, DNS, SSL, resource state comparison, and environments.md updates is highly distinctive and unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a thorough and well-structured verification workflow with excellent error handling and clear step sequencing. However, it suffers significantly from verbosity—the three outcome branches (PASS/WARN/FAIL) contain heavily repeated patterns that inflate the token cost, and much of the content could be consolidated or moved to reference files. Actionability is moderate since the skill relies on pseudocode placeholders rather than concrete executable examples.
Suggestions
Consolidate the PASS/WARN/FAIL branches into a shared procedure with a decision table for the differences (e.g., which labels to add/remove, whether to update lastVerified, whether to close the issue), reducing repetition by ~40%.
Move the verification summary template and next-steps recommendations into a reference file (e.g., verification-report-template.md) and reference it, keeping the main skill focused on the workflow logic.
Replace pseudocode placeholders like 'Read <resource-manifest-path>' and 'Glob <specs-dir>/INFRA_HANDOFF_<environment>*' with concrete tool invocation examples showing actual tool names and parameter formats.
Move the detailed remediation suggestions (endpoint unreachable, DNS not resolving, SSL invalid, etc.) into a reference file to reduce the main skill's token footprint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~250+ lines with significant redundancy. The PASS/WARN/FAIL branches repeat nearly identical update steps (environments.md, active-resources.json, issue labels) that could be consolidated into a table or shared procedure. The verification summary template and next steps are spelled out in full for all three outcomes when a compact table would suffice. Much of this is procedural boilerplate that Claude could infer from a more concise specification. | 1 / 3 |
Actionability | The skill provides a clear sequence of steps and specifies file paths, agent invocation patterns, and structured context blocks. However, there are no executable code examples—commands like 'Read <resource-manifest-path>' and 'Glob <specs-dir>/INFRA_HANDOFF_<environment>*' are pseudocode placeholders rather than concrete executable commands. The agent invocation context block is a template with bracketed placeholders rather than a concrete, copy-paste-ready example. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced across 5 numbered steps with explicit validation checkpoints. Step 4 handles all three verification outcomes (PASS/WARN/FAIL) with specific actions for each, including feedback loops (retry, rollback, re-deploy options on failure). Error handling is comprehensive with fallback procedures for agent failures, missing manifests, DNS propagation delays, and SSL provisioning. The idempotency note for re-runs is a good safety detail. | 3 / 3 |
Progressive Disclosure | The skill references several external files (health-check-patterns.md, verification-report-template.md, experience-derivation.md, ensure-config.md) which is good progressive disclosure practice. However, no bundle files were provided to verify these references exist, and the main SKILL.md itself is monolithic—the detailed PASS/WARN/FAIL handling, remediation suggestions, and summary templates could be split into reference files to keep the main skill leaner. | 2 / 3 |
Total | 8 / 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.