github / github/copilot-cli

Add capability declaration fields to SKILL.md frontmatter (tools, mcp-servers, hooks, model)

Ouverte
#3,095 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
area:configuration area:plugins
Langage dominant
Shell
Étoiles
11.2k
Forks
1.9k
Merge moyen
14 h 16 min
PR mergées (30 j)
6

Description

## Brief

**Canonical issue:** https://github.com/microsoft/vscode-copilot-chat/issues/5101

Cross-filed at the GitHub Copilot CLI repo because SKILL.md is a cross-tool format consumed by both VS Code Copilot Chat and Copilot CLI plugin install. The gap and the proposal apply identically here.

## Summary (1 paragraph)

Custom agents (`.agent.md`) declare their capabilities in frontmatter — `tools`, `mcp-servers`, `hooks`, `model`. Skills (`SKILL.md`) cannot — they currently support only `name`, `description`, `argument-hint`, `user-invocable`, `disable-model-invocation`. The asymmetry forces every consuming agent to know and re-declare a skill's capability requirements, leading to silent under-capability and ecosystem-specific workarounds. Proposed: extend SKILL.md frontmatter with the same optional fields, with skill-declared `tools`/`mcp-servers` unioning with consuming agents, skill-declared `hooks` activating with the skill, and `model` as advisory.

## Why filed here

`copilot plugin install` loads SKILL.md files; the same capability-declaration gap applies to the CLI surface. Closing it natively at the SKILL.md level reduces the need for plugin-level bundling workarounds (whole plugin enables together, coarser than per-skill) and aligns skill composability across both surfaces.

See the canonical issue for full proposal, use cases, inheritance semantics, and references.

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Start with the canonical issue at microsoft/vscode-copilot-chat#5101 and trace where copilot plugin install loads SKILL.md files. Determine the relevant frontmatter parsing and capability-inheritance entry points, then validate that the proposed fields and semantics work across the CLI and VS Code surfaces with appropriate tests.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
github
Domaine
cli, tooling
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
Calme
Clarté
À clarifier
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.