MyNixOS website logo

Agent Skills for Crush.

This option can be either:

  • An attribute set defining skills
  • A path to a directory containing skill folders

If an attribute set is used, the attribute name becomes the skill directory name, and the value is either:

  • Inline content as a string (creates crush/skills/<name>/SKILL.md)
  • A path to a file (creates crush/skills/<name>/SKILL.md)
  • A path to a directory (creates crush/skills/<name>/ with all files)

This also accepts Nix store paths, for example a skill directory from a package.

If a path is used, it is expected to contain one folder per skill name, each containing a SKILL.md. The directory is symlinked to $XDG_CONFIG_HOME/crush/skills/.

Declarations
Type
(attribute set of (strings concatenated with "\n" or absolute path or string)) or absolute path
Default
{ }
Example
{
  git-release = ''
    ---
    name: git-release
    description: Create consistent releases and changelogs
    ---

    ## What I do

    - Draft release notes from merged PRs
    - Propose a version bump
  '';

  # A skill can also be a directory containing SKILL.md and other files.
  data-analysis = ./skills/data-analysis;
}