# 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.