/pitchcraft
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;
$ npx -y skills add moshuying/pitchcraft --skill pitchcraft --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/pitchcraft
Context preview
The summary Claude sees to decide when to auto-load this skill.
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;
SKILL.md
pitchcraft.SKILL.mdname: pitchcraft
description: 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.
**Languages:** English (this file) · 简体中文 → `SKILL.zh-CN.md`
Persuasive briefings · Workflow
Essence
This is not report writing—it is **persuasion**. In every scenario you do the same thing:
> In limited time, help a specific audience understand context, trust your judgment, and provide the support you need.
Users & scenarios
| Role | Scenarios | Audience | |---|---|---| | Tech lead / engineering manager | Kickoff, milestone review, wrap-up | Business leaders, CTO, PMO | | PM / product lead | Quarterly review, annual summary, requirements review | Director, VP | | Founder / business owner | Investor pitch | Investors, partners | | Pre-sales / solutions | Solution selling | Customer execs, technical evaluators |
---
Core: 5-part persuasion framework
All briefing types share one backbone; section emphasis differs.
Part 1 · Hook
→ Why should they keep listening?
→ Opportunity / pain / urgency
Part 2 · Context
→ What is the situation?
→ What we have done and what we have
Part 3 · Proposal
→ What we will do / did?
→ Scope, path, pace
Part 4 · Evidence
→ Why we can succeed / succeeded?
→ Data, moat, team, cases
Part 5 · Ask
→ What do we need from them?
→ Decision / resources / partnership / investment
---
Briefing types & templates
Each type is an instance of the 5-part framework.
Project kickoff
**Goal:** Get leadership to approve start and allocate people and budget.
| Part | Section | Focus | |---|---|---| | Hook | Background & opportunity | Market, pain, competition, why now | | Context | What we already have | Team, tech, data, prior assets | | Proposal | Goals & scope | In/out of scope, milestones | | Evidence | Why us | Differentiation, moat | | Ask | Resources & risks | Support needed, top risks and mitigation |
# {Project} · Kickoff
## Background & opportunity
{Why now: market, pain, competition—2–4 sentences.
This is the persuasion entry—create “we should do this.”}
## What we already have
{Team, tech, data, business assets—not bragging, but trust.
Pattern: “We already have X, so this is not from zero.”}
## Goals & scope
**In scope**: {capabilities}
**Out of scope**: {explicit exclusions—prevent scope creep}
{Milestones and timeline}
## Why us
{Core difference vs alternatives. Moat: why others can’t or won’t match.}
## Resources & risks
{People / budget / cross-team needs
Top risk and mitigation}Status update
**Goal:** Convince leaders and stakeholders the work is on track and worth continued investment.
| Part | Section | Focus | |---|---|---| | Hook | One-line summary | 1–2 most important facts this period | | Context | Period context | Position vs last period | | Proposal | Key progress | By milestone or module | | Evidence | Key metrics | Progress, quality, efficiency | | Ask | Risks & decisions | Decisions and coordination needed |
# {Project} · Status update
## One-line summary
{1–2 facts; audience grasps core in 10 seconds}
## Key progress
{Completed items and metrics by milestone or module}
## Risks & response
Formula per item: {symptom} → {root cause} → {mitigation} → {status}
Decisions: options + recommendation—no open homework:
❌ "Dependency X uncertain—please advise"
✅ "Dependency X slipped 2 weeks. Option A (add people) vs B (move milestone). Recommend A; need Team Y support."
## Next phase
| Item | ETA | Dependencies | Risk |
|---|---|---|---|Wrap-up / annual review
**Goal:** Show delivered value and assets retained.
| Part | Section | Focus | |---|---|---| | Hook | Goal attainment overview | Did we succeed overall? | | Context | Original goals | What we committed to | | Evidence | Quantified outcomes | Data-led | | Proposal | Lessons & assets | What remains | | Ask | Next phase or handoff | What happens next |
# {Project} · Wrap-up / {Year} annual review
## Goal attainment
| Goal | Target | Actual | % | Notes |
|---|---|---|---|---|
Underperformance: root cause and improvement—say it before they ask.
## Core deliverables
3–5 items, each: {what} + {metric} + {business impact}
## Lessons
- **What worked**: reusable methods / architecture / process
- **What failed**: root cause + prevention
- **Assets left**: code / data / docs / team capability
## Next
If continuing → direction, goals, key results, resources
If ending → handoff so nothing is left unsupportedInvestor pitch
**Goal:** Spark interest for a deeper conversation.
| Part | Section | Focus | |---|---|---| | Hook | One-liner | Elevator pitch | | Context | Market opportunity | Size, pain, why now | | Proposal | Product | Solution, core features, stage | | Evidence | Moat & traction | Tech, data, growth, team | | Ask | Funding / partnership | Amount, use, milestones |
# {Project} · Pitch
## One-liner
{What we do, for whom, what value}
## Market opportunity
{Size, persona, pain, why now}
## Product
{How we solve, core features, architecture (brief), stage}
## Moat & traction
**Moat**: {tech / data / network / team—why others can’t}
**Metrics**: {users, growth, retention, revenue}
**Team**: {why this team can execute}
## Funding ask
{Amount, use of funds, milestones, next round goal}Solution selling
**Goal:** Convince customer executives your solution is the best fit.
| Part | Section | Focus | |---|---|---| | Hook | Pain alignment | Their problem in their words | | Context | Current state | Gaps in status quo | | Proposal | Solution | How we solve | | Evidence | Cases & data | Proof | | Ask | Partnership | How to start |
# {Project} · Proposal
## Pain alRead more
name: pitchcraft description: 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.
**Languages:** English (this file) · 简体中文 → `SKILL.zh-CN.md`
Persuasive briefings · Workflow
Essence
This is not report writing—it is **persuasion**. In every scenario you do the same thing:
> In limited time, help a specific audience understand context, trust your judgment, and provide the support you need.
Users & scenarios
| Role | Scenarios | Audience | |---|---|---| | Tech lead / engineering manager | Kickoff, milestone review, wrap-up | Business leaders, CTO, PMO | | PM / product lead | Quarterly review, annual summary, requirements review | Director, VP | | Founder / business owner | Investor pitch | Investors, partners | | Pre-sales / solutions | Solution selling | Customer execs, technical evaluators |
---
Core: 5-part persuasion framework
All briefing types share one backbone; section emphasis differs.
Part 1 · Hook → Why should they keep listening? → Opportunity / pain / urgency Part 2 · Context → What is the situation? → What we have done and what we have Part 3 · Proposal → What we will do / did? → Scope, path, pace Part 4 · Evidence → Why we can succeed / succeeded? → Data, moat, team, cases Part 5 · Ask → What do we need from them? → Decision / resources / partnership / investment
---
Briefing types & templates
Each type is an instance of the 5-part framework.
Project kickoff
**Goal:** Get leadership to approve start and allocate people and budget.
| Part | Section | Focus | |---|---|---| | Hook | Background & opportunity | Market, pain, competition, why now | | Context | What we already have | Team, tech, data, prior assets | | Proposal | Goals & scope | In/out of scope, milestones | | Evidence | Why us | Differentiation, moat | | Ask | Resources & risks | Support needed, top risks and mitigation |
# {Project} · Kickoff
## Background & opportunity
{Why now: market, pain, competition—2–4 sentences.
This is the persuasion entry—create “we should do this.”}
## What we already have
{Team, tech, data, business assets—not bragging, but trust.
Pattern: “We already have X, so this is not from zero.”}
## Goals & scope
**In scope**: {capabilities}
**Out of scope**: {explicit exclusions—prevent scope creep}
{Milestones and timeline}
## Why us
{Core difference vs alternatives. Moat: why others can’t or won’t match.}
## Resources & risks
{People / budget / cross-team needs
Top risk and mitigation}Status update
**Goal:** Convince leaders and stakeholders the work is on track and worth continued investment.
| Part | Section | Focus | |---|---|---| | Hook | One-line summary | 1–2 most important facts this period | | Context | Period context | Position vs last period | | Proposal | Key progress | By milestone or module | | Evidence | Key metrics | Progress, quality, efficiency | | Ask | Risks & decisions | Decisions and coordination needed |
# {Project} · Status update
## One-line summary
{1–2 facts; audience grasps core in 10 seconds}
## Key progress
{Completed items and metrics by milestone or module}
## Risks & response
Formula per item: {symptom} → {root cause} → {mitigation} → {status}
Decisions: options + recommendation—no open homework:
❌ "Dependency X uncertain—please advise"
✅ "Dependency X slipped 2 weeks. Option A (add people) vs B (move milestone). Recommend A; need Team Y support."
## Next phase
| Item | ETA | Dependencies | Risk |
|---|---|---|---|Wrap-up / annual review
**Goal:** Show delivered value and assets retained.
| Part | Section | Focus | |---|---|---| | Hook | Goal attainment overview | Did we succeed overall? | | Context | Original goals | What we committed to | | Evidence | Quantified outcomes | Data-led | | Proposal | Lessons & assets | What remains | | Ask | Next phase or handoff | What happens next |
# {Project} · Wrap-up / {Year} annual review
## Goal attainment
| Goal | Target | Actual | % | Notes |
|---|---|---|---|---|
Underperformance: root cause and improvement—say it before they ask.
## Core deliverables
3–5 items, each: {what} + {metric} + {business impact}
## Lessons
- **What worked**: reusable methods / architecture / process
- **What failed**: root cause + prevention
- **Assets left**: code / data / docs / team capability
## Next
If continuing → direction, goals, key results, resources
If ending → handoff so nothing is left unsupportedInvestor pitch
**Goal:** Spark interest for a deeper conversation.
| Part | Section | Focus | |---|---|---| | Hook | One-liner | Elevator pitch | | Context | Market opportunity | Size, pain, why now | | Proposal | Product | Solution, core features, stage | | Evidence | Moat & traction | Tech, data, growth, team | | Ask | Funding / partnership | Amount, use, milestones |
# {Project} · Pitch
## One-liner
{What we do, for whom, what value}
## Market opportunity
{Size, persona, pain, why now}
## Product
{How we solve, core features, architecture (brief), stage}
## Moat & traction
**Moat**: {tech / data / network / team—why others can’t}
**Metrics**: {users, growth, retention, revenue}
**Team**: {why this team can execute}
## Funding ask
{Amount, use of funds, milestones, next round goal}Solution selling
**Goal:** Convince customer executives your solution is the best fit.
| Part | Section | Focus | |---|---|---| | Hook | Pain alignment | Their problem in their words | | Context | Current state | Gaps in status quo | | Proposal | Solution | How we solve | | Evidence | Cases & data | Proof | | Ask | Partnership | How to start |
# {Project} · Proposal
## Pain alLanguages: English · 简体中文 A Claude Agent Skill for structured persuasion—your work deserves to be seen. 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.

