MyNixOS website logo
option

programs.github-copilot-cli.skills

Custom skills for GitHub Copilot CLI.

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 ${configDir}/skills/<name>/SKILL.md)
  • A path to a file (creates ${configDir}/skills/<name>/SKILL.md)
  • A path to a directory (symlinks ${configDir}/skills/<name>/ to that directory)

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 ${configDir}/skills/.

See https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference#skills-reference for the documentation.

Declarations
Type
(attribute set of (strings concatenated with "\n" or absolute path or string)) or absolute path
Default
{ }
Example
{
  data-analysis = ./skills/data-analysis;
  release-notes = ''
    ---
    name: release-notes
    description: Draft release notes from commits and pull requests.
    ---

    Summarize user-visible changes and call out migrations.
  '';
}