02 / Documentation

Install Agent Skills

Skills are folders with a SKILL.md file and optional resources that an AI agent loads for a specific job. Knackbox skills follow the open Agent Skills format.

Install targets

Knackbox CLI

Zero-dependency Node CLI. Resolves the live catalog, downloads the repo tarball, and extracts only the skill folder. Defaults to ~/.claude/skills.

Use --agent cursor|codex|opencode, --dest DIR, or --force. Install a starter pack with npx knackbox pack <slug>.

Start from a job

npx knackbox for "review a PR"

See all job guides. Add --add to install the match.

Add a skill

npx knackbox add commit-messages

Install a pack

npx knackbox pack developer-essentials

Skills CLI

Install through the open Agent Skills ecosystem. The CLI detects installed agents including Claude Code, Codex, OpenCode, Cursor, and others.

Add -g for a global install or -a claude-code to select a target explicitly.

Example

npx skills add shinzoxD/knackbox --skill commit-messages

Claude.ai

Open Settings, Capabilities, Skills, then upload the skill folder or paste the SKILL.md content.

Repository installer

The dependency-free shell installer remains available for Claude Code or a custom destination.

Fallback

curl -fsSL https://raw.githubusercontent.com/shinzoxD/knackbox/main/install.sh | bash -s commit-messages

Skill format

Each skill has YAML frontmatter with a name and a trigger-oriented description, followed by instructions. Optional references/, scripts/, and assets/ folders stay with the skill.

Scores, tiers, and catalog fields are generated from the repository. See metrics for the measurement model.