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.
74
68%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-sketch/SKILL.mdQuality
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 natural phrases that would activate the skill and clearly stating both what it does and when to use it. Its main weakness is that the 'what it does' portion is somewhat vague — it says it creates 'real, runnable artifacts' but doesn't specify the concrete actions or output types (e.g., generating component files, rendering HTML previews, producing terminal mockups). The long enumerated list of trigger phrases, while thorough, is somewhat verbose and could be more concise.
Suggestions
Add more specific concrete actions to the 'what' portion, e.g., 'Generates runnable UI component previews, terminal output mockups, and page layout sketches using the project's actual framework.'
| Dimension | Reasoning | Score |
|---|---|---|
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? React components? Terminal output previews?). | 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 list of trigger phrases plus the contextual condition 'wants to see a working interface preview of a feature before committing to full implementation'). The 'Use when' guidance is thoroughly explicit. | 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', etc. This provides excellent coverage of natural language variations. | 3 / 3 |
Distinctiveness Conflict Risk | The skill has a very clear niche — previewing/sketching UI and CLI interfaces before full implementation, using a dedicated sketch namespace. The specific trigger terms like 'sketch', 'arness code sketch', and the concept of previewing before committing to implementation make it highly distinctive and unlikely to conflict with general coding 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, and error recovery paths. However, it is significantly over-verbose, explaining integration points, pipeline positioning, and threshold rules at length that could be condensed or moved to reference files. The actionability is moderate — while the workflow is clear, actual executable guidance is largely delegated to external references and a builder agent that aren't provided for evaluation.
Suggestions
Cut the content by 40-50%: remove the Pipeline Position ASCII diagram, condense Integration Points into a brief list of skill names, and trim threshold examples to just the paradigm-agnostic principle.
Move the detailed threshold rules (Step 3) and integration points section into a reference file, keeping only a one-line summary in the main skill body.
Add at least one concrete, executable example of what a sketch artifact looks like (e.g., a minimal web sketch file) rather than only showing the manifest JSON schema.
Since bundle files are referenced extensively (sketch-setup.md, paradigm-*.md, iteration-guide.md), ensure these are provided in the bundle so the skill body can be leaner and delegate appropriately.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~300+ lines. It over-explains pipeline positioning, integration points, and context that Claude could infer. The threshold rules, error handling, and integration sections contain significant redundancy and explanatory padding. Many sections describe what other skills do rather than focusing on actionable instructions for this skill. | 1 / 3 |
Actionability | The workflow steps are concrete and sequenced, with specific file paths, JSON schemas, and clear agent spawning instructions. However, much of the actual execution is delegated to external reference files (paradigm references, iteration guide, sketch-setup.md) and a builder agent, so the skill itself contains limited executable guidance. The manifest JSON schema is a good concrete artifact, but code examples for actual sketch creation are absent. | 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 a clear finish state with three options. The pipeline position diagram and error handling section provide good recovery paths. | 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 no bundle files were provided to verify these exist or contain useful content. The main SKILL.md itself is monolithic — the integration points, pipeline position diagram, and threshold rules could be split into references. The inline content is too long for what should be an overview. | 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
1fe948f
Table of Contents
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.