catskill-research

---

name: catskill-research description: Research events and conditions data for Catskill Crew newsletter. Use when gathering Instagram events, fetching sun/moon/weather data, or preparing data for newsletter writing.

<essential_principles>

How This Skill Works

This skill gathers raw data for the Catskill Crew newsletter. It does NOT write newsletter content - use catskill-writer for that.

Data Types

1. Events - From Instagram venues/promoters via ScrapeCreators API
2. Conditions - Sun, moon, air quality, fire danger via Firecrawl scraping

Output

Research produces structured data saved to tmp/ for the writer skill to consume:

• tmp/extraction/event_candidates.json - Parsed events
• tmp/extraction/images/<handle>/ - Downloaded flyer images
• tmp/conditions/ - Conditions data (optional)

Key Principle

Images are critical. Many venues post event details only in flyer images, not captions. Always analyze downloaded images with Claude's vision. </essential_principles>

1. Events - Scrape Instagram venues for upcoming events
2. Conditions - Fetch sun/moon/air/fire data
3. Both - Full research for a newsletter edition

Wait for response before proceeding.

<reference_index> All domain knowledge in references/:

Instagram: instagram-api.md, instagram-sources.md Conditions: conditions-sources.md Data Models: event-schema.md </reference_index>

<workflows_index>

<success_criteria> Research is complete when:

• Event candidates saved to tmp/extraction/event_candidates.json
• All flyer images downloaded and analyzed
• Conditions data fetched and parsed
• Data is ready for catskill-writer skill </success_criteria>