`extract-api` Skill#

The extract-api skill reads API documentation from any source and imports every operation as a first-class sdkck command.

Installation#

Claude Code#

claude plugin marketplace add hesedcasa/sdkck
claude plugin install sidekick@api

Other coding tools#

Install with the skills CLI to use with Cursor, Codex, OpenCode, and 40+ other agents:

npx skills add hesedcasa/sdkck --skill extract-api

Install globally (available across all projects):

npx skills add hesedcasa/sdkck --skill extract-api -g

Target a specific agent:

npx skills add hesedcasa/sdkck --skill extract-api -a cursor
npx skills add hesedcasa/sdkck --skill extract-api -a codex
npx skills add hesedcasa/sdkck --skill extract-api -a opencode

Usage#

/extract-api {source} [--name {name}]

Argument	Description
`source`	GitHub URL, HTTP/HTTPS docs URL, or local file path
`--name`	Override the API name (default: derived from source)

Examples#

# From a hosted OpenAPI spec
/extract-api https://petstore3.swagger.io/api/v3/openapi.json --name petstore

# From a GitHub repo (auto-detects spec or crawls README/docs)
/extract-api https://github.com/stripe/openapi --name stripe

# From an online docs site (crawls linked reference pages)
/extract-api https://developers.notion.com/reference/intro

# From a Postman collection file
/extract-api ./my-workspace.postman_collection.json --name myapi

# From a GraphQL SDL file
/extract-api ./schema.graphql --name myapi

# From a live GraphQL endpoint
/extract-api https://countries.trevorblades.com/graphql --name countries

# From local markdown docs
/extract-api ./my-project/api-docs.md --name myapi

What happens#

Fast path — if the source is already an OpenAPI spec, Postman collection, or GraphQL schema (SDL, introspection JSON, or live endpoint), it is imported directly.
Crawl path — if the source is a GitHub repo or docs site, the skill probes for spec files, follows reference links, and generates an OpenAPI 3.0 document from the discovered content.
Import — runs sdkck api import and registers every operation as sdkck <name> <operationId>.
Auth setup — detects the auth scheme from the spec and shows the exact sdkck api auth command to configure credentials.

After import#

# Browse all imported commands
sdkck help petstore

# Search across them
sdkck search "petstore list pets"

# Call one
sdkck petstore listPets --limit 10

Supported sources#

Source	Notes
OpenAPI 3.0 / 3.1 JSON or YAML	Used directly — no extraction needed
Swagger 2.0 JSON or YAML	Used directly
Postman Collection v2.1	Converted to OpenAPI internally via `@scalar/postman-to-openapi`
GraphQL SDL (`.graphql`, `.gql`, `.graphqls`)	Auto-detected by extension; requires `--base-url`
GraphQL introspection JSON	Pass `--graphql` to force GraphQL mode
Live GraphQL endpoint (`/graphql` URL)	Auto-detected; fetches introspection automatically
GitHub repository URL	Probes for spec files; falls back to README + `docs/` crawl
HTTP/HTTPS docs URL	Probes well-known spec paths; crawls reference pages if needed
Local `.md`, `.html`, `.txt`	Extracts endpoints from prose and generates OpenAPI 3.0

extract-api Skill#