apiscribe

v2.3.0

OpenAPI-first API documentation. Skills keep specs, prose, and SDK examples in sync; an MCP server serves the spec registry.

3 skills1 MCP serverstdio

by Inkwell OSSApache-2.06.1kupdated 1 week ago

Install

$ git clone https://github.com/inkwell-oss/apiscribe

Clone into your agent client’s plugin directory — components are discovered from fixed locations per the spec.

Layout

apiscribe/

├── plugin.json
├── skills/
│   ├── endpoint-docs/
│   │   └── SKILL.md
│   ├── openapi-sync/
│   │   └── SKILL.md
│   └── sdk-examples/
│       └── SKILL.md
└── mcp.json

Skills3

endpoint-docsskills/endpoint-docs/

Write endpoint documentation with realistic request/response examples pulled from the spec's schemas.

openapi-syncskills/openapi-sync/

Diff the OpenAPI spec against handler signatures and update whichever side is stale.

sdk-examplesskills/sdk-examples/

Generate copy-pasteable SDK snippets per endpoint for each configured language target.

MCP servers1

spec-registrystdio

command: npx
args: -y @inkwell/apiscribe-mcp

Manifest

plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "apiscribe",
  "version": "2.3.0",
  "description": "OpenAPI-first API documentation. Skills keep specs, prose, and SDK examples in sync; an MCP server serves the spec registry.",
  "author": {
    "name": "Inkwell OSS",
    "email": "hello@inkwell.dev",
    "url": "https://inkwell.dev"
  },
  "homepage": "https://apiscribe.dev",
  "repository": "https://github.com/inkwell-oss/apiscribe",
  "license": "Apache-2.0",
  "keywords": [
    "documentation",
    "openapi",
    "api"
  ],
  "extensions": {
    "dev.inkwell.apiscribe": {
      "defaultStyle": "reference",
      "sdkTargets": [
        "typescript",
        "python"
      ]
    }
  }
}