claude-content-skills

---

Built with ADD-Supercharged Claude

These skills were developed using Claude Code enhanced with the Assess-Decide-Do (ADD) Framework - a human cognitive framework integration that creates more aligned, flow-aware AI interactions. The ADD framework taught Claude to recognize exploration vs. decision vs. execution phases, resulting in cleaner architecture, a more thoughtful implementation and significant token savings.

---

What This Is

A collection of five production-ready Claude Code skills that automate / enhance common content management tasks:

| Skill | Purpose | Time Saved | |-------|---------|------------| | SEO WordPress Manager | Batch update Yoast SEO metadata via GraphQL | Hours per week | | Astro CTA Injector | Intelligently inject CTAs into static site content | Manual work eliminated | | Link Analyzer | Find broken links, orphan pages, and linking issues | Comprehensive site audits | | GSC Assistant | Track indexing status, manage submissions, process false positives | Indexing workflow streamlined | | Pre-publish Post Assistant | Classify posts with categories/tags, generate SEO metadata | Pre-publish workflow optimized |

These aren't toy examples. They emerged from real-world needs managing a 15+ years old, 1,300+ posts blog migration and optimization project.

Why Skills Matter

Claude Code skills are model-invoked capabilities - Claude automatically detects when to use them based on your conversation context. Unlike slash commands that require explicit invocation, skills let Claude seamlessly apply specialized knowledge when relevant.

You: "My WordPress posts have terrible meta descriptions, can you help optimize them?"

Claude: [Automatically activates SEO WordPress Manager skill]
        "I'll help you batch-update your Yoast SEO metadata. Let me first
        fetch your posts via GraphQL and show you a preview of the changes..."

Quick Start

Installation (2 minutes)

# Clone the repository
git clone https://github.com/dragosroua/claude-content-skills.git
cd claude-content-skills

# Install Python dependencies
pip install -r requirements.txt

# Copy skills to Claude Code (global installation)
cp -r skills/* ~/.claude/skills/
cp -r shared ~/.claude/skills/

Configuration

# Copy example configs
cp .env.example .env

# Edit with your credentials (only needed for skills you use)
# - WordPress GraphQL URL and Application Password (SEO WordPress Manager)
# - Content path for your Astro site (CTA Injector)
# - Dist folder path for built site (Link Analyzer - works on local files)

Verify Installation

Start Claude Code - the skills should now appear when relevant to your requests.

Skills Overview

1. SEO WordPress Manager

Batch update Yoast SEO fields (titles, meta descriptions, focus keyphrases) via WordPress GraphQL API.

Key Features:

• Preview changes before applying (dry-run by default)
• Progress tracking with resume capability
• Batch processing with rate limiting
• Backup of original values

Requirements:

• WordPress with WPGraphQL plugin
• Yoast SEO + WPGraphQL Yoast extension
• Application Password for authentication

Example Usage:

"Update meta descriptions for all posts in the tutorials category"
"Fix SEO titles that are too long"
"Add focus keyphrases to posts missing them"

Full Documentation

---

2. Astro CTA Injector

Inject Call-to-Action blocks into Astro site content with intelligent placement and relevance scoring.

Key Features:

• Multiple placement strategies (end, after 50%, after 60%, after heading)
• Content-based relevance scoring
• Template system for CTA HTML
• Backup and rollback capability

Placement Strategies: | Strategy | Best For | |----------|----------| | end | Non-intrusive, general CTAs | | after-paragraph-50% | Newsletter signups (highest conversion) | | after-paragraph-60% | Product recommendations | | after-heading | Important announcements |

Example Usage:

"Add newsletter CTAs to my productivity articles"
"Inject product promotion into posts scoring above 7"
"Preview CTA placements before applying"

Full Documentation

---

3. Link Analyzer

Comprehensive link analysis for static sites - find broken links, orphan pages, and internal linking issues.

Key Features:

• Internal/external link extraction and validation
• HTTP checking with false-positive filtering
• Link graph metrics (the real value):
  • Orphan pages (zero inbound links - critical SEO issue)
  • Under-linked pages (missed ranking opportunities)
  • Over-linked pages (link equity dilution)
  • Link sinks (receive but don't pass links)

Example Usage:

"Analyze my site's internal linking structure"
"Find orphan pages that aren't linked from anywhere"
"Check for broken external links"
"Show me pages that receive links but don't pass them"

Full Documentation

---

4. GSC Assistant

Track Google Search Console indexing status, manage submission workflows, and process false positives.

Key Features:

• Compare sitemap against GSC indexed pages export
• Track two index states: Public (GSC export) and Lag (URL Inspection confirmed)
• Prioritize pages for submission by category
• Process false positives (move to indexed when confirmed)
• Track submission dates and progress

Tracking Files: | File | Purpose | |------|---------| | indexed.md | All indexed pages (Public + Lag tables) | | to-index.md | Pages awaiting indexing, prioritized |

Example Usage:

"Compare my sitemap with GSC export and generate tracking files"
"Process false positives and update indexed list"
"Show indexing progress statistics"

Full Documentation

---

5. Pre-publish Post Assistant

Intelligent pre-publish assistant for new blog posts. Suggests categories, tags, and SEO metadata with transparent rationale.

Key Features:

• Suggest categories from existing taxonomy (1-2 max)
• Suggest tags from existing tags (3-5 max, no pollution)
• Generate SEO title, meta description, focus keyphrase
• Show rationale for every suggestion
• Distribution-aware (avoids oversized categories, orphan tags)

Best Practices Enforced: | Practice | Description | |----------|-------------| | No tag pollution | Only suggests existing tags with 3+ posts | | Balanced distribution | Warns if category would become oversized | | SEO compliance | Enforces character limits (60/160) | | Transparent reasoning | Every suggestion includes rationale |

Example Usage:

"Classify this post: /drafts/morning-routine.md"
"What tags should I use for a post about Bitcoin ETFs?"
"Generate SEO metadata for my productivity article"

Full Documentation

---

Repository Structure

claude-content-skills/
├── README.md                    # You are here
├── LICENSE                      # MIT License
├── requirements.txt             # Python dependencies
├── .env.example                 # Environment template
│
├── docs/                        # Documentation
│   ├── README.md               # Documentation index
│   ├── skills/                 # Per-skill deep dives
│   ├── integration/            # Setup and troubleshooting
│   └── philosophy/             # Design decisions
│
├── shared/                      # Shared utilities
│   ├── config_loader.py        # Configuration management
│   └── utils.py                # Progress tracking, JSON helpers
│
└── skills/                      # The skills themselves
    ├── seo-wordpress-manager/
    │   ├── SKILL.md            # Skill definition (required)
    │   ├── reference.md        # Detailed reference
    │   ├── config.example.json
    │   └── scripts/
    │       ├── wp_graphql_client.py
    │       ├── preview_changes.py
    │       └── yoast_batch_updater.py
    │
    ├── astro-cta-injector/
    │   ├── SKILL.md
    │   ├── reference.md
    │   ├── config.example.json
    │   ├── templates/
    │   │   ├── newsletter.html
    │   │   └── product.html
    │   └── scripts/
    │       ├── score_posts.py
    │       ├── preview_injection.py
    │       └── inject_ctas.py
    │
    ├── link-analyzer/
    │   ├── SKILL.md
    │   ├── reference.md
    │   ├── config.example.json
    │   └── scripts/
    │       ├── analyze.py          # Main orchestrator
    │       ├── outbound_links.py
    │       ├── internal_links.py
    │       ├── http_checker.py
    │       └── link_graph.py