- name
- skill-compiler
- description
- Compile SKILL.md files into runtime artifacts (SKILL.struct.json and SKILL.toon), verify freshness/health, and prepare portable publish-ready skill folders for ClawHub-style registries.
- contract_version
- v0
- quick_cmd
- skills/public/skill-compiler/scripts/compile-skill --skill skills/todoist/SKILL.md
- risk_level
- safe
- capabilities
- bins
- [bash, mdquery, jq, toon]
- network
- false
- secrets
- []
- dry_run_cmd
- skills/public/skill-compiler/scripts/check-env
- compat
- os
- [linux, macos]
- arch
- [x64, arm64]
- shell
- [bash]
- owner
- matt
- last_tested
- 2026-03-08
- rollback
- remove skills/public/skill-compiler and revert commit
- category
- ops
- inputs_min
- []
- cost_hint
- low
skill-compiler
Compile-first workflow for skill runtime performance.
Commands
# Check local dependencies
skills/public/skill-compiler/scripts/check-env
# Compile one skill doc
skills/public/skill-compiler/scripts/compile-skill --skill skills/todoist/SKILL.md
# Compile all SKILL.md under a root (default: ./skills)
skills/public/skill-compiler/scripts/compile-all --root skillsOutputs
For each input SKILL.md, compiler generates sibling artifacts:
SKILL.struct.json(canonical runtime structure)SKILL.toon(token-lean projection)
Entrypoint trigger setup (exe / execute)
Preferred runtime trigger words:
exe <skill>execute <skill>
Resolution order:
SKILL.struct.json/SKILL.toon(artifact-first)quick_cmdfrom frontmatterSKILL.mdfallback
Use bundled helper:
skills/public/skill-compiler/scripts/exe skill-compilerPublish-ready shape
This folder is ClawHub-ready once versioned:
SKILL.mdskill.yamlscripts/*
Optional publish command:
clawhub publish ./skills/public/skill-compiler \
--slug skill-compiler \
--name "Skill Compiler" \
--version 0.2.0 \
--changelog "Add exe/execute trigger docs and artifact-first entrypoint"