---
name: "openapi-rest-explorer"
description: "Browse API endpoints interactively. Pre-loaded with the SkillSlap REST API spec — endpoints, parameters, response schemas, and status codes all in one view."
metadata:
version: "1.0.0"
runtime:
entrypoint: "openapi-explorer.html"
---
# OpenAPI REST Explorer
> **Purpose:** Render any REST API spec as an interactive, searchable reference UI. Pre-loaded with the SkillSlap API endpoints. Click an endpoint in the sidebar to see its full documentation: description, parameters (with types and required flags), example response schema, and status codes.
---
## What's Included (Pre-loaded)
| Method | Path | Description |
|--------|------|-------------|
| GET | /skills | List all skills with search and filtering |
| GET | /skills/{id} | Retrieve full skill details |
| POST | /skills | Create and publish a new skill |
| POST | /skills/{id}/fork | Fork a skill to your account |
| GET | /skills/{id}/verifications | List verification runs |
---
## How to Use
1. Click any endpoint in the left sidebar
2. Read the description, parameters, and response schema
3. Use **Try It Out** to manually test against a live API
---
## Reading Parameters
- **Red asterisk (*)** — required parameter
- `in: path` — part of the URL
- `in: query` — appended as `?key=value`
- `in: body` — sent as JSON request body
- `in: header` — sent as HTTP header
---
## Adapting to Your API
Modify the `api.endpoints` array in the source to document your own API. The renderer handles GET, POST, PUT, DELETE, and PATCH with color-coded method badges.
---
## Files
### `openapi-explorer.html`
```html
OpenAPI REST Explorer
```