CtrlK
BlogDocsLog inGet started
Tessl Logo

daily-brief

Generate personalized news intelligence with verified sources (7-day freshness requirement)

34

Quality

30%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/daily-brief/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
huytieu/COG-second-brain
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.