CLAUDE.md@skills/edge-esmeralda git:20260521.a5e9657A

Immutable. This exact content is served forever at /api/v1/blob/8af86a1aa11c82e0.

# Edge Agent Skill

This repo contains a single-file AI agent skill (SKILL.md) for Edge Esmeralda 2026, plus backend infrastructure to keep reference content fresh.

## Project Structure
- `SKILL.md` — The skill file users download. Self-contained.
- `references/` — Preprocessed content from Notion wiki, website, newsletter. Generated by indexer.
- `scripts/index.ts` — Indexer that fetches and preprocesses static sources.
- `.github/workflows/index-references.yml` — Runs indexer every 15 min.

## Commands
- `bun install` — Install dependencies
- `bun run scripts/index.ts` — Run indexer to regenerate reference files

## Key Data
- EdgeOS Events API: `api.edgeos.world/api/v1` — calendar, RSVPs, venues. Requires user-supplied personal access token (`eos_live_...`).
- EdgeOS Citizen Portal: `api-citizen-portal.simplefi.tech`, popup_id `8` — attendee directory
- Notion Wiki page ID: `317d45cdfc5981d2a571f52b024c5141`
- Newsletter RSS: `edgeesmeralda2026.substack.com/feed`

## Placeholder sections in SKILL.md
- §4 Spatial Browsing (Geo Browser) — stub, awaiting PR from Geo Browser team. Marker: `<!-- GEO_BROWSER_PLACEHOLDER ... END -->`.

When the Geo Browser team PRs in their content, they replace the placeholder block with concrete endpoints, auth, examples, and remove the marker comment.

(§3 Knowledge Discovery (Index Network) was previously a placeholder; it is now live in SKILL.md with full MCP-server documentation.)

Default to using Bun instead of Node.js.