CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-init

Optional customization tool for infrastructure projects. This skill should be used when the user says "infra init", "arn infra init", "initialize infra", "setup infrastructure", "arn-infra-init", "configure infra", "init infra", "infrastructure setup", "set up infrastructure", "infra setup", "start infra", "configure arn infra", "add infrastructure to this project", "review infra config", "customize infra config", "infra settings", or wants to configure providers, environments, IaC tools, CI/CD platform, or review current infrastructure settings. Arness Infra auto-configures with sensible defaults on first skill invocation — this init is optional for basic usage but required for provider/environment configuration.

59

Quality

68%

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-init/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 is a well-constructed skill description with excellent trigger term coverage and clear completeness. Its main weakness is that the specific capabilities could be more concretely described — while it mentions configuring providers, environments, IaC tools, and CI/CD, it could benefit from more specific action verbs describing what the configuration actually produces. The extensive trigger phrase list, while thorough, makes the description somewhat verbose.

Suggestions

Replace some of the generic verbs ('configure', 'customize', 'review') with more specific concrete actions, e.g., 'Selects cloud providers (AWS/GCP/Azure), defines deployment environments, chooses IaC tooling (Terraform/Pulumi), and sets CI/CD pipeline targets.'

DimensionReasoningScore

Specificity

The description mentions configuring providers, environments, IaC tools, CI/CD platform, and reviewing infrastructure settings, which names the domain and some actions. However, the concrete actions are somewhat vague — 'customize', 'configure', 'review' are generic verbs, and it doesn't list specific concrete outcomes like 'generates Terraform configs' or 'creates CI/CD pipelines'.

2 / 3

Completeness

The description clearly answers both 'what' (optional customization tool for infrastructure projects, configuring providers/environments/IaC tools/CI/CD) and 'when' (explicit trigger phrases and use cases). It also clarifies the relationship to auto-configuration, noting this is optional for basic usage but required for provider/environment configuration.

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would actually say, covering many variations like 'infra init', 'setup infrastructure', 'configure infra', 'add infrastructure to this project', etc. This provides excellent coverage of how users might naturally phrase their requests.

3 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche — it's specifically about initializing and configuring infrastructure settings for the 'Arness Infra' system. The specific trigger terms like 'arn infra init' and 'arn-infra-init' are highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

47%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a comprehensive, well-structured workflow with excellent sequencing, branching logic, and error handling. However, it suffers significantly from verbosity — the skill tries to be both a high-level orchestration guide and a detailed reference document simultaneously, resulting in a very long file that could be dramatically shortened by moving inline details to reference files. The heavy reliance on external references that aren't provided in the bundle makes it hard to assess completeness.

Suggestions

Reduce the SKILL.md to ~150 lines by moving the full config field listing (Step 8), file templates (providers.md, environments.md), and detection patterns (Step 0) into reference files, keeping only the workflow skeleton and decision points inline.

Remove explanatory text that Claude doesn't need — e.g., 'PDF-style' explanations of what Git remotes are, what CI/CD pipelines do, or why staging environments exist. Trust Claude's existing knowledge.

Consolidate the provider configuration section (Step 3) by moving the experience-level-adaptive conversation scripts to a reference file and keeping only the decision tree and output format in the main skill.

Include the referenced bundle files (config-schema.md, reference-override-protocol.md, experience-derivation.md) so the skill can be properly evaluated as a complete unit with progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines with significant redundancy. It explains concepts Claude already knows (what Git remotes are, what CI/CD is), repeats information across steps (e.g., the deferred flow details, reference override mentions), and includes extensive inline documentation that could be in reference files. Many fields and options are exhaustively enumerated when a reference file would suffice.

1 / 3

Actionability

The skill provides concrete commands (mkdir, gh label create, git remote -v) and specific file templates with markdown structure, which is good. However, many critical procedures delegate to external reference files (experience-derivation.md, reference-override-protocol.md, step-0-fast-path.md, config-schema.md) that are not provided in the bundle, making the skill incomplete on its own. Some steps are more descriptive than prescriptive.

2 / 3

Workflow Clarity

The workflow is exceptionally well-sequenced with numbered steps, clear branching logic for different user choices (deferred/now, expert/intermediate/beginner, monorepo/separate/infra-only), explicit validation in Step 9 with a comprehensive checklist, and robust error handling with recovery paths. The Update flow and re-run safety are well-documented with feedback loops.

3 / 3

Progressive Disclosure

The skill references multiple external files (reference-override-protocol.md, experience-derivation.md, config-schema.md, recommendation-matrix.md, etc.) which is good progressive disclosure in principle, but none of these bundle files are provided for evaluation. The main SKILL.md itself is monolithic — much of the inline content (full config field listings, file templates, detailed sub-step descriptions) could be moved to reference files to keep the main skill leaner.

2 / 3

Total

8

/

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.