newsletter-events-setup
Set up environment for local newsletter events plugin. Use when first installing, updating dependencies, or verifying configuration.
When & Why to Use This Skill
This Claude skill automates the environment configuration and dependency management for the local newsletter events plugin. It streamlines the setup of multi-runtime environments (Python and Node.js), manages high-performance package managers like uv and bun, and performs comprehensive health checks to ensure all scraping and generation components are correctly integrated and ready for use.
Use Cases
- Initial Installation: Automatically provision a complete local environment with all required Python and Node.js dependencies for the newsletter plugin.
- Dependency Synchronization: Use fast package managers (uv and bun) to update libraries and ensure environment consistency via lockfiles.
- Configuration Validation: Verify that critical API keys, such as SCRAPECREATORS_API_KEY, and configuration files are correctly set up before execution.
- Environment Troubleshooting: Diagnose and fix issues related to runtime versions, missing libraries, or subprocess bridge failures between Python and JavaScript.
| name | newsletter-events-setup |
|---|---|
| description | Set up environment for local newsletter events plugin. Use when first installing, updating dependencies, or verifying configuration. |
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).
- 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.
| Response | Workflow | |----------|----------| | 1, "setup", "install", "fresh" | `workflows/setup-environment.md` | | 2, "check", "verify", "status" | Run verification checks inline | | 3, "update", "upgrade" | Run `uv sync --upgrade` and `bun update` | | 4, "troubleshoot", "debug", "help" | Diagnose common issues | 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