Installing Uzzo skills in AI coding tools
Uzzo workflow skills are shipped as resources in the uzzo-workflow-kb artifact (a jar file,). Each skill is a directory containing a SKILL.md file (and optional supporting files) under /uzz/skills/<name>/ inside the jar.
This page shows how to obtain the jar from Maven Central and install the skills for GitHub Copilot, Claude Code, and OpenCode.
1. Download the jar from Maven Central
Download the uzzo-workflow-kb jar for the version you want:
- Artifact:
com.github.stefanofornari:uzzo-workflow-kb - Browse versions: Maven Central
Example (replace VERSION with a released version, e.g. 0.1.0):
VERSION=<version>
curl -fL -o uzzo-workflow-kb.jar \
"https://repo1.maven.org/maven2/com/github/stefanofornari/uzzo-workflow-kb/${VERSION}/uzzo-workflow-kb-${VERSION}.jar"
2. Extract the skills from the jar
The skills are packaged under uzz/skills/ in the jar. Extract them to a temporary location:
mkdir -p /tmp/uzzo-skills
unzip uzzo-workflow-kb.jar 'uzz/skills/*' -d .
cp -R uzz/skills /tmp/uzzo-skills/
After extraction, /tmp/uzzo-skills/skills contains the skill directories (for example kb/, scope/, story/, code/, uzzo-init/), each with a SKILL.md.
3. Install the skills
Choose a project location to share skills with a repository, or a personal/global location to make them available across projects on your machine. Copy the extracted skill directories into the location your tool reads.
GitHub Copilot
Copilot discovers project skills from .github/skills/, .claude/skills/, or .agents/skills/ in a repository, and personal skills from ~/.copilot/skills/ or ~/.agents/skills/.
Project install:
mkdir -p .github/skills
cp -R /tmp/uzzo-skills/skills/* .github/skills/
Personal install:
mkdir -p ~/.copilot/skills
cp -R /tmp/uzzo-skills/skills/* ~/.copilot/skills/
Each copied folder must contain its SKILL.md at .github/skills/<skill-name>/SKILL.md (or the equivalent personal path).
Claude Code
Claude Code loads project skills from .claude/skills/ and personal skills from ~/.claude/skills/.
Project install:
mkdir -p .claude/skills
cp -R /tmp/uzzo-skills/skills/* .claude/skills/
Personal install:
mkdir -p ~/.claude/skills
cp -R /tmp/uzzo-skills/skills/* ~/.claude/skills/
Start a new Claude Code session (or use /skills / /reload-skills as needed) to pick up newly added skills.
OpenCode
OpenCode discovers project skills from .opencode/skills/ and global skills from ~/.config/opencode/skills/ (it also reads .claude/skills/ and .agents/skills/ for compatibility).
Project install:
mkdir -p .opencode/skills
cp -R /tmp/uzzo-skills/skills/* .opencode/skills/
Global install:
mkdir -p ~/.config/opencode/skills
cp -R /tmp/uzzo-skills/skills/* ~/.config/opencode/skills/
OpenCode discovers skills when a session starts; open a new session after installing.
4. Verify the installation
- Confirm each skill directory contains
SKILL.md(e.g.ls <skills-dir>/kb). - Use the tool’s skill listing or invoke a skill by name (for example, ask the agent to use the Uzzo
kb/knowledge-base orscopeskill) to confirm it is discovered. - To update, download the new jar version and repeat the copy, replacing the existing skill directories.
Notes
- The canonical skill sources in this repository live under
uzzo-workflow-kb/src/main/resources/uzz/skills/and are packaged by theuzzo-workflow-kbmodule. Installing from the jar gives the same content as a released artifact. - If you prefer to install directly from a checkout instead of Maven Central, copy the contents of
uzzo-workflow-kb/src/main/resources/uzz/skills/into the same destination directories shown above.