CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-spark-dev-setup

This skill should be used when the user says "dev setup", "arn spark dev setup", "development environment", "configure dev environment", "dev container", "configure CI", "set up CI", "onboard developer", "developer setup", "set up docker", "configure development", "how do I set up this project", "development setup", "onboard me", "get this project running", "set up my machine", "new developer setup", "how do I get started", "developer onboarding", or wants to define a standardized development environment for their project (producing dev environment infrastructure files and a dev-setup document) or follow an existing environment standard to get onboarded as a new developer.

56

Quality

64%

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-spark/skills/arn-spark-dev-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

82%

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 exhaustive list of natural phrases users would say, and it clearly addresses both 'what' and 'when'. However, the actual capability description is somewhat vague—it could benefit from more specific concrete actions beyond 'producing dev environment infrastructure files and a dev-setup document'. Some trigger terms are broad enough to potentially conflict with more specialized skills.

Suggestions

Add more specific concrete actions, e.g., 'Generates Dockerfiles, docker-compose configs, .devcontainer setups, CI pipeline configs, and developer onboarding documentation'

Consider narrowing overly broad triggers like 'configure CI' or 'set up docker' to reduce conflict risk with dedicated CI or Docker skills, or clarify that this skill handles these only in the context of full dev environment setup

DimensionReasoningScore

Specificity

The description mentions some actions like 'define a standardized development environment', 'producing dev environment infrastructure files and a dev-setup document', and 'get onboarded as a new developer', but these are somewhat vague and not a comprehensive list of concrete actions (e.g., what specific files are produced, what tools are configured).

2 / 3

Completeness

The description explicitly answers both 'what' (define a standardized development environment producing infrastructure files and a dev-setup document, or follow an existing standard for onboarding) and 'when' (with a comprehensive explicit trigger list prefaced by 'should be used when'). Both components are clearly present.

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would actually say, such as 'dev setup', 'how do I get started', 'set up docker', 'configure CI', 'onboard me', 'new developer setup', and many more variations covering a wide range of how users might phrase their request.

3 / 3

Distinctiveness Conflict Risk

While the dev setup/onboarding niche is fairly specific, some trigger terms like 'configure CI', 'set up docker', and 'how do I get started' could overlap with CI/CD skills, Docker skills, or general project setup skills. The broad scope of triggers increases conflict risk somewhat.

2 / 3

Total

10

/

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 well-structured conversational skill with clear mode detection, step sequencing, and verification checkpoints. However, it is significantly over-verbose — explaining conversational strategies, probing questions, and edge cases that Claude could handle with general reasoning. It would benefit from being roughly half its current length, with detailed error handling and agent invocation guidance moved to reference files.

Suggestions

Cut the content by 40-50%: remove the probing questions table in Step 3 (Claude can ask contextual questions), compress the per-approach questions in Step 4 into a brief list, and trim the Agent Invocation Guide to only non-obvious cases.

Move the Error Handling section and Agent Invocation Guide to separate reference files (e.g., references/error-handling.md and references/agent-guide.md) to reduce the main skill's token footprint.

Add at least one concrete example of a generated artifact (e.g., a sample devcontainer.json snippet or setup script fragment) so Claude understands the expected output format rather than fully delegating to the builder agent.

Consolidate the duplicate mode-detection logic — the 'already configured' case appears in both Step 1 and Error Handling with slightly different presentations.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines. It over-explains conversational flows, includes extensive tables of probing questions Claude could derive from context, and repeats information across sections (e.g., mode detection logic appears in both Step 1 and Error Handling). Many sections like the Agent Invocation Guide and Error Handling enumerate scenarios that Claude could handle with general intelligence.

1 / 3

Actionability

The skill provides clear conversational structure with specific AskUserQuestion prompts and option lists, which is actionable for a conversational skill. However, it lacks concrete executable examples — no actual setup script snippets, no devcontainer.json examples, no CI workflow YAML samples. It delegates all file generation to an agent without showing what the outputs look like.

2 / 3

Workflow Clarity

The workflow is clearly sequenced with numbered steps for both Define and Onboard modes. It includes explicit verification checkpoints (Step 8, Step O4), error recovery paths (setup script retry logic, fallback to manual steps), and clear branching logic between modes. The feedback loop of 'invoke builder → verify → fix if needed' is well-defined.

3 / 3

Progressive Disclosure

The skill references external files appropriately (dev-setup-template.md, dev-setup-checklist.md, ensure-config.md, agent-models/spark.md) with clear paths, but the SKILL.md itself is monolithic — all the conversational guidance, error handling, and agent invocation details are inline rather than split into reference files. The Agent Invocation Guide and Error Handling sections could be separate references.

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.