CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-scout-explorer

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

39

5.41x
Quality

7%

Does it follow best practices?

Impact

92%

5.41x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agents/skills/agent-scout-explorer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

14%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is excessively verbose, repeating the same memory-store pattern six or more times with minor variations in payload fields. It lacks a clear operational workflow—there's no defined sequence for how a scout should actually explore, validate, and report. The scouting strategies section is generic and abstract, adding little value beyond what Claude already knows about exploration approaches.

Suggestions

Consolidate the repetitive memory storage examples into a single generic template with a table showing the different key patterns and payload schemas for each discovery type (threat, opportunity, codebase map, etc.)

Add a concrete sequential workflow: e.g., 1) Check existing discoveries in memory, 2) Read directory structure, 3) Analyze files, 4) Validate findings, 5) Store to memory — with explicit validation checkpoints before reporting threats or critical findings

Remove the 'Scouting Strategies' section (breadth-first, depth-first, continuous patrol) as these are generic concepts Claude already understands, or replace with specific decision criteria for when to use each

Extract detailed scout-type templates (dependency, performance, security) into separate reference files and keep only a concise overview with links in the main skill

DimensionReasoningScore

Conciseness

Extremely verbose with repetitive JSON blocks that all follow the same pattern (store to memory with slightly different payloads). The skill could convey the same information in a fraction of the space. Multiple exploration patterns (codebase, dependency, performance, environment) are essentially the same template with different field names. The 'Scouting Strategies' section describes generic exploration concepts Claude already knows.

1 / 3

Actionability

The MCP tool call patterns provide concrete structure for memory coordination, but they are templates with placeholders rather than truly executable code. The exploration strategies (breadth-first, depth-first, continuous patrol) are abstract numbered lists without concrete commands or steps for actually performing reconnaissance on a codebase.

2 / 3

Workflow Clarity

There is no clear sequential workflow with validation checkpoints. The skill presents a collection of memory storage templates but lacks a coherent process: when to start exploring, how to decide what to explore, how to validate findings before reporting, or when exploration is complete. No feedback loops or error recovery are defined despite the skill involving potentially destructive coordination with other agents.

1 / 3

Progressive Disclosure

Monolithic wall of repetitive JSON examples with no references to external files and no layered structure. All content is inline regardless of complexity. The various scout types (codebase, dependency, performance, security) could each be separate reference files, keeping the main skill lean.

1 / 3

Total

5

/

12

Passed

Description

0%

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

This description is critically deficient across all dimensions. It functions only as a label and invocation instruction, providing zero information about what the skill does, when to use it, or what user requests should trigger it. Claude would have no meaningful basis for selecting this skill from a list of available skills.

Suggestions

Add concrete actions describing what scout-explorer actually does (e.g., 'Explores directory structures, searches for files by pattern, and maps project layouts').

Add an explicit 'Use when...' clause with natural trigger terms users would say (e.g., 'Use when the user asks to explore a codebase, find files, navigate project structure, or search directories').

Remove or supplement the invocation instruction with a functional description — the invocation syntax is operational detail, not a description of capability.

DimensionReasoningScore

Specificity

The description provides no concrete actions whatsoever. 'Agent skill for scout-explorer' is entirely vague and abstract, giving no indication of what the skill actually does.

1 / 3

Completeness

Neither 'what does this do' nor 'when should Claude use it' is answered. The description only states it's an agent skill and how to invoke it, with no explanation of purpose or trigger conditions.

1 / 3

Trigger Term Quality

There are no natural keywords a user would say. 'scout-explorer' is an internal tool name, not a term users would naturally use in requests. The only actionable term is the invocation command '$agent-scout-explorer'.

1 / 3

Distinctiveness Conflict Risk

The description is so generic that it provides no distinguishing characteristics. Without knowing what the skill does, it could conflict with any number of other skills, and Claude would have no basis for selecting it appropriately.

1 / 3

Total

4

/

12

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.

Validation11 / 11 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.