Adición de habilidades de agente para CLI de GitHub Copilot

Modifique el comportamiento y las capacidades de Copilot cuando trabaja en tareas concretas.

En este artículo

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 obtener más información, vea Acerca de las aptitudes del agente.

Creación y adición de una aptitud

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

  1. Si aún no lo ha hecho, cree un skills directorio en una de las siguientes ubicaciones. Aquí es donde encuentra su habilidad y cualquier otra que quiera crear en el futuro.

    Para aptitudes de proyecto específicas de un único repositorio, cree un directorio en .github/skills, .claude/skills o .agents/skills en el repositorio.

    Para las aptitudes personales compartidas entre proyectos, cree un ~/.copilot/skills, ~/.claude/skills, o ~/.agents/skills directorio en su directorio de inicio local.

  2. En el skills directorio, 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.

  3. 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 Copilot debe seguir.

  4. 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.

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:

  1.        **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

  2.        **Opcionalmente, apruebe previamente las herramientas que necesita la aptitud.** En el texto preliminar de `SKILL.md`, puede utilizar el campo `allowed-tools` para enumerar las herramientas que Copilot puede utilizar 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.

  3.        **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.

Añadir una habilidad que otra persona ha creado

Además de crear sus propias aptitudes, también puede agregar aptitudes que otras personas hayan creado.

  1. Descargue un directorio de aptitudes (es decir, un directorio que contenga un archivo SKILL.md y, opcionalmente, otros archivos y subdirectorios).

    Por ejemplo, descargue una habilidad del repositorio Awesome GitHub Copilot: https://awesome-copilot.github.com/skills/.

  2. Si descargó un .zip archivo, descomprímalo.

  3. Mueva el directorio de aptitudes a la ubicación necesaria:

    • Para las habilidades del proyecto, específicas de un único repositorio: .github/skills, .claude/skills o .agents/skills en tu repositorio.

    • Para aptitudes personales, compartidas entre proyectos: ~/.copilot/skills, ~/.claude/skillso ~/.agents/skills en el directorio principal local.

  4. Inicie una sesión de la CLI o, si actualmente está en una sesión de la CLI, escriba /skills reload.

  5. Escriba /skills info SKILL-NAME para comprobar que la habilidad se ha vuelto a cargar.

    SKILL-NAME se define en el archivo SKILL.md y suele ser el mismo que el nombre del directorio de aptitudes.

Uso de habilidades 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.

Para indicarle Copilot que use una aptitud específica, incluya el nombre de la aptitud en el mensaje, precedido de una barra diagonal. Por ejemplo, si tiene una habilidad denominada "frontend-design", podría usar un indicador como:

Use the /frontend-design skill to create a responsive navigation bar in React.

Comandos de aptitudes en la CLI

  •         **Lista de las habilidades disponibles actualmente:** use el comando `/skills list` o el indicador:

    What skills do you have?

  •         **Habilitar o deshabilitar aptitudes específicas:** use el comando `/skills` y, a continuación, use las teclas arriba y abajo en el teclado y la barra espaciadora para activar o desactivar las aptitudes.

  •         **Obtenga más información sobre una aptitud** (incluida su ubicación): use el comando `/skills info`.

  •         **Agregar una ubicación de aptitudes:** para agregar una ubicación alternativa en la que almacenar aptitudes, use el comando `/skills add`.

  •         **Recarga de aptitudes:** si ha agregado una aptitud durante una sesión de la CLI, puede agregarla mediante el comando `/skills reload` para evitar tener que reiniciar la CLI para usarla.

  •         **Quitar aptitudes:** para quitar una aptitud que haya agregado directamente (no a través de un complemento), use el comando `/skills remove SKILL-DIRECTORY`. Para quitar las habilidades agregadas como parte de un complemento, debe administrar el complemento. Use el `info` subcomando para averiguar de qué complemento procede una aptitud.

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 Adición de instrucciones personalizadas del repositorio para GitHub Copilot.

Para obtener más información sobre cómo las aptitudes difieren de otras características de personalización, consulte Comparación de las características de personalización de la CLI de GitHub Copilot.