How do I deploy the skills?
Table of Contents
For where the output lands and how the build script works, see CMake setup.
1. Question
How do I build the Claude Code skills bundle locally?
2. Answer
compass build --direct skills invokes Emacs in batch mode against
projects/ores.lisp/src/ores-build-skills.el, which exports each skill under doc/llm/skills/ to
the format Claude Code expects. It calls Emacs directly (no cmake, no
vcpkg), so it works in a light environment:
./compass.sh build --direct skills
Output lands in the skills directory configured by CMakeLists.txt
(ORES_SKILLS_DIRECTORY, by default the .claude/skills/ beside the
checkout). The script prunes that directory after it writes, so a skill
removed from doc/llm/skills/ leaves the bundle in the same run, and a
failed publish never empties it.
In a full environment the equivalent deploy_skills CMake target
(cmake --build --preset <preset> --target deploy_skills) runs the same
script; prefer the compass command above.
2.1. Prerequisites
- Emacs on PATH. (No cmake configure step is required for
--direct.)
3. Script
projects/ores.lisp/src/ores-build-skills.el is the Emacs script that compass build --direct
skills runs. The equivalent deploy_skills CMake target definition
lives in CMakeLists.txt near add_custom_target(deploy_skills ...) and
invokes the same script.
4. Tested by
No dedicated CI workflow yet — the target is exercised by manual deployment when a skill is updated.
5. See also
- CMake setup
- How do I deploy the site? — parallel target for the website.
- How do I deploy the settings? — parallel target for Claude Code permissions.