Creación de aptitudes de agente para CLI de GitHub Copilot

Modifique el comportamiento y las capacidades de Copilot al trabajar en tareas específicas.

En este artículo

Las competencias del agente son carpetas de instrucciones, scripts y recursos que Copilot puede cargar cuando sea pertinente para mejorar su 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 habilidad, guarde el archivo SKILL.md y los recursos subsidiarios en una ubicación donde Copilot sepa dónde buscar habilidades. Esto puede estar dentro de un repositorio o dentro del directorio principal.

  1. Cree un skills directorio para almacenar su habilidad y cualquier otra que quiera crear en el futuro.

    Para aptitudes del proyecto, específicas de un único repositorio, almacene la aptitud en .github/skills o .claude/skills.

    Para aptitudes personales, compartidas entre proyectos, almacene su aptitud en ~/.copilot/skills o ~/.claude/skills.

  2. 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 habilidad y cuándo Copilot debería usarla. * license (opcional): una descripción de la licencia que se aplica a esta aptitud.
    • Cuerpo en Markdown, con las instrucciones, ejemplos y directrices para Copilot a continuación.

  4. Opcionalmente, añade scripts, ejemplos u otros recursos al directorio de la habilidad.

    Por ejemplo, si estaba escribiendo una aptitud para convertir imágenes entre diferentes formatos, podría incluir un script para convertir imágenes SVG en PNG. Las instrucciones de aptitud deben indicar a Copilot cuándo y cómo usar estos recursos.

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.

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 indicar a Copilot que use una aptitud específica, incluya el nombre de la aptitud en la solicitud, 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.

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 Copilot de GitHub.