This skill should be used when the user says "manage environments", "arn infra env", "infra env", "environment setup", "configure environments", "set up staging", "set up production", "environment management", "create environment", "environment promotion", "promote to staging", "promote to production", "environment isolation", "configure dev staging prod", "environment-specific config", "tfvars per environment", "arn-infra-env", or wants to configure, create, or manage infrastructure environments (dev/staging/production) with isolation strategies, variable overrides, and promotion rules.
73
67%
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-env/SKILL.mdQuality
Discovery
72%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 excels at trigger term coverage with an extensive list of natural phrases users would say, and it occupies a clear niche. However, it is heavily weighted toward 'when to use' at the expense of 'what it does' — the actual capabilities are described only in vague terms like 'configure, create, or manage' without listing specific concrete actions or outputs.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Generates per-environment tfvars files, configures backend state isolation, sets up promotion pipelines between environments'.
Restructure to lead with a clear 'what it does' statement listing capabilities, then follow with the 'Use when...' trigger clause — currently the entire description is essentially one long trigger list.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description mentions domain concepts like 'isolation strategies, variable overrides, and promotion rules' and references dev/staging/production environments, but it doesn't list concrete actions (e.g., 'creates tfvars files', 'configures backend state isolation'). The actions are mostly generic verbs like 'configure, create, or manage'. | 2 / 3 |
Completeness | The 'when' is thoroughly covered with explicit trigger phrases, but the 'what' is weak — it only vaguely states 'configure, create, or manage infrastructure environments with isolation strategies, variable overrides, and promotion rules' without detailing specific actions or outputs the skill produces. | 2 / 3 |
Trigger Term Quality | The description includes an extensive list of natural trigger phrases users would say, including variations like 'manage environments', 'set up staging', 'promote to production', 'tfvars per environment', and shorthand like 'arn infra env'. This provides excellent coverage of how users would naturally phrase requests. | 3 / 3 |
Distinctiveness Conflict Risk | The description is clearly scoped to infrastructure environment management (dev/staging/prod) with specific terms like 'tfvars per environment', 'environment promotion', and 'arn-infra-env' that create a distinct niche unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 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 is a well-structured environment management skill with clear workflow sequencing, thorough error handling, and good experience-level adaptation. Its main weaknesses are verbosity (the skill is long with some content that could be externalized or trimmed) and moderate actionability (concrete output templates exist but actual config generation is delegated to a specialist agent without showing complete examples). The workflow clarity is strong with explicit decision points and safe re-run behavior.
Suggestions
Trim explanatory content that Claude already knows — for example, the variable overrides list (instance sizes, replica counts, etc.) could be a compact table rather than a bulleted list with parenthetical examples for each item.
Include at least one complete, executable example of a generated environment config file (e.g., a full `dev.tfvars`) rather than only showing fragments, so Claude has a concrete reference for what the specialist agent should produce.
Consider extracting the IaC tool config format table and the experience-level branching details into reference files to reduce the main skill's length and improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long and includes some explanatory content that Claude doesn't need (e.g., explaining what isolation strategies are, listing obvious variable override examples like 'Domain names and URLs per environment'). The experience-level branching adds significant length but is structurally justified. Some sections like the sizing matrix examples and promotion defaults could be tighter. | 2 / 3 |
Actionability | The skill provides structured workflows with specific steps and concrete output formats (e.g., the environments.md template, the IaC tool config table, the specialist agent invocation format). However, it lacks executable code examples — the IaC config examples are fragments rather than complete files, and the specialist agent delegation means the actual config generation is deferred. The AskUserQuestion patterns are concrete but the actual generation logic is abstract. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced (Steps 1-7) with explicit decision points, user confirmation pauses, and branching logic for full setup vs. specific tasks. Error handling is thorough with fallback strategies. The promotion pipeline has clear validation gates (approval requirements, rollback policies). Re-running safety is explicitly addressed with diff-before-overwrite behavior. | 3 / 3 |
Progressive Disclosure | The skill references external files like `environment-patterns.md`, `promotion-patterns.md`, `experience-derivation.md`, and provider/environment config paths, which suggests good structural intent. However, no bundle files are provided to verify these references exist, and the skill itself is quite long — some content (like the full IaC tool config format table or the detailed sizing matrices) could be split into reference files. The skill is somewhat monolithic for its length. | 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.