CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

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-code/skills/arn-code-sketch/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 natural phrases users would say and clearly answering both what the skill does and when to use it. Its main weakness is that the 'what it does' portion is somewhat vague — 'creates real, runnable artifacts' could be more specific about the types of outputs (e.g., HTML mockups, component previews, terminal output simulations). The extensive trigger list, while thorough, borders on verbose and could be more concisely organized.

Suggestions

Add more specific concrete actions to the capability description, e.g., 'Generates runnable HTML/component mockups, terminal output previews, and UI prototypes' instead of the generic 'creates real, runnable artifacts'.

DimensionReasoningScore

Specificity

The description mentions creating 'real, runnable artifacts using the project's actual framework and conventions, rendered in a dedicated sketch namespace,' which names the domain and a key action, but doesn't list multiple specific concrete actions beyond 'creates real, runnable artifacts.' It's somewhat specific but not comprehensive about what exactly it does (e.g., generates HTML mockups, renders component previews, etc.).

2 / 3

Completeness

The description explicitly answers both 'what' (creates real, runnable artifacts using the project's actual framework and conventions in a sketch namespace) and 'when' (extensive 'Use when' trigger list plus the broader condition of wanting to preview a feature before committing to full implementation).

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would actually say: 'sketch', 'preview this', 'show me what this looks like', 'UI preview', 'mock this up', 'prototype this UI', 'sketch the TUI', 'what will the CLI look like', 'mock up the terminal output'. These cover a wide range of natural variations including UI, TUI, and CLI contexts.

3 / 3

Distinctiveness Conflict Risk

The skill has a very clear niche — previewing/sketching UI/TUI/CLI features as runnable artifacts in a sketch namespace before full implementation. The specific trigger terms like 'sketch', 'arness code sketch', and the concept of a 'sketch namespace' make it highly distinctive and unlikely to conflict with general code generation or design 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 skill has excellent workflow clarity with well-defined steps, decision branches, error handling, and feedback loops. However, it is significantly over-verbose for a skill file — the pipeline position diagram, integration points, detailed threshold examples, and inline JSON schema consume substantial tokens without proportional value. The actual executable guidance is largely delegated to external reference files that aren't bundled, making the skill more of an orchestration document than a self-contained actionable guide.

Suggestions

Reduce token cost by moving the Pipeline Position ASCII diagram, Integration Points section, and detailed threshold examples to a reference file — the main skill should focus on the workflow steps themselves.

Move the full sketch-manifest.json schema to a reference file and keep only a brief mention in the main skill (e.g., 'Create sketch-manifest.json per the schema in references/manifest-schema.md').

Trim the Integration Points section to a brief table or bullet list — the detailed descriptions of how other skills invoke this one are informational context that Claude doesn't need inline during execution.

Include at least one concrete, end-to-end example showing the builder agent invocation with actual Task tool parameters, rather than only describing the context template abstractly.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines. It over-explains pipeline positioning, integration points, and concepts that Claude can infer. The ASCII pipeline diagram, detailed manifest JSON schema, and extensive threshold examples add significant token cost. Many sections (e.g., Integration Points, Pipeline Position) are informational rather than actionable and could be drastically condensed or moved to reference files.

1 / 3

Actionability

The workflow steps are concrete and sequenced with specific file paths, tool invocations (Task tool for builder agent), and manifest schemas. However, much of the actual implementation is delegated to external reference files (paradigm references, iteration guide, sketch-setup.md) that aren't provided, and the skill itself contains no executable code examples — just a JSON schema template and conceptual instructions.

2 / 3

Workflow Clarity

The 8-step workflow is clearly sequenced with explicit decision points (threshold assessment with skip/proceed branches), validation checkpoints (verify sketch files created, error handling for build failures), feedback loops (Step 7 iterate cycle), and clear finish states (promote/keep/clean up). Error handling covers multiple failure modes with specific recovery actions.

3 / 3

Progressive Disclosure

The skill references multiple external files (sketch-setup.md, paradigm-*.md, iteration-guide.md) which is good progressive disclosure in principle, but none of these bundle files were provided for evaluation. The main SKILL.md itself is monolithic — the Pipeline Position diagram, Integration Points section, and detailed threshold rules could be moved to reference files. The inline manifest schema is lengthy and could be referenced instead.

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.