CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scout

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

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/scout/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-sequenced, genuinely actionable workflow with strong error-recovery scaffolding (fallback table, uncertainty ladder, confirmation gates). Its main costs are the meta sections (Success Metrics, Philosophy) that spend tokens without guiding execution, and minor specificity gaps in the search and category-suggestion steps.

Suggestions

Delete or collapse the "Success Metrics" and "Philosophy" sections into one or two lines, e.g. fold "no duplicate saves" into the vault-coverage step — they spend context without instructing Claude.

Enumerate the suggested categories for the Save template (the value /url-dump expects) and give a concrete search command (e.g. grep -ri "<domain> --include='*.md'" over the vault) so the coverage check is copy-paste executable.

Add a quick validation step for vault hits, e.g. read the matched file's frontmatter to confirm it's a true duplicate rather than a passing mention, before recommending skip.

DimensionReasoningScore

Conciseness

The body is mostly task-specific procedure, but the "Success Metrics" and "Philosophy" sections are non-actionable padding ("Scout embodies COG's 'evaluate before you accumulate' principle") that Claude cannot use at runtime. Fits the 3 anchor (mostly efficient with some unnecessary explanation) rather than 4, since these are whole sections, not minor instances.

3 / 5

Actionability

Concrete, executable guidance throughout: exact vault paths (00-inbox/MY-PROFILE.md), verbatim prompt templates in code blocks, a defined search strategy, a fallback table, and exact output formats for Save/Skip/batch cases. Minor gaps — suggested categories are never enumerated and the grep strategy is described but not given as a command — keep it below the 5 anchor's fully copy-paste-ready bar.

4 / 5

Workflow Clarity

Seven clearly sequenced steps with real checkpoints: a pre-flight profile check, user-confirmation gates before handoff ("Shall I hand off to /url-dump?"), a batch summary table for batch mode, and Fallback Behavior / Uncertainty Handling sections that act as explicit error-recovery loops. It is not 5 because there is no step validating that vault-search hits are true duplicates or that fetched content was parsed correctly.

4 / 5

Progressive Disclosure

A single well-organized file with clear section headers, no nested or dead references, and no bundle files to mis-navigate. It is not 5 because at ~195 lines the output templates and fallback details could arguably live in one-level-deep reference files, and the rubric's 5-without-references exception applies only to skills under 50 lines.

4 / 5

Total

15

/

20

Passed

Description

58%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 clearly communicates three concrete capabilities but entirely omits when to use the skill — no trigger phrase or 'Use when' clause — which both caps completeness and limits natural trigger-term coverage. Adding an explicit invocation clause would lift the two weakest dimensions at once.

Suggestions

Append a trigger clause such as: "Use when the user shares a URL or tool name and asks whether it's worth saving, e.g. 'should I save this?', 'is this relevant?', 'scout this'."

Include natural synonyms users would say ("worth saving", "relevant to me", "already have this") rather than only capability verbs like "evaluate" and "assess".

Name the handoff boundary in the description (evaluate vs. save via /url-dump) to sharpen distinctiveness from the saving skill itself.

DimensionReasoningScore

Specificity

Names the domain and three concrete actions — "check vault coverage", "assess relevance", "recommend save or skip" — which matches the 4 anchor (several specific actions, minor gaps in coverage). It falls short of 5 because coverage isn't comprehensive (e.g., what relevance is assessed against, or what the tool-name path does is left to the body).

4 / 5

Completeness

The 'what' is clear (check coverage, assess relevance, recommend save/skip), but there is no 'Use when...' clause or any equivalent trigger guidance — the rubric guideline caps completeness at 3 for this. Not 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Keywords like "evaluate", "URLs", "tools", "save", "skip" are relevant, but the natural phrases a user would actually say ("should I save this?", "is this relevant?", "scout this") appear only in the body, not the description. Fits the 3 anchor (some relevant keywords, missing common variations) rather than 4's good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The save/skip triage framing and vault-coverage check establish a clear niche distinct from generic fetch/research skills, though "Evaluate URLs and tools" is broad phrasing with minor overlap risk. Fits 4 (mostly distinct) rather than 5, which expects explicit distinct trigger phrases.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

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.