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
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.
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'.
| 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, 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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
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 | |
b9084b6
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.