Skip to content
Generate a pitch logo

Generate a pitch

Define the scope of an article or newsletter at the beginning of the drafting an article or newsletter

mattnigh/skills_collection0installs24stars

SKILL.md

Full skill instructions

Generate a pitch

Overview

A pitch is a critical step in writing a blog that ensures that the aim of the post is clear and within a manageable scope. At the start of the writing process, your human partner is likely to be excited with fresh ideas. Your role is to refine and distil that energy into a single paragraph of not more than 150-200 words.

Success criteria

The pitch is perfect when:

  1. It can be used to develop an outline of a suitable length. Remember: newsletter articles are roughly 4-6 minutes reading time, while blogs can be 9 minutes reading time or more. Let us keep to these guidelines so that we will have an end goal to complete writing.
  2. It should be obvious that the final product will be engaging and worth reading to our audience. If we are not sure, let's consult our subagents for more direction.
  3. It should be possible to see what kinds of research are needed to produce a valuable and helpful article. Such research can also include content from previous posts to form a story.
  4. It should be in a narrative form, that is it should have a title and a single paragraph of not more than 150-200 words.

Remember that this is at an early stage of writing, so even if we are unable to fulfil any of the above criteria, as long as the human partner believes that this is a good post to write about, we should continue.

The process

Step 0: Create TodoWrite task list

Before starting pitch development, create a comprehensive todo list to track the entire post creation workflow:

- Develop pitch (brainstorming if needed)
- Research supporting evidence
- Draft content
- Content quality audit
- Target audience review
- Backlink curation
- Publish to Ghost
- Check published post and sync repo
- Update discussion notes

This ensures all quality checks are tracked from the start and never skipped.

Step 1: An idea

The human partner has suggested an idea which is suitable for developing a pitch. If it is still too vague, use "skills/​brainstorming" and feedback from sub-agents to give it more details and direction.

Step 2: Develop the pitch

From the idea, generate a pitch. You must imagine that we are in an elevator with our readers and so we only have a limited time to tell them what our blog post will be about. We want to persuade them to spend time from their daily lives to read our newsletter or blog article.

Present a draft title and pitch to the human partner and ask: "Does it look alright?" Once the human partner approves, we can move on to the next step.

Step 3: Authenticity Check

It is important to interrogate what is my personal angle in every post to ensure that I am writing my blog and not AI. Let us avoid authenticity issues so that we don't need to conduct expensive rewrites. Ensure that the pitch is coming from me and not from others.

For each claim in pitch:

  • Is this true to my experience? (Not aspirational or third-person)
  • Can I cite a specific moment when I felt/​learned this?
  • Am I framing someone else's work as mine?
  • Am I claiming expertise I don't have?

Red flags:

  • "I learned that..." (Did you? Or did you always know this?)
  • "Others might think..." (Distancing language)
  • "One should..." (Who? Be specific)

Step 4: Suggest Tags

After the pitch is approved, use the tag-registry skill to suggest appropriate tags:

  • Analyze the pitch content to identify themes and topics
  • Suggest 3-4 tags from the canonical registry
  • Ensure at least 1 Core Topic tag is included
  • Include the suggested tags in the pitch.md file

This early tag planning helps maintain consistency and prevents tag sprawl during publishing.

Step 5: Scaffold the post

  • Create the folder structure using the title, for example "posts/​ai-vs-lawyers-newsletter"
  • Save the pitch in that folder under the file "pitch.md" (including suggested tags)
  • Save the discussion using "skills/​note-taking" under the file "note-taking.md"
  • Save any documents or links discussed during the process under the folder

Once this process is completed, you should ask the human partner whether you can develop the outline of the article.

More skills from mattnigh

spring-framework-patterns logo
mattnigh/skills_collection

spring-framework-patterns

Comprehensive Spring Framework and Spring Boot best practices including dependency injection patterns, bean lifecycle and scopes, REST API development, Spring Data JPA, service layer design, Spring Security, testing strategies, caching, AOP, async processing, error handling, and common anti-patte...

24 0
View

TypeScript厳格モードによる型安全性設計を専門とするスキル。 📖 参照書籍: - 『Effective TypeScript』(Dan Vanderkam): 型設計 📚 リソース参照: - `resources/Level1_basics.md`: レベル1の基礎ガイド - `resources/Level2_intermediate.md`: レベル2の実務ガイド - `resources/Level3_advanced.md`: レベル3の応用ガイド - `resources/Level4_expert.md`: レベル4の専門ガイド - `resources/di...

24 0
View
deploying-cloud-k8s logo
mattnigh/skills_collection

deploying-cloud-k8s

Deploys applications to cloud Kubernetes (AKS/GKE/DOKS) with CI/CD pipelines. Use when deploying to production, setting up GitHub Actions, troubleshooting deployments. Covers build-time vs runtime vars, architecture matching, and battle-tested debugging.

24 0
View
moai-alfred-agent-guide logo
mattnigh/skills_collection

moai-alfred-agent-guide

19-agent team structure, decision trees for agent selection, Haiku vs Sonnet model selection, and agent collaboration principles. Use when deciding which sub-agent to invoke, understanding team responsibilities, or learning multi-agent orchestration.

24 0
View
mermaid-diagram-generator logo
mattnigh/skills_collection

mermaid-diagram-generator

Converts architecture descriptions, module specs, or workflow docs into Mermaid diagrams. Use when visualizing brick module relationships, workflows (DDD, investigation), or system architecture. Supports: flowcharts, sequence diagrams, class diagrams, state machines, entity relationship diagrams,...

24 0
View
pre-flight-check logo
mattnigh/skills_collection

pre-flight-check

INVOKE FIRST before any code work. Validates git workflow (branch, issue, worklog) and checks approach. Use at START of every task and END before completing. Prevents skipped steps.

24 0
View
browser-dev-tools logo
mattnigh/skills_collection

browser-dev-tools

This skill should be used when working with browser-rendered artifacts (i.e. Bun, React/React Native) to proactively validate that development work on localhost is being built appropriately and to support debugging browser-rendered content. Use this skill after making frontend changes to verify t...

24 0
View
lead-dev logo
mattnigh/skills_collection

lead-dev

Lead Développeur - Coordination technique opérationnelle, code review, mentoring et livraison. Pair de web-dev-process au niveau OPÉRATIONS.

24 0
View
worker-monitor logo
mattnigh/skills_collection

worker-monitor

Monitor Docker workers, RQ queue health, and auto-scale workers (max 4). Use when: checking job progress, monitoring queue depth, scaling workers up/down, diagnosing slow processing, or waiting for jobs to complete. Referenced by data-quality skill during reprocessing.

24 0
View
quality-advisor logo
mattnigh/skills_collection

quality-advisor

Proactive quality guidance system that monitors artifact creation and provides real-time feedback on documentation quality

24 0
View
bump-version logo
mattnigh/skills_collection

bump-version

This skill should be used when the user wants to bump the version number in the workspace. It updates versions across all pyproject.toml files (root, tde, and tda packages) and the CHANGELOG.md to keep them synchronized.

24 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View