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 skills

Outputs

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: 1. SKILL.struct.json / SKILL.toon (artifact-first) 2. quick_cmd from frontmatter 3. SKILL.md fallback

Use bundled helper:

skills/public/skill-compiler/scripts/exe skill-compiler

Publish-ready shape

This folder is ClawHub-ready once versioned: - SKILL.md - skill.yaml - scripts/*

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"

这个 Skill 的文档写得条理清晰、说明详细，看起来很专业。但实际拿到手后发现只是个"空壳"——没有可执行的程序代码，只有使用说明。对于想实际编译 SKILL 文件的用户来说，暂时无法使用。建议作者补充完整的编译脚本后再发布。