CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-spark-init

Optional customization tool for greenfield projects. This skill should be used when the user says "greenfield init", "arn spark init", "initialize greenfield", "setup greenfield", "greenfield setup", "start greenfield", "configure greenfield", "set up greenfield", "init greenfield", "greenfield configuration", "review greenfield config", "customize greenfield config", "greenfield settings", "Figma setup", "Canva setup", "add Figma", "add Canva", "design tool setup", or wants to customize Arness Spark configuration, add design tool integrations (Figma, Canva), or review current greenfield settings. Arness Spark auto-configures with sensible defaults on first skill invocation — this init is optional. Design tool integration (Figma/Canva) remains available only through this skill.

64

Quality

76%

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-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 description excels at trigger term coverage and completeness, providing an exhaustive list of phrases that would help Claude select this skill accurately. Its main weakness is that the actual capabilities are somewhat vaguely described — 'Optional customization tool' doesn't convey concrete actions as clearly as it could. The extensive trigger phrase list, while thorough, borders on verbose and could be more concise while still being effective.

Suggestions

Replace the vague opening 'Optional customization tool for greenfield projects' with specific concrete actions, e.g., 'Configures project scaffolding, sets design tool API keys, and generates greenfield project configuration files.'

DimensionReasoningScore

Specificity

The description mentions some actions like 'customize Arness Spark configuration', 'add design tool integrations (Figma, Canva)', and 'review current greenfield settings', but the core capability ('Optional customization tool for greenfield projects') is vague. It doesn't list concrete specific actions like 'generates config files' or 'sets up project scaffolding'.

2 / 3

Completeness

The description clearly answers both 'what' (customize Arness Spark configuration, add design tool integrations, review greenfield settings) and 'when' (explicit trigger phrases listed, plus contextual triggers like wanting to customize configuration). The 'Use when' equivalent is thoroughly addressed via the extensive trigger list.

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would say, including variations like 'greenfield init', 'initialize greenfield', 'setup greenfield', 'Figma setup', 'Canva setup', 'add Figma', 'add Canva', and 'design tool setup'. This provides excellent coverage of natural user language.

3 / 3

Distinctiveness Conflict Risk

The description is highly distinctive with very specific trigger terms ('greenfield init', 'arn spark init', 'Figma setup', 'Canva setup') that are unlikely to conflict with other skills. It also explicitly notes that design tool integration is 'available only through this skill', further reducing conflict risk.

3 / 3

Total

11

/

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 skill is highly actionable and has excellent workflow clarity with proper sequencing, validation gates, and error recovery. However, it is significantly over-engineered for a configuration/init skill — the extreme verbosity (listing every field from sibling plugins, exhaustive checklists, 10-step next-steps pipeline) wastes substantial token budget. The content would benefit greatly from aggressive trimming and moving reference material (like the list of fields managed by other plugins) into separate files.

Suggestions

Move the exhaustive list of fields managed by other plugins (Plans directory, Specs directory, Report templates, etc. and all infra fields) into a reference file like `references/field-ownership.md` and replace with a single line: 'Preserve all fields not listed above — see field-ownership.md for the complete list.'

Compress the 10-step 'next steps' pipeline into a reference file or reduce to 3-4 key next actions, since Claude can look up skill descriptions when needed.

Consolidate the verification checklist in Step 5 — many items are redundant with the workflow steps and could be reduced to 'Verify all directories created and CLAUDE.md updated correctly.'

Trim the directory configuration prompts in Step 2 — the quoted user-facing messages and 'Used by' skill lists add significant tokens; a table format would be more efficient.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines with extensive detail that could be significantly compressed. It over-explains concepts like field preservation rules, lists every single field managed by other plugins (dev fields, infra fields), and repeats information across steps. The 10-step 'next steps' pipeline and exhaustive verification checklist add significant token cost.

1 / 3

Actionability

The skill provides highly concrete, executable guidance throughout: specific CLI commands (git rev-parse, gh auth status, gh label create, mkdir -p), exact config block format, specific MCP detection methods, precise label definitions with colors, and clear AskUserQuestion prompts with exact options. Every step is copy-paste actionable.

3 / 3

Workflow Clarity

The workflow is exceptionally well-sequenced with 5 clear steps, explicit validation checkpoints (auth checks that STOP init if unresolved), branching logic for existing vs fresh config, and a comprehensive verification checklist in Step 5. Error handling covers cancellation, write failures, and auth issues with specific recovery paths.

3 / 3

Progressive Disclosure

The skill references external files appropriately (platform-labels.md, bkt-setup.md, jira-mcp-setup.md, step-0-fast-path.md, agent-models presets) for detailed procedures, which is good progressive disclosure. However, the main SKILL.md itself is monolithic — the massive field preservation lists, the full 10-step pipeline recommendation, and the exhaustive verification checklist could be split into reference files. No bundle files were provided to verify reference accuracy.

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.