| 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
- Events - From Instagram venues/promoters via ScrapeCreators API
- 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 eventstmp/extraction/images/<handle>/ - Downloaded flyer imagestmp/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?
- Events - Scrape Instagram venues for upcoming events
- Conditions - Fetch sun/moon/air/fire data
- 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>
