Skip to main content

Skills

A skill is a folder with a SKILL.md: short frontmatter plus a markdown body the agent can load with builtin_skill. Skills are extra instructions for a domain (Rust gates, kernel builds, your team’s review checklist). They do not add tools or bypass permissions.

Skills are not dumped into every prompt. Knox may hint a matching skill name; the full body loads when the agent calls builtin_skill. Type /skills to list what is loaded and which directories were scanned.

SKILL.md format​

---
name: rust-review
description: Review a Rust diff for ownership, clippy, and missing tests. Use when reviewing .rs files or cargo check output.
globs: ["**/*.rs", "Cargo.toml"]
---

1. Restate the ownership graph in prose.
2. Prefer `builtin_build` over shell cargo.
3. Do not `cargo clean` unless asked.

Required: name, description. Optional: globs, paths, or applyTo (same matching as rules). A skill with globs is only offered while a matching file is open.

The body can include @./relative/file references and !`shell` snippets. Follows symlinks when scanning.

Where Knox looks​

Project (workspace, walking up toward the repo root):

LocationNotes
skills/ or skill/Knox-native project skills
.claude/skills/Claude Code compat
.agents/skills/Shared-agent compat
.opencode/skill/ and .opencode/skills/OpenCode compat

This machine:

LocationNotes
~/.knoxcoder/skills/User skills (Knox-native)
~/.claude/skills/, ~/.agents/skills/, ~/.opencode/skill(s)/Same compat dirs, global

Bundled (shipped with Knox): rust, linux-kernel, qemu, gdb, kbuild. A project skill with the same name overrides a bundled or global one.

Skip directories: node_modules, .git, __pycache__, .venv.

There is no remote skill registry in 2.2. Put files on disk. config.yaml uses: owner/package is a local YAML include under ~/.knoxcoder/registry/, not a skill download — see Prompts and config.yaml.

Using a skill​

  1. Drop skills/my-skill/SKILL.md in the repo (or ~/.knoxcoder/skills/my-skill/SKILL.md).
  2. /skills — confirm it appears.
  3. Ask Knox to do the matching work, or mention the skill in chat. The agent calls builtin_skill when it needs the body.

Verified recipes with at least three clean replays can be saved as a skill (Recipes tab → Save as project / global skill). Existing skills are never overwritten.

Next​

AGENTS.md and rules · Custom agents · Prompts and config.yaml