Menu
Generates a detailed, SEO-optimized blog post outline with H2/H3 structure, key points per section, and a hook.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Runs a systematic checklist review on any code diff or file, covering correctness, security, performance, and readability.
Writes a high-quality CLAUDE.md, .cursorrules, or .windsurfrules file that gives a coding agent the right project context, conventions, and constraints to work effectively.
Designs an eval suite for an LLM agent or pipeline including success metrics, trajectory scoring, LLM-as-judge setup, and regression test cases.
Designs a hybrid retrieval pipeline combining dense vector search and BM25 sparse search with reciprocal rank fusion, and explains when to use each configuration.
Converts a workflow description into a LangGraph node/edge graph with typed state, conditional routing, and human-in-the-loop checkpoints.
Audits an AI application for unnecessary token spend and recommends prompt caching, model routing, and token reduction techniques to cut costs.
| name | Blog Outline Generator |
| description | Generates a detailed, SEO-optimized blog post outline with H2/H3 structure, key points per section, and a hook. |
| category | writing |
| tags | ["blog","writing","content","seo","outline"] |
| author | simplyutils |
This skill produces a complete, ready-to-write blog post outline for any topic. Given a subject and target audience, it generates multiple title options, a meta description, an intro hook angle, 5โ7 H2 sections with H3 sub-points under each, a CTA suggestion, and internal link opportunities. The output is structured to satisfy SEO requirements while giving a writer a clear narrative arc to follow.
Use this before writing any long-form blog post. A strong outline cuts writing time in half and ensures the post is complete, well-structured, and optimized for the primary keyword before you write a single sentence.
Copy this file to .agents/skills/blog-outline-generator/SKILL.md in your project root.
Then ask:
Provide the topic, primary keyword, target audience, and approximate word count target if you have them.
Add the "Prompt / Instructions" section to your .cursorrules file. Describe the blog topic in the chat.
Describe the blog topic, target audience, and primary keyword you want to rank for. Include the instructions below.
When asked to generate a blog outline, follow these steps:
Clarify the parameters (use what's provided; ask only if critical information is missing):
Generate 3 title options. Each title should:
Write a meta description (150โ160 characters):
Design the intro hook. Suggest one of these proven hook angles:
Write 2โ3 sentences for the suggested hook.
Create 5โ7 H2 sections that form a logical narrative arc:
Suggest a CTA for the post conclusion:
List 3โ5 internal link opportunities:
Output format:
## Blog Post Outline: [TOPIC]
### Keyword & Audience
- **Primary keyword:** [keyword]
- **Target audience:** [audience]
- **Tone:** [tone]
- **Target length:** [word count]
---
### Title Options
1. [Title option 1] *(XX chars)*
2. [Title option 2] *(XX chars)*
3. [Title option 3] *(XX chars)*
### Meta Description
[150โ160 character meta description]
---
### Intro Hook
**Angle:** [Hook type]
[2โ3 sentence hook]
---
### Outline
**H1:** [Chosen or recommended title]
**H2: [Section 1 title]**
- H3: [Sub-point] โ [1-sentence description]
- H3: [Sub-point] โ [1-sentence description]
**H2: [Section 2 title]**
- H3: ...
...
---
### CTA Suggestion
[One-sentence CTA]
### Internal Link Opportunities
- In "[Section]", mention [topic] โ link to a post about [related topic]
...
Input to Agent:
"Use the Blog Outline Generator skill. Topic: how to do code reviews effectively. Primary keyword: 'code review best practices'. Audience: mid-level software engineers. Tone: practical and direct. Target: ~1500 words."
Output from Agent:
Blog Post Outline: Code Review Best Practices
Keyword & Audience
- Primary keyword: code review best practices
- Target audience: mid-level software engineers
- Tone: Practical and direct
- Target length: ~1500 words
Title Options
- 10 Code Review Best Practices That Actually Improve Your Team (62 chars)
- How to Do Code Reviews That Don't Waste Everyone's Time (56 chars)
- Are Your Code Reviews Hurting Your Team? Here's How to Fix Them (64 chars)
Meta Description
Learn code review best practices that speed up merges, reduce bugs, and build team trust โ without turning reviews into a chore. Start here.
Intro Hook
Angle: Pain point opener You've left a pull request open for three days. The reviewer left 47 comments, half of them about formatting. The author rewrote half the file. And somehow the bug you both missed shipped to production anyway. Code reviews don't have to work this way.
Outline
H1: 10 Code Review Best Practices That Actually Improve Your Team
H2: Why Most Code Reviews Fail (And What They Should Actually Do)
- H3: The two jobs of a code review โ Distinguish between catching bugs and sharing knowledge; most teams only do one.
- H3: The review anti-patterns killing your team's velocity โ Cover the most common failure modes: nitpick spirals, rubber-stamping, and review hoarding.
H2: Before You Open the PR โ Set Reviews Up for Success
- H3: Keep PRs small and focused โ Explain the research behind PR size and review quality.
- H3: Write a useful PR description โ What to include so reviewers understand the "why" without reading every line.
- H3: Self-review before requesting โ The fast mental checklist authors should run before tagging someone.
H2: How to Give Feedback That Actually Gets Acted On
- H3: The difference between blocking and non-blocking comments โ Introduce the
nit:/blocking:/question:prefix convention.- H3: Explain the "why," not just the "what" โ How to write comments that teach, not just criticize.
- H3: Ask questions instead of making demands โ Reframe feedback as curiosity to reduce defensiveness.
H2: How to Receive a Review Without Getting Defensive
- H3: Separate yourself from your code โ Practical reframe for taking feedback professionally.
- H3: Responding to comments efficiently โ The "resolve vs. reply vs. push back" decision framework.
H2: Automate the Boring Parts
- H3: What linters, formatters, and CI should catch โ Free your reviewers for logic, not style.
- H3: The tools worth setting up (ESLint, Prettier, GitHub Actions) โ Quick practical list.
H2: Common Code Review Mistakes (And How to Avoid Them)
- H3: Reviewing for too long โ Why diminishing returns kick in after 60 minutes.
- H3: Approving without reading โ The "LGTM" problem and how to prevent it culturally.
- H3: Making it personal โ Red flags in review culture and how to course-correct.
H2: Building a Code Review Culture Your Team Actually Respects
- H3: Set team norms explicitly โ How to run a 30-minute team session to agree on review standards.
- H3: Track review time as a metric โ Why treating review latency as a team health metric changes behavior.
CTA Suggestion
Share this with your team and pick one practice to try in your next sprint โ even one change can cut your average PR merge time significantly.
Internal Link Opportunities
- In "Automate the Boring Parts," mention CI/CD โ link to a post about setting up GitHub Actions
- In "Keep PRs Small," mention git branching โ link to a post about Git branching strategies
- In the intro, mention debugging โ link to a post about debugging techniques