Content
93%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 exemplary LLM-first skill body: compact tables for branching, a tight five-step workflow with fallbacks, a concrete output contract, and a verified one-level-deep local reference. The only real gap is that the apply-mode feedback loop (rerun/validate after edits) is mentioned but not spelled out.
Suggestions
Make the apply-mode validation loop explicit, e.g., 'After edits, rerun the audit on each changed skill and re-check issues until none remain' instead of 'then rerun or request gentle-ai skill-registry refresh'.
Clarify what 'rerun' refers to in step 5 (rerun this audit) so the checkpoint is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean runtime instructions throughout (e.g., 'Default to audit-only', 'Never delete meaningful content silently; move long explanation, examples, templates, or schemas into local references/'), with zero tutorial background and every token earning its place, matching the anchor-5 example of assuming Claude's competence. | 5 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: exact file paths with fallback chains ('Read docs/skill-style-guide.md; if unavailable, read references/skill-style-guide.md; if neither exists, enforce the core LLM-first structure'), enumerated audit criteria, and a concrete command ('gentle-ai skill-registry refresh'); the Decision Gates table and Output Contract give unambiguous instructions for every fork. | 5 / 5 |
Workflow Clarity | The five Execution Steps are clearly sequenced with fallbacks and an output contract, and apply mode ends with a rerun/registry-refresh checkpoint; however, for a batch multi-file editing operation the post-apply validation is terse and partly implicit ('then rerun or request gentle-ai skill-registry refresh' does not specify re-running the audit or a fix-and-revalidate loop), fitting anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: references/skill-style-guide.md exists, is clearly signaled both in Execution Steps (as the documented fallback) and in the References section with per-file purpose annotations, and is exactly one level deep; the ~45-line body is well organized into the required section order with no content that belongs in a separate file inlined, and docs/skill-style-guide.md / .atl/skill-registry.md are repo-environment files with explicit fallback handling rather than nested references. | 5 / 5 |
Total | 19 / 20 Passed |