Content
77%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.
The skill body is a well-structured, highly actionable workflow with strong validation checkpoints and feedback loops appropriate to its destructive/batch file-rewriting scope. Its main weaknesses are an inlined long path enumeration in step 5 that could move to a reference and references that are not clearly signaled as navigation links.
Suggestions
Extract the step 5 install-mode template-location enumeration into a reference file (e.g. references/template-locations.md) and link to it, keeping step 5 to the resolution rule.
Add explicit "See [AGENTS.template.md](assets/AGENTS.template.md)" navigation signals for the bundled asset rather than only inline path mentions.
Tighten repeated lines such as "Use only project-local paths under the current working tree" (steps 3 and 4) into a single shared constraint in the Rules section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with actionable specifics (e.g. "git show HEAD:<path>", "git diff HEAD -- <skill-path>", "git checkout HEAD -- <skill-path>") and the <context> block covers flowai-specific behavior Claude would not know, with no padding about concepts Claude already knows. Matches the efficient-with-minor-trim anchor; not a 5 because the long install-mode path enumeration in step 5 and repeated "Use only project-local paths" lines could be tightened, not a 3 because it is not noticeably padded. | 4 / 5 |
Actionability | Provides concrete executable commands throughout ("git diff --no-index -- <template> <artifact>", "git show HEAD:<path>/SKILL.md", subagent delegation with explicit inputs) plus specific pre-filter logic. Matches mostly-executable with minor gaps; not a 5 because commands are woven into prose rather than copy-paste blocks and subagent interfaces/todo-write usage are assumed ("e.g., todo write"), not a 3 because guidance is concrete and complete rather than pseudocode. | 4 / 5 |
Workflow Clarity | The seven-step sequence has explicit validation checkpoints and feedback loops for destructive/batch file rewrites: "verify the diff actually replaces stale commands ... rerun the adapter or fix", frontmatter "byte-for-byte identical" checks, per-resource confirmation gates, "Revert rejected adaptations: git checkout HEAD", plus a dedicated <verification> checklist. Matches the clear-sequence-with-explicit-validation-and-feedback-loops anchor; not a 4 because validation is explicit rather than minor-gaps. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned (Overview, Rules, Instructions, Verification) and references one bundle file (assets/AGENTS.template.md) as a one-level runtime input, but step 5 inlines a ~20-line install-mode path enumeration that belongs in a separate reference, and references are not formatted as clearly signaled navigation links (no "See X for details"). Matches the some-structure-but-could-be-better-organized anchor; not a 4 because the inlined bulk and unclear reference signaling are real organization gaps, not a 2 because section structure is present and content is not an unstructured wall. | 3 / 5 |
Total | 16 / 20 Passed |