{"meta":{"title":"Aptitudes personalizadas","intro":"Las capacidades son módulos de indicaciones reutilizables que amplían las capacidades de Copilot. Cargue aptitudes de directorios para proporcionar Copilot capacidades especializadas para dominios o flujos de trabajo específicos.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/how-tos","title":"Procedimientos"},{"href":"/es/copilot/how-tos/copilot-sdk","title":"SDK de Copilot"},{"href":"/es/copilot/how-tos/copilot-sdk/features","title":"Características"},{"href":"/es/copilot/how-tos/copilot-sdk/features/skills","title":"Habilidades"}],"documentType":"article"},"body":"# Aptitudes personalizadas\n\nLas capacidades son módulos de indicaciones reutilizables que amplían las capacidades de Copilot. Cargue aptitudes de directorios para proporcionar Copilot capacidades especializadas para dominios o flujos de trabajo específicos.\n\n<!-- markdownlint-disable GHD046 GHD005 -->\n\n<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->\n\n## Visión general\n\nUna habilidad es un directorio con nombre que contiene un archivo `SKILL.md`: un documento Markdown que proporciona instrucciones a Copilot. Cuando se carga, el contenido de la habilidad se inyecta en el contexto de la sesión.\n\nLas aptitudes le permiten:\n\n* Empaquetar la experiencia de dominio en módulos reutilizables\n* Uso compartido de comportamientos especializados entre proyectos\n* Organizar las configuraciones complejas del agente\n* Habilitación o deshabilitación de funcionalidades por sesión\n\n## Aptitudes de carga\n\nEspecifique directorios que contengan aptitudes al crear una sesión:\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nimport { CopilotClient } from \"@github/copilot-sdk\";\n\nconst client = new CopilotClient();\nconst session = await client.createSession({\n    model: \"gpt-5.4\",\n    skillDirectories: [\n        \"./skills/code-review\",\n        \"./skills/documentation\",\n    ],\n    onPermissionRequest: async () => ({ kind: \"approve-once\" }),\n});\n\n// Copilot now has access to skills in those directories\nawait session.sendAndWait({ prompt: \"Review this code for security issues\" });\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nfrom copilot import CopilotClient, PermissionDecisionApproveOnce\n\nasync def main():\n    client = CopilotClient()\n    await client.start()\n\n    session = await client.create_session(\n        on_permission_request=lambda req, inv: PermissionDecisionApproveOnce(),\n        model=\"gpt-5.4\",\n        skill_directories=[\n            \"./skills/code-review\",\n            \"./skills/documentation\",\n        ],\n    )\n\n    # Copilot now has access to skills in those directories\n    await session.send_and_wait(\"Review this code for security issues\")\n\n    await client.stop()\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\npackage main\n\nimport (\n    \"context\"\n    \"log\"\n    copilot \"github.com/github/copilot-sdk/go\"\n    \"github.com/github/copilot-sdk/go/rpc\"\n)\n\nfunc main() {\n    ctx := context.Background()\n    client := copilot.NewClient(nil)\n    if err := client.Start(ctx); err != nil {\n        log.Fatal(err)\n    }\n    defer client.Stop()\n\n    session, err := client.CreateSession(ctx, &copilot.SessionConfig{\n        Model: \"gpt-5.4\",\n        SkillDirectories: []string{\n            \"./skills/code-review\",\n            \"./skills/documentation\",\n        },\n        OnPermissionRequest: func(req copilot.PermissionRequest, inv copilot.PermissionInvocation) (rpc.PermissionDecision, error) {\n            return &rpc.PermissionDecisionApproveOnce{}, nil\n        },\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n\n    // Copilot now has access to skills in those directories\n    _, err = session.SendAndWait(ctx, copilot.MessageOptions{\n        Prompt: \"Review this code for security issues\",\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n}\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nusing GitHub.Copilot;\nusing GitHub.Copilot.Rpc;\n\nawait using var client = new CopilotClient();\nawait using var session = await client.CreateSessionAsync(new SessionConfig\n{\n    Model = \"gpt-5.4\",\n    SkillDirectories = new List<string>\n    {\n        \"./skills/code-review\",\n        \"./skills/documentation\",\n    },\n    OnPermissionRequest = (req, inv) =>\n        Task.FromResult(PermissionDecision.ApproveOnce()),\n});\n\n// Copilot now has access to skills in those directories\nawait session.SendAndWaitAsync(new MessageOptions\n{\n    Prompt = \"Review this code for security issues\"\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n```java\nimport com.github.copilot.CopilotClient;\nimport com.github.copilot.rpc.*;\nimport java.util.List;\n\ntry (var client = new CopilotClient()) {\n    client.start().get();\n\n    var session = client.createSession(\n        new SessionConfig()\n            .setModel(\"gpt-5.4\")\n            .setSkillDirectories(List.of(\n                \"./skills/code-review\",\n                \"./skills/documentation\"\n            ))\n            .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n    ).get();\n\n    // Copilot now has access to skills in those directories\n    session.sendAndWait(new MessageOptions()\n        .setPrompt(\"Review this code for security issues\")\n    ).get();\n}\n```\n\n</div>\n\n</div>\n\n## Deshabilitación de aptitudes\n\nDeshabilite aptitudes específicas mientras mantiene a otros usuarios activos:\n\n<div class=\"ghd-codetabs\">\n<div class=\"ghd-codetab\" data-lang=\"typescript\" data-label=\"TypeScript\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">TypeScript</div>\n\n```typescript\nconst session = await client.createSession({\n    skillDirectories: [\"./skills\"],\n    disabledSkills: [\"experimental-feature\", \"deprecated-tool\"],\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"python\" data-label=\"Python\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Python</div>\n\n```python\nfrom copilot.session import PermissionHandler\n\nsession = await client.create_session(\n    on_permission_request=PermissionHandler.approve_all,\n    skill_directories=[\"./skills\"],\n    disabled_skills=[\"experimental-feature\", \"deprecated-tool\"],\n)\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"go\" data-label=\"Go\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Go</div>\n\n```golang\nsession, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{\n    SkillDirectories: []string{\"./skills\"},\n    DisabledSkills:   []string{\"experimental-feature\", \"deprecated-tool\"},\n})\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"dotnet\" data-label=\".NET\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">.NET</div>\n\n```csharp\nvar session = await client.CreateSessionAsync(new SessionConfig\n{\n    SkillDirectories = new List<string> { \"./skills\" },\n    DisabledSkills = new List<string> { \"experimental-feature\", \"deprecated-tool\" },\n});\n```\n\n</div>\n\n<div class=\"ghd-codetab\" data-lang=\"java\" data-label=\"Java\"><div class=\"ghd-codetab-fallback-label\" role=\"heading\" aria-level=\"3\">Java</div>\n\n<!-- docs-validate: skip -->\n\n```java\nimport com.github.copilot.rpc.*;\nimport java.util.List;\n\nvar session = client.createSession(\n    new SessionConfig()\n        .setSkillDirectories(List.of(\"./skills\"))\n        .setDisabledSkills(List.of(\"experimental-feature\", \"deprecated-tool\"))\n        .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n</div>\n\n</div>\n\n## Estructura del directorio de aptitudes\n\nCada aptitud es un subdirectorio con nombre que contiene un `SKILL.md` archivo:\n\n```text\nskills/\n├── code-review/\n│   └── SKILL.md\n└── documentation/\n    └── SKILL.md\n```\n\nLa `skillDirectories` opción apunta al directorio primario (por ejemplo, `./skills`). La CLI detecta todos los `SKILL.md` archivos en subdirectorios inmediatos.\n\n### formato SKILL.md\n\nUn archivo `SKILL.md` es un documento Markdown con un frontmatter YAML opcional.\n\n```markdown\n---\nname: code-review\ndescription: Specialized code review capabilities\n---\n\n# Code Review Guidelines\n\nWhen reviewing code, always check for:\n\n1. **Security vulnerabilities** - SQL injection, XSS, etc.\n2. **Performance issues** - N+1 queries, memory leaks\n3. **Code style** - Consistent formatting, naming conventions\n4. **Test coverage** - Are critical paths tested?\n\nProvide specific line-number references and suggested fixes.\n```\n\nLos campos de frontmatter:\n\n* **`name`**: identificador de la aptitud (que se usa con `disabledSkills` para deshabilitarla de forma selectiva). Si se omite, se usa el nombre del directorio.\n* **`description`**: Una breve descripción de lo que hace la habilidad.\n\nEl cuerpo de Markdown contiene las instrucciones que se insertan en el contexto de sesión cuando se carga la aptitud.\n\n## Opciones de configuración\n\n### Campos de habilidades de SessionConfig\n\n| Language | Campo               | Tipo           | Description                                  |\n| -------- | ------------------- | -------------- | -------------------------------------------- |\n| Node.js  | `skillDirectories`  | `string[]`     | Directorios desde los que cargar habilidades |\n| Node.js  | `disabledSkills`    | `string[]`     | Habilidades para desactivar                  |\n| Python   | `skill_directories` | `list[str]`    | Directorios desde los que cargar habilidades |\n| Python   | `disabled_skills`   | `list[str]`    | Habilidades para desactivar                  |\n| Ir       | `SkillDirectories`  | `[]string`     | Directorios desde los que cargar habilidades |\n| Ir       | `DisabledSkills`    | `[]string`     | Habilidades para desactivar                  |\n| .NET     | `SkillDirectories`  | `List<string>` | Directorios desde los que cargar habilidades |\n| .NET     | `DisabledSkills`    | `List<string>` | Habilidades para desactivar                  |\n\n## procedimientos recomendados\n\n1. **Organizar por dominio** : agrupar aptitudes relacionadas (por ejemplo, `skills/security/`, `skills/testing/`)\n\n2. **Usa metadatos preliminares** - Incluye `name` y `description` en los metadatos preliminares de YAML para mayor claridad\n\n3. **Dependencias del documento**: indica las herramientas o servidores MCP que requiere una habilidad.\n\n4. **Prueba de aptitudes de forma aislada** : compruebe que las aptitudes funcionan antes de combinarlas\n\n5. **Utiliza rutas relativas** - Mantén las habilidades portátiles en distintos entornos\n\n## Combinación con otras características\n\n### Habilidades + agentes personalizados\n\nLas habilidades enumeradas en el campo `skills` de un agente se **precargan de forma anticipada**: su contenido completo se inserta en el contexto del agente al iniciarse, por lo que el agente tiene acceso inmediato a las instrucciones de la habilidad sin necesidad de invocar una herramienta de habilidades. Los nombres de las aptitudes se resuelven a partir de `skillDirectories` de nivel de sesión.\n\n```typescript\nconst session = await client.createSession({\n    skillDirectories: [\"./skills/security\"],\n    customAgents: [{\n        name: \"security-auditor\",\n        description: \"Security-focused code reviewer\",\n        prompt: \"Focus on OWASP Top 10 vulnerabilities\",\n        skills: [\"security-scan\", \"dependency-check\"],\n    }],\n    onPermissionRequest: async () => ({ kind: \"approve-once\" }),\n});\n```\n\n> \\[!NOTE]\n> Las aptitudes son opcionales, cuando `skills` se omite, no se inserta ningún contenido de aptitudes. Los subagentes no heredan habilidades del agente principal; debe enumerarlas explícitamente para cada agente.\n\n### Habilidades y servidores MCP\n\nLas aptitudes pueden complementar las funcionalidades del servidor MCP:\n\n```typescript\nconst session = await client.createSession({\n    skillDirectories: [\"./skills/database\"],\n    mcpServers: {\n        postgres: {\n            type: \"local\",\n            command: \"npx\",\n            args: [\"-y\", \"@modelcontextprotocol/server-postgres\"],\n            tools: [\"*\"],\n        },\n    },\n    onPermissionRequest: async () => ({ kind: \"approve-once\" }),\n});\n```\n\n## Solución de problemas\n\n### Las aptitudes no cargan\n\n1. **Compruebe que la ruta existe** - Verifique que la ruta del directorio de habilidades es correcta y que contiene subdirectorios con archivos `SKILL.md`\n2. **Comprobación de permisos** : asegúrese de que el SDK puede leer el directorio.\n3. **Comprobar el formato de SKILL.md** - Verificar que el archivo Markdown esté bien formado y que cualquier encabezado YAML utilice una sintaxis válida.\n4. **Habilitar el registro de depuración**: configure `logLevel: \"debug\"` para ver los registros de carga de habilidades\n\n### Conflictos de aptitudes\n\nSi varias aptitudes proporcionan instrucciones en conflicto:\n\n* Use `disabledSkills` para excluir habilidades en conflicto\n* Reorganización de directorios de aptitudes para evitar superposiciones\n\n## Consulte también\n\n* [Crea tu primera aplicación con tecnología Copilot](/es/copilot/how-tos/copilot-sdk/getting-started#create-custom-agents) - Definir perfiles de IA especializados\n* [Crea tu primera aplicación con tecnología Copilot](/es/copilot/how-tos/copilot-sdk/getting-started#step-4-add-a-custom-tool) : crear sus propias herramientas\n* [Uso de servidores MCP con el SDK de GitHub Copilot](/es/copilot/how-tos/copilot-sdk/features/mcp) : conexión de proveedores de herramientas externos"}