CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-sketch

This skill should be used when the user says "sketch", "arness code sketch", "preview this", "show me what this looks like", "UI preview", "sketch the feature", "visual preview", "sketch this page", "what will this look like", "mock this up", "prototype this UI", "preview the design", "sketch the UI", "preview this command", "show me what the output looks like", "sketch the TUI", "what will the CLI look like", "mock up the terminal output", or wants to see a working interface preview of a feature in the context of their existing application before committing to full implementation. Creates real, runnable artifacts using the project's actual framework and conventions, rendered in a dedicated sketch namespace.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

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

A well-engineered orchestration skill: concrete prompts, templates, and a manifest schema make every step executable, and the workflow has explicit checkpoints and error-recovery loops. The only deductions are minor — a redundant pipeline diagram duplicating the workflow, and paradigm-specific detail inlined in the main body that belongs in the (otherwise excellent) reference files.

Suggestions

Drop or shrink the ASCII 'Pipeline Position' diagram, which restates the Workflow section's sequence, and remove the duplicated sketch-strategy halt message from Error Handling (it already appears in Prerequisites).

Move the per-paradigm threshold lists (Step 3) and the full manifest schema into the paradigm reference files, keeping only the decision rule and a minimal manifest skeleton in the main body.

DimensionReasoningScore

Conciseness

The body is dense and procedural with no explanations of concepts Claude already knows, but the ASCII pipeline diagram restates the Workflow section and the 'No sketch strategy found' halt message is duplicated between Prerequisites and Error Handling. Minor trimmable redundancy places it at anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Fully executable guidance: a copy-paste-ready sketch-manifest.json schema, a verbatim builder-agent context template with delimiters, exact user-facing prompts ('What would you like to change?'), and concrete per-paradigm threshold rules with examples. Specific examples cover the common cases, matching anchor 5 for an instruction-orchestration skill.

5 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation checkpoints (verify the output directory in Step 6, threshold decision in Step 3, user confirmation of component mapping before promote/keep) and feedback loops (re-spawn the builder with error context, iterate-until-satisfied loop). Destructive cleanup requires user confirmation, so no cap applies — matches anchor 5.

5 / 5

Progressive Disclosure

References are well-signaled ('> Read ...' directives at exact steps) and verified one level deep — sketch-setup.md, the five paradigm files, and iteration-guide.md all exist and none nest further. Minor gap: paradigm-specific threshold lists (Step 3) and the full manifest schema are inlined in the main body where they could live in the paradigm references, matching anchor 4's 'minor organization gaps' rather than anchor 5's fully appropriate split.

4 / 5

Total

18

/

20

Passed

Description

86%Weight 40%Scale 1-5

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 answers both 'what' and 'when' explicitly with an unusually rich set of natural trigger phrases, and it carves out a fairly distinct niche. Its main weakness is a narrow 'what' — only artifact creation is described, not the iterate/promote/clean-up lifecycle the skill actually covers.

Suggestions

Expand the 'what' clause to enumerate the full capability set concisely, e.g. 'Creates real, runnable artifacts using the project's actual framework and conventions in a dedicated sketch namespace; iterate on feedback, then promote, keep, or clean up sketches.'

Trim redundant trigger phrases that add little discrimination (e.g. keep one of 'preview the design' / 'UI preview' / 'visual preview') to reduce generic overlap risk with other preview skills.

DimensionReasoningScore

Specificity

The 'what' is a single concrete action — 'Creates real, runnable artifacts using the project's actual framework and conventions, rendered in a dedicated sketch namespace' — which names the domain and one action but omits iteration, promotion, and cleanup. Matches anchor 3 (1-2 concrete actions, not comprehensive); anchor 4 requires several specific actions listed.

3 / 5

Completeness

Explicitly answers 'when' ('This skill should be used when the user says... or wants to see a working interface preview... before committing to full implementation') with concrete trigger phrases, and 'what' ('Creates real, runnable artifacts using the project's actual framework and conventions'). Both are explicit, matching anchor 5.

5 / 5

Trigger Term Quality

Roughly 18 natural trigger phrases with synonym coverage ('sketch', 'preview this', 'mock this up', 'prototype this UI', 'sketch the TUI', 'what will the CLI look like', 'mock up the terminal output') — users would naturally say these. Comprehensive coverage; no common variation is missing, so anchor 4 does not fit better.

5 / 5

Distinctiveness Conflict Risk

A clear niche (pre-implementation interface preview in a dedicated sketch namespace) with distinctive phrases, but generic triggers like 'preview this' and 'show me what this looks like' create minor overlap risk with other preview/prototype-type skills. Mostly distinct with minor overlap risk, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-sketch/SKILL.md

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.