Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, actionable bootstrap skill: fully executable commands, an explicit step sequence, verification, and success criteria. It loses points only on minor redundancy, absent error-recovery guidance for install/init failures, and a couple of sections that could be consolidated.
Suggestions
Remove the redundant trailing 'Note' at the end, which repeats the 'After successful setup, this skill is no longer needed. The user should use /start' statement from the Success Criteria section.
Add brief error-recovery guidance for the two most likely failure points: 'trellis --version' failing after npm install (e.g., PATH/restart terminal) and 'trellis init' errors (e.g., not in project root, rerun in the correct directory).
Consider merging the 'What is Trellis?' bullets into the opening paragraph to tighten the overview without losing the structure/memory/automation context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — executable commands, a compact directory tree, and a command table with almost no filler — but includes minor redundancy: the closing note 'Once Trellis is initialized, use the built-in /start command instead of this skill' repeats the 'After successful setup, this skill is no longer needed. The user should use /start' line above it, and the 'What is Trellis?' bullets could be trimmed. | 4 / 5 |
Actionability | Every step is copy-paste ready: 'node --version', 'npm install -g @mindfoldhq/trellis@latest', 'trellis --version', 'trellis init -u <developer-name>', and verification 'ls -la .trellis/' commands, plus a concrete example question for the developer-name step. Commands are executable as written and cover the common path end to end. | 5 / 5 |
Workflow Clarity | Clear sequence (prerequisites → install → get name → init → verify) with a verification step and a Success Criteria checklist, plus one error path ('If Node.js is not installed, ask the user to install it first'). Not 5 because there are no feedback loops for other failure modes (e.g., 'trellis --version' failing after install, or 'trellis init' erroring), and not 3 because checkpoints are explicit and the operation is non-destructive. | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed at this size; content is organized into well-labeled sections with headers, a table, and a checklist. It sits just above the <50-line threshold where clean sections alone earn a 5, and the ~113-line body includes borderline-inline detail (the Quick Reference command table and directory tree), so 'good structure with minor organization gaps' is the best fit. | 4 / 5 |
Total | 17 / 20 Passed |