CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

buzz-hn

Hacker News post crafter — given a product, feature, or story produces a ready-to-post HN submission (title ≤80 chars, no marketing), honest body text with technical depth, no outbound links, predicted reception analysis, and comment-response templates for likely pushback. Use when asked to "write an HN post", "craft a Show HN", "prepare our Hacker News launch", or "help me post on HN".

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, actionable skill body with a clear step sequence and copy-paste-ready templates, weakened by a dangling dependency: the output format it instructs Claude to follow lives in a non-existent docs/output-kit.md file. Verifying its own title/link rules is left implicit rather than an explicit checkpoint.

Suggestions

Add the referenced docs/output-kit.md to the bundle (or inline the 40-line output format) so the load-bearing output-format reference is not broken.

Add an explicit pre-delivery validation checklist in the workflow: confirm title ≤80 chars, no marketing language, and zero outbound links in the body before presenting output.

Trim rhetorical flourishes ('zero, none, not one', 'Not a wall of text, not a tweet') and clarify what /atlas-report refers to, since it is an undeclared external dependency.

DimensionReasoningScore

Conciseness

The body is directive and mostly lean — rules, templates, and concrete find commands rather than explanations of known concepts. Minor rhetorical flourishes could be trimmed ('zero, none, not one', 'Not a wall of text, not a tweet'), matching 'efficient; minor instances that could be trimmed'. Not 5 because a few emphasis lines don't fully earn their tokens; not 3 because there is no real over-explanation of things Claude already knows.

4 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: explicit title rules with examples ('a Rust library for X' not 'a fast way to do X'), a 3-variant title template, paragraph-by-paragraph body skeleton, a reception-forecast template, and near copy-paste comment responses plus runnable bash find commands. Not 4 because the common cases are covered with ready-to-use material, leaving only trivial gaps.

5 / 5

Workflow Clarity

Steps 0–6 are clearly sequenced with an explicit input-gathering checkpoint ('Ask for any missing inputs') and a delivery contract. Not 5 because there are no explicit verification checkpoints for the skill's own rules (e.g., no 'verify title ≤80 chars and body has zero links before delivery' step — it is only implied by the Delivery line). Not 3 because the sequence itself is complete and unambiguous, and the operation is not destructive or batch, so a hard cap does not apply.

4 / 5

Progressive Disclosure

Sections are well-organized and the skill is single-file, but it depends on 'docs/output-kit.md' for its output format and delegates to '/atlas-report' — and the bundle contains no docs/ directory, references/, scripts/, or assets/, so the load-bearing output-format reference is broken. Not 4 because a reader cannot actually navigate to the file that defines the required output format; not 2 because the inline structure is otherwise clear and the skill remains largely self-contained.

3 / 5

Total

16

/

20

Passed

Description

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

Excellent description: concrete deliverables with explicit constraints, quoted natural trigger phrases for both what and when, in third person, occupying a distinct niche. No fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'produces a ready-to-post HN submission (title ≤80 chars, no marketing)', 'honest body text with technical depth', 'predicted reception analysis', and 'comment-response templates for likely pushback' — with concrete constraints, matching the comprehensive-coverage anchor. Not 4 because coverage of the skill's outputs is complete, not 'minor gaps'.

5 / 5

Completeness

It explicitly answers both what (title, body, reception analysis, comment templates) and when ('Use when asked to...' with concrete quoted trigger phrases). Not 4 because the 'when' clause is fully explicit rather than something that 'could be more specific'.

5 / 5

Trigger Term Quality

It quotes natural user phrases verbatim — 'write an HN post', 'craft a Show HN', 'prepare our Hacker News launch', 'help me post on HN' — plus synonyms (HN, Hacker News, Show HN). Not 4 because there are no common natural variations missing; no file extensions apply since the skill handles no files.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Hacker News submission crafting) with distinct triggers ('Show HN', 'Hacker News launch') that no general-purpose or other-domain skill would claim. Not 4 because there is no realistic overlap with closely related skills.

5 / 5

Total

20

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

jeremylongshore/tons-of-skills-marketplace

Path

plugins/ai-agency/tonone/bundle/marketing-team/skills/buzz-hn/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.