# om.curious — full site map for LLMs

> Extended reference for AI agents crawling or assisting users on om-curious.pages.dev. For a short index, use [/llms.txt](https://om-curious.pages.dev/llms.txt).

## Site purpose

om.curious is a curated hub of AI **skills**, **prompts**, **guides**, **tools**, and **templates**, with real outcome preview images. The flagship drop is the **Om.curious GPT Image Skill**: a `.skill` file users upload to Claude so Claude writes production-ready GPT Image 2 prompts (Format A/B/C patterns, editable brackets).

Owner: **@om.curious**. Stack: React SPA (Vite) on Cloudflare Pages, D1 database, Pages Functions under `/api`.

## Human routes

| Path | Purpose |
|------|---------|
| `/` | Home — latest drop, collections, categories |
| `/trending` | Drops + search (`?q=`, `?category=`) |
| `/r/{short}` | Short item link (preferred share URL) |
| `/item/{slug}` | Full-slug item detail |
| `/skills` `/prompts` `/guides` `/tools` `/templates` | Category browse (`?q=`, `?tag=`) |
| `/collections` | All collections |
| `/collection/{slug}` | Collection detail (e.g. `design-prompt-pack`) |
| `/links` | Compact link tree for bio / reels |

## Public JSON API

All endpoints return JSON.

### GET /api/home

Home payload: `categories[]`, `collections[]`, `latestDrop`, `featured[]`.

### GET /api/items

Query parameters:

| Param | Notes |
|-------|--------|
| `q` | Full-text search (FTS5) |
| `category` | `skills` \| `prompts` \| `guides` \| `tools` \| `templates` |
| `tag` | Tag slug |
| `drop` | `1` = trending/drops ranking |
| `limit` | Page size (default ~24 client-side) |
| `offset` | Pagination offset |

### GET /api/items/{slug}

Detail by **full slug** or **short_slug**. Includes `promptText`, `content`, `thumbnailUrl`, `downloadUrl`, `externalUrl`, tags, related items.

### GET /api/categories | /api/tags | /api/collections | /api/collections/{slug}

Taxonomy and collection payloads.

## WebMCP tools (browser agents)

When a capable browser is open on this origin, tools may be available via:

1. **Declarative** HTML forms with `toolname` + `tooldescription` (search forms).
2. **Imperative** `document.modelContext.registerTool` (search, open routes, fetch item summary).

Registered tool names (progressive enhancement; feature-detect before calling):

- `search_catalog` — declarative header form (toolname + tooldescription)
- `search_catalog_page` — declarative trending search form
- `open_category` — imperative; open a category browse page
- `open_route` — imperative; navigate to a known path
- `get_item` — imperative; fetch item JSON by slug/short_slug via `/api/items/{slug}`

See: https://developer.chrome.com/docs/ai/webmcp

## Key content IDs

- Skill short link: `/r/skill` → Om.curious GPT Image Skill
- Skill file: `/downloads/gpt-image.skill`
- Cover image: `/downloads/om-gpt-image-cover.webp`
- Design collection: `/collection/design-prompt-pack`

## Crawling preferences

- Prefer API + llms.txt over scraping infinite grids.
- Respect `Cache-Control` on `/downloads/*` (long-lived, content-versioned filenames).
- HTML shell is SPA; deep links work via client router; for offline text prefer API.

## Contact / brand

- Brand system: dark stage + lime accent, professional SFW.
- Attribution: om.curious / @om.curious when republishing prompt formulas.