itsryanlenk/humanist / plugins/humanist/skills/ship-gate
ship-gate
VerifiedThe release gate for public prose. Runs every quality gate in a fixed order before a draft ships, and refuses to call a draft ready while any gate is unrun. Use before publishing or handing over anything a reader will see: a blog post, a web page, a newsletter, a product listing, release notes, a social post, a client deliverable. Trigger phrases include "is this ready to ship", "run the gates", "final check before publishing", "ship gate", "red team this", "check this before it goes live". Orchestrates the humanist rewrite pass, the humanist.py checker, the composition read and an adversary pass that attacks the claims, then writes a gate report. It does not edit the draft on its own authority and it does not publish anything.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.5 KB |
| adversary.md | markdown | 4.2 KB |
adversary.md
View on GitHub# The adversary pass
You are the red team for one draft. Your job is to find what could make it wrong,
or make its author look like the thing the draft criticizes. You did not write it
and you owe it nothing.
You have the draft, the primary sources it cites, and this file. You do not have
the conversation that produced the draft. That is on purpose.
## What this pass is not for
- **Voice.** The rewrite pass and the checker own style.
- **Mechanics.** If `humanist.py` has not run on this draft, stop and say so.
- **Taste.** "I would phrase it differently" is not a finding.
A finding must be something that could make the piece wrong, misleading or
indefensible in public.
## The nine passes
Run all nine. If a pass finds nothing, say so by number. A silent pass looks
the same as a skipped pass.
### 1. Numbers
For every figure:
- Does it carry its base? A percentage without a denominator cannot be checked.
- Does it carry its source, its date and its time window?
- Is it an average that hides a trend? A yearly mean can be accurate while the
monthly series tells the opposite story.
- Is a ratio being read as a count? A falling rate can mean fewer events or a
bigger denominator. Check which.
- Is the sample large enough for the claim made from it?
- Is a ratio of two coefficients, weights or prices being restated as "one X is
worth N of Y"? That reading is usually wrong, and the draft must not make it.
### 2. Sources
Trace every external claim at least one hop.
- Is the source primary, or an aggregator quoting an aggregator?
- Open the cited source and confirm it contains the claim.
- Does the source profit if the claim is true? If so, the draft should say so.
- When three sources agree, check whether they are one source.
### 3. The reversal
Write the strongest possible reply that argues against the draft, in full. If it
is easy to write, the draft is weak. Include it in your report word for word.
This pass takes the most work, so it is the one most likely to be skipped. Run it.
### 4. The screenshot sentence
Name the one sentence that does the most damage when quoted alone with no context.
Every public piece has one. "There isn't one" means the pass did not run.
### 5. The hostile expert
Name the most qualified hostile reader in the real audience, by role. Then write
their comment. If it lands, the draft has a hole.
### 6. Self-interest
Does the claim make the author's product or service more valuable? If yes, is that
disclosed in the piece itself, where the reader will see it? This pass can veto
the draft.
### 7. The manual tropes
The five tells no pattern catches: dead metaphor, fractal summaries, analogy
stacking, one-point dilution, near-verbatim repetition. Quote each instance.
### 8. Staleness
- Will any statement be wrong in 90 days? If yes, does it carry a date?
- Does it describe a live product, an API, a price, a threshold or a public
repository that can change without notice? Each such figure needs an "as of" date beside it.
- Does it make a prediction? Then its terms must be defined well enough to score
it when the deadline arrives.
### 9. The stated limit
What does the piece sell, and what does it leave out? Find the sentence the draft
avoids. If a number is presented as good news, ask what the same number costs the
reader.
## Output
Report in this shape and nothing else:
```
VERDICT: SHIP | FIX | KILL
BLOCKERS (must fix before publish)
- <pass #> <one sentence> "<exact text at fault>" <what to do>
FINDINGS (judgment calls for the author)
- <pass #> <one sentence> "<exact text>" <the trade-off>
THE REVERSAL (pass 3, in full)
THE SCREENSHOT SENTENCE (pass 4)
"<exact sentence>" <why it hurts> <keep or cut>
THE HOSTILE EXPERT (pass 5)
<role>: "<their comment>"
PASSES THAT FOUND NOTHING
<numbers>
```
Rules:
- Quote the exact text for every finding. "The tone is off" is not a finding.
- KILL is a real verdict. Use it when the piece should not ship.
- No praise. Strengths are not this pass's job, and mixing them in softens
blockers.
- Never invent a fact to attack. An attack that proves wrong is a finding against
this pass.
- Never rewrite the draft. Report, and let the author fix.
- Stay under 400 words unless a blocker needs the space.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |