CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-multi-repo-swarm

Agent skill for multi-repo-swarm - invoke with $agent-multi-repo-swarm

49

4.34x
Quality

26%

Does it follow best practices?

Impact

87%

4.34x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-multi-repo-swarm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

7%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a placeholder: it restates the skill name and an invocation command instead of describing capabilities or when to use the skill. It fails on all fronts — no concrete actions, no natural trigger terms, no use-when guidance — which would make it nearly impossible for a user or Claude to select this skill correctly. Notably, the more descriptive text ("Cross-repository swarm orchestration for organization-wide automation...") is buried in a stray second frontmatter block in the body rather than in the actual description field.

Suggestions

Rewrite the description to state concrete capabilities in third person, e.g. "Coordinates AI agent swarms across multiple GitHub repositories: discovers related repos, executes synchronized dependency/refactoring/security changes, and creates linked PRs with tracking issues."

Add an explicit trigger clause: "Use when the user wants to apply the same change across many repositories in an organization, coordinate work between repos, or manage cross-repo dependencies."

Remove the "$agent-multi-repo-swarm" invocation syntax from the description — it occupies the entire description budget without telling Claude or the user anything about the skill's purpose.

Move the descriptive line currently stranded in the body's second frontmatter block ("Cross-repository swarm orchestration for organization-wide automation...") into the real frontmatter description and delete the duplicate nested frontmatter block.

DimensionReasoningScore

Specificity

The description is only "Agent skill for multi-repo-swarm - invoke with $agent-multi-repo-swarm" — it names the skill but lists zero concrete actions (no orchestration, coordination, or repo operations are mentioned), matching the "entirely vague; no concrete actions" anchor. It is not a 2 because it doesn't even name a domain action like "Processes PDF files"; it purely restates the skill name with an invocation instruction.

1 / 5

Completeness

There is no answer to "what does this do" beyond the tautological "Agent skill for multi-repo-swarm", and no "when to use it" clause at all — both are missing or extremely vague, matching anchor 1. It does not reach anchor 2 because even a vague standalone 'what' or 'when' is absent; the second sentence is pure invocation mechanics.

1 / 5

Trigger Term Quality

The only terms are the skill's own name ("multi-repo-swarm") and the literal invocation token "$agent-multi-repo-swarm", which no user would naturally say when they need this skill. This matches the "no natural keywords; only technical jargon" anchor rather than anchor 2, which expects at least one or two generic but real keywords like "works with files".

1 / 5

Distinctiveness Conflict Risk

Naming the niche (multi-repo swarm orchestration) gives it some distinctiveness from generic skills, but the description gives no distinguishing trigger phrases, so it could overlap with other agent/swarm/automation skills. This sits between anchor 2 (very broad) and anchor 4 (mostly distinct); the specific domain name lifts it to 3 rather than clearly separating it.

3 / 5

Total

6

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (558 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
ruvnet/ruflo
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.