Content
76%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 well-structured, highly actionable command catalog: every script has exact copy-paste usage, prerequisites are documented, and prose stays lean. The main gap is safety workflow around destructive commands — git-abort is flagged destructive but has no verification step — which caps workflow clarity, and two sections carry dense inline detail that could move to reference files.
Suggestions
Add a verification step before destructive commands, e.g., under Undoing: 'Before `git abort`, run `git status` and confirm no untracked files are needed; aborting hard-resets and deletes untracked files.'
Deduplicate the cpanel section — the paragraph repeats the table's purpose cell verbatim; keep one.
Move the cpanel panel listing and the mux naming-rule details into reference files (e.g., references/cpanel.md, references/mux.md) to slim the main file below the simple-skill threshold.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean tables of script/usage/purpose with almost no explanation of concepts Claude already knows. Not a 5: the cpanel entry duplicates its purpose cell nearly verbatim in the paragraph below ("React/Bun TUI for everything in ~/.claude/ — browse, search, mine, and clean"), and the mux naming-rules paragraph is a dense wall of detail that could be tightened. Not a 3: there is no padding or tutorial-style over-explanation anywhere. | 4 / 5 |
Actionability | Every entry gives exact, copy-paste-ready usage with concrete arguments: `git save file1 file2 "message"`, `killport 3000`, `artisan migrate`, `cpx pint`, `mux tab <name> [path]`. Prerequisites are documented where they matter (git-issue's DOTFILES_GITHUB_USERNAME env var, cpanel's bun requirement, cpx's fallback chain). Not a 4: the commands cover the common cases with real argument examples, leaving no gaps an executor would hit. | 5 / 5 |
Workflow Clarity | Sections are clearly organized by task category, but the skill documents destructive operations — `git-abort` is explicitly labeled "Hard reset + clean untracked files (destructive)" — with only a warning label and no verification or safety checkpoint (e.g., confirm a clean tree or stash before aborting). Per the rubric, a destructive/batch skill without validation steps is capped at 3, which overrides the simple-skill exception. Not a 2: the structure is coherent and each script's effect is unambiguous; the cap alone prevents a 4. | 3 / 5 |
Progressive Disclosure | Well-organized sections (Committing, Undoing, History, Inspection, Syncing, Utilities, etc.) make this ~125-line catalog easy to navigate, and there are no bundle files to mismanage. Not a 5: the file exceeds the under-50-lines simple-skill exception and inlines reference-level detail — the cpanel panel-by-panel listing and the mux session-naming rules — that would fit naturally in reference files. Not a 3: nearly all content is appropriately placed and nothing is buried. | 4 / 5 |
Total | 16 / 20 Passed |