skrun

skrun is a Python-first executable skill runtime for AI agent frameworks. It lets an agent discover, build, install, and call local skills without taking over the main agent loop.

Why skrun

• Build skills as small local executables.
• Call Rust binary skills through a Python API.
• Run uv-backed Python skills with the same JSON protocol.
• Keep skill execution separate from the agent framework.
• Use generated architecture docs to keep humans and coding agents aligned.

Install

pip install skrun

cargo install skrun

Minimal Python Use

import skrun

result = skrun.skill("regex-finder").call({
    "action": "match",
    "input": {
        "pattern": "\\d+",
        "text": "abc 123"
    }
})

Documentation Map

• Quickstart covers installation and the first local skill call.
• Examples covers the bundled binary skill examples.
• Frameworks shows how to wrap skills from existing agent frameworks.
• Generated Reference is produced by Codocia from source-local documentation blocks.