# Catskill Research

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

- Skill: `majiayu000/catskill-research` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/catskill-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/catskill-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/catskill-research

---


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

<intake>
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.**
</intake>

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

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