Uso de habilidades de agente con GitHub Copilot

Las aptitudes del agente son conjuntos de instrucciones reutilizables que enseñan a los agentes de Copilot cómo realizar tareas específicas, como ejecutar una canalización de compilación, generar código genérico o seguir los estándares de codificación del equipo. Al definir aptitudes una vez, se ahorra tiempo y se garantiza un comportamiento coherente en todo el flujo de trabajo.

Las aptitudes complementan los agentes personalizados y las instrucciones personalizadas. Aunque los agentes personalizados definen un rol y un conjunto de herramientas, y las instrucciones personalizadas establecen preferencias generales de codificación, las aptitudes proporcionan instrucciones centradas y específicas de tareas que cualquier agente puede detectar y usar automáticamente.

Prerequisites

Cómo funcionan las aptitudes del agente

Cuando utiliza el modo agente, Copilot detecta automáticamente las habilidades de su repositorio y su perfil de usuario. El agente decide cuándo una aptitud es relevante para la solicitud y la activa. Cuando se activa una aptitud, aparece en el chat para avisarle que se está aplicando.

Captura de pantalla que muestra una habilidad utilizada por el agente Copilot en el chat.

Ubicaciones de habilidades

Las aptitudes se adquieren en los siguientes lugares:

Tipo de aptitud Ubicación
Habilidades de espacio de trabajo o de proyecto (almacenadas en su repositorio) .github/skills/, , .claude/skills/, .agents/skills/
Aptitudes personales (almacenadas en el perfil de usuario) ~/.copilot/skills/, , ~/.claude/skills/, ~/.agents/skills/

Las habilidades del entorno de trabajo se comparten con el equipo mediante el control de código fuente. Las habilidades personales se aplican a todos los proyectos y no están almacenadas en ningún repositorio.

Crear una aptitud

Puede crear una aptitud desde el panel de aptitudes de Visual Studio o manualmente en el sistema de archivos. Para crear una aptitud desde el panel de aptitudes, debe tener Visual Studio 2026 Insiders versión 18.6 o posterior.

Creación de una aptitud en el panel de aptitudes

  1. Seleccione el icono Tools en la esquina inferior derecha de Copilot Chat para abrir el panel de aptitudes.

  2. Seleccione el + botón en la esquina superior derecha del panel.

    Captura de pantalla que muestra la creación de una nueva aptitud en el panel de aptitudes.

  3. Elija un destino (aptitud global o de nivel de solución) y elija un nombre.

    Captura de pantalla que muestra cómo asignar un nombre a una nueva aptitud.

  4. Visual Studio genera una plantilla de aptitud para rellenarla. Puede usar agente de Copilot modo para ayudarle a completar la plantilla.

Crear una habilidad manualmente

Cada habilidad es un directorio que contiene un SKILL.md archivo que sigue la especificación agentskills.io.

  1. Cree un directorio de aptitudes. Para una habilidad de espacio de trabajo, utilice .github/skills/ en la raíz de su repositorio. Para una habilidad personal, utiliza ~/.copilot/skills/.

  2. Cree un subdirectorio para su habilidad. Cada aptitud debe tener su propio directorio (por ejemplo, .github/skills/github-issues/).

  3. Cree un SKILL.md archivo en el directorio de aptitudes. El archivo contiene un preámbulo YAML con metadatos, seguido de instrucciones Markdown.

  4. De forma opcional, agregue scripts, ejemplos u otros recursos al directorio de la habilidad.

Estructura del directorio de aptitudes

your-repo/
└── .github/
    └── skills/
        └── github-issues/
            ├── SKILL.md          # Required: metadata + instructions
            ├── scripts/          # Optional: executable code
            ├── references/       # Optional: documentation
            └── assets/           # Optional: templates, resources

formato SKILL.md

El archivo SKILL.md debe contener el front matter de YAML seguido del contenido de Markdown.

---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---

When creating GitHub issues:

- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs

Propiedades de frontmatter

Propiedad Obligatorio Descripción
name Sí Solo letras minúsculas, números y guiones. Debe coincidir con el nombre del directorio primario. Máximo de 64 caracteres.
description Sí Describe lo que hace la habilidad y cuándo usarla. Máximo de 1024 caracteres.
license No Nombre de licencia o referencia a un archivo de licencia agrupado.
compatibility No Requisitos del entorno, como el producto previsto o los paquetes de sistema necesarios.
metadata No Mapeo arbitrario de clave-valor para metadatos adicionales.
allowed-tools No Cadena separada por espacios de herramientas preaprobadas que la habilidad puede utilizar.

Sugerencias para escribir capacidades eficaces

  • Mantenga el principal SKILL.md por debajo de las 500 líneas. Mueva el material de referencia detallado a archivos independientes en el references/ directorio.
  • Escriba un valor claro description que incluya palabras clave específicas para ayudar a los agentes a identificar cuándo es relevante la aptitud.
  • Incluya instrucciones paso a paso, ejemplos y casos perimetrales comunes.

Administre las habilidades desde el panel de habilidades

Seleccione el icono Tools en la esquina inferior derecha de Copilot Chat para abrir el panel de aptitudes, una vista dedicada de cada aptitud detectada. El panel Aptitudes solo está disponible en los Visual Studio 2026 Insiders.

Captura de pantalla que muestra el panel de aptitudes donde puede editar y abrir aptitudes.

En el panel, puede hacer lo siguiente:

  • Editar: Edite cualquier habilidad SKILL.md directamente en el editor desde el menú ....
  • Abrir ubicación del archivo: Ir al directorio de habilidades en el disco.
  • Búsqueda: filtre las aptitudes por nombre o palabra clave.

El panel también muestra diagnósticos para cualquier error de configuración de aptitudes, por lo que puede detectar y corregir rápidamente los problemas.

Aptitudes de la comunidad

Consulte el repositorio awesome-copilot para obtener aptitudes de ejemplo compartidas por la comunidad.

Contenido relacionado

  • Last updated on