Habilidades copilot-sdk
📦

copilot-sdk

Seguro

Crear aplicaciones de IA con GitHub Copilot SDK

Los desarrolladores necesitan acceso programático a GitHub Copilot para flujos de trabajo de IA personalizados. Este SDK proporciona gestión de sesiones, herramientas personalizadas, hooks e integración MCP en Node.js, Python, Go y .NET.

Soporta: Claude Codex Code(CC)
🥉 73 Bronce
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "copilot-sdk". Create a session and ask Copilot to explain a Python function

Resultado esperado:

Sesión creada con modelo gpt-4.1. Copilot analiza la función y proporciona una explicación detallada de su propósito, parámetros, valor de retorno y posibles mejoras.

Usando "copilot-sdk". Define a weather tool and ask Copilot about conditions in a city

Resultado esperado:

Herramienta personalizada registrada. Cuando se pregunta sobre el clima, Copilot llama a la herramienta y devuelve datos estructurados incluyendo ciudad, temperatura y condiciones.

Usando "copilot-sdk". Enable streaming and request a code review

Resultado esperado:

La respuesta se transmite token por token en tiempo real. Los comentarios de la revisión de código aparecen progresivamente con resaltado de sintaxis y sugerencias en línea.

Auditoría de seguridad

Seguro
v1 • 2/24/2026

All 192 static analysis findings are false positives. The scanner misinterpreted markdown code block delimiters (```) as shell backtick execution. The file contains documentation examples only, not executable code. URLs are reference links, environment variable mentions document authentication patterns. No actual security risks detected.

1
Archivos escaneados
516
Líneas analizadas
0
hallazgos
1
Auditorías totales
No se encontraron problemas de seguridad
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
50
Comunidad
100
Seguridad
87
Cumplimiento de la especificación

Lo que puedes crear

Herramientas de desarrollo con IA

Construye extensiones de IDE o herramientas CLI que aprovechen Copilot para generación, revisión y refactorización de código con integraciones de herramientas personalizadas.

Sistemas automatizados de revisión de código

Crea agentes personalizados para análisis de pull requests, escaneo de seguridad y validación de mejores prácticas con retroalimentación automatizada.

Flujos de trabajo multiagente

Orquestra agentes de IA especializados para diferentes tareas como documentación, pruebas y despliegue usando integración con servidores MCP.

Prueba estos prompts

Creación básica de sesión
Create a CopilotClient, start a session with the gpt-4.1 model, and send a message asking for code explanation.
Integración de herramientas personalizadas
Define a custom tool that retrieves file contents from the filesystem, then create a session that can use this tool to answer questions about project files.
Streaming con manejadores de eventos
Set up a streaming session that displays real-time responses, handles assistant message deltas, and logs session idle events.
Servidor MCP y Hooks
Configure a session with an MCP server for GitHub API access, add hooks to control shell command permissions, and implement custom error handling.

Mejores prácticas

  • Usa hooks para implementar controles de permisos para operaciones sensibles como comandos de shell y acceso a archivos
  • Habilita el logging de depuración durante el desarrollo para solucionar problemas de conexión y autenticación
  • Usa persistencia de sesiones con IDs personalizados para flujos de trabajo de larga duración que puedan exceder los límites de contexto

Evitar

  • Codificar tokens de GitHub en el código fuente en lugar de usar variables de entorno
  • Crear nuevas sesiones para cada solicitud en lugar de reutilizar sesiones para tareas relacionadas
  • Ignorar solicitudes de permisos y auto-aprobar todas las llamadas de herramientas sin validación

Preguntas frecuentes

¿Cuál es la diferencia entre Copilot SDK y Copilot CLI?
La CLI es una interfaz de línea de comandos para interacción directa del usuario. El SDK envuelve la CLI para habilitar acceso programático para construir aplicaciones que integren capacidades de Copilot.
¿Necesito una suscripción a GitHub Copilot para usar el SDK?
Se requiere una suscripción para los modelos estándar de GitHub Copilot. Sin embargo, puedes usar BYOK (Bring Your Own Key) para conectarte a proveedores alternativos como Azure OpenAI o Anthropic sin una suscripción a Copilot.
¿Cómo gestiono la autenticación para el SDK?
Prioridad de autenticación: 1) githubToken explícito en el constructor, 2) Variable de entorno COPILOT_GITHUB_TOKEN, 3) GH_TOKEN o GITHUB_TOKEN, 4) OAuth almacenado de copilot auth login, 5) Credenciales de GitHub CLI.
¿Puedo usar el SDK con modelos de IA locales?
Sí. Usa la configuración de proveedor BYOK con Ollama u otros servidores de modelos locales. Establece el tipo de proveedor como 'openai' y especifica tu URL de endpoint local.
¿Qué son los servidores MCP y cómo los uso?
Los servidores MCP (Model Context Protocol) proporcionan herramientas pre-construidas a través de interfaces estandarizadas. Configura mcpServers en la configuración de sesión con URLs HTTP para servidores remotos o configuraciones de comandos locales para servidores stdio.
¿Cómo prevengo la ejecución no autorizada de herramientas?
Usa el hook onPreToolUse para interceptar llamadas de herramientas. Retorna permissionDecision: 'deny' con una razón para operaciones bloqueadas. Auto-aprueba solo herramientas confiables como comandos git.

Detalles del desarrollador

Estructura de archivos

📄 SKILL.md