newsletter-events-setup

Set up environment for local newsletter events plugin. Use when first installing, updating dependencies, or verifying configuration.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/devops/newsletter-events-setup

SKILL.md

<essential_principles>

Environment Requirements

This plugin requires two runtimes:

Python 3.12+ with uv for:

Instagram scraping (ScrapeCreators API)
Event deduplication (rapidfuzz)
Newsletter generation (Jinja2)
Config validation (Pydantic)

Node.js 18+ with bun for:

Facebook event scraping (facebook-event-scraper npm)

Why Two Runtimes?

The facebook-event-scraper library is JavaScript-only with no Python equivalent. Rather than reimplement it, we use a subprocess bridge with strict JSON contracts.

Package Managers

uv: Fast Python package manager with lockfile support
bun: Fast JavaScript runtime and package manager

Both ensure reproducible environments via lockfiles (uv.lock, bun.lockb). </essential_principles>

Full setup - Install all dependencies from scratch
Check environment - Verify everything is configured correctly
Update dependencies - Update to latest compatible versions
Troubleshoot - Debug environment issues

Wait for response before proceeding.

<success_criteria> Environment is ready when:

uv --version returns 0.4.0+
bun --version returns 1.0.0+
uv run python -c "import rapidfuzz" succeeds
bun run scripts/scrape_facebook.js --help succeeds
.env file exists with SCRAPECREATORS_API_KEY set
config/sources.yaml exists and validates </success_criteria>