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[]	"*"

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

Best Practices Overview