Content
70%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.
The body is an exceptionally actionable, well-sequenced pipeline with genuine error-recovery handling for batch operations, but it is a long single-file monolith with repeated guidance and time-sensitive batch details, and most of its curl examples have broken JSON/shell quoting that prevents copy-paste execution.
Suggestions
Fix the curl examples so each JSON body is a single properly quoted -d argument — currently most close the quote after "path" and leave the remaining keys (e.g. "website_url") outside the string, making the commands non-executable as written.
Deduplicate guidance that appears multiple times (YC-partner filtering, batch tags vs. individual-page sectors, plain-URL formatting, rich Perplexity prompts) into one authoritative section, and move time-sensitive details like the 'Spring 2026' batch facts and default into a clearly labeled section so they don't age the whole skill.
Split the large reference material — the column layout, expected API response schemas, and Strong/Moderate/Weak assessment exemplars — into one-level-deep reference files (e.g. references/schemas.md, references/assessment-examples.md) so SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense with non-obvious API specifics Claude could not know, but it repeats the same guidance several times (YC-partner filtering appears in 3a and Tips; batch-tags-vs-individual-sectors in Step 1, 3a, formatting rules, and Tips; the plain-URL rule and rich-Perplexity-prompt advice each appear twice), and embeds time-sensitive claims ('"Spring 2026" is a real YC batch… ~22 companies', a dated default batch) outside any deprecated/old-patterns section, which the guidelines penalize. This is more than the 'minor instances' of the level-4 anchor but well short of the severe padding of level 2. | 3 / 5 |
Actionability | Concrete endpoints, auth headers, expected JSON response shapes, field-name variants, fallback calls, and a cost table make the guidance highly actionable. However, most curl examples are malformed as written — the -d '{…}' JSON body is closed early and subsequent keys like "website_url" sit outside any quotes (only the Apollo calls are well-formed) — so they are not copy-paste executable. All parameters and structure are present and trivially reassembled, fitting 'concrete commands with minor gaps' better than the pseudocode/missing-details anchor, but short of fully executable. | 4 / 5 |
Workflow Clarity | A clearly numbered 5-step sequence with an explicit parallelization strategy, per-row update cadence, and real error-recovery loops for this batch operation (website 404 → 'Website not available or pre-launch', missing LinkedIn → Apollo name+company fallback, 'Skip gracefully… partial data > empty row', and a mandated re-sort step with 'Do not skip the sort'). Validation and feedback loops for batch failures are present, so the batch-operation cap does not apply, and this matches the top anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist and the entire ~515-line skill is a single monolith: column layout tables, API response schemas, Strong/Moderate/Weak assessment exemplars, and formatting rules are all inlined with no one-level-deep references. Internal headers are clear and it is not a wall of text (so above anchor 2), but content that would fit separate reference files is inline and there is no reference navigation at all, matching anchor 3 rather than 4. | 3 / 5 |
Total | 15 / 20 Passed |