Skip to main content

Skills & Agents Tabs

The Skills and Agents tabs share the same structure. Both display YAML-defined extensions that add specialized capabilities to Copilot CLI — skills provide domain-specific workflows, while agents define autonomous task runners.

Sources

TypeUser directoryPlugin-bundled directory
Skills~/.copilot/skills/~/.copilot/installed-plugins/<plugin>/skills/
Agents~/.copilot/agents/~/.copilot/installed-plugins/<plugin>/agents/

Columns

ColumnDescription
NameSkill or agent name (from YAML filename or name field)
Sourceuser for files in the user directory, or the plugin name for bundled items
DescriptionShort description from the YAML description field

Detail Pane

Selecting a skill or agent displays its full YAML content:

  • Name and description
  • Triggers — keywords or phrases that activate the skill/agent
  • Allowed tools — which tools the skill/agent is permitted to use
  • Locationuser or the parent plugin name
  • Any additional YAML fields defined in the file

Plugin-Bundled Discovery

copilot-setup scans each installed plugin's directory for bundled skills and agents. During data loading, the app walks:

~/.copilot/installed-plugins/
└── <plugin-name>/
├── skills/
│ ├── my-skill.md
│ └── another-skill.md
└── agents/
└── my-agent.md

Each discovered file is attributed to its parent plugin in the Source column. This lets you see at a glance which skills and agents come from which plugin versus your own user-defined files.

View-Only

Both tabs are view-only — they display skill and agent definitions as they exist on disk. Skills are directories containing a SKILL.md file, and agents are .agent.md markdown files. To add, edit, or remove skills and agents, modify the files directly in the appropriate directory.