CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-swarm-memory-manager

Agent skill for swarm-memory-manager - invoke with $agent-swarm-memory-manager

57

2.25x
Quality

36%

Does it follow best practices?

Impact

90%

2.25x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-swarm-memory-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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 reads like a persona system prompt dumped into a skill file: it identifies rich responsibilities (multi-level caching, CRDT conflict resolution, replication) but backs almost none of them with executable code, ordered steps, or validation loops. Structural defects — a duplicated frontmatter block, contradictory timing mandates, undefined helper functions — mean Claude could store the sample keys but could not actually run the described protocol.

Suggestions

Convert the MCP calls to real executable form (e.g., actual tool-call syntax or a runnable script) and remove undefined references like resolveConflict and expectedVersion, or explicitly justify them as interfaces.

Reorder the content into an actual lifecycle workflow (initialize → read/write → sync → monitor → recover) with validation checkpoints after write/sync steps, since these are batch operations that currently have no verify/retry loop.

Resolve the contradiction between 'EVERY 60 SECONDS write metrics' and 'Write memory state every 30 seconds' into one cadence rule, and delete the duplicate frontmatter block from the body.

DimensionReasoningScore

Conciseness

The body is mostly dense directives rather than concept explanations, but there is clear padding: persona fluff ('You are the Swarm Memory Manager, the distributed consciousness keeper of the hive mind'), redundant coverage of caching (section 2 plus 'Memory Patterns'), conflict resolution appearing in both 'Synchronization Protocol' and its own section, and contradictory cadence rules ('EVERY 60 SECONDS write metrics' vs 'Write memory state every 30 seconds'). Mostly efficient but could be tightened — anchor 3.

3 / 5

Actionability

Keys, namespaces, and payload shapes are concrete (e.g., 'swarm$shared$memory-index', 'coordination'), but none of the code is executable: 'mcp__claude-flow__memory_usage { ... }' is pseudo-syntax that would not parse inside the JavaScript wrappers, 'resolveConflict(current.value, value)' and 'expectedVersion' are never defined, and metrics like 'operations_per_second: 1000' and 'checksum: "hash"' are hardcoded placeholders. Some concrete guidance but pseudocode instead of executable code — anchor 3.

3 / 5

Workflow Clarity

The numbered 'Core Responsibilities' are topic categories, not a sequence — there is no startup order, no initialization flow, and no validation checkpoints anywhere. Batch/destructive-adjacent operations (broadcast memory updates, atomic writes over existing keys) ship with zero verify/recover steps, e.g. 'conflicts_resolved: []' is written empty with no procedure for filling it. Rough sequence at best with many gaps and absent validation — anchor 2.

2 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), so everything is inlined in one ~190-line SKILL.md. Section headers provide reasonable navigation and no references are dangling, but the file mixes identity metadata (a stray second frontmatter block), operational protocol details, and recovery procedures that belong in separate reference files — anchor 3 ('some structure but could be better organized').

3 / 5

Total

11

/

20

Passed

Description

28%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 frontmatter description is packaging boilerplate rather than a capability description: it says how to invoke the skill but not what it does or when to use it. The substantive description exists only in a malformed second frontmatter block inside the body, leaving the actual description field nearly useless for triggering or disambiguation.

Suggestions

Replace the description with the capability sentence already written in the body ('Manages distributed memory across the hive mind, ensuring data consistency, persistence, and efficient retrieval...') so the real frontmatter carries the what.

Add an explicit trigger clause, e.g. 'Use when the user mentions hive mind state, distributed/swarm memory, syncing agent memory, or memory conflicts across agents.'

Remove the redundant second frontmatter block so there is exactly one name/description pair and no conflicting identity for the skill.

DimensionReasoningScore

Specificity

The description is only "Agent skill for swarm-memory-manager - invoke with $agent-swarm-memory-manager" — it names the domain but lists zero concrete actions or capabilities (no store/retrieve/sync/conflict-resolution verbs). It is not anchor 1 ('entirely vague') because the domain name is specific, but it fails anchor 3+ since no action is described at all.

2 / 5

Completeness

There is a vague 'what' ("Agent skill for swarm-memory-manager") and no 'when' clause whatsoever — matching anchor 2 ('has a vague what and no when'). It cannot score 3 or higher because a 'Use when...' clause or equivalent trigger guidance is completely missing; the richer capability sentence ("Manages distributed memory across the hive mind...") sits in a stray second frontmatter block in the body rather than in the actual description field.

2 / 5

Trigger Term Quality

The only trigger language is the literal invocation syntax "$agent-swarm-memory-manager", which is technical jargon rather than phrases a user would naturally say (e.g., 'sync memory', 'hive mind state', 'distributed memory'). It is above anchor 1 only because the skill name itself is a relevant keyword, but natural language triggers are entirely absent.

2 / 5

Distinctiveness Conflict Risk

"swarm-memory-manager" is a fairly distinct niche name, but the generic "Agent skill for X - invoke with $X" boilerplate is identical to every similarly-generated agent skill, so it would pattern-match siblings like the referenced queen-coordinator or neural-pattern-analyzer. Somewhat specific but with real overlap risk — anchor 3.

3 / 5

Total

9

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.