{"meta":{"title":"Creación de un complemento para GitHub Copilot CLI","intro":"Cree un complemento para compartir personalizaciones en un paquete fácil de instalar.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/how-tos","title":"Procedimientos"},{"href":"/es/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/es/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalización de la CLI de Copilot"},{"href":"/es/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating","title":"Complementos: Creación de un complemento"}],"documentType":"article"},"body":"# Creación de un complemento para GitHub Copilot CLI\n\nCree un complemento para compartir personalizaciones en un paquete fácil de instalar.\n\n## Introducción\n\nLos complementos son paquetes que amplían la funcionalidad de Copilot CLI. Consulta [Información sobre GitHub Copilot complementos](/es/copilot/concepts/agents/about-plugins).\n\n> \\[!NOTE]\n> Puede encontrar ayuda sobre el uso de complementos escribiendo `copilot plugin [SUBCOMMAND] --help` en el terminal.\n\n## Estructura del complemento\n\nUn complemento consta de un directorio con una estructura específica. Como mínimo, debe contener un `plugin.json` archivo de manifiesto en la raíz del directorio. También puede contener cualquier combinación de agentes, aptitudes, enlaces y configuraciones de servidor MCP.\n\n### Estructura del complemento de ejemplo\n\n```text\nmy-plugin/\n├── plugin.json           # Required manifest\n├── agents/               # Custom agents (optional)\n│   └── helper.agent.md\n├── skills/               # Skills (optional)\n│   └── deploy/\n│       └── SKILL.md\n├── hooks.json            # Hook configuration (optional)\n└── .mcp.json             # MCP server config (optional)\n```\n\n## Creación de un complemento\n\n1. Cree un directorio para el complemento.\n\n2. Agregue un `plugin.json` archivo de manifiesto a la raíz del directorio.\n\n**Archivo de ejemplo `plugin.json`**\n\n```json copy\n{\n  \"name\": \"my-dev-tools\",\n  \"description\": \"React development utilities\",\n  \"version\": \"1.2.0\",\n  \"author\": {\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\"\n  },\n  \"license\": \"MIT\",\n  \"keywords\": [\"react\", \"frontend\"],\n  \"agents\": \"agents/\",\n  \"skills\": [\"skills/\", \"extra-skills/\"],\n  \"hooks\": \"hooks.json\",\n  \"mcpServers\": \".mcp.json\"\n}\n```\n\nPara obtener más información sobre el conjunto completo de campos que puede incluir en este archivo, consulte [Referencia del plugin CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference#pluginjson).\n\n1. Agregue algunos componentes al complemento mediante la creación de los archivos y directorios adecuados para agentes, aptitudes, enlaces y configuraciones de servidor MCP.\n\n   Por ejemplo:\n\n   1. Agregue un agente mediante la creación de un `NAME.agent.md` archivo en un `agents` subdirectorio.\n\n      ```markdown copy\n      ---\n      name: my-agent\n      description: Helps with specific tasks\n      tools: [\"bash\", \"edit\", \"view\"]\n      ---\n\n      You are a specialized assistant that...\n      ```\n\n   2. Agregue una aptitud mediante la creación de un `skills/NAME` subdirectorio del directorio del complemento, donde `NAME` es el nombre de la aptitud. A continuación, dentro de este subdirectorio, cree un `SKILL.md` archivo que defina la aptitud.\n\n      Por ejemplo, para crear una aptitud de \"implementación\", cree `skills/deploy/SKILL.md`:\n\n      ```markdown copy\n      ---\n      name: deploy\n      description: Deploy the current project to...\n      ---\n\n      Instructions for the skill...\n      ```\n\n2. Instale el complemento localmente para que pueda probarlo a medida que lo desarrolle.\n\n   Por ejemplo, donde `./my-plugin` es la ruta de acceso al directorio del complemento, escriba:\n\n   ```shell copy\n   copilot plugin install ./my-plugin\n   ```\n\n3. Compruebe que el complemento se cargó correctamente viendo la lista de complementos instalados:\n\n   ```shell copy\n   copilot plugin list\n   ```\n\n   O bien, puede iniciar una nueva sesión interactiva y escribir:\n\n   ```copilot copy\n   /plugin list\n   ```\n\n4. Compruebe que los agentes, aptitudes, enlaces y configuraciones del servidor MCP que ha definido se cargan correctamente.\n\n   Por ejemplo, en una sesión interactiva, para comprobar que los agentes personalizados definidos en el complemento se cargaron, escriba:\n\n   ```copilot copy\n   /agent\n   ```\n\n   Para comprobar que las aptitudes definidas en el complemento se cargaron, escriba:\n\n   ```copilot copy\n   /skills list\n   ```\n\n5. Use la funcionalidad proporcionada por los componentes del complemento para comprobar que cada componente funciona según lo previsto.\n\n6. Itere en el desarrollo del complemento, según sea necesario.\n\n   > \\[!IMPORTANT]\n   > Al instalar un complemento, sus componentes se almacenan en caché y la CLI lee de la memoria caché para sesiones posteriores. Para recoger los cambios realizados en un complemento local, instálelo de nuevo:\n   >\n   > ```shell copy\n   > copilot plugin install ./my-plugin\n   > ```\n\n7. Una vez finalizadas las pruebas, puede desinstalar la versión local del complemento escribiendo lo siguiente:\n\n   ```shell copy\n   copilot plugin uninstall NAME\n   ```\n\n   > \\[!NOTE]\n   > Para desinstalar un complemento, use el nombre del complemento como se especifica en el `name` campo del archivo de manifiesto del `plugin.json` complemento, no la ruta de acceso al directorio del complemento.\n\n## Distribución del complemento\n\nPara distribuir el complemento, puede agregarlo a un marketplace. Consulta [Creación de un marketplace de complementos para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).\n\n## Lectura adicional\n\n* [Búsqueda e instalación de complementos para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)\n* [Referencia del plugin CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference)"}