Content
71%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |