Skip to content

Sohri Skill Runtime

Version

v0.1.2 · built 2026-08-19 · source /data/mago-services/sohri/sohri-skill-runtime

A generic execution proxy between Sohri Graph Builder and Sohri Skill Engine.

Execution contract

  • Graph Builder: POST /v1/skills/execute
  • Skill Engine: POST /v1/skills/execute
  • skill_id → skill
  • arguments → input
  • kebab-case Skill ID → snake_case Engine ID

The Runtime contains no Skill-specific implementations or input/output models. Skill Engine owns the Skill contracts and the actual execution.

Quick start

./scripts/install.sh
source .venv/bin/activate
python -m cli.main serve --reload
  • API docs: http://localhost:59213/skill_runtime/docs
  • Health check: http://localhost:59213/health/live
  • Execution API: http://localhost:59213/v1/skills/execute

Design principles

  • arguments are never interpreted or modified.
  • Execution POSTs are never retried automatically or cached, so the Runtime stays safe for any Skill.
  • Engine errors are converted to the Runtime's common error format.
  • The Skill ID in the Engine response is checked against the requested ID.

Development commands

python -m cli.main test
python -m cli.main openapi --output docs/openapi.json
python -m cli.main smoke \
  --skill-id sample-skill \
  --arguments '{"query":"example"}'

See the API contract and API reference for details, and Deployment and operations for running the service.