CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-env

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

Quality

67%

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-env/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.