Jido.Code.Skill

Skill-only runtime for Jido-based markdown skills with signal-first dispatch.

Warning

This repository is pending archive.

Do not start new work in jido_skill.

Skill functionality from this package is being ported into jido_ai, which will remain the canonical implementation.

Track the migration here: agentjido/jido_ai#207 - Integrate Agent Skills support into jido_ai (port useful pieces from jido_skill)

Installation

Add jido_skill to your dependencies:

def deps do
  [
    {:jido_skill, "~> 0.1.0"}
  ]
end

Terminal Commands

Build the local skill escript:

mix escript.build

Invoke a skill from terminal:

./skill pdf-processor --route pdf/extract/text --data '{"file":"report.pdf"}'

Equivalent explicit form:

./skill run pdf-processor --route pdf/extract/text --data '{"file":"report.pdf"}'

Mix task equivalent:

mix skill.run pdf-processor --route pdf/extract/text --data '{"file":"report.pdf"}'

List discovered skills:

./skill list
mix skill.list --scope local

Reload skills and settings from disk:

./skill reload
mix skill.reload

Inspect active dispatcher routes:

./skill routes
mix skill.routes --reload

Watch skill lifecycle and registry signals:

./skill watch --limit 20
mix skill.watch --pattern skill.pre --pattern skill.post

Publish a skill signal manually:

./skill signal skill.pre --data '{"skill_name":"pdf-processor","route":"pdf/extract/text"}'
mix skill.signal custom.health.check --data '{"status":"ok"}'

Guides

• User guides: docs/user/
• Developer guides: docs/developer/
• Acceptance contracts by phase: docs/contracts/