Examples

The skrun repository includes small executable skills under examples/skills. Each example is a normal local program plus artifact.json, SKILL.md, optional schemas, and a strict stdin/stdout JSON entrypoint.

regex-finder

regex-finder is a Rust binary skill that evaluates regular expressions over provided text.

skrun skill build examples/skills/regex-finder
skrun skill run \
  --input '{"action":"match","input":{"pattern":"\\d+","text":"abc 123"}}' \
  examples/skills/regex-finder

Expected output:

{
  "ok": true,
  "action": "match",
  "data": {
    "matched": true
  },
  "error": null
}

cdp-browser

cdp-browser is a browser-control skill shape built around a strict stdio-json command protocol.

skrun skill build examples/skills/cdp-browser
skrun skill run --input '{"action":"describe"}' examples/skills/cdp-browser

The example demonstrates how an existing tool can become a skill by adding:

• artifact.json
• SKILL.md
• input and output JSON schemas
• a single stdin/stdout executable entrypoint

That is the core skrun pattern: keep the useful local program, add a stable artifact manifest, and let an agent framework call it through skrun.

Release Assets

Example skill release assets are published from tags such as:

git tag regex-finder@0.1.2
git tag cdp-browser@0.1.3
git push origin --tags

The release workflow builds the binary, runs its smoke test, packages the skill directory, and uploads a .tar.gz asset to GitHub Releases.

Example skill docs should stay aligned with the checked-in Rust and Python skills, their smoke tests, and the release packaging path.