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.
An exceptionally information-dense maintenance skill that assumes competence and provides executable commands with genuine validation checkpoints (check-sqlean-pin, the full-chain warning, the wheelhouse gate). Its weaknesses are structural rather than substantive: embedded version pins, recovery guidance scattered into Gotchas, and a long wheels section that could be offloaded to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense with non-obvious, repo-specific knowledge (the pin-partner table, "the URL embeds both, so a mismatch 404s", "build_ext keys on source mtime") with no explanations of concepts Claude already knows. Not a 5: time-sensitive version numbers ("pinned at 3.50.4", "SQLite removed it in 3.51.0", "sqlean >= 0.28") are embedded outside any old-patterns section, and a few dense passages could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: "./scripts/check-upstream.sh sqlite --apply", "git ls-remote <repo> 'refs/tags/<version>*'" with peeled-tag guidance, "make prepare-src download-sqlite download-sqlean", "python setup.py build_ext -i", "python -m tests", and "touch src/sqlean.c". Placeholders like <repo> are justified parameterization, not pseudocode. | 5 / 5 |
Workflow Clarity | Clear sectioned sequence (With the script → By hand → Verify) with real checkpoints: the "always the full chain" double-append warning, check-sqlean-pin as an automatic prerequisite, and SHA3-256 confirmation before recording the pin. Not a 5 because error-recovery guidance ("Regenerate it against the new sqlean sources") lives in the Gotchas list rather than inline feedback loops, and steps are not explicitly ordered. | 4 / 5 |
Progressive Disclosure | Single-file skill with no bundle files and well-organized, clearly headed sections. Not a 5: at ~140 lines, content such as the ~40-line "Wheels and publishing" section could be split into a one-level-deep reference file; not a 3 because the structure is clean and content is appropriately grouped for a single file. | 4 / 5 |
Total | 17 / 20 Passed |