05 / FAQ
Agent Skills FAQ
Knackbox is an open SKILL.md library for Claude Code, Codex, Cursor, and OpenCode. These are the questions people ask before they install.
What is Knackbox?
- Knackbox is an open library of Agent Skills (SKILL.md folders) for Claude Code, Codex, Cursor, OpenCode, and any runtime that loads the Agent Skills format. Skills are ranked by review, benchmark coverage, and measured quality — not install counts.
What are Agent Skills?
- Agent Skills are portable folders with a SKILL.md file of YAML frontmatter plus instructions. Compatible agents load a skill when the description matches the user's task — commits, reviews, SQL, incidents, writing, and more.
How is Knackbox different from skills.sh?
- skills.sh is a discovery directory ranked by popularity. Knackbox is a curated quality layer on the same open format: every skill ships a benchmark suite, a content digest, declared permissions, and honest empty scores until measured.
How do I install a skill for Claude Code?
- Run npx knackbox add <skill-name>. The default destination is ~/.claude/skills. You can also use npx skills add shinzoxD/knackbox --skill <name> or the curl installer in the docs.
Do these skills work with Cursor, Codex, and OpenCode?
- Yes. Pass --agent cursor, --agent codex, or --agent opencode to the Knackbox CLI, or let the open Skills CLI detect installed agents. Any runtime that reads SKILL.md can load the folders as-is.
Are Knackbox skills free?
- Yes. The catalog is Apache-2.0. You can install, fork, and contribute skills under the same license with DCO sign-off.
How are skills ranked?
- Tiers are core, verified, and community. Measured columns include trigger accuracy, quality uplift, context cost, and a composite score. Unmeasured fields stay visibly empty instead of being estimated.
How do I contribute a new Agent Skill?
- Scaffold with python scripts/new_skill.py, replace every TODO, add at least five trigger and five near-miss prompts, run python scripts/validate.py, and open a pull request. See the contribute page and CONTRIBUTING.md.