scout

Evaluate URLs and tools — check vault coverage, assess relevance, recommend save or skip

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/scout/SKILL.md

Quality

Content

77%

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

The body is actionable and workflow-clear with concrete templates and explicit checkpoints, but it is a monolithic wall of text padded with non-essential Philosophy and Success Metrics sections. Splitting detail into referenced files and trimming meta sections would improve both conciseness and progressive disclosure.

Suggestions

Move the detailed process flow, fallback table, and output templates into a reference file linked from the SKILL.md overview to improve progressive disclosure.

Remove or compress the Philosophy and Success Metrics sections, which add tokens without actionable guidance.

Keep only the trigger conditions, high-level process, and handoff boundary inline in SKILL.md.

Dimension	Reasoning	Score
Conciseness	Most of the body is efficient, structured guidance, but the Philosophy and Success Metrics sections add meta-content Claude does not need to act on the skill.	2 / 3
Actionability	It provides concrete, copy-paste-ready output templates (SAVE/SKIP blocks, batch summary table), a specific search strategy, and a fallback table — fully executable instruction-only guidance.	3 / 3
Workflow Clarity	A clearly numbered 1–7 process is sequenced with explicit checkpoints: pre-flight profile check, vault coverage check before fetching, and user confirmation before handoff.	3 / 3
Progressive Disclosure	The ~200-line body is well-sectioned but monolithic with no file split and no one-level-deep references, so content that could live in separate files stays inline.	2 / 3
	Total	10 / 12 Passed

Description

67%

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 specific and distinctive about what the skill does, but it omits explicit "when to use" trigger guidance that would help Claude select it reliably. Adding a "Use when…" clause with natural user phrases would raise completeness and trigger-term quality.

Suggestions

Append a "Use when…" trigger clause naming natural user phrases like "should I save this?", "is this relevant?", or "evaluate this".

Surface the most common trigger terms (e.g. "evaluate", "relevant", "save or skip") directly in the description rather than only in the body.

Tighten the dash-separated action list into one flowing sentence to make the what-and-when pairing explicit.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete actions — "check vault coverage", "assess relevance", "recommend save or skip" — rather than vague language.	3 / 3
Completeness	It clearly answers "what" the skill does but lacks a "Use when…" clause or explicit trigger guidance, capping completeness at 2 per the rubric.	2 / 3
Trigger Term Quality	It contains relevant keywords ("URLs and tools", "save or skip") but omits the natural phrases users would say (e.g. "should I save this?", "is this relevant?") which only appear in the body.	2 / 3
Distinctiveness Conflict Risk	The triage niche ("recommend save or skip") is clearly distinct from the saving skill /url-dump, making wrong-skill triggering unlikely.	3 / 3
	Total	10 / 12 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: huytieu/COG-second-brain
Path: .claude/skills/scout/SKILL.md
Commit: dfbf9e9

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.