Add or edit skills bundled with Crush, following guidance on file placement, required metadata, compile-time embedding, and discovery tests. It also explains how built-in skills are loaded and how user skills override them.
Use when creating a new builtin skill for Crush, editing an existing builtin skill (internal/skills/builtin/), or when the user needs to understand how the embedded skill system works.
Review the instructions the agent will receive before you install.
Crush embeds skills directly into the binary via internal/skills/builtin/.
These are always available without user configuration.
internal/skills/builtin/<skill-name>/SKILL.md.//go:embed builtin/* in
internal/skills/embed.go.DiscoverBuiltin() walks the embedded FS, parses each SKILL.md, and sets
paths with the crush://skills/ prefix (e.g., crush://skills/jq/SKILL.md).crush:// paths from the embedded FS, not disk.Deduplicate()).internal/skills/builtin/<skill-name>/SKILL.md with YAML frontmatter
(name, description) and markdown instructions. The directory name must
match the name field.//go:embed builtin/* picks up new directories
automatically.TestDiscoverBuiltin in
internal/skills/skills_test.go to verify discovery.go build . && go test ./internal/skills/...| Skill | Directory | Description |
|---|---|---|
crush-config | builtin/crush-config/ | Crush configuration help |
crush-hooks | builtin/crush-hooks/ | Authoring, configuring and debugging hooks |
jq | builtin/jq/ | jq JSON processor usage guide |
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Configure Crush with Bash or JSON files to choose AI providers and models, connect external tools, set permissions, and adjust behavior. Understand how project and global settings combine when customizing your working environment.
Create, configure, and troubleshoot Crush hooks, commands that run before tool execution. Use them to block or approve calls, rewrite tool input, or add context for the agent, with guidance on configuration and troubleshooting.
Extract fields, filter records, and reshape JSON from API responses, configuration files, or logs using Crush’s built-in jq. Get help writing and debugging transformations, constructing new JSON, and formatting output for other commands.
Add or modify commands handled inside Crush's embedded shell before they reach the operating system. The guidance covers command routing, input and output streams, exit codes, and cancellation so commands work with pipes, redirection, and hook timeouts.