api-docs-portal

name	api-docs-portal
description	Generate premium API documentation portals from OpenAPI specs, route lists, or examples.

API Docs Portal

Generate a polished API documentation portal from OpenAPI specs, route files, or endpoint examples.

Requirements

• Authenticate with skills auth login.
• This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.

Usage

skills run api-docs-portal --spec "GET /v1/projects, POST /v1/projects" --title "Acme API"
skills run api-docs-portal --spec-file ./openapi.json --base-url "https://api.example.com" --auth bearer

Options

Option	Description	Default
--spec <text>	OpenAPI JSON, route list, or endpoint examples. Positional text also works.	required
--spec-file <path>	Read the API spec or route list from a file.	none
--title <text>	Portal and API title.	API Documentation
--base-url <url>	Base URL used in examples.	https://api.example.com
--auth <mode>	Auth mode: bearer, api-key, oauth, session, or none.	bearer
--theme <name>	Portal theme: light or slate.	light
--output <dir>	Output directory for direct local execution. Hosted runs use the run export directory.	run export dir

Outputs

• site/index.html
• site/styles.css
• site/endpoints.json
• openapi.json
• endpoint-reference.md
• auth-guide.md
• examples.md
• README.md
• manifest.json

After submitting a hosted run, poll with skills runs status <run-id> and download outputs with skills exports download <run-id>.