CtrlK
BlogDocsLog inGet started
Tessl Logo

hn-summarize

Fetch and summarize Hacker News / hckrnews.com top stories, articles, and their comment threads. Use when asked to summarize HN front-page stories, a specific HN story plus its discussion, or "the top N from hckrnews".

80

Quality

100%

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

100%

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

The body is lean and highly actionable, with executable curl/python recipes for each common HN intent, a clear output format, and a sensible fallback for paywalled pages. It is well-organized as a single file with no unnecessary explanation of concepts Claude already knows.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence, and avoids explaining generic concepts; even the opening paragraph earns its place by stating a non-obvious gotcha ("do not scrape" hckrnews, use the JSON APIs instead) rather than filler, matching the level-3 anchor.

3 / 3

Actionability

Each section provides fully executable, copy-paste-ready curl + python3 one-liners with clearly marked parameter placeholders (YOUR+QUERY, OBJECT_ID, ARTICLE_URL), matching the level-3 anchor for executable, specific examples.

3 / 3

Workflow Clarity

Distinct intents are sequenced into clearly numbered sections (1 top stories, 2 search, 3 story+comments, 4 article) with a defined output spec and a recovery path for paywalled/JS-heavy pages; the task is read-only so no validation checkpoints are required, satisfying the simple-skill allowance for level 3.

3 / 3

Progressive Disclosure

The skill is a self-contained single file (no bundle files present) with well-organized section headers and no nested reference chains; the inline code is core action content rather than material that should be split out, matching the level-3 allowance for simple skills with well-organized sections.

3 / 3

Total

12

/

12

Passed

Description

100%

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 is concise, specific, and well-structured with both clear capability statements and an explicit 'Use when' trigger covering natural user phrasings for a distinct niche. No vague fluff or over-claims are present.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ("Fetch and summarize") over specific objects ("top stories, articles, and their comment threads"), matching the level-3 anchor that lists several specific concrete actions rather than a vague domain mention.

3 / 3

Completeness

Explicitly answers both what ("Fetch and summarize ... top stories, articles, and their comment threads") and when via an explicit "Use when asked to summarize ..." clause, matching the level-3 anchor with explicit triggers.

3 / 3

Trigger Term Quality

Covers natural user phrasing — "Hacker News", "HN", "hckrnews", "summarize ... front-page stories", "the top N from hckrnews" — giving good coverage of terms a user would actually say, matching the level-3 anchor.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (Hacker News / hckrnews specifically) with distinct triggers unlikely to overlap other skills, matching the level-3 anchor for a clear, conflict-free niche.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ykdojo/claude-code-tips
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.