skrun

<p align="center"> </p>

<p align="center"> <a href="https://github.com/skrun-dev/skrun/actions"></a> <a href="https://www.npmjs.com/package/@skrun-dev/cli"></a> <a href="LICENSE"></a> </p>

---

Turn any Agent Skill (SKILL.md) into a callable API via POST /run. Multi-model, stateful, open source.

npm install -g @skrun-dev/cli

# Import an existing skill → deploy → call
skrun init --from-skill ./my-skill
skrun deploy

curl -X POST localhost:4000/api/agents/dev/my-skill/run \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"input": {"query": "analyze this"}}'

• Create a new agent
• Import an existing skill
• Develop & test locally
• Deploy

skrun init my-agent
cd my-agent
# Creates SKILL.md (instructions) + agent.yaml (config)

skrun init --from-skill ./path-to-skill
# Reads SKILL.md, asks 2-3 questions, generates agent.yaml

skrun dev
# ✓ Server running at http://localhost:3000
# POST /run ready — watching for changes...

skrun test
# ✓ basic-test (output.score >= 0)
# 1 passed, 0 failed

skrun deploy
# ✓ Validated → Built → Pushed
# 🚀 POST http://localhost:4000/api/agents/you/my-agent/run

> v0.1 ships with a local runtime. Cloud deploy is on the roadmap — the architecture is ready (RuntimeAdapter interface).

• [Agent Skills](https://agentskills.io) — SKILL.md standard, co