Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Full content production pipeline from blank page to publish-ready piece: research, briefs, drafting, SEO, readability, and editorial gates. Use when writing blog posts, articles, guides, or long-form content end-to-end at scale.
.claude/skills/borghei-content-production/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-05 | ✗→✓ | ▲ Improved | 402% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 178% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 219% | 0% |
| case-09 | ✗→✓ | ▲ Improved | 348% | 0% |
| case-12 | ✗→✓ | ▲ Improved | 187% | 0% |
The execution engine for content — taking topics from blank page to published, optimized, and distributed.
content production, blog writing, article drafting, content pipeline, editorial workflow, content operations, content calendar, content brief, SEO content, content optimization, readability, internal linking, meta tags, content repurposing, content at scale, editorial calendar, content quality, publishing workflow, long-form content, content management
Before producing the content, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Step 1: Competitive Content Analysis
Before writing, understand what already ranks for your target keyword:
| URL | Format | Word Count | Key Angle | What's Missing | |-----|--------|-----------|-----------|----------------| | URL 1] | How-to guide | 2,400 | Step-by-step technical | No real-world examples | | URL 2] | Listicle | 1,800 | Tools comparison | Outdated, 2023 data | | URL 3] | Expert roundup | 3,100 | Multiple perspectives | No actionable framework |
| SERP Pattern | Intent | What to Write | |-------------|--------|---------------| | "What is / How to" dominate | Informational | Comprehensive guide or explainer | | Product pages, reviews | Commercial | Comparison or buyer's guide | | Forum results (Reddit, Quora) | Discovery | Opinionated piece with real perspective | | News, recent articles | Trending | Timely take with unique angle |
Step 2: Source Gathering
Collect 3-5 credible, citable sources before drafting:
Rule: If you cannot cite a specific number, do not make a vague claim.
Step 3: Produce the Content Brief
markdown## Content Brief ### Target - Primary keyword: [keyword] (volume: [X], difficulty: [X]) - Secondary keywords: [keyword 1], [keyword 2], [keyword 3] - Search intent: [Informational / Commercial / Transactional] ### Audience - Reader profile: [Who they are and what they know] - Job-to-be-done: [What problem they are solving right now] - Awareness level: [Unaware / Problem-aware / Solution-aware] ### Angle - Unique perspective: [What makes this piece different] - Core argument: [The single thesis of this piece] - Key claims to prove: [3-5 specific claims with supporting evidence] ### Structure - H1: [Working title] - H2: [Section 1] - H2: [Section 2] - H2: [Section 3] - H2: [Section 4] - H2: [Conclusion / Next Steps] ### Requirements - Target word count: [X] - Internal links to include: [List existing pages to link to] - Competitive pieces to beat: [Top 3 URLs to outperform] - CTA: [What action should the reader take]
Step 1: Build the Outline
Before writing prose, create the header skeleton:
Step 2: Write the Introduction
The intro has one job: make the reader believe this piece answers their question.
Formula:
What to avoid:
Step 3: Write Section by Section
For each H2:
Step 4: Write the Conclusion
Three elements:
Run these passes in order on every draft:
Pass 1: SEO Optimization
Pass 2: Readability
Pass 3: Structure Audit
Pass 4: Meta Content
| Week | Monday | Wednesday | Friday | |------|--------|-----------|--------| | 1 | Pillar topic A] | Supporting topic B] | Social repurpose] | | 2 | Pillar topic C] | Guest/collab piece] | Update old post] | | 3 | Pillar topic A] | Supporting topic D] | Social repurpose] | | 4 | Data/research piece] | Supporting topic E] | Roundup/compilation] |
| Type | Frequency | Purpose | |------|-----------|---------| | Pillar posts (2,000+ words) | 2x/month | Authority building, SEO ranking | | Supporting posts (800-1,500 words) | 2-4x/month | Topic cluster depth, internal linking | | Update/refresh existing posts | 2x/month | Maintain ranking, improve performance | | Data/research pieces | 1x/month | Backlink attraction, original insights | | Guest/collaboration | 1x/month | Audience expansion, backlinks |
| Stage | Owner | Duration | Deadline Relative to Publish | |-------|-------|----------|---------------------------| | Brief creation | Strategist | 1 day | Publish - 14 days | | Research and outline | Writer | 2 days | Publish - 12 days | | First draft | Writer | 3 days | Publish - 9 days | | Editorial review | Editor | 2 days | Publish - 7 days | | Revisions | Writer | 1 day | Publish - 5 days | | SEO optimization | SEO lead | 1 day | Publish - 4 days | | Final review | Editor | 1 day | Publish - 3 days | | Staging and QA | Operations | 1 day | Publish - 2 days | | Publish | Operations | — | Publish day |
Every pillar content piece should produce 5-8 derivative pieces:
| Source | Derivative | Platform | Effort | |--------|-----------|----------|--------| | Blog post | Key insight thread | Twitter/X | Low | | Blog post | Carousel of main points | LinkedIn | Medium | | Blog post | Short-form video summary | TikTok/Reels | Medium | | Blog post | Newsletter section | Email | Low | | Blog post | Slide deck | SlideShare/LinkedIn | Medium | | Blog post | Podcast discussion topic | Podcast | Low | | Blog post | Infographic | Pinterest/Blog | High | | Blog post | FAQ page content | Website | Low |
For high-performing content:
Every piece must pass these gates before publishing:
Content Quality:
SEO Quality:
Technical Quality:
Editorial Quality:
| Problem | Likely Cause | Fix | |---------|-------------|-----| | Content consistently fails the quality gate checklist | Briefs are incomplete or writers do not have enough context | Invest more time in brief creation — include target keyword, angle, audience, H2 structure, and competitive gaps | | Published content ranks #15-30 but does not break into top 10 | Content depth insufficient or missing E-E-A-T signals compared to page 1 results | Add original data, expert quotes, experience signals; increase word count to match or exceed top-ranking competitors | | Content sounds robotic after AI-assisted drafting | AI patterns not caught during editing passes | Run Content Humanizer audit before SEO optimization pass; check for filler words, hedging, and structural uniformity | | Internal linking neglected on new posts | Not built into production workflow | Add "update 2-4 existing posts to link to new content" as a required step in every production checklist | | Repurposing never happens despite planning | Repurposing treated as afterthought instead of workflow step | Build repurposing into the production timeline — schedule derivative content in the same editorial calendar | | Production bottleneck at editorial review stage | Single editor reviewing all content; no SLA on review turnaround | Set 48-hour review SLA; create self-service checklists writers can run before submitting for review | | Content outdated within 6 months of publishing | No refresh cycle established | Schedule quarterly reviews for all content ranking top 20; update stats, links, and publish dates |
In scope:
Out of scope:
Known limitations:
bash# Score content readability with detailed metrics python scripts/readability_scorer.py article.md --json # Generate a content brief from keyword research python scripts/content_brief_generator.py --keyword "cloud cost optimization" --json # Analyze headline options for a new piece python scripts/headline_analyzer.py --headlines headlines.txt --json
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 17,249 | 17,307 | +0% | 1 | 1 | 0% | 2,760 | 7,038 | +155% | 0 | 0 | — |
case-02 | fail→fail | 24,223 | 34,939 | +44% | 1 | 1 | 0% | 3,538 | 9,958 | +181% | 0 | 0 | — |
case-03 | pass→pass | 19,404 | 6,671 | -66% | 1 | 1 | 0% | 3,080 | 5,516 | +79% | 0 | 0 | — |
case-04 | fail→fail | 7,241 | 3,786 | -48% | 1 | 1 | 0% | 1,033 | 5,036 | +388% | 0 | 0 | — |
case-05 | fail→pass | 8,197 | 10,490 | +28% | 1 | 1 | 0% | 1,199 | 6,017 | +402% | 0 | 0 | — |
case-06 | fail→pass | 15,308 | 50,035 | +227% | 1 | 1 | 0% | 2,327 | 6,475 | +178% | 0 | 0 | — |
case-07 | pass→pass | 11,276 | 9,672 | -14% | 1 | 1 | 0% | 1,731 | 5,965 | +245% | 0 | 0 | — |
case-08 | fail→pass | 14,716 | 13,585 | -8% | 1 | 1 | 0% | 2,018 | 6,439 | +219% | 0 | 0 | — |
case-09 | fail→pass | 7,701 | 5,508 | -28% | 1 | 1 | 0% | 1,187 | 5,316 | +348% | 0 | 0 | — |
case-10 | pass→pass | 9,573 | 6,950 | -27% | 1 | 1 | 0% | 1,574 | 5,636 | +258% | 0 | 0 | — |
case-11 | fail→fail | 8,561 | 5,837 | -32% | 1 | 1 | 0% | 1,521 | 5,481 | +260% | 0 | 0 | — |
case-12 | fail→pass | 10,376 | 4,311 | -58% | 1 | 1 | 0% | 1,819 | 5,226 | +187% | 0 | 0 | — |
case-13 | fail→pass | 10,449 | 7,873 | -25% | 1 | 1 | 0% | 1,708 | 5,764 | +237% | 0 | 0 | — |
case-14 | pass→pass | 12,432 | 6,384 | -49% | 1 | 1 | 0% | 2,150 | 5,392 | +151% | 0 | 0 | — |
case-15 | fail→pass | 7,072 | 3,834 | -46% | 1 | 1 | 0% | 1,199 | 5,127 | +328% | 0 | 0 | — |
case-16 | fail→pass | 14,145 | 14,575 | +3% | 1 | 1 | 0% | 2,180 | 6,818 | +213% | 0 | 0 | — |
case-17 | fail→pass | 6,764 | 2,350 | -65% | 1 | 1 | 0% | 942 | 4,854 | +415% | 0 | 0 | — |
case-23 | pass→pass | 7,805 | 4,199 | -46% | 1 | 1 | 0% | 1,172 | 5,104 | +335% | 0 | 0 | — |
case-18 | pass→pass | 8,803 | 4,676 | -47% | 1 | 1 | 0% | 1,354 | 5,273 | +289% | 0 | 0 | — |
case-19 | fail→pass | 13,754 | 10,814 | -21% | 1 | 1 | 0% | 2,113 | 5,902 | +179% | 0 | 0 | — |
case-20 | pass→pass | 17,068 | 16,384 | -4% | 1 | 1 | 0% | 2,783 | 7,221 | +159% | 0 | 0 | — |
case-21 | pass→pass | 13,918 | 10,012 | -28% | 1 | 1 | 0% | 2,094 | 6,189 | +196% | 0 | 0 | — |
case-22 | fail→pass | 13,583 | 8,427 | -38% | 1 | 1 | 0% | 2,204 | 5,736 | +160% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 23 cases were attempted. The headline lift of +48 percentage points is the difference between those two pass rates over the 23 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.