Content
78%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 skill body: an explicit 8-step procedure with exact failure messages and validation checks, lean non-pedantic prose, and clean one-level reference files verified to exist. The only deductions are minor: duplicated rules between Principles and Anti-Patterns, an inline bash snippet referencing undefined variables with an inconsistent path, and no recovery step when the parse check fails.
Suggestions
Define '$dir' and '$file' in the inline bash snippet (or remove the duplicated snippet and rely solely on storage-and-schema.md) and use the same '${PRAXIS_DIR}/thinking/bridges' path in both places so the snippet is copy-paste ready.
Add an explicit recovery step after the yq parse check, e.g. 'If parsing fails, re-quote the description/context and rewrite the file before answering', to close the workflow's only feedback-loop gap.
Trim the overlap between Principles and Anti-Patterns — 'Store the user's words, not yours' and 'Choose an honest default over a confident guess' restate the NEVER-reformulate and NEVER-guess-a-rare-archetype bullets; keep one formulation of each rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes Claude's competence, and explains no general concepts, but there is minor duplication that could be trimmed: 'Store the user's words, not yours' restates the 'NEVER reformulate the user's description' anti-pattern, 'Choose an honest default over a confident guess' restates the 'NEVER guess a rare archetype' bullet, and the inline sequence-number bash duplicates the snippet in storage-and-schema.md. This is the efficient-with-minor-trimming tier, not the every-token-earns-its-place tier. | 4 / 5 |
Actionability | Guidance is mostly executable: exact input grammar ('/bridge <src> → <tgt>: <desc>' with '[type]'), exact response template, ordered keyword lists for strength detection, and a bash snippet for the sequence number and parse check. Minor gaps keep it below fully copy-paste ready: the inline bash uses '$dir' and '$file' without defining them in the body, and it hardcodes './thinking/bridges/' while the storage reference uses '${PRAXIS_DIR}/thinking/bridges'. | 4 / 5 |
Workflow Clarity | The 8-step procedure is clearly sequenced with most checkpoints present: stop-on-missing-config with an exact warning message, write-nothing-on-unresolved-alias, duplicate check before writing, collision-safe numbering (highest number plus one), and a post-write yq parse confirmation. It falls short of the top anchor because the parse check has no explicit recovery path (no 'if parse fails, fix and re-write' step), leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview (principles, when/when not, procedure, anti-patterns) and the four detail files — archetype detection, storage/schema, list/map/stats, worked examples — all exist, are one level deep with no nested references, and are well signaled both in the References section with descriptions and inline at the point of use (steps 4, 7, and Commands). Content is appropriately split and easy to navigate. | 5 / 5 |
Total | 17 / 20 Passed |