This skill should be used when the user says "deploy", "deploy to staging", "deploy to production", "promote to production", "infra deploy", "arn infra deploy", "deploy infrastructure", "apply infrastructure", "push to prod", "go live", "tofu apply", "terraform apply", "pulumi up", "cdk deploy", "fly deploy", "deploy to railway", "release to prod", "promote environment", or wants to execute a deployment of their infrastructure to a target environment. This skill handles environment promotion, CI/CD enforcement, cost gates, safety layers, and resource tracking.
80
76%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-infra/skills/arn-infra-deploy/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.
This description excels at trigger term coverage and completeness, providing an exhaustive list of deployment-related phrases that would help Claude correctly select this skill. However, the 'what it does' portion is somewhat compressed into a brief list at the end, and the description could benefit from more detail on the specific capabilities beyond the high-level feature names. The heavy front-loading of trigger phrases, while functional, makes the description read more like a keyword list than a balanced capability description.
Suggestions
Expand the capability descriptions beyond the brief list at the end — for example, specify what 'cost gates' or 'safety layers' concretely do (e.g., 'enforces cost thresholds before applying changes', 'requires confirmation before production deployments').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description mentions some concrete actions like 'environment promotion, CI/CD enforcement, cost gates, safety layers, and resource tracking' but these are listed briefly at the end rather than being elaborated as specific capabilities. The main body focuses on trigger phrases rather than detailing what the skill actually does. | 2 / 3 |
Completeness | The description explicitly answers both 'what' (handles environment promotion, CI/CD enforcement, cost gates, safety layers, and resource tracking) and 'when' (extensive list of trigger phrases plus the general condition 'wants to execute a deployment of their infrastructure to a target environment'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including common phrases like 'deploy', 'push to prod', 'go live', tool-specific terms like 'tofu apply', 'terraform apply', 'pulumi up', 'cdk deploy', 'fly deploy', and variations like 'deploy to staging', 'deploy to production', 'promote to production'. These are terms users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | The skill is clearly focused on infrastructure deployment with very specific trigger terms tied to deployment tools and workflows. The combination of deployment-specific terminology and infrastructure tooling references (Terraform, Pulumi, CDK, Fly, Railway) makes it highly distinctive 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 excels at actionability and workflow clarity — it provides precise, executable commands for every tool and a well-structured 9-step deployment pipeline with strong safety gates and validation checkpoints. However, it is severely over-long, embedding extensive detail inline that should be in reference files, and explains many concepts Claude already knows (CI/CD purpose, state locking mechanics, what IaC tools do). The progressive disclosure structure exists but is underutilized given the volume of inline content.
Suggestions
Move the deployment command tables (Step 4), success indicators (Step 5), and the entire error handling catalog to reference files, keeping only the orchestration logic and decision points inline in SKILL.md.
Remove explanatory text that Claude already knows — e.g., why CI/CD is recommended, what state locking is, why saved plan files prevent drift — and replace with terse directives.
Consolidate the pre-deployment safety checklist (Step 3) into a reference to the already-mentioned deployment-safety-checklist.md rather than duplicating the full checklist inline.
Trim the deployment summary template in Step 9 to a brief format reference rather than a full inline template, since the handoff template is already in a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~300+ lines. It over-explains concepts Claude already understands (what CI/CD is, what state locking means, how IaC tools work), repeats patterns across steps, and includes extensive inline content that should be in reference files. The error handling section alone is a wall of text covering scenarios that could be condensed significantly. | 1 / 3 |
Actionability | The skill provides highly concrete, executable commands for every IaC tool and platform CLI, with specific flags, file paths, and exact command syntax. The deployment command table, plan file usage, and success indicators are all copy-paste ready and leave no ambiguity about what to execute. | 3 / 3 |
Workflow Clarity | The 9-step workflow is clearly sequenced with explicit validation checkpoints: promotion validation in Step 1, pre-deployment safety checklist with 6 gates in Step 3, user confirmation before deployment, error handling with retry/rollback/cancel options in Step 5, and a stall detection timeout. Feedback loops are well-defined throughout. | 3 / 3 |
Progressive Disclosure | The skill references external files appropriately (deployment-safety-checklist.md, rollback-patterns.md, resource-manifest-schema.md, infra-handoff-template.md, experience-derivation.md), but the main body contains far too much inline content that should be delegated to those references. The command tables, error handling catalog, and success indicators could all be in reference files, keeping the SKILL.md as a lean orchestration overview. No bundle files were provided to verify reference accuracy. | 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 | |
1fe948f
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.