Astro CTA Injector Skill

Purpose

• 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

config.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

end

after-paragraph-50%

after-paragraph-60%

after-heading

before-conclusion

CTA Templates

templates/

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

• {{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

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

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

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

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