Content
86%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 tight, well-structured instruction skill: lean prose, a concrete candidate checklist and routing table, explicit human-approval gates with validation/re-run steps, and exactly one verified, clearly signaled reference file carrying the evaluation detail. The only real gap is the absence of a worked example or concrete commands for the evidence-mining step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~50-line body is lean and directive throughout — "Never auto-apply a skill change", "Keep rejected ideas in the session rather than building a permanent backlog of noise" — with zero padding and no explanation of concepts Claude already knows. Every sentence adds a constraint or instruction, matching anchor 5. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is highly actionable: enumerated evidence sources, a five-field per-candidate record checklist, an explicit routing table (tooling / .factory/CONTEXT.md / .factory/FACTORY.json / narrowest existing skill / new skill), and a copy-paste Output template. It stays at anchor 4 because there are no concrete commands or a worked example showing how to mine tickets or fill in the template. | 4 / 5 |
Workflow Clarity | The select → derive → evaluate → ask-user → apply sequence is unambiguous with real checkpoints: "Only after explicit approval may the relevant skill-authoring workflow edit the skill repository", "Validate changed skills and rerun affected evaluations", and the accept/revise/reject decision loop. It falls short of anchor 5 because the steps are prose sections rather than an explicitly numbered workflow, and key validation detail is delegated to the reference file instead of inline feedback loops. | 4 / 5 |
Progressive Disclosure | The body is a concise overview that appropriately splits evaluation detail into a single well-signaled, one-level-deep reference ("Read [references/evaluation.md](references/evaluation.md)"), which exists in the bundle and points to no further nested files. Navigation is trivial and nothing that belongs in a separate file is inlined, matching anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |