Crush — Skills
- File format
- Markdown
- Discovery path
-
.crush/skills - Global install path
-
~/.config/crush/skills - Syllago install method
- Symlink, Direct copy
- Symlink support
- Yes
- Native frontmatter fields
-
name,description,license,compatibility,metadata
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Fields
Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.
| Provider field | Conversion | Canonical key | Summary |
|---|---|---|---|
description | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | description | yaml frontmatter key: description (required); documents what the skill does and when Crush should invoke it |
disable-model-invocation | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | disable_model_invocation | yaml frontmatter key: disable-model-invocation (optional boolean) per the Agent Skills standard. Note: the Go Skill struct in skills.go does not have a corresponding field — behavior is inferred from the standard, not from explicit Crush source handling. |
name | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | display_name | yaml frontmatter key: name (required); follows the Anthropic Agent Skills standard. Validated: must be alphanumeric with hyphens, max 64 chars. |
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
canonical_filename | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | SKILL.md (required, fixed name per the Agent Skills standard) |
global_scope | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | ~/.config/crush/skills/<name>/SKILL.md (XDG-compliant native path) and ~/.agents/skills/<name>/SKILL.md (cross-provider convention) |
project_scope | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | .crush/skills/<name>/SKILL.md (native) and .agents/skills/<name>/SKILL.md (cross-provider convention) |
| Anthropic Agent Skills standard frontmatter | Preserved Conversion type: Preserved Syntax survives conversion but the target provider may not interpret it. Learn more → | Frontmatter follows the Agent Skills open standard (agentskills.io) with name, description, license, compatibility, metadata, and disable-model-invocation fields. |
| Cross-provider skill discovery | Preserved Conversion type: Preserved Syntax survives conversion but the target provider may not interpret it. Learn more → | Crush discovers skills from .agents/skills/ (cross-provider convention) in addition to .crush/skills/ (native) and ~/.config/crush/skills/ (user global). |
| Skill name must match directory name | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | Crush validates that the skill name from SKILL.md frontmatter matches the directory basename containing the SKILL.md file. Skills failing this check are rejected at load time. |
Sources
| Source |
|---|
| https://raw.githubusercontent.com/charmbracelet/crush/main/internal/skills/skills.go |
| https://raw.githubusercontent.com/charmbracelet/crush/main/internal/skills/builtin/crush-config/SKILL.md |