JPeetz/agent-skills / skills/development/finding-unknowns/skills/pitch-packager
pitch-packager
VerifiedUse when the user needs buy-in or a review-ready summary.
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 376 B |
| SKILL.md | skill md | 1.9 KB |
| evals/evals.json | config | 2.3 KB |
SKILL.md
View on GitHub---
name: pitch-packager
description: Use when the user needs buy-in or a review-ready summary.
version: 1.0.0
license: MIT
author: Neeeophytee (original), Skill Foundry (packaged)
platforms:
- linux
- macos
- windows
metadata:
hermes:
tags:
- pitch
- review
- documentation
related_skills:
- finding-unknowns
- implementation-notes
---
# Pitch packager
Reviewers start with the same unknowns the builder started with, plus one more: whether the builder accounted for the failure points an expert would probe. A good pitch doc kills both in one read.
## Steps
1. Collect the artifacts: the spec or plan, the prototype or demo, the implementation notes, and the diff. Ask for a demo recording or screenshots if any user-facing behavior changed — lead with that.
2. Structure the document in reading order for a skeptic:
- **The demo** — what it looks like working, first. A GIF or screenshot beats prose.
- **The problem and the bet** — two paragraphs max: what this solves and the approach chosen over the alternatives.
- **What an expert would ask** — the 3-5 hard questions a reviewer in this domain would raise (edge cases, scale, failure modes, migration), each answered honestly, including "not handled, here's why that's acceptable for now."
- **Deviations from plan** — lifted straight from implementation-notes, because surprises found in review cost trust.
- **What's NOT in this change** — scope fences, so the review doesn't sprawl.
3. Keep it one page. Link out to the spec, notes, and diff rather than inlining them.
4. Match the medium to the venue: a Slack-pasteable doc, a PR description, or a standalone HTML page — ask which if unclear.
## Guardrails
- Never oversell: a pitch that hides a known weakness converts one approval into a permanent credibility loss.
- The "what an expert would ask" section is the heart. If it's easy to write, the questions aren't hard enough.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |