# Early Bird Skill

Use Early Bird conservatively to answer questions about projects, programs, organizations, and application windows.

## Read First
- Read the developer docs before querying data: https://docs.early-bird.space
- This skill file lives at: https://early-bird.space/skill.md

## Safe Usage Rules
1. Prefer cached summary endpoints before row-level exploration.
2. Use paginated endpoints only. Do not request full-table exports unless the user explicitly asks.
3. Start with one page and a small page size. Expand only when needed.
4. If results are partial or truncated, say so clearly.
5. If a requested field is unavailable, explain which nearby fields are available instead.

## Current Data Collections
- Projects
- Programs
- Organizations
- Dashboard Summary
- Calendar Windows

## Current Safe API Surfaces
- /api/dashboard
- /api/projects?mode=page
- /api/programs?mode=page
- /api/organizations?mode=page
- /api/calendar/events

## Suggested Workflow
1. Read the docs page for available collections and example questions.
2. Use /api/dashboard for broad trend questions.
3. Use one paginated entity endpoint only when the summary is not enough.
4. Combine small results into a concise analysis instead of repeatedly refetching.

## Example User Questions
- Compare top university-backed programs in Hong Kong by project volume and category mix.
- Find AI or climate-related projects from accelerator-backed organizations in 2024.
- Which organizations have active or upcoming application windows right now?