convez.ai
SkillProdutividadeIntermediário
moshuying

PitchCraft - Framework de Persuasão Estruturada

moshuying/pitchcraft

Transforme execução técnica em linguagem que influencia decisões

Ver no GitHub
BomPluginScore · de 0 a 100

Skill de estruturação de comunicação persuasiva para tech leads, PMs e founders. Oferece framework em 5 partes (Hook→Contexto→Proposta→Evidência→Pedido) adaptável a kickoffs, status updates, pitches e vendas consultivas, com intake de materiais assistido por IA e checklist pré-submissão.

Instalação

$npx convez-ai moshuying/pitchcraft

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
202
Forks
19
Acompanhando
6
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Estruturar kickoffs de projeto com propostas convincentes
  • Comunicar status updates que pedem ação imediata
  • Preparar investor pitches com narrativa clara e dados
  • Venda consultiva (solution selling) baseada em dor do cliente
  • Wraps anuais com comprovação quantificada de resultados

Veredito

Skill bem pensado que endereça gap real: código bom não vence sem persuasão estruturada. O framework 5-partes é genérico o bastante para reutilização, e a integração com Claude torna a intake de materiais e iteração fluida. Prático para quem precisa comunicar impacto com regularidade.

README

A tradução para o português deste README ainda está na fila.

pitchcraft (汇报.Skill)

Languages: English · 简体中文

License: Apache License 2.0

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.

Most people only practice the first.

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.

Influence is not innate—it can be structured.


Why this project exists

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.

pitchcraft turns that from a gift into a repeatable workflow:

One persuasion structure + scenario templates + AI-driven material intake + pre-submit checklist.

How it differs from “AI weekly report” tools

Generic AI reportspitchcraft
ScenariosWeekly/monthly activity logsKickoff, status, wrap-up, pitch, solution selling
GoalRecord workPersuade and secure support
AI roleFill-in-the-blankAsk what’s missing, who’s in the room, what they care about
Core idea“What we did”“Why they should care”
MemoryNoneLeader context, business positioning, format prefs (when configured)

Star History

Framework: 5-part persuasion structure

Every scenario shares the same backbone; section emphasis changes:

Hook → Context → Proposal → Evidence → Ask
ScenarioHook focusEvidence focusAsk
Project kickoffPain / opportunityWhy us (moat)Resources, approval
Status updateHeadline takeawayKey metricsDecisions, coordination
Wrap-up / annualGoal attainmentQuantified outcomesNext phase or handoff
Investor pitchMarket spaceMoat + tractionInvestment, partnership
Solution sellingCustomer pain alignmentCases + dataDeal, next steps

Install

npm / npx

# Global (~/.claude/skills/pitchcraft/)
npm install -g pitchcraft

Also works with the Vercel skills CLI:

npx skills add moshuying/pitchcraft -a claude-code -a cursor -y

Publish: npm publish (scoped: set "name": "@moshuying/pitchcraft" if pitchcraft is taken on npm).

Claude Code

/plugin marketplace add moshuying/pitchcraft
/plugin install pitchcraft

Or tell your agent:

Install pitchcraft for me: https://github.com/moshuying/pitchcraft

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).

SkillsMP / GitHub discovery

SkillsMP 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.

On GitHub: Settings → General → Topics → add claude-skills or claude-code-skill (daily sync).

Cursor / Codex / other AI tools

ToolHow
CursorPaste prompts/universal.md (or universal.zh-CN.md) into Rules for AI
Codex CLISame content as system instructions
ChatGPT / Claude webPaste the prompt file into the chat

Trigger phrases

English

  • status update / briefing — cross-level update, 15 minutes to set the tone
  • project kickoff — persuade leadership to approve and fund
  • milestone review — sync progress, keep investment
  • wrap-up / retrospective — goals, outcomes, assets
  • pitch / fundraising — investors or partners
  • solution selling — customer decision-makers

中文(使用 SKILL.zh-CN.md 或 universal.zh-CN.md 时)

  • 汇报 / 简报 · 立项汇报 · 阶段汇报 · 结项总结 · 路演 · 方案推销

How it helps

pitchcraft is not a magic wand. The workflow:

  1. Pick a scenario — kickoff, status, wrap-up, pitch, or solution selling
  2. Intake materials — AI checks completeness and asks for gaps
  3. Understand the audience — role, familiarity, concerns shape the draft
  4. Draft to structure — 5-part framework, stay on message
  5. Run the checklist — sourced metrics? risks with judgment?

You focus on substance; structure and checks are handled by the framework and AI.


Localization

FileLanguage
README.mdEnglish (default)
README.zh-CN.md简体中文
prompts/universal.mdEnglish
prompts/universal.zh-CN.md简体中文
.claude/skills/pitchcraft/SKILL.mdEnglish (plugin default)
.claude/skills/pitchcraft/SKILL.zh-CN.md简体中文

Repository layout

pitchcraft/
├── SKILL.md                      # Root skill (SkillsMP / lazy-load index)
├── package.json                  # npm install → .claude/skills/pitchcraft/
├── scripts/install.js
├── .claude/
│   └── skills/pitchcraft/
│       ├── SKILL.md              # English (plugin install source)
│       └── SKILL.zh-CN.md
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── commands/
│   ├── pitchcraft.md
│   └── pitchcraft.zh-CN.md
├── prompts/
│   ├── universal.md
│   └── universal.zh-CN.md
├── README.md
├── README.zh-CN.md
├── LICENSE
└── .gitignore

Further reading

Ideas drawn from:

  • Malcolm Gladwell — Blink: first impressions; the first 10 seconds of a briefing matter.
  • Malcolm Gladwell — The Tipping Point: how ideas spread; persuasion lowers acceptance friction.
  • Chip Heath & Dan Heath — Made to Stick: SUCCESs (Simple, Unexpected, Concrete, Credible, Emotional, Stories).
  • Robert Cialdini — Influence: reciprocity, commitment, social proof, liking, authority, scarcity.
  • Nancy Duarte — Resonate: tension between “what is” and “what could be.”
  • Barbara Minto — The Pyramid Principle: conclusion first, MECE, hierarchy.
  • Anne-Laure Le Cunff — Tiny Experiments: decisions and progress under uncertainty.

What it is / isn’t

Not

  • ❌ “AI writes my weekly status” — activity logs are out of scope
  • ❌ A repeat of The Pyramid Principle — concrete, executable templates, not principles only
  • ❌ Flattery or scripts — the goal is accurate understanding of your work

Is

  • ✅ Structured persuasion for “limited time, specific audience, clear ask”
  • ✅ One framework, five scenario instances—learn kickoff, reuse for pitches
  • ✅ Checklists so you don’t skip metrics, risks, or audience fit
  • ✅ In the AI era, make execution visible, credible, and amplified

Status

v1.0 — core framework, 5 scenario templates, workflow, checklist, cross-platform install, EN + zh-CN

Planned: Japanese / Korean; web writing assistant; more scenarios (incident review, tech review, OKR alignment)


License

Apache 2.0.


Author

Created by @jiujiangliu. Refined through real executive and stakeholder briefings.

Ver o original no GitHub

Bom para

Relacionados