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.

58

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 multi-step workflows, good error handling, and thoughtful experience-level adaptation. Its main weaknesses are verbosity from repeated experience-level branching patterns across steps and reliance on pseudocode/templates rather than executable examples. The progressive disclosure design references external files appropriately but the main body could be more compact.

Suggestions

Consolidate the experience-level branching pattern into a single reference section or table rather than repeating the beginner/intermediate/expert pattern in Steps 2, 3, and 5 separately.

Add at least one complete, executable example of a generated config file (e.g., a full `dev.tfvars` file) rather than only showing single-line fragments in the IaC tool table.

Move the detailed IaC tool config format table and variable overrides list to a reference file to reduce the main skill body length.

DimensionReasoningScore

Conciseness

The skill is fairly long and includes some repetitive patterns (experience-level branching repeated across multiple steps with similar structures). Some sections like the variable overrides list and sizing matrix could be more compact. However, most content is task-specific and not explaining concepts Claude already knows.

2 / 3

Actionability

The skill provides structured workflows with specific file paths, config formats, and a useful IaC tool mapping table. However, the code examples are mostly pseudocode or template placeholders rather than executable snippets. The specialist agent invocation context block is well-structured but the actual config generation is delegated, making the skill more of a coordination guide than directly executable.

2 / 3

Workflow Clarity

The workflow is clearly sequenced (Steps 1-7) with explicit decision points, user confirmation pauses, routing logic for specific tasks, and a comprehensive error handling section that covers re-running safety, fallback strategies, and duplicate prevention. The promotion pipeline includes validation gates (approval requirements, rollback policies).

3 / 3

Progressive Disclosure

The skill references external files like `environment-patterns.md`, `promotion-patterns.md`, `experience-derivation.md`, and provider configs, which is good progressive disclosure design. However, no bundle files were provided to verify these references exist, and the main SKILL.md itself is quite long (~200+ lines) with detailed inline content (like the full IaC tool table and sizing matrices) that could potentially be split into reference files.

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.