AI Content Ops

Ship content that scores 90+ every time. Automatically.

Most content teams publish and pray. This pipeline scores, gates, and iterates every piece of content through an AI expert panel before it goes live. Nothing ships below 90/100.

What's Inside

🎯 Expert Panel (`SKILL.md`)

Claude Code skill that auto-assembles a panel of 7-10 domain experts tailored to whatever you're scoring. Works on:

Blog posts, social content, email sequences
Landing pages, ads, CTAs
Strategy docs, pitch decks, charts
Recruiting outreach, vendor evaluations
Literally anything that needs a quality gate

The panel scores your content, identifies weaknesses, revises, and loops until every expert scores 90+. Max 3 rounds. Includes a 1.5x-weighted AI Writing Detector that catches all 24 known AI writing patterns.

🚦 Content Quality Gate (`scripts/content-quality-gate.py`)

CI/CD-style gate for your content pipeline. Runs the quality scorer on a batch of drafts and filters out anything below threshold. Nothing publishes without passing.

📊 Content Quality Scorer (`scripts/content-quality-scorer.py`)

Automated scoring engine with 5 dimensions:

Voice similarity (35%) — matches your brand voice patterns
Specificity (25%) — real numbers, named entities, concrete examples
AI slop penalty (20%) — detects and penalizes 50+ banned AI words and 8 AI writing patterns
Length appropriateness (10%) — platform-specific character limits
Engagement potential (10%) — hooks, CTAs, debate invitations

🧠 Editorial Brain (`scripts/editorial-brain.py`)

Two-pass LLM analysis for finding clip-worthy moments in video transcripts:

Pass 1: Scans transcript chunks for candidate moments (hook → build → payoff arcs)
Pass 2: Deep-scores each candidate on hook/build/payoff/clean-cut (0-100)
Only 90+ clips get cut

Fundamentally different from keyword matching. Thinks like a human editor.

⛏️ Quote Mining Engine (`scripts/quote-mining-engine.py`)

Scans podcast RSS feeds and meeting notes to extract quotable, contrarian, viral-worthy moments. Scoring heuristics:

Contrarian signals (wrong, myth, overrated, secret...)
Specificity signals ($amounts, percentages, multipliers)
Emotional triggers (fear, love, shocking, AI...)
Shareability signals (how to, framework, lesson learned...)

🔄 Content Transform (`scripts/content-transform.py`)

Repurposes long-form content into platform-native formats:

X threads/posts — punchy, data-driven, with ASCII diagrams
LinkedIn posts — hook before the fold, story arc, engagement CTA
YouTube Short scripts — HOOK/SETUP/PAYOFF/CTA structure with visual cues
Newsletter sections — scannable, value-dense, "why this matters"

Includes optional expert panel integration for iterative quality improvement.

Quick Start

# 1. Install dependencies
pip install -r requirements.txt

# 2. Set up environment
cp .env.example .env
# Edit .env with your API keys

# 3. Score a batch of content drafts
python scripts/content-quality-scorer.py --input drafts.json --verbose

# 4. Run the quality gate
python scripts/content-quality-gate.py --input drafts.json --threshold 70

# 5. Mine quotes from your podcast RSS
python scripts/quote-mining-engine.py --days 90 --min-score 60

# 6. Find clip-worthy moments in a video
python scripts/editorial-brain.py --url "https://youtube.com/watch?v=..." --min-score 90

# 7. Transform content atoms into platform drafts
python scripts/content-transform.py --atoms atoms.json --top-n 10

Configuration

All scripts use environment variables for configuration. See .env.example for the full list.

Voice Customization

The quality scorer and content transformer use configurable voice patterns. Edit these in your .env or pass custom config files:

VOICE_MARKERS — regex patterns that signal your brand voice
BANNED_WORDS — AI slop vocabulary to penalize
PLATFORM_LIMITS — character limits per platform

Scoring Weights

Adjust scoring weights via a JSON config file:

{
  "weights": {
    "voice_similarity": 0.35,
    "specificity": 0.25,
    "slop_penalty": 0.20,
    "length_appropriateness": 0.10,
    "engagement_potential": 0.10
  },
  "threshold": 70
}

Expert Panel Domains

Pre-built expert panels included:

experts/humanizer.md — AI writing detection (24 patterns, mandatory)
experts/x-articles.md — X/Twitter long-form posts
experts/linkedin.md — LinkedIn posts
experts/newsletter.md — Email newsletters
experts/youtube-shorts.md — YouTube Shorts scripts
experts/instagram.md — Instagram visual content
experts/podcast-quotes.md — Podcast quote cards
experts/recruiting.md — Recruiting outreach
experts/seo-strategy.md — SEO strategy docs

Scoring rubrics:

scoring-rubrics/content-quality.md — Blog, social, email, scripts
scoring-rubrics/strategic-quality.md — Strategy and analysis
scoring-rubrics/conversion-quality.md — Landing pages, ads, CTAs
scoring-rubrics/visual-quality.md — Charts, infographics, slides
scoring-rubrics/evaluation-quality.md — Candidate/vendor evaluations

Input Formats

Content Drafts (for scorer/gate)

{
  "drafts": [
    {
      "id": "draft-001",
      "platform": "x",
      "draft": "Your content text here..."
    }
  ]
}

Content Atoms (for transformer)

{
  "atoms": [
    {
      "id": "atom-001",
      "content": "Long-form source content...",
      "tags": ["AI", "marketing"],
      "platforms_missing": ["x", "linkedin"],
      "repurpose_score": 8
    }
  ]
}

Architecture

Content Source → Content Transform → Quality Scorer → Quality Gate → Publish
                      ↑                    ↓
                Expert Panel ←── Revision Loop (max 3 rounds)

The pipeline is modular. Use any script standalone or wire them together.

License

MIT

---

🧠 Want these built and managed for you? →

*This is how we build agents at Single Brain for our clients.*

Single Grain · our marketing agency

📬 Level up your marketing with 14,000+ marketers and founders → *(free)*

</div>

Content Mint — AIで稼ぎ続けるコンテンツ自動生成機