Skip to main content

Module skills

Module skills 

Source
Expand description

The agent skills: the embedded files, the user-scope record, and the installer.

Skills land under the invoking user’s home and never into a target repository. An agent resolves a skill by name across scopes, so a second copy under one name is a second entry offering the same skill, with no way for the operator to tell which one runs. One installed binary already serves every repository, and the skills routing into it belong at the same scope.

That places every destination outside the reach of rk init, which has a target directory to compare against and a landing to refuse. Here there is no target and no manifest, so record stands in for one: it answers the single question the installer cannot otherwise answer — are these bytes ones we wrote?

Re-exports§

pub use crate::digest::Digest;

Modules§

installer
Install the embedded skills into the agent skill directories.
record
The user-scope skill record: what this tool last wrote outside a project.

Structs§

Package
One installed skill: its name and every file its directory carries.
PackageFile
One file of an installed skill package.
SharedArtifact
One shared artifact: its file name, and its bytes.
Skill
One embedded skill: its directory name and its SKILL.md text.

Enums§

PackageError
Why a skill’s authored files do not compose into a package.

Constants§

AGENTS_ROOT
The root Codex, Gemini CLI, and Copilot read, relative to the home directory.
CLAUDE_ROOT
The root Claude Code reads, relative to the home directory.
LEGACY_SHARED_ROOT
The root an earlier release installed the shared gates to, relative to the home directory.
REFERENCES_DIR
The directory inside a package that holds its reference files, the shared gates’ copies among them.

Functions§

all
Every embedded skill, sorted by name.
compose
Compose one package from a skill’s own files and the shared artifacts.
home
The home directory, from the environment.
packages
Every embedded skill as the package an install writes, sorted by name.
shared
Every artifact the skills share, sorted by path.