Creación de habilidades de agente para GitHub Copilot

Nota:

Las aptitudes del agente funcionan con Agente de programación Copilot, el CLI de GitHub Copilot, y el modo de agente en Visual Studio Code.

Las habilidades del agente son carpetas de instrucciones, scripts y recursos que Copilot se pueden cargar cuando sea pertinente para mejorar el rendimiento en tareas especializadas. Para más información, consulta Acerca de las aptitudes del agente.

Creación y adición de una aptitud

Para crear una habilidad del agente, escriba un SKILL.md archivo y, opcionalmente, otros recursos, como archivos complementarios de Markdown o scripts, a los que haga referencia en las SKILL.md instrucciones.

Para agregar una aptitud, guarde el SKILL.md archivo y los recursos subsidiarias en una ubicación donde Copilot sepa buscar aptitudes. Esto puede estar dentro de un repositorio o dentro del directorio principal.

Cree un skills directorio en una de las ubicaciones admitidas para almacenar la habilidad y cualquier otra que pueda querer crear en el futuro.

Para habilidades específicas del proyecto de un único repositorio, cree y use un .github/skills, .claude/skills o .agents/skills en su repositorio.

Para aptitudes personales compartidas entre proyectos, crea y utiliza un directorio ~/.copilot/skills, ~/.claude/skills o ~/.agents/skills en tu directorio personal.
Cree un subdirectorio para la nueva aptitud. Cada aptitud debe tener su propio directorio (por ejemplo, .github/skills/webapp-testing).

Los nombres de subdirectorio de aptitudes deben estar en minúsculas y usar guiones en lugar de espacios.
En el subdirectorio de aptitudes, cree un SKILL.md archivo que contenga las instrucciones de la aptitud.

Importante

Los archivos de habilidades deben llamarse SKILL.md.
```
       `SKILL.md` los archivos son archivos Markdown con texto preliminar en YAML. En su forma más sencilla, incluyen:
```
- Texto preliminar de YAML * name (obligatorio): un identificador único para la aptitud. Debe estar en minúsculas, usando guiones en lugar de espacios. Normalmente, coincide con el nombre del directorio de la aptitud. * description (obligatorio): una descripción de lo que hace la aptitud y cuándo Copilot debe usarlo. * license (opcional): una descripción de la licencia que se aplica a esta aptitud.
- Un cuerpo de Markdown, con las instrucciones, ejemplos y pautas que se deben Copilot seguir.
Opcionalmente, añade scripts, ejemplos u otros recursos al directorio de la habilidad.

Para obtener más información, consulte "Habilitación de una aptitud para ejecutar un script".

Archivo `SKILL.md` de ejemplo

Para una habilidad de proyecto, este archivo estaría ubicado en un .github/skills/github-actions-failure-debugging directorio de tu repositorio.

Para una habilidad personal, este archivo estaría ubicado en un ~/.copilot/skills/github-actions-failure-debugging directorio.

Markdown

---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

Habilitación de una aptitud para ejecutar un script

Cuando se invoca una aptitud, Copilot detecta automáticamente todos los archivos del directorio de la aptitud y los pone a disposición junto con las instrucciones de la aptitud. Esto significa que puede incluir scripts u otros recursos en el directorio de aptitudes y hacer referencia a ellos en las SKILL.md instrucciones.

Para crear una aptitud que ejecute un script:

       **Agrega el script al directorio de la habilidad.** Por ejemplo, una aptitud para convertir imágenes SVG en PNG podría tener la estructura siguiente.

.github/skills/image-convert/
├── SKILL.md
└── convert-svg-to-png.sh

```
       **Opcionalmente, apruebe previamente las herramientas que necesita la aptitud.** En el `SKILL.md` frontmatter, puede usar el `allowed-tools` campo para enumerar las herramientas Copilot que pueden usar sin pedir confirmación cada vez. Si una herramienta no aparece en el `allowed-tools` campo , Copilot le solicitará permiso antes de usarlo.
```
```
---
name: image-convert
description: Converts SVG images to PNG format. Use when asked to convert SVG files.
allowed-tools: shell
---
```
Advertencia

Solo apruebe previamente las herramientas shell o bash si ha revisado esta habilidad y los scripts a los que se hace referencia, y confíe completamente en su origen. La aprobación previa de shell o bash elimina el paso de confirmación para ejecutar comandos de terminal y puede permitir que habilidades controladas por el atacante o inyecciones en solicitudes ejecuten comandos arbitrarios en su entorno. En caso de duda, omita shell y bash de allowed-tools para que Copilot deba solicitar la confirmación explícita antes de ejecutar comandos de terminal.

       **Escriba instrucciones que indiquen Copilot cómo usar el script.** En el cuerpo de Markdown de `SKILL.md`, describe cuándo y cómo ejecutar el script.

When asked to convert an SVG to PNG, run the `convert-svg-to-png.sh` script
from this skill's base directory, passing the input SVG file path as the
first argument.

Cómo Copilot usa las aptitudes del agente

Al realizar tareas, Copilot decidirá cuándo usar sus habilidades en función de su solicitud y la descripción de la habilidad.

Cuando Copilot elige usar una aptitud, el archivo SKILL.md se insertará en el contexto del agente, lo que le proporcionará acceso a las instrucciones. Después, puede seguir esas instrucciones y usar los scripts o ejemplos que hayas incluido en el directorio de la habilidad.

Aptitudes frente a instrucciones personalizadas

Puede usar habilidades e instrucciones personalizadas para enseñar a Copilot cómo trabajar en su repositorio y cómo realizar tareas específicas.

Se recomienda usar instrucciones personalizadas para obtener instrucciones sencillas relevantes para casi todas las tareas (por ejemplo, información sobre los estándares de codificación del repositorio) y aptitudes para obtener instrucciones más detalladas que Copilot solo deben tener acceso cuando proceda.

Para más información sobre las instrucciones personalizadas del repositorio, consulte Agregar instrucciones personalizadas del repositorio para GitHub Copilot.