bestblogs-brief

Use this skill when the user asks about today's daily brief, morning digest, or BestBlogs highlights. Triggers include "今天早报 / 今日早报 / BestBlogs 早报 / 今天有啥好文 / 今日精选 / 给我看早报", "today's brief", "today's digest", "BestBlogs morning brief", "today's highlights on BestBlogs", "what's in today's brief". Invokes the `bestblogs` CLI.

Quality

95%

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

Quality

Content

100%Weight 40%Scale 1-3

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

A tight, well-structured single-purpose skill: executable commands, the real response schema, field-level presentation guidance, explicit error-recovery fallbacks, and clean composition pointers to sibling skills. It is concise and assumes Claude's competence throughout.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence — no padding about what a brief or a CLI is, and every section (primitives table, core command, response shape, error handling, composition) earns its place; the JSON sample is the actual response structure needed to render results rather than illustrative fluff.	3 / 3
Actionability	Commands are fully executable and copy-paste ready ('bestblogs brief today --json', '--locale en', 'bestblogs brief latest --json'), and the response shape plus field-keyed presentation guidance ('podcastTitle as theme', 'featured=true first', 'matchReason for why') give concrete, specific direction.	3 / 3
Workflow Clarity	For this single-purpose skill the primary action is unambiguous, and the error-handling section provides explicit recovery checkpoints (404 NOT_FOUND -> switch to latest; 401 -> degrade to public latest; 429 -> retry), which are the validation/feedback loops the rubric rewards for fragile operations.	3 / 3
Progressive Disclosure	The skill is compact and single-purpose with no need for external bundle files (none present), and it is well-organized into clear sections (何时使用 / 原语 / 核心动作 / 英文早报 / 获取最新 / 错误处理 / 组合建议) with composition hints pointing to named sibling skills — meeting the 'well-organized sections' allowance for simple skills.	3 / 3
	Total	12 / 12 Passed

Description

90%Weight 40%Scale 1-3

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, well-targeted description with explicit 'Use when' guidance and rich natural trigger phrasing in both Chinese and English. The only soft spot is specificity, which describes a single capability plus the CLI rather than a list of multiple concrete actions.

Suggestions

If the skill also supports distinct actions (e.g. summarizing, listing items, explaining recommendations), enumerate them as concrete verbs to lift specificity toward the multi-action anchor.

Consider stating the output the user receives (e.g. 'returns a JSON brief of featured articles and editor intro') so the capability is concrete beyond just invoking the CLI.

Dimension	Reasoning	Score
Specificity	It names the domain ('today's daily brief, morning digest, or BestBlogs highlights') and a concrete mechanism ('Invokes the `bestblogs` CLI'), but it does not enumerate multiple distinct concrete actions — effectively a single retrieve-and-summarize capability, so it sits at the 'domain and some actions' anchor rather than the multi-action anchor.	2 / 3
Completeness	It explicitly answers both what the skill does and when to use it, opening with 'Use this skill when the user asks about...' and listing explicit 'Triggers include...', which is the both-what-and-when anchor.	3 / 3
Trigger Term Quality	It gives broad natural-language coverage in both languages — '今天早报 / 今天有啥好文 / 给我看早报' and 'today's brief', 'today's digest', 'what's in today's brief' — phrases a user would naturally say, matching the good-coverage anchor.	3 / 3
Distinctiveness Conflict Risk	The niche is narrow and specific (BestBlogs daily brief) with highly specific bilingual triggers, making it unlikely to fire for the wrong skill; matches the clear-niche anchor.	3 / 3
	Total	11 / 12 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: ginobefun/BestBlogs
Path: skills/bestblogs-brief/SKILL.md
Commit: 756ffbd

Reviewed: 23 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.