Structured persuasion for tech leads, PMs, and founders—not activity logs. Five scenarios (kickoff, status update, wrap-up, investor pitch, solution selling) on one 5-part framework (Hook→Context→Proposal→Evidence→Ask). AI prompts for missing materials and audience context; pre-submit checklist. Claude Code plugin; Cursor, Codex, and chat via prompts.
$npx -y skills add moshuying/pitchcraft --skill pitchcraftInstalls into the current project.
Run `npx skills use "https://github.com/moshuying/pitchcraft" --skill "moshuying/pitchcraft"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/moshuying/pitchcraft" that are relevant to the current task. Run `npx skills add "https://github.com/moshuying/pitchcraft"` and select the relevant skills, then follow their instructions.
| 1 | # pitchcraft (汇报.Skill) |
| 2 | |
| 3 | **Languages:** [English](README.md) · [简体中文](README.zh-CN.md) |
| 4 | |
| 5 |  |
| 6 | |
| 7 | A Claude Agent Skill for structured persuasion—**your work deserves to be seen.** |
| 8 | |
| 9 | Writing good code is a skill. Getting leaders to understand what you shipped, trust your judgment, and act on your recommendations is a bigger one. |
| 10 | |
| 11 | Most people only practice the first. |
| 12 | |
| 13 | pitchcraft is a **structured persuasion framework** for project kickoffs, status updates, wrap-ups, investor pitches, and solution selling. It is not a writing template—it helps you translate what you built into language your audience understands, trusts, and acts on. |
| 14 | |
| 15 | **Influence is not innate—it can be structured.** |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | ## Why this project exists |
| 20 | |
| 21 | In the AI era, execution is commoditized; persuasion compounds. AI can write code, but explaining _why now_, _why us_, and _why this matters_ to decision-makers still needs you—AI can make you better at it. |
| 22 | |
| 23 | pitchcraft turns that from a gift into a **repeatable workflow**: |
| 24 | |
| 25 | > One persuasion structure + scenario templates + AI-driven material intake + pre-submit checklist. |
| 26 | |
| 27 | ## How it differs from “AI weekly report” tools |
| 28 | |
| 29 | | | Generic AI reports | pitchcraft | |
| 30 | | --------- | ---------------------------- | -------------------------------------------------------------------- | |
| 31 | | Scenarios | Weekly/monthly activity logs | Kickoff, status, wrap-up, pitch, solution selling | |
| 32 | | Goal | Record work | Persuade and secure support | |
| 33 | | AI role | Fill-in-the-blank | Ask what’s missing, who’s in the room, what they care about | |
| 34 | | Core idea | “What we did” | “Why they should care” | |
| 35 | | Memory | None | Leader context, business positioning, format prefs (when configured) | |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | ## Framework: 5-part persuasion structure |
| 40 | |
| 41 | Every scenario shares the same backbone; section emphasis changes: |
| 42 | |
| 43 | ``` |
| 44 | Hook → Context → Proposal → Evidence → Ask |
| 45 | ``` |
| 46 | |
| 47 | | Scenario | Hook focus | Evidence focus | Ask | |
| 48 | | ---------------- | ----------------------- | ------------------- | ----------------------- | |
| 49 | | Project kickoff | Pain / opportunity | Why us (moat) | Resources, approval | |
| 50 | | Status update | Headline takeaway | Key metrics | Decisions, coordination | |
| 51 | | Wrap-up / annual | Goal attainment | Quantified outcomes | Next phase or handoff | |
| 52 | | Investor pitch | Market space | Moat + traction | Investment, partnership | |
| 53 | | Solution selling | Customer pain alignment | Cases + data | Deal, next steps | |
| 54 | |
| 55 | --- |
| 56 | |
| 57 | ## Install |
| 58 | |
| 59 | ### npm / npx |
| 60 | |
| 61 | ```bash |
| 62 | # Global (~/.claude/skills/pitchcraft/) |
| 63 | npm install -g pitchcraft |
| 64 | ``` |
| 65 | |
| 66 | Also works with the [Vercel skills CLI](https://github.com/vercel-labs/skills): |
| 67 | |
| 68 | ```bash |
| 69 | npx skills add moshuying/pitchcraft -a claude-code -a cursor -y |
| 70 | ``` |
| 71 | |
| 72 | Publish: `npm publish` (scoped: set `"name": "@moshuying/pitchcraft"` if `pitchcraft` is taken on npm). |
| 73 | |
| 74 | ### Claude Code |
| 75 | |
| 76 | ``` |
| 77 | /plugin marketplace add moshuying/pitchcraft |
| 78 | /plugin install pitchcraft |
| 79 | ``` |
| 80 | |
| 81 | Or tell your agent: |
| 82 | |
| 83 | ``` |
| 84 | Install pitchcraft for me: https://github.com/moshuying/pitchcraft |
| 85 | ``` |
| 86 | |
| 87 | Restart, then use a trigger phrase below. The plugin installs the English `SKILL.md` by default. For Chinese, copy `SKILL.zh-CN.md` over `SKILL.md` (see **Localization**). |
| 88 | |
| 89 | ### SkillsMP / GitHub discovery |
| 90 | |
| 91 | [SkillsMP](https://skillsmp.com) auto-indexes repos with a root `SKILL.md` and valid frontmatter (`name`, `description`). This repo keeps root `SKILL.md` in sync with `.claude/skills/pitchcraft/SKILL.md` for crawlers and the Claude Code plugin. |
| 92 | |
| 93 | On GitHub: **Settings → General → Topics** → add `claude-skills` or `claude-code-skill` (daily sync). |
| 94 | |
| 95 | ### Cursor / Codex / other AI tools |
| 96 | |
| 97 | | Tool | How | |
| 98 | | -------------------- | ------------------------------------------------------------------------ | |
| 99 | | Cursor | Paste `prompts/universal.md` (or `universal.zh-CN.md`) into Rules for AI | |
| 100 | | Codex CLI | Same content as system instructions | |
| 101 | | ChatGPT / Claude web | Paste the prompt file into the chat | |
| 102 | |
| 103 | ### Trigger phrases |
| 104 | |
| 105 | **English** |
| 106 | |
| 107 | - **status update** / **briefing** — cross-level update, 15 minutes to set the tone |
| 108 | - **project kickoff** — persuade leadership to approve and fund |
| 109 | - **milestone review** — sync progress, keep investment |
| 110 | - **wrap-up** / **retrospective** — goals, outcomes, assets |
| 111 | - **pitch** / **fundraising** — investors or partners |
| 112 | - **solution selling** — customer decision-makers |
| 113 | |
| 114 | **中文(使用 `SKILL.zh-CN.md` 或 `universal.zh-CN.md` 时)** |
| 115 | |
| 116 | - **汇报** |