Agent skill

API Discovery

Discover any website's API and create domain plugins with proxy routes.

MITAuto-check passed

Install API Discovery

skills CLI

$ npx skills add adam-s/intercept --skill api-discovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install adam-s/intercept api-discovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/adam-s/intercept.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/api-discovery .claude/skills/api-discovery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "api-discovery" agent skill from https://github.com/adam-s/intercept/tree/main/.claude/skills/api-discovery into .claude/skills/api-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-discovery", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/adam-s/intercept/tree/main/.claude/skills/api-discovery

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add adam-s/intercept --skill api-discovery -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install adam-s/intercept api-discovery --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/adam-s/intercept.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/api-discovery .agents/skills/api-discovery && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "api-discovery" agent skill from https://github.com/adam-s/intercept/tree/main/.claude/skills/api-discovery into .agents/skills/api-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-discovery", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add adam-s/intercept --skill api-discovery -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install adam-s/intercept api-discovery --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/adam-s/intercept.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/api-discovery .cursor/skills/api-discovery && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "api-discovery" agent skill from https://github.com/adam-s/intercept/tree/main/.claude/skills/api-discovery into .cursor/skills/api-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-discovery", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/adam-s/intercept.git --path .claude/skills/api-discovery

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add adam-s/intercept --skill api-discovery -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install adam-s/intercept api-discovery --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/adam-s/intercept.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/api-discovery .gemini/skills/api-discovery && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "api-discovery" agent skill from https://github.com/adam-s/intercept/tree/main/.claude/skills/api-discovery into .gemini/skills/api-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-discovery", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install adam-s/intercept api-discovery

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add adam-s/intercept --skill api-discovery -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/adam-s/intercept.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/api-discovery .github/skills/api-discovery && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "api-discovery" agent skill from https://github.com/adam-s/intercept/tree/main/.claude/skills/api-discovery into .github/skills/api-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-discovery", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add adam-s/intercept --skill api-discovery -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install adam-s/intercept api-discovery --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/adam-s/intercept.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/api-discovery .opencode/skills/api-discovery && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "api-discovery" agent skill from https://github.com/adam-s/intercept/tree/main/.claude/skills/api-discovery into .opencode/skills/api-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-discovery", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: api-discovery
GitHub stars: 189
Token cost: ~621 tokens
SKILL.md length: 233 words
Files: 11 (incl. scripts)
Skills in repo: 10
Repo updated: Jul 31, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Discover any website's API and create domain plugins with proxy routes.

Works in 5 steps: Observe — PRE-FLIGHT (write down what… → Classify — Run the discovery protocol… → Extract — Write routes: start with… → …
The user wants to create an API for a website
SKILL.md covers ⚠️💣 MANDATORY CONSENT CHECK…, Phases and References
Runs Shell scripts from its folder; calls bash

What it does

API Discovery is an agent skill from adam-s/intercept. Discover any website's API and create domain plugins with proxy routes. Use when the user wants to create an API for a website, discover a web service's data transport, add a new domain, capture browser traffic, build typed API clients, or integrate with a third-party site. Also use when the user mentions a website name and wants to interact with it programmatically.

Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts (for example `reference/decoding.md`, `reference/gotchas.md` and `reference/rate-limits.md`).

The repository describes itself as: Turn any website into a typed JSON API using self improving agents. The licence is MIT.

When your agent uses it

The user wants to create an API for a website
Discover a web services data transport
Add a new domain
Capture browser traffic

Example prompts

“/api-discovery”

Requirements

Node.js
A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Observe — PRE-FLIGHT (write down what you know about the site), then GATHER (connect browser, navigate to a page with 100+ items…
Classify — Run the discovery protocol per data type. Produce Transport Elimination table (MANDATORY GATE)
Extract — Write routes: start with browserFetch → run elimination → store minimum auth in GenericSessionManager → verify with…
Verify — Curl every route, confirm real data AND complete pagination (MANDATORY GATE — no dashboard until this passes)
Scaffold — Create domain plugin, register, test end-to-end. Command: bash ${CLAUDE_SKILL_DIR}/scripts/scaffold-domain.sh

What it can do on your machine

Read from SKILL.md and the folder at commit 6451b89. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
- bash
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Discovery loads about 621 tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 233 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~96
When it runs · the whole SKILL.md, loaded when a task matches: ~621

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from adam-s/intercept at commit 6451b89, republished under its MIT licence (© adam-s). 233 words, ~621 tokens.

Download SKILL.mdSave it as .claude/skills/api-discovery/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.

name: api-discovery
description: Discover any website's API and create domain plugins with proxy routes. Use when the user wants to create an API for a website, discover a web service's data transport, add a new domain, capture browser traffic, build typed API clients, or integrate with a third-party site. Also use when the user mentions a website name and wants to interact with it programmatically.

API Discovery

Check if .claude/user-consent.md exists with ACCEPTED: true. If yes, display: ✅ Prior consent on file (DATE). Proceeding. and skip to "Phases."

If not, present the 3 warnings from .claude/skills/instruction-tuning/SKILL.md (ToS, autonomous agents, resource consumption). All 3 must be accepted. Write .claude/user-consent.md on acceptance. This file is shared across all skills that access external websites.

Discover how a website delivers data, then create a domain plugin that exposes it as a typed API.

Before writing ANY code: follow .claude/rules/discovery.md and produce the Transport Elimination table.

Reference implementation: domains/boardshop/src/routes.ts has working examples of every transport type against the test server.

Phases

Observe — PRE-FLIGHT (write down what you know about the site), then GATHER (connect browser, navigate to a page with 100+ items, intercept pagination 2-3 times to capture the API pattern).
Classify — Run the discovery protocol per data type. Produce Transport Elimination table (MANDATORY GATE)
Extract — Write routes: start with browserFetch → run elimination → store minimum auth in GenericSessionManager → verify with rateLimitedFetch last. For Gap=Y: read session-harvest.md first.
Verify — Curl every route, confirm real data AND complete pagination (MANDATORY GATE — no dashboard until this passes)
Scaffold — Create domain plugin, register, test end-to-end. Command: bash ${CLAUDE_SKILL_DIR}/scripts/scaffold-domain.sh <name> <root-domain>

References

reference/decoding.md — When API values don't match rendered DOM
reference/rate-limits.md — 429/403 troubleshooting checklist
reference/gotchas.md — Singleton browser, background polling, multi-domain pages
reference/session-harvest.md — Capture, eliminate, trace, build: getting data from auth-gated endpoints

Files

SKILL.md and 10 other files (scripts) in .claude/skills/api-discovery of adam-s/intercept.

SKILL.md
reference/decoding.md
reference/gotchas.md
reference/rate-limits.md
reference/session-harvest.md
scripts/scaffold-domain.sh
templates/config.ts.template
templates/index.ts.template
templates/interceptor.ts.template
templates/package.json.template
templates/routes.ts.template

Open the folder on GitHubat commit 6451b89

Compare with similar skills

API Discovery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Discovery compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
API Discovery this skilladam-s/intercept	189	—	~621	Automated safety check: Pass	MIT	2 mo ago
Discover Pluginsruvnet/ruflo	74k	—	~2k	Automated safety check: Notes	MIT	today
Sitemap Domainthedaviddias/Front-End-Checklist	74k	—	~531	Automated safety check: Pass	MIT	2 days ago
Domain Driven Designdavila7/claude-code-templates	32k	5 repos	~623	Automated safety check: Pass	MIT	today
Domain Modeling and Glossarywindmill-labs/windmill	18k	—	~622	Automated safety check: Pass	Custom licence	yesterday
Aas Discoversickn33/agentic-awesome-skills	47k	1 repos	~523	Automated safety check: Pass	MIT	yesterday

Similar skills

Discover Plugins
ruvnet/ruflo
Discover and recommend ruflo plugins based on your workflow, installed MCP tools, and current task
74k GitHub stars~2k tokensUpdated today
Agent WorkflowsAuto-check: notes
Sitemap Domain
thedaviddias/Front-End-Checklist
A skill your agent uses when applies to sites that have recently migrated from HTTP to HTTPS, changed domain name, or have www/non-www redirect configurations.
74k GitHub stars~531 tokensUpdated 2 days ago
Marketing & SEOAuto-check passed
Domain Driven Design
davila7/claude-code-templates
Plan and route Domain-Driven Design work from strategic modeling to tactical implementation and evented architecture patterns.
32k GitHub starsUsed in 5 repos~623 tokens
DevelopmentAuto-check passed
Domain Modeling and Glossary
windmill-labs/windmill
Actively challenges vague or conflicting terminology as you design, and keeps a living domain glossary file up to date in real time.
18k GitHub stars~622 tokensUpdated yesterday
DevelopmentAuto-check passed
Aas Discover
sickn33/agentic-awesome-skills
Discover AAS skills for an explicit task and compare their complete instructions without installing them.
47k GitHub starsUsed in 1 repo~523 tokens
Auto-check passed
Codebase Domain Flow Extractor
Egonex-AI/Understand-Anything
Extracts business domains, flows and process steps from a codebase and produces an interactive horizontal flow graph, reusing an existing knowledge graph when one exists.
86k GitHub starsUsed in 1 repo~2.4k tokens
Knowledge ManagementAuto-check passed

Questions about API Discovery

What does API Discovery do?

Discover any website's API and create domain plugins with proxy routes. API Discovery is an agent skill from adam-s/intercept. Discover any website's API and create domain plugins with proxy routes.

When should I use API Discovery?

API Discovery fits situations like: the user wants to create an API for a website; discover a web services data transport; add a new domain; capture browser traffic.

How do I install API Discovery in Claude Code?

Run `npx skills add adam-s/intercept --skill api-discovery -a claude-code`. Or copy the skill folder (.claude/skills/api-discovery in adam-s/intercept) into .claude/skills/api-discovery in your project. Claude Code loads it when a task matches its description.

How do I install API Discovery in Codex?

Run `npx skills add adam-s/intercept --skill api-discovery -a codex`. Or copy the skill folder (.claude/skills/api-discovery in adam-s/intercept) into .agents/skills/api-discovery in your project. Codex loads it when a task matches its description.

Can I use API Discovery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add adam-s/intercept --skill api-discovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-discovery, .gemini/skills/api-discovery, .github/skills/api-discovery and .opencode/skills/api-discovery in your project.

What does API Discovery need to run?

Going by SKILL.md and its folder, API Discovery needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: Node.js; A Bash shell.

Does API Discovery access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Discovery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does API Discovery use?

API Discovery is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does API Discovery use?

About 621 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Discovery?

Skills that share tags, products or a category with API Discovery: Discover Plugins (ruvnet/ruflo, 74k stars), Sitemap Domain (thedaviddias/Front-End-Checklist, 74k stars), Domain Driven Design (davila7/claude-code-templates, 32k stars) and Domain Modeling and Glossary (windmill-labs/windmill, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Discovery?

adam-s (a GitHub user) maintains it in adam-s/intercept, which has 189 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on July 31, 2026.

Source: adam-s/intercept on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

API Discovery

Install API Discovery

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

API Discovery

Phases

References

Files

Compare with similar skills

Similar skills

Discover Plugins

Sitemap Domain

Domain Driven Design

Domain Modeling and Glossary

Aas Discover

Codebase Domain Flow Extractor

More from adam-s/intercept

App

Debug Logs

Instruction Dashboard Tuning

Instruction Tuning

Systematic Testing

Ec2 Deploy

Questions about API Discovery

Install API Discovery

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

API Discovery

⚠️💣 MANDATORY CONSENT CHECK 💣⚠️

Phases

References

Files

Compare with similar skills

Similar skills

More from adam-s/intercept

Questions about API Discovery