CtrlK
BlogDocsLog inGet started
Tessl Logo

trending-ad-hook-spotter

Monitor Twitter/X, Reddit, LinkedIn, and Hacker News for trending narratives, viral posts, and hot-button topics in your space. Maps trends to ad hook opportunities with timing urgency scores. Tells you what to run ads about right now while the topic is hot.

59

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/ads/composites/trending-ad-hook-spotter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable, well-sequenced multi-phase skill with genuinely executable API commands and query templates across all four platforms. Its weaknesses are structural rather than substantive: duplicated Prerequisites/Tools and Trigger/When-to-Use sections waste tokens, and at ~290 lines with no reference files it inlines content (the output template, per-platform API details) that should be split out. Score-scale conversion for trends is also underspecified.

Suggestions

Merge 'Prerequisites' and 'Tools Required' into one section, and fold 'Trigger Phrases' into 'When to Use' — both pairs currently say the same thing twice.

Move the ~60-line Phase 4 output template (and optionally the per-platform API details) into references/ files (e.g., references/output-template.md) linked one level deep, keeping SKILL.md as an overview.

Specify how to convert the five weighted trend factors into the 0-100 score (e.g., rate each factor 1-10, multiply by its weight percentage, sum), so the urgency tiers are reproducible.

DimensionReasoningScore

Conciseness

The core scanning guidance is tight and command-first, but there is real redundancy: 'Tools Required' restates the 'Prerequisites' section (APIFY_API_TOKEN, web search, free HN API appear twice), and 'Trigger Phrases' near-verbatim duplicates the 'When to Use' bullet list. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 2, since the duplicated content is confined to two sections and everything else earns its tokens.

3 / 5

Actionability

Fully executable throughout: copy-paste web_search query templates ('<industry keyword> (viral OR trending OR hot take OR thread) site:x.com'), complete Apify POST/GET calls with JSON payloads and poll-then-fetch sequence, parameterized HN Algolia URLs, and a filled-in output template. Placeholders are parameterization, not pseudocode, and common cases (browse vs. search Reddit, front-page vs. keyword HN) are each covered. Not 4 because there are no meaningful gaps in executability.

5 / 5

Workflow Clarity

A clearly sequenced Phase 0-4 pipeline with explicit checkpoints: 'Poll until the run finishes... When status is SUCCEEDED, fetch results', a defined trend threshold ('For each trend scoring 50+'), and urgency tiers that gate action. It falls short of 5 because there are no error-recovery/feedback loops (e.g., what to do on a failed Apify run or empty search results) and trend scoring says 'Total score out of 100' without specifying how to convert weighted factors into numeric subscores.

4 / 5

Progressive Disclosure

The body is ~290 lines with good headers but no bundle files (references/, scripts/, assets/ do not exist), so everything is inline — including a ~60-line output format template and full API details for four platforms that belong in one-level-deep reference files. This fits 'some structure but could be better organized; content that should be separate is inline' rather than 4, since the inlining is substantial, not minor.

3 / 5

Total

15

/

20

Passed

Description

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

A concrete, well-targeted description with strong platform specificity and natural trigger vocabulary. Its main weakness is the absence of any 'Use when...' trigger clause, which caps completeness and leaves invocation conditions implicit. Adding explicit trigger conditions (e.g., 'Use when planning paid campaigns around current events or viral topics') would raise it further.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when planning or refreshing paid ad campaigns, newsjacking a viral topic, or when the user asks what to run ads about right now.'

Include natural synonym phrases users actually say — 'newsjacking', 'what's hot in [industry]', 'viral hooks for paid campaigns' — to broaden trigger coverage.

State the deliverable ('produces a scored list of ad hooks in a dated markdown report') so the 'what' covers output as well as process.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Monitor Twitter/X, Reddit, LinkedIn, and Hacker News for trending narratives, viral posts, and hot-button topics', 'Maps trends to ad hook opportunities with timing urgency scores' — but omits how the monitoring happens (search queries, APIs) and what the deliverable is. Closest to the 'several specific actions; minor gaps' anchor, not 5 because coverage is not comprehensive and not 3 because it goes beyond 1-2 generic actions.

4 / 5

Completeness

The 'what' is clear (monitor four named platforms, map trends to ad hooks, urgency-score them), but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'Tells you what to run ads about right now' describes output timing, not invocation conditions. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3; it is above 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

Contains natural phrases users would say — 'trending narratives', 'viral posts', 'hot-button topics', 'run ads about' — with the platform names as strong disambiguators. A few natural synonyms are missing ('newsjacking', 'paid campaigns', 'social listening', 'what's hot in [industry]'), so it sits at 'good coverage; a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The combination of named platforms, 'ad hook opportunities', and 'timing urgency scores' carves a fairly distinct niche that is unlikely to trigger general social-media or copywriting skills. Minor overlap risk remains with a generic 'social listening' or 'trend monitoring' skill, so it fits 'mostly distinct; minor overlap risk' rather than the 5 anchor's minimal-conflict profile.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
gooseworks-ai/goose-skills
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.