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.

80

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

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.

The 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 core capability description is somewhat vague — 'Optional customization tool for greenfield projects' doesn't clearly convey what concrete actions the skill performs beyond configuration and design tool integration. The extensive trigger phrase list, while helpful for selection, makes the description verbose.

Suggestions

Replace the vague opening 'Optional customization tool for greenfield projects' with specific concrete actions, e.g., 'Configures project scaffolding settings, sets API keys for design tools, and customizes code generation preferences for Arness Spark greenfield projects.'

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 comprehensively — what does customization actually entail?

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 'wants to customize Arness Spark configuration'). The 'Use when' equivalent is thoroughly addressed via the enumerated trigger phrases.

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would say, such as 'greenfield init', 'setup greenfield', 'Figma setup', 'Canva setup', 'add Figma', 'add Canva', 'design tool setup', covering many variations and synonyms. This is thorough coverage of natural user language.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to 'Arness Spark' greenfield initialization and configuration, with very distinct trigger terms like 'greenfield init', 'arn spark init', and design tool setup (Figma/Canva). It explicitly notes that design tool integration is only available 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 with excellent workflow clarity, providing concrete commands, precise branching logic, and a thorough verification checklist with error handling. However, it is significantly over-long and verbose — it inlines content that should be in reference files (label tables, other-plugin field lists, next-steps pipeline) and explains context that Claude doesn't need. The progressive disclosure is adequate but could be improved by moving more detail into supporting files.

Suggestions

Move the exhaustive list of fields managed by other plugins (dev fields, infra fields in Step 4 Rules) into a reference file like `references/field-ownership.md` and reference it with a single line.

Move the 10-step 'recommended exploration pipeline' in Step 5 into a reference file — it's static content that doesn't need to be in the main workflow.

Move the GitHub labels table into the already-referenced `platform-labels.md` file and just say 'Create the 7 Arness labels listed in platform-labels.md using gh label create'.

Trim explanatory phrases like 'This ensures portability across machines' and 'the command is idempotent — it will skip labels that already exist' — Claude knows these concepts.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines. It over-explains many concepts Claude can infer (e.g., what directories are for, what each skill does), lists exhaustive field preservation rules for other plugins, and includes lengthy inline tables and detection flows that could be in reference files. The enumeration of all fields managed by other plugins (dev fields, infra fields) is particularly wasteful.

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 format with field names and values, precise detection logic, and clear decision trees with specific tool invocations (AskUserQuestion with exact options).

3 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit validation and verification (Step 5 checklist), error handling section covers failure modes, feedback loops exist (auth fails → stop → user fixes → re-run), and branching logic (existing config vs fresh init, github vs bitbucket) is well-defined with clear decision points.

3 / 3

Progressive Disclosure

The skill references external files appropriately (platform-labels.md, bkt-setup.md, jira-mcp-setup.md) for detailed setup instructions, but the main body is monolithic with too much inline content. The exhaustive list of fields from other plugins, the full label table, and the 10-step next-steps pipeline could be in reference files. The bundle files were not provided, so referenced paths cannot be verified.

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.