CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-deploy

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.

64

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-infra/skills/arn-infra-deploy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 extensive list of natural phrases that would activate the skill and clearly stating both when and what. Its main weakness is that the 'what it does' portion is somewhat compressed and uses the vague verb 'handles' rather than listing specific concrete actions. The description is functional and effective for skill selection but could be more specific about its actual capabilities.

Suggestions

Replace 'handles environment promotion, CI/CD enforcement, cost gates, safety layers, and resource tracking' with more specific action descriptions like 'Promotes deployments between staging and production environments, enforces CI/CD pipeline checks before deploying, estimates and gates on infrastructure costs, applies safety checks before destructive changes, and tracks deployed resources and their ARNs.'

DimensionReasoningScore

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 'what it does' is somewhat vague — 'handles' is not as concrete as listing specific actions like 'runs tofu apply', 'checks cost estimates before deploying', etc.

2 / 3

Completeness

The description explicitly answers both 'what' (handles environment promotion, CI/CD enforcement, cost gates, safety layers, 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'). The 'Use when' guidance is effectively provided through the opening clause.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including common phrases users would say: 'deploy', 'push to prod', 'go live', 'promote to production', plus tool-specific terms like 'tofu apply', 'terraform apply', 'pulumi up', 'cdk deploy', 'fly deploy', 'deploy to railway'. This covers a wide range of natural language variations.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to infrastructure deployment with clear, distinct triggers. The combination of deployment-specific terms, infrastructure tooling references (tofu, terraform, pulumi, cdk, fly, railway), and environment promotion concepts makes it very 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, providing concrete commands, clear step sequencing, and robust validation checkpoints including user confirmation gates and failure recovery loops. However, it is significantly over-verbose — the content could be cut by 40-50% without losing any actionable information, as it explains concepts Claude already knows and includes excessive prose around straightforward instructions. The progressive disclosure is adequate but the monolithic structure suggests content should be better distributed across reference files.

Suggestions

Drastically reduce verbosity: remove explanatory prose (e.g., 'This guarantees the user approves exactly what gets deployed, eliminating plan-apply drift'), collapse the error handling section into a compact table with columns for error/action/stop?, and trim step descriptions to essential instructions only.

Move the tool command mapping tables, error handling catalog, and success indicators into separate reference files (e.g., `references/deploy-commands.md`, `references/error-catalog.md`) to keep the main SKILL.md as a lean orchestration overview.

Remove explanations of concepts Claude already knows, such as what CI/CD pipelines provide ('reproducibility, audit trails, and team visibility'), what state locking is, and how IaC idempotency works.

DimensionReasoningScore

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 prose that could be condensed into tables or terse instructions. The error handling section alone is a wall of text that could be a compact table.

1 / 3

Actionability

The skill provides concrete, executable commands for every IaC tool and platform CLI, includes a detailed command mapping table, specifies exact flags (e.g., `--require-approval never`, `-out=deploy.tfplan`), and gives specific file paths and schemas. The guidance is copy-paste ready throughout.

3 / 3

Workflow Clarity

The 9-step workflow is clearly sequenced with explicit validation checkpoints (pre-deployment safety checklist with 6 gates, user confirmation required before deployment, deployment monitoring with failure recovery options, post-deployment resource manifest updates). Feedback loops are present for failures (retry/rollback/cancel) and stalled deployments.

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 no bundle files were provided to verify these exist. The main SKILL.md itself is monolithic — much of the inline content (error handling, tool command tables, ephemeral deployment logic) could be split into reference files to keep the main skill leaner.

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
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.