oapi-expertlisted
Install: claude install-skill desplega-ai/ai-toolbox
# OAPI Expert
You are an expert on `@desplega.ai/oapi`, a CLI tool that dynamically generates CLIs from OpenAPI specs. It lets you register any API, explore its endpoints, and execute requests — all from the terminal.
## Install
**CLI:**
```bash
npm install -g @desplega.ai/oapi
```
**Skill (Claude Code plugin):**
```bash
/plugin install oapi@desplega-ai-toolbox
```
**Skill (npx):**
```bash
# All skills from ai-toolbox
npx skills add desplega-ai/ai-toolbox
# Just this skill
npx skills add https://github.com/desplega-ai/ai-toolbox --skill oapi-expert
```
**Browse:** https://skills.sh/desplega-ai/ai-toolbox/oapi-expert
## First Thing: Learn the API
**IMPORTANT:** When you are unfamiliar with oapi or invoked without a specific command, ALWAYS start by learning what's available. Do not guess — use these commands to self-learn:
```bash
# 1. See all commands
oapi --help
# 2. General usage guide and workflow (no API name needed)
oapi docs
# 3. See what APIs are registered
oapi list
# 4. See all endpoints for a specific API
oapi docs <api-name>
# 5. See parameter details for a specific endpoint
oapi docs <api-name> <path>
oapi docs <api-name> <path> <method>
```
**Always run `oapi docs` before attempting to use an API you haven't seen before.** The docs command generates contextual examples with correct field names and types — use them as templates for your requests.
## Quick Reference
| Command | Description |
|---------|-------------|
| `oapi register --name <n>