58 lines
1.2 KiB
YAML
58 lines
1.2 KiB
YAML
name: api.define
|
|
version: 0.1.0
|
|
description: Create OpenAPI and AsyncAPI specifications from templates
|
|
|
|
inputs:
|
|
- name: service_name
|
|
type: string
|
|
required: true
|
|
description: Name of the service/API (e.g., user-service, order-api)
|
|
|
|
- name: spec_type
|
|
type: string
|
|
required: false
|
|
default: openapi
|
|
description: Type of specification (openapi or asyncapi)
|
|
|
|
- name: template
|
|
type: string
|
|
required: false
|
|
default: zalando
|
|
description: Template to use (zalando, basic, minimal)
|
|
|
|
- name: output_dir
|
|
type: string
|
|
required: false
|
|
default: specs
|
|
description: Output directory for generated specification
|
|
|
|
- name: version
|
|
type: string
|
|
required: false
|
|
default: 1.0.0
|
|
description: API version
|
|
|
|
outputs:
|
|
- name: spec_path
|
|
type: string
|
|
description: Path to generated specification file
|
|
|
|
- name: spec_content
|
|
type: object
|
|
description: Generated specification content
|
|
|
|
dependencies:
|
|
- context.schema
|
|
|
|
entrypoints:
|
|
- command: /skill/api/define
|
|
handler: api_define.py
|
|
runtime: python
|
|
permissions:
|
|
- filesystem:read
|
|
- filesystem:write
|
|
|
|
status: active
|
|
|
|
tags: [api, openapi, asyncapi, scaffolding, zalando]
|