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 well-structured workflow skill: highly actionable templates, tables, and validation specs arranged in a clear seven-step sequence with an external reviewer checkpoint and sensible stopping rules. The main improvable points are the implicit refinement loop (feedback handling is not spelled out despite MAX_REFINEMENT_ROUNDS) and the cluttered reviewer-routing blockquote that could be consolidated or moved.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is overwhelmingly lean, imperative guidance — tables for claim categories and figure plans, an exact problem-statement format, a concrete dependency-map sketch, and a full output template — with no explanations of concepts Claude already knows. Minor trimmable instances exist: the 9-line reviewer-routing blockquote at the top, the nested "Resolve this reviewer slot first" blockquote in Step 6 that repeats it, and the dangling "Adapted from the refinement pattern in /research-refine" line. This matches anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed") rather than anchor 5, and is above anchor 3 because the unnecessary material is a small fraction of otherwise tight content. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: an exact problem-statement template ("The technical problem to be solved is how to [specific technical objective] given [specific technical constraint]"), a concrete novelty test for core features ("if you remove this feature, the invention is no longer novel"), two lookup tables, a worked claim-hierarchy example, a complete copy-paste reviewer spawn_agent spec with model/effort/message, and a complete output markdown template. This matches anchor 5 ("Fully executable; copy-paste ready... specific examples cover the common cases"); the scoring note for instruction-only skills confirms absence of runnable code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | Seven clearly sequenced steps end in an explicit validation checkpoint (Step 6 fresh-agent review with five concrete assessment questions) plus a stop-and-ask rule if delegation is unavailable — matching "clear sequence with most checkpoints present". It falls short of anchor 5 because the feedback loop is not spelled out: MAX_REFINEMENT_ROUNDS = 3 is declared but the revise-then-revalidate iteration (how reviewer findings are applied and when rounds stop) is left implicit. There are no destructive or batch operations, so the workflow-clarity cap of 3 does not apply. | 4 / 5 |
Progressive Disclosure | Structure is good: the body is sectioned into Constants/Inputs/Workflow/Key Rules, and external detail is pushed to clearly signaled one-level-deep references — "Load ../shared-references/patent-writing-principles.md for the Problem-Solution-Advantage framework" and the reviewer-backends pointer for the reviewer slot. Minor gaps keep it at anchor 4 rather than 5: the reviewer-backends reference is buried inside a dense blockquote at the top rather than a clean navigation section, and no bundle-local references/ or scripts/ files exist to carry the tables or spawn spec. It is well above anchor 3 since references are present, signaled, and only one level deep. | 4 / 5 |
Total | 17 / 20 Passed |