Skill: neckr0ik/neckr0ik-api-wrapper (version 1.0.0)

--- name: neckr0ik-api-wrapper version: 1.0.0 description: Convert any REST API into an OpenClaw skill automatically. Generates SKILL.md, scripts, and claw.json from OpenAPI spec or URL. Use when you want to quickly create a skill for any API. --- # API Wrapper Generator Automatically generate OpenClaw skills from REST APIs. ## What This Does - **Parses OpenAPI specs** — Read API documentation - **Generates skill files** — SKILL.md, scripts, claw.json - **Handles authentication** — API keys, OAuth, Bearer tokens - **Creates type-safe wrappers** — Validates requests/responses - **Documents endpoints** — Usage examples for each operation ## Quick Start ```bash # Generate skill from OpenAPI spec neckr0ik-api-wrapper generate --spec https://api.example.com/openapi.json --name my-api # Generate from URL (discovers OpenAPI) neckr0ik-api-wrapper generate --url https://api.example.com --name my-api # Generate from local file neckr0ik-api-wrapper generate --spec ./openapi.yaml --name my-api ``` ## Output Structure ``` my-api/ ├── SKILL.md # Skill documentation ├── claw.json # Package metadata └── scripts/ └── api.py # Generated API client ``` ## Supported Auth Types | Type | Support | Config | |------|---------|--------| | API Key (header) | ✅ | `--auth header:X-API-Key` | | API Key (query) | ✅ | `--auth query:api_key` | | Bearer Token | ✅ | `--auth bearer` | | Basic Auth | ✅ | `--auth basic` | | OAuth 2.0 | ✅ | `--auth oauth2` | ## Commands ### generate Generate OpenClaw skill from API spec. ```bash neckr0ik-api-wrapper generate [options] Options: --spec <url> OpenAPI spec URL or file --url <url> API base URL (discovers spec) --name <name> Skill name (default: api name) --output <dir> Output directory --auth <type> Authentication type --include <endpoints> Include specific endpoints (comma-sep) --exclude <endpoints> Exclude specific endpoints (comma-sep) ``` ### validate Validate OpenAPI spec before generating. ```bash neckr0ik-api-wrapper validate --spec <url> ``` ### test Test generated skill against live API. ```bash neckr0ik-api-wrapper test --skill ./my-api --endpoint <operationId> ``` ## Generated Skill Example ```markdown # Generated from Stripe API ## Quick Start ```bash stripe-api customers list --limit 10 stripe-api customers create --email "[REDACTED_SECRET]" stripe-api charges create --amount 1000 --currency usd ``` ## Endpoints ### customers.list List all customers. - Method: GET - Path: /v1/customers - Auth: Bearer Token ### customers.create Create a new customer. - Method: POST - Path: /v1/customers - Auth: Bearer Token - Body: email, name, metadata ``` ## Benefits 1. **Speed** — Generate skills in minutes, not hours 2. **Consistency** — Standard format for all API skills 3. **Documentation** — Auto-generated from OpenAPI 4. **Type Safety** — Request/response validation 5. **Maintainability** — Regenerate when API updates ## Use Cases - **API Providers** — Create skills for your APIs - **Developers** — Quickly integrate new APIs - **Monetization** — Sell skills for popular APIs ## Example APIs to Wrap - Stripe Payments API - OpenAI API - Slack API - Notion API - GitHub API - Any OpenAPI-compliant API ## See Also - `references/openapi.md` — OpenAPI specification guide - `references/templates/` — Skill templates - `scripts/generator.py` — Main generator


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)