CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-scout-explorer

Agent skill for scout-explorer - invoke with $agent-scout-explorer

53

5.41x
Quality

31%

Does it follow best practices?

Impact

92%

5.41x

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-scout-explorer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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 is a hive-mind role prompt with a clear section structure and a consistent (if templated) reporting protocol, but it is built from non-executable placeholder pseudocode repeated across seven near-identical blocks, includes a malformed duplicate frontmatter, and offers no progressive disclosure or validation loops. It functions as inspiration for a persona rather than as operational skill guidance.

Suggestions

Collapse the seven repetitive memory_usage blocks into one parameterized example (with the full key/value schema documented once) and vary only the parts that differ per pattern.

Make the code executable or explicitly justify the template form: replace placeholders like "scout-[ID]" and "what was found" with concrete fill-in instructions or valid syntax.

Move the per-pattern exploration templates (codebase/dependency/performance scout) into a references/ file and add a validation step (e.g., confirm the store succeeded before proceeding) to the reporting workflow.

DimensionReasoningScore

Conciseness

Sections like "Scouting Strategies", "Integration Points", and the Do/Don't lists are tight, but seven near-identical mcp__claude-flow__memory_usage template blocks padded with dummy data ("total_count: 45", "load_time_ms: 3500") repeat the same call structure, and the stray duplicate frontmatter block at the top of the body is pure noise. This sits between the 'mostly efficient' (3) and 'noticeably verbose' (2) anchors — the padding is substantial but there is little conceptual over-explanation.

3 / 5

Actionability

Concrete guidance exists — real tool name, key names, namespaces, and value schemas are specified — but the blocks are non-executable templates: invalid JS object literals, unfilled placeholders like "scout-[ID]", "what was found", and "reconnaissance type". This matches the 'pseudocode instead of executable code; missing key details' anchor, not 4 which requires mostly executable guidance.

3 / 5

Workflow Clarity

The three Scouting Strategies give numbered, legible sequences and "Verify findings before alerting" appears in the Do list, but the deploy → discover → report protocol has no real validation checkpoints, error-recovery, or feedback loops around the memory operations — matching the 'steps listed but checkpoints missing or implicit' anchor.

3 / 5

Progressive Disclosure

The body has consistent ##/### section headers and is navigable, but it is a 247-line monolith with no reference files anywhere in the bundle (references/, scripts/, assets/ absent) and no in-body pointers, while the repetitive per-pattern call templates are exactly the content that belongs in a separate reference file — matching 'some structure but could be better organized'.

3 / 5

Total

12

/

20

Passed

Description

12%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 parsed frontmatter description is boilerplate metadata that fails to describe what the skill does or when to use it, and contains no natural trigger terms. The file is also malformed: a second nested '---' frontmatter block (lines 6-11) holds a richer intended description, indicating a generation error rather than deliberate design.

Suggestions

Rewrite the description to state concrete capabilities (e.g., 'Explores unfamiliar codebases and dependencies, detects threats and performance bottlenecks, and reports findings to shared swarm memory'), replacing the 'Agent skill for X - invoke with $X' template.

Add an explicit trigger clause such as 'Use when performing reconnaissance on an unknown codebase, auditing dependencies or performance, or coordinating exploration with other swarm agents.'

Remove the duplicate nested frontmatter block so only one valid name/description pair remains.

DimensionReasoningScore

Specificity

The description says only "Agent skill for scout-explorer - invoke with $agent-scout-explorer" — it names a label but states zero concrete actions or capabilities, matching the "entirely vague; no concrete actions" anchor; score 2 requires at least a minimal action verb like "Processes PDF files".

1 / 5

Completeness

A vague 'what' is present (an agent skill for scout-explorer) but there is no 'when' or usage trigger of any kind, matching anchor 2; it cannot score 3 because the 'what' never states what the skill actually does.

2 / 5

Trigger Term Quality

"invoke with $agent-scout-explorer" is internal invocation syntax, and "agent skill" is generic filler; no natural keyword a user would actually say when needing this skill, fitting the "only technical jargon or entirely generic language" anchor.

1 / 5

Distinctiveness Conflict Risk

The boilerplate "Agent skill for X - invoke with $X" pattern is very broad and would be indistinguishable from any sibling swarm-agent skill sharing the same template, creating high overlap risk.

2 / 5

Total

6

/

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.