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>

What would you like to research?

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.

| Response | Workflow | |----------|----------| | 1, "events", "instagram" | `workflows/research-events.md` | | 2, "conditions", "weather", "sun", "moon" | `workflows/research-conditions.md` | | 3, "both", "full", "newsletter" | Run both workflows sequentially |

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

Workflow	Purpose
research-events.md	Scrape Instagram, download images, extract events
research-conditions.md	Fetch sun/moon/air/fire from free sources
</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>