Generate personalized news intelligence with verified sources (7-day freshness requirement)
34
30%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/daily-brief/SKILL.mdQuality
Discovery
32%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 conveys a general sense of the skill's purpose—generating curated news content with source verification and recency constraints—but lacks concrete action verbs, explicit trigger guidance, and natural user-facing keywords. It reads more like a feature tagline than a functional skill description that would help Claude reliably select it from a large skill library.
Suggestions
Add an explicit 'Use when...' clause with trigger terms like 'news briefing', 'current events', 'latest headlines', 'news summary', or 'what's happening in [topic]'.
List specific concrete actions such as 'searches for recent news articles, summarizes key stories, verifies sources, and compiles personalized briefings'.
Include common user phrasing variations like 'news update', 'daily digest', 'trending topics', or 'news roundup' to improve trigger term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain ('news intelligence') and mentions some qualities ('personalized', 'verified sources', '7-day freshness requirement'), but doesn't list multiple concrete actions like summarizing, filtering, aggregating, or formatting news. | 2 / 3 |
Completeness | Describes what it does at a high level ('generate personalized news intelligence') but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when...' caps completeness at 2, and the 'what' is also not very detailed, warranting a 1. | 1 / 3 |
Trigger Term Quality | Includes 'news' and 'sources' which are natural terms, but misses common variations users might say like 'headlines', 'current events', 'latest news', 'news summary', 'news briefing', or 'what's happening'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of 'news intelligence', 'verified sources', and '7-day freshness requirement' provides some distinctiveness, but 'personalized news' could overlap with general search or summarization skills without clearer trigger boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is well-intentioned with a thorough output template and good deduplication logic, but it suffers from extreme verbosity — much of the content describes aspirational qualities (learning, adaptation, philosophy) rather than providing executable instructions. The core research methodology is underspecified despite the document's length, and the entire skill would benefit enormously from splitting the output template and reference material into separate files.
Suggestions
Extract the full output template into a separate `BRIEF-TEMPLATE.md` file and reference it from the main skill, reducing the SKILL.md to workflow steps and key rules only.
Remove the 'Performance Metrics', 'Learning and Adaptation', and 'Philosophy' sections entirely — these are aspirational descriptions, not actionable instructions for Claude.
Specify concrete tool usage for news research (e.g., which search tools/commands to use, specific WebFetch patterns) instead of abstract guidance like 'search based on interest profile'.
Add a validation checkpoint between research and file generation: explicitly verify all gathered stories meet the 7-day freshness requirement and have 2+ sources before proceeding to write the brief.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~350+ lines. Includes extensive sections Claude doesn't need explained (what Tier 1/2/3 sources are, philosophy section, learning/adaptation metrics that aren't actionable instructions, lengthy opportunity/threat taxonomies). The template alone is massive with placeholder comments that could be dramatically condensed. Sections like 'Performance Metrics' and 'Learning and Adaptation' describe aspirational concepts rather than executable instructions. | 1 / 3 |
Actionability | The skill provides a concrete output template and specific file paths, which is good. However, the actual news research step is vague — it says 'search based on user's current interest profile' without specifying which tools to use or how to search (beyond a single mention of WebFetch). The pre-flight check with the `date` command is concrete, but the core research methodology lacks executable specifics. | 2 / 3 |
Workflow Clarity | The 5-step process flow is clearly sequenced (Gather Context → Research → Generate → Handle Special Cases → Confirm). The deduplication step is well-defined with matching rules. However, there are no validation checkpoints between research and generation — no step to verify freshness compliance before writing the file, no feedback loop if sources can't be found. The verification report is generated as part of the output but isn't a process checkpoint. | 2 / 3 |
Progressive Disclosure | Everything is crammed into a single monolithic file with no references to supporting documents. The massive output template (100+ lines), the detailed source tier definitions, the opportunity/threat taxonomy, and the special case templates could all be split into referenced files. The result is a wall of text that's difficult to navigate. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
034af4c
Table of Contents
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.