Content
46%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 body presents a broad feature catalog with genuine gh-CLI-driven workflows and a useful dependency-update pattern that includes a test-before-PR checkpoint, but it is undermined by systematic path corruption ("$" where "/" belongs) that makes most code non-executable, a stray duplicate frontmatter block after the real frontmatter, dead links to nonexistent bundle files, and no overall workflow sequencing the many subcommands. It reads as a generated API surface dump rather than a curated operational guide. It is above the failing anchors because the core orchestration patterns and gh CLI usage are concrete and roughly sequenced.
Suggestions
Fix the corrupted path separators throughout the code blocks ("gh api repos$org/$repo", ".swarm$multi-repo.yml", "github.com$my-org$frontend", "https:/$swarm-coordinator.example.com") and define variables like $tmp and $org before use, so the examples are actually copy-paste executable.
Remove the stray second frontmatter block immediately after the real frontmatter (name/description/tools/hooks), which is invalid content and conflicts with the actual skill metadata; if the tool allowlist is intended, merge it into the real frontmatter.
Either create the referenced swarm-pr.md and project-board-sync.md files under references/ or delete the dead "See also" links, and split the config, communication, and use-case sections into reference files so SKILL.md stays a concise overview with one-level-deep pointers.
Add a top-level "How to use this skill" workflow (discover repos → init swarm → execute task → verify → create/link PRs) with explicit validation checkpoints for every batch PR-creation flow, not just the dependency-update one.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command listings with little padded prose, so it avoids the classic over-explanation failure, but it is noticeably loose: ~520 lines of enumerated subcommands (dashboards, Kafka config, GraphQL federation, resource pooling) where each `npx ruv-swarm github <subcommand> --flags` block adds flags without explaining when or why to use it. This matches anchor 3 ("mostly efficient but could be tightened") better than anchor 2, since there is little concept-explanation Claude already knows — the waste is in coverage breadth, not explanatory padding. | 3 / 5 |
Actionability | There is real, concrete guidance (gh CLI loops, PR creation, tracking issues), but the snippets are not executable as written: path separators are corrupted throughout — "gh api repos$org/$repo", ".swarm$multi-repo.yml", "github.com$my-org$frontend", "redis:/$shared-memory", "https:/$swarm-coordinator.example.com" — and undefined variables like $tmp are used. This matches anchor 3 ("concrete guidance but incomplete; missing key details") rather than anchor 2, because most blocks are genuine commands with specific flags, not high-level hints. | 3 / 5 |
Workflow Clarity | The two main workflows (synchronized operations, dependency management) do have a rough sequence — clone, execute, test, branch, PR — and the dependency workflow includes a validation checkpoint (npm test before PR, failure comment on the tracking issue). However, other batch workflows (Synchronized Operations, monorepo migration) create PRs across many repos with no verification, and there is no top-level workflow telling Claude how to sequence discovery → init → execute → monitor. Per the rubric cap for batch operations without validation, this cannot exceed 3. | 3 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/ directories), yet the body ends with "See also: [swarm-pr.md](./swarm-pr.md), [project-board-sync.md](./project-board-sync.md)" — links to files that are not present. Meanwhile ~480 lines of material that clearly belongs in separate files (config examples, communication strategies, GraphQL/Kafka configs, use cases, troubleshooting) are inlined in SKILL.md. This matches anchor 2 ("content that clearly belongs in separate files is inlined") rather than anchor 3, because the only references offered are broken and the body is a monolithic feature dump. | 2 / 5 |
Total | 11 / 20 Passed |