This skill should be used when the user says "scaffold", "arn scaffold", "set up the project", "create project", "initialize project", "bootstrap project", "create the skeleton", "install dependencies", "configure the project", or wants to create a working project skeleton from architecture decisions with installed dependencies, configured build tools, and a UI toolkit ready for development.
71
64%
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-spark/skills/arn-spark-scaffold/SKILL.mdQuality
Discovery
82%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 with an extensive list of natural phrases users would say, and it clearly addresses both what the skill does and when to use it. However, the 'what' portion could be more specific about the concrete actions performed (e.g., which build tools, what kind of UI toolkit setup), and some trigger terms like 'create project' or 'install dependencies' could cause conflicts with other skills. The description also uses a somewhat awkward structure by front-loading all trigger terms before explaining the capability.
Suggestions
Restructure to lead with specific capabilities (e.g., 'Creates project scaffolding with dependency installation, build tool configuration, and UI toolkit setup based on architecture decisions') before listing trigger terms.
Add more specificity about what distinguishes this from generic project creation—mention specific technologies, frameworks, or the 'arn' tool if relevant to reduce conflict risk with other project setup skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description mentions some actions like 'create a working project skeleton from architecture decisions with installed dependencies, configured build tools, and a UI toolkit ready for development,' but these are bundled into one clause rather than listing multiple distinct concrete actions (e.g., install dependencies, configure build tools, set up UI toolkit are mentioned but not as separate enumerated capabilities). | 2 / 3 |
Completeness | The description explicitly answers both 'what' (create a working project skeleton from architecture decisions with installed dependencies, configured build tools, and a UI toolkit) and 'when' (extensive list of trigger phrases plus a 'Use when' equivalent clause). The trigger guidance is very explicit. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'scaffold', 'set up the project', 'create project', 'initialize project', 'bootstrap project', 'create the skeleton', 'install dependencies', 'configure the project'. These are terms users would naturally say when wanting to scaffold a project. | 3 / 3 |
Distinctiveness Conflict Risk | While 'scaffold' and 'bootstrap project' are fairly distinctive, terms like 'create project', 'initialize project', and 'install dependencies' could overlap with other project setup or dependency management skills. The mention of 'architecture decisions' and 'UI toolkit' adds some specificity but the scope is still somewhat broad. | 2 / 3 |
Total | 10 / 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.
The skill has excellent workflow structure with clear sequencing, validation checkpoints, and error handling, but is significantly over-verbose. It scripts out conversational interactions in excessive detail (example option lists with pillar commentary, table formatting) that Claude could generate contextually. The actionability is moderate — it delegates to agents but doesn't show concrete invocation patterns.
Suggestions
Reduce verbosity by 50%+: remove scripted conversation examples (the full AskUserQuestion option lists with pillar commentary), inline table templates, and explanatory text about what pillars imply — Claude can generate contextually appropriate options and explanations.
Move the detailed UI toolkit options (CSS approaches, component libraries, icon libraries) and pillar alignment examples into a reference file like `references/ui-toolkit-options.md` to improve progressive disclosure.
Add concrete agent invocation syntax showing exactly how to call `arn-spark-scaffolder` and `arn-spark-tech-evaluator` with parameter examples rather than describing what to pass.
Condense the profile-aware recommendations paragraph into a brief decision table (experience level → recommendation style) rather than prose explanation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~250+ lines. It over-explains conversational flow, includes lengthy example option lists with pillar alignment commentary, and spells out details Claude could infer (e.g., what product pillars imply, how to present tables). Much of the AskUserQuestion scripting and pillar alignment commentary could be dramatically condensed. | 1 / 3 |
Actionability | The skill provides clear step-by-step guidance and specific agent invocation patterns, but lacks executable code examples. It delegates actual work to agents (arn-spark-scaffolder, arn-spark-tech-evaluator) without showing concrete invocation syntax or parameters. The checklist and template references are good but the actual commands/code are placeholders. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced across 6 steps with explicit validation (Step 4 checklist verification), error recovery (retry scaffolder up to 3 times), staging behavior for safe file merging, and clear prerequisites. The feedback loop for build failures and the checklist-based verification are well-designed. | 3 / 3 |
Progressive Disclosure | The skill references external files (scaffold-checklist.md, scaffold-summary-template.md) which is good progressive disclosure, but the main SKILL.md itself is a monolithic wall of text that inlines extensive option lists, pillar alignment examples, and conversational scripts that could be in reference files. No bundle files were provided to verify the referenced paths exist. | 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.