astro-cta-injector

# Astro CTA Injector Skill

## Purpose

This skill injects Call-to-Action (CTA) blocks into Astro site content. It supports:
- Multiple CTA types (newsletter, product, custom)
- Intelligent placement strategies
- Content-based relevance scoring
- Batch processing with preview

## When to Use This Skill

- User asks to "add CTAs to blog posts"
- User wants to "inject newsletter signup" into content
- User mentions "add product promotion" to posts
- User needs to batch-add any type of content block to posts
- User wants to "add calls to action" to their Astro site

## Prerequisites

- Astro site with content in `.astro` or `.md` files
- Python 3.10+
- BeautifulSoup4 for HTML parsing

## Configuration

Create a `config.json` in the skill directory:

```json
{
  "content_path": "./src/content/blog",
  "file_patterns": ["*.astro", "*.md"],
  "cta_types": {
    "newsletter": {
      "template": "newsletter.html",
      "default_placement": "after-paragraph-50%",
      "keywords": ["tip", "guide", "learn", "strategy"]
    },
    "product": {
      "template": "product.html",
      "default_placement": "end",
      "keywords": ["productivity", "task", "habit", "goal"]
    }
  },
  "output": {
    "state_file": "./state/cta_injection_progress.json",
    "backup_dir": "./backups",
    "report_file": "./reports/cta_injection_report.md"
  },
  "dry_run": true
}
```

## Placement Strategies

| Strategy | Description | Best For |
|----------|-------------|----------|
| `end` | After all content | Non-intrusive CTAs |
| `after-paragraph-50%` | After 50% of paragraphs | Mid-content engagement |
| `after-paragraph-60%` | After 60% of paragraphs | Later engagement |
| `after-heading` | After first H2 | Early engagement |
| `before-conclusion` | Before last paragraph | Strong finish |

## CTA Templates

Templates are HTML files in the `templates/` directory:

```html
<!-- templates/newsletter.html -->
<aside class="cta-newsletter" data-cta-type="newsletter">
  <h3>{{title}}</h3>
  <p>{{description}}</p>
  <form action="{{form_url}}" method="post">
    <input type="email" placeholder="Your email" required />
    <button type="submit">Subscribe</button>
  </form>
</aside>
```

Variables:
- `{{title}}` - CTA headline
- `{{description}}` - CTA body text
- `{{form_url}}` - Form submission URL
- `{{product_url}}` - Product link
- `{{image_url}}` - Image source

## Workflow

### Step 1: Score Posts for Relevance
```bash
python scripts/score_posts.py --content-path ./src/content/blog --cta-type newsletter
```

### Step 2: Preview Injections
```bash
python scripts/preview_injection.py --input scored_posts.json --cta-type newsletter
```

### Step 3: Apply Injections
```bash
python scripts/inject_ctas.py --input scored_posts.json --cta-type newsletter
```

## Input Format

Scored posts JSON:

```json
{
  "posts": [
    {
      "file_path": "./src/content/blog/my-post.astro",
      "title": "My Blog Post",
      "relevance_score": 8.5,
      "cta_type": "newsletter",
      "placement": "after-paragraph-50%",
      "cta_data": {
        "title": "Get More Tips Like This",
        "description": "Subscribe to my weekly newsletter"
      }
    }
  ]
}
```

## Scoring Algorithm

Posts are scored for CTA relevance based on:
1. **Keyword density** - How many relevant keywords appear
2. **Content length** - Longer posts = better candidates
3. **Topic match** - Title and content topic alignment
4. **Existing CTAs** - Skip posts that already have CTAs

Scores range from 0-10. Default threshold: 5.0

## Safety Features

- **Dry-run mode** by default
- **Backup creation** before any modifications
- **Duplicate detection** - Won't inject if CTA already exists
- **Rollback capability** - Restore from backups
- **Preview diffs** - See exactly what will change

## Example Usage

User: "Add a newsletter signup CTA to all my productivity-related blog posts"

Claude will:
1. Scan content directory for posts
2. Score posts for "newsletter" relevance using productivity keywords
3. Generate CTA HTML from template
4. Show preview of changes
5. Ask for confirmation
6. Inject CTAs into matching posts
7. Report results