CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

news-scout

Gathers the latest TLDR Tech and TLDR AI issues and the top Hacker News stories, filters them against scout-profile.md, and writes a daily digest with three suggested article topics to news/<date>.md. Use when Daisy asks for today's tech news, a news digest, or topic ideas, or when run as a scheduled task.

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

Excellent content: lean, fully actionable instruction-only guidance with a clearly sequenced four-stage workflow, concrete file paths and output formats, and edge-case handling for failed sources and headline-only stories. The only gap is the absence of a final output-validation checkpoint, and the referenced scripts/fetch_news.py is not present in the bundle being evaluated.

Suggestions

Add a final verification step at the end of Stage 3 confirming the digest satisfies the skill's own constraints (at most 10 stories, no overlap with the previous digest, exactly three topic ideas) before finishing.

Specify what to do if every source shows FAIL in Stage 1 (e.g. stop and report the failure instead of writing a digest), since the current instruction only covers partial failure.

Ensure scripts/fetch_news.py actually ships with the skill bundle - the body's fully-qualified command references it, but no scripts/ directory exists alongside this SKILL.md.

DimensionReasoningScore

Conciseness

Every line instructs ('Run ~/anaconda3/envs/writer-agent/bin/python scripts/fetch_news.py', 'Never copy the newsletter's wording', 'Do not use em dashes') with zero explanation of concepts Claude already knows and nothing to trim. This matches the 5 anchor rather than 4, which requires 'minor instances of over-explanation'.

5 / 5

Actionability

Fully executable guidance: a fully-qualified copy-paste command, concrete file paths (news/raw/<today>/, briefs/_template.yaml), an explicit digest format with per-story and per-idea fields, and an edge case handled ('label the summary "(headline only)"'). Per the rubric's instruction-only note, the absence of code is not penalized when guidance is this concrete, matching the 5 anchor.

5 / 5

Workflow Clarity

A clear 4-stage sequence with numbered steps, one error-recovery branch ('If a source shows FAIL, continue with the sources that worked'), a dedup checkpoint ('skip any story it already covered'), and scheduled-vs-interactive branching. It falls short of the 5 anchor because there is no final validation of the output against the skill's own constraints (at most 10 stories, exactly three ideas) and no handling if all sources fail - the 'minor validation gaps' of anchor 4.

4 / 5

Progressive Disclosure

Under 50 lines, well-organized staged sections, and no detail content inlined: profile criteria live in scout-profile.md and the brief structure in briefs/_template.yaml, each referenced one level deep with its role explained. Per the rubric's simple-skill note this matches 5; the referenced scripts/fetch_news.py ships no scripts/ directory in this bundle, but that is a bundle-completeness concern rather than a structure flaw.

5 / 5

Total

19

/

20

Passed

Description

92%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.

A strong description: it states a concrete three-step pipeline with specific sources and an explicit output location, and provides an explicit 'Use when' clause with natural trigger phrases. The only weakness is slight trigger coverage - a few natural phrasings a user might use are not listed.

DimensionReasoningScore

Specificity

Multiple concrete actions with named sources and outputs: 'Gathers the latest TLDR Tech and TLDR AI issues and the top Hacker News stories', 'filters them against scout-profile.md', 'writes a daily digest with three suggested article topics to news/<date>.md'. No generic filler, so it exceeds the 4 anchor's 'minor gaps in coverage'; voice is third person, so no penalty applies.

5 / 5

Completeness

Explicitly answers both: the 'what' is a full gather-filter-write pipeline with a concrete output path, and the 'when' is a dedicated 'Use when...' clause with concrete trigger phrases plus a scheduled-task trigger. This matches the 5 anchor; a missing or weak when-clause would have capped it at 3.

5 / 5

Trigger Term Quality

'today's tech news', 'a news digest', 'topic ideas', and 'run as a scheduled task' are natural user phrases with good coverage, but a few natural variations are absent (e.g. 'daily news', 'headlines', or naming TLDR/HN directly in the when-clause), which fits 4 rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

Named newsletters (TLDR Tech, TLDR AI), a personal profile file, and a dated digest written for a specific user create a clear niche with distinct triggers and minimal overlap with generic news or writing skills, matching the 5 anchor.

5 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

Daisy-Faith-Auma/writer-agent

Path

.claude/skills/news-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.