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:

{
  "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:

<!-- 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

python scripts/score_posts.py --content-path ./src/content/blog --cta-type newsletter

Step 2: Preview Injections

python scripts/preview_injection.py --input scored_posts.json --cta-type newsletter

Step 3: Apply Injections

python scripts/inject_ctas.py --input scored_posts.json --cta-type newsletter

Input Format

Scored posts 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:

• Keyword density - How many relevant keywords appear
• Content length - Longer posts = better candidates
• Topic match - Title and content topic alignment
• 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:

• Scan content directory for posts
• Score posts for "newsletter" relevance using productivity keywords
• Generate CTA HTML from template
• Show preview of changes
• Ask for confirmation
• Inject CTAs into matching posts
• Report results