Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, actionable skill that provides clear workflows for auditing skills using Tessl and manual review. Its strengths are concrete CLI commands, explicit sequencing with validation loops, and good separation of concerns (handoffs section). Minor weaknesses include some slightly verbose sections and uncertainty about whether referenced bundle files actually exist to support the progressive disclosure claims.
Suggestions
Trim the 'Principles' section—items like 'Evidence beats hunches' and 'Audit only the requested scope' are general advice Claude can infer; keep only principles that encode non-obvious project-specific decisions.
Verify and include the referenced bundle files (references/scorecard.md, references/best-practices.md) so the progressive disclosure structure is complete and reviewable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining concepts Claude already knows, but some sections could be tightened—e.g., the 'Principles' and 'Handoffs' sections add moderate value but include some obvious guidance ('Evidence beats hunches'). The Tessl introduction paragraph is useful context but slightly verbose. | 2 / 3 |
Actionability | The skill provides concrete CLI commands (`npx tessl skill review --json skills/<name>`), specific file paths to check, concrete examples of weak vs. stronger metadata, and explicit failure signs to look for. The workflow steps are specific and executable. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced (steps 1-6) with explicit validation checkpoints—run Tessl first to get a baseline score, audit multiple dimensions, then synthesize changes and rerun Tessl to verify improvement. The 'Quick experiential feedback mode' provides an alternative path with clear criteria for when to use it. The output section defines what 'done' looks like. | 3 / 3 |
Progressive Disclosure | The skill references `references/scorecard.md` and `references/best-practices.md` appropriately, and the References section is well-organized. However, no bundle files were provided to verify these references exist, and some content in the workflow steps (like the audit dimensions in steps 2-5) could potentially be offloaded to the referenced scorecard rather than being inline. The structure is reasonable but the split between inline and referenced content isn't fully optimized. | 2 / 3 |
Total | 10 / 12 Passed |