# SiteSkills.ai — Agent Guide

SiteSkills is an open marketplace of pre-mapped navigation guides (called "SiteSkills") for AI browser agents. Each skill is a SKILL.md file containing verified CSS selectors, page structures, navigation flows, and timing patterns for a specific website. Install once — works across Claude Code, Cursor, Cline, Windsurf, Continue.dev, OpenClaw, and 14+ other AI agent platforms.

The site is a React SPA. If you can't execute JavaScript, use the API directly — it exposes everything.

---

## The #1 Shortcut: Resolve a Domain

If you are about to navigate a website and want to load its skill in one call:

```
GET https://api.siteskills.ai/api/resolve?domain=github.com
```

Returns:
```json
{
  "slug": "github",
  "displayName": "GitHub",
  "description": "...",
  "version": "1.0.0",
  "content": "---\nname: github\n...\n# GitHub — AI Navigation Skill\n..."
}
```

The `content` field is the full SKILL.md text — ready to use immediately.
Rate limit: 600 requests/minute. No auth required.

Examples:
- https://api.siteskills.ai/api/resolve?domain=stripe.com
- https://api.siteskills.ai/api/resolve?domain=github.com
- https://api.siteskills.ai/api/resolve?domain=notion.so
- https://api.siteskills.ai/api/resolve?domain=stackoverflow.com

---

## Install a Skill (CLI — Zero Setup Required)

```bash
npx siteskills install github
npx siteskills install stripe
npx siteskills install mdn-web-docs
npx siteskills install hackernews-top-stories
```

Skills are saved to `~/.claude/skills/<slug>/SKILL.md` (Claude Code) or the platform-appropriate directory. The CLI auto-detects your agent platform.

---

## Search for Skills (No Browser Needed)

```
GET https://api.siteskills.ai/api/skills?q=stripe&limit=10
GET https://api.siteskills.ai/api/skills?q=github&sort=downloads
GET https://api.siteskills.ai/api/skills?category=developer-tools&limit=20
GET https://api.siteskills.ai/api/skills?limit=50&sort=newest
```

Response fields per skill: `slug`, `displayName`, `description`, `targetDomains`, `downloadCount`, `rating`, `version`, `tags`, `categories`.

---

## All Useful API Endpoints

Base URL: `https://api.siteskills.ai`

| Method | Path | Description |
|--------|------|-------------|
| GET | /api/resolve?domain={domain} | Get skill by domain name (full content) |
| GET | /api/skills | Browse/search skills (paginated) |
| GET | /api/skills/{slug} | Skill detail with full content |
| GET | /api/skills/{slug}/content | Raw SKILL.md as text/markdown |
| GET | /api/skills/{slug}/reviews | User reviews |
| GET | /api/skills/{slug}/versions | Version history |
| GET | /api/stats/public | Site-wide stats |
| GET | /sitemap.xml | All skill pages |

No API key needed for any read operation.

### Pagination

All list endpoints support cursor pagination:
```
GET /api/skills?limit=50&cursor=<nextCursor>
```

Response: `{ data: [...], nextCursor: "..." | null }`

---

## Get Raw Skill Content

To get just the markdown file with no JSON wrapper:

```
GET https://api.siteskills.ai/api/skills/github/content
```

Returns `Content-Type: text/markdown` with the raw SKILL.md. Cached for 1 hour.

---

## Submit a Skill (API Key Required)

```
POST https://api.siteskills.ai/api/skills
Authorization: Bearer sk_live_...
Content-Type: application/json

{
  "content": "---\nname: mysite\n...\n# MySite\n...",
  "displayName": "My Site",
  "description": "Navigate mysite.com",
  "targetDomains": ["mysite.com"],
  "tags": ["productivity"],
  "categories": ["productivity"],
  "version": "1.0.0",
  "license": "MIT"
}
```

Skills scoring ≥ 80/100 on the automated scan are auto-published. Lower scores go to manual review.

---

## Currently Available: 300+ Skills

Top skills by downloads:
- mozilla — Navigate mozilla.org (docs, products, settings)
- mdn-web-docs — MDN Web Docs (API references, documentation)
- medium — Navigate medium.com (articles, categories)
- replicate — Navigate replicate.com (AI models)
- publicapis — Navigate publicapis.io (API directory)
- elastic — Navigate elastic.co (search, docs)
- playwright — Navigate playwright.dev (docs)
- twilio — Navigate twilio.com (docs, products)
- resend — Navigate resend.com (email API docs)
- heroku — Navigate heroku.com (apps, docs)
- github — Navigate GitHub (repos, PRs, issues, code search)
- stripe — Navigate Stripe (payments, API docs)
- hackernews-top-stories — Fetch top HN stories
- jsfiddle — Navigate JSFiddle (create/find fiddles)
- httpbin — Navigate httpbin.org (HTTP testing)

Browse all: https://api.siteskills.ai/api/skills?limit=50

---

## SKILL.md Format

Skills use the Agent Skills open standard (agentskills.io). Format:

```markdown
---
name: github
description: Navigate GitHub repositories, PRs, issues, code search
target-domains:
  - github.com
tags:
  - git
  - developer-tools
version: 1.0.0
license: MIT
---

# GitHub — AI Navigation Skill

## Site Map
| Page | URL | Notes |
|------|-----|-------|
| Home | https://github.com | Dashboard, repos |
| Repo | https://github.com/{owner}/{repo} | Code, issues, PRs |

## Page Structures
| Element | Selector | Notes |
|---------|----------|-------|
| Search input | input[name="q"] | Global search |
| New repo button | a[href="/new"] | Top nav |

## Navigation Flows
### Flow: Search for a repository
| Step | Action | Target | Value | Wait For |
|------|--------|--------|-------|----------|
| 1 | click | input[name="q"] | | visible |
| 2 | type | input[name="q"] | "query" | |
| 3 | press | input[name="q"] | Enter | results loaded |

## Timing & Waiting
| Transition | Wait For | Typical Delay |
|------------|----------|---------------|
| Search results | .repo-list | 1-2s |
```

Install path: `~/.claude/skills/<slug>/SKILL.md`

---

## Web UI Navigation (if you can execute JavaScript)

The site is a React SPA at https://siteskills.ai

Key pages:
- / — Homepage with search and top skills
- /skills — Browse all skills (filterable by category, sort)
- /skills/{slug} — Skill detail page with install command, reviews
- /upload — Submit a new skill (requires login)
- /admin — Admin review queue (admin only)

Search on the /skills page: there is a search input at the top. Type to filter. Results update as you type.

Install button on skill detail pages shows: `npx siteskills install {slug}`

---

## Platform Compatibility

| Platform | Skills Directory |
|----------|-----------------|
| Claude Code | ~/.claude/skills/{slug}/SKILL.md |
| OpenClaw | ~/.openclaw/skills/{slug}/SKILL.md |
| Cursor | ~/.cursor/skills/{slug}/SKILL.md |
| Custom | Set SITESKILLS_DIR env var |

---

## About

SiteSkills runs a 3-stage automated scan on all submissions:
1. Format validation (30% weight) — structure, frontmatter, required sections
2. Security analysis (40% weight) — no prompt injection, no exfiltration
3. LLM review (30% weight) — quality and accuracy check

Skills scoring ≥ 80 auto-publish. Others go to manual review. All skills are MIT licensed.

Sitemap: https://siteskills.ai/sitemap.xml
llms.txt: https://siteskills.ai/llms.txt
API base: https://api.siteskills.ai