Documentation

Render API

## GET /api/adapters/render Returns the list of available models and a built-in sample spec — useful for initializing forms. ```bash curl https://prompt.solokit.run/api/adapters/render ``` ```json { "data": { "models": [ { "family": "claude", "label": "Claude (Anthropic)", "examples": ["claude-sonnet-4.5"], "origin": "international", "reasoning": false, "longContext": true, "preferredFormat": "xml", "toolProtocol": "anthropic" }, { "family": "deepseek-r1", "label": "DeepSeek R1 (reasoning)", ... } ], "sample": { "id": "code-reviewer", ... } } } ``` ## POST /api/adapters/render | Field | Type | Description | | --- | --- | --- | | spec | CanonicalSkillSpec | Required — the spec to render | | targets | ModelFamily[] | "*" | Optional; omit or use "*" to render to all models | ```bash curl -X POST https://prompt.solokit.run/api/adapters/render \ -H "Content-Type: application/json" \ -d @spec.json ``` ## Response Fields (RenderedSkill) | Field | Type | Description | | --- | --- | --- | | family | ModelFamily | Target model family | | system | string | Content to put in the system role (may be empty for reasoning models) | | user | string? | First-turn user message for reasoning models (instructions merged in) | | messages | {role,content}[]? | Complete messages payload — pass directly to OpenAI-compatible APIs | | tools | any? | Vendor-native tool schema (Anthropic / OpenAI / Google) | | recommendedParameters | Record<string,any>? | Suggested params (temperature / reasoning_effort / response_format) | | artifacts | {filename,language,content,description}[]? | Extra artifacts, e.g. Claude's SKILL.md | | notes | string[] | Model-specific usage notes | ## Errors | HTTP | Description | | --- | --- | | 400 | Invalid spec (missing fields, bad id format, JSON parse error) | | 400 | targets contains an unknown model family |