Workshop de dos horas centrado en las cuatro capas de personalización de GitHub Copilot: instrucciones, prompt files, custom agents y agent skills. Cierra con el uso de code review asistido por Copilot, tanto en VS Code como en GitHub.com. Incluye tres módulos de profundización opcionales: skills avanzadas y de la comunidad, hooks (garantías determinísticas sobre el ciclo del agente) y optimización de tokens bajo el modelo de AI Credits.
El escenario es un servicio de préstamos para Contoso Banco. La API ya viene implementada de forma mínima en starter/, así que el tiempo se invierte en personalizar Copilot, no en escribir CRUDs.
Este workshop asume que ya conoces:
- Los modos Ask, Edit y Agent de Copilot Chat en VS Code.
- Cómo crear un
.github/copilot-instructions.mdbásico. - Comandos slash como
/explain,/tests,/fix. - C# y .NET 8 a nivel intermedio.
Si nunca has trabajado con GitHub Copilot en .NET, primero pasa por el workshop básico y luego vuelve aquí.
Sigue los módulos en orden. Cada uno enlaza al siguiente al final.
Antes de empezar
- 📍 Mapa de personalización · 5 min · qué se carga automáticamente y qué invocas a mano.
Ruta principal (2 horas)
- Setup y selección de modelo · 10 min · Claude Sonnet/Opus y chat customizations.
- Instrucciones personalizadas · 20 min · repo-wide y path-specific con
applyTo. - Prompt files · 20 min · recetas reutilizables con argumentos.
- Custom agents · 30 min · roles con tools restringidas y handoffs.
- Agent skills · 20 min · paquetes con scripts y recursos.
- Code review con Copilot · 20 min · en VS Code y en pull requests de GitHub.
Extras
- 4.1 Subagents (opcional, +25-30 min) · orquestación automática y revisión en paralelo. Extiende el módulo 4.
- 5.1 Skills avanzadas (opcional, +20-25 min) · references con carga progresiva y skills de la comunidad (caveman, markitdown). Extiende el módulo 5.
- 7. Cuándo usar qué · 5-10 min · árbol de decisión y anti-patrones. Ideal como cierre de la ruta principal.
- Glosario · referencia rápida de términos.
Profundización (+45 min, recomendado como segunda sesión)
- Hooks · 25 min · auditoría de prompts y bloqueo determinístico de comandos peligrosos.
- Optimización de tokens · 20 min · qué cuesta cada capa bajo AI Credits y qué consejos de ahorro son teatro.
.
├── README.md Este archivo
├── docs/ Una sub-página por módulo
│ ├── 00-mapa-personalizacion.md
│ ├── 01-setup.md
│ ├── 02-instrucciones-personalizadas.md
│ ├── 03-prompt-files.md
│ ├── 04-custom-agents.md
│ ├── 04_01-subagents.md
│ ├── 05-agent-skills.md
│ ├── 05_01-skills-avanzadas.md
│ ├── 06-code-review.md
│ ├── 07-cuando-usar-que.md
│ ├── 08-hooks.md
│ ├── 09-optimizacion-tokens.md
│ └── glosario.md
├── starter/ Código base que cada participante clona
│ ├── ContosoBanco.Loans.sln
│ ├── ContosoBanco.Loans.Api/
│ └── ContosoBanco.Loans.Tests/
└── ejemplos-finales/ Versión de referencia con todo construido
└── .github/
├── copilot-instructions.md
├── instructions/
├── prompts/
├── agents/
├── skills/ Incluye caveman, markitdown, scoring-crediticio y reportes-regulatorios
└── hooks/ Auditoría de prompts y política de comandos
La carpeta ejemplos-finales/ existe para que un participante que se atrase pueda copiar los archivos resueltos y seguir el ritmo del grupo. No la usen como copy/paste por defecto: el aprendizaje está en construir cada archivo guiado por Copilot.
- VS Code 1.95 o superior.
- Extensión GitHub Copilot y GitHub Copilot Chat (versiones recientes que ya incluyen el menú de Custom Agents y Agent Skills).
- C# Dev Kit.
- .NET 8 SDK o superior (
dotnet --versiondebe devolver 8.x o mayor; los proyectos tienen como targetnet8.0). - Cuenta de GitHub con licencia Copilot que tenga Claude Sonnet 4.5 y/o Claude Opus 4.5 habilitados en el selector de modelos.
- Git y una terminal funcional.
Las features que vamos a usar (instrucciones path-specific, agentes con tools y handoffs, skills) funcionan mejor con modelos de razonamiento fuerte. Recomendado:
- Claude Sonnet 4.5 para el flujo general.
- Claude Opus 4.5 para los pasos donde haya razonamiento financiero o revisión de seguridad (el módulo 4 lo configura explícitamente para el agente de revisión).
GPT-5 funciona razonablemente, pero algunos ejercicios están diseñados pensando en cómo Claude maneja contexto largo y handoffs.
- Clona el repo.
- Abre
starter/en VS Code. - Lee el Mapa de personalización (5 minutos) para entender qué se carga solo y qué no.
- Avanza módulo por módulo empezando por docs/01-setup.md. Cada módulo enlaza al siguiente al final.
- Si te atrasas, copia el archivo correspondiente desde
ejemplos-finales/.github/y continúa.
Mapa → Setup → Instrucciones → Prompts → Agentes → Subagents (opcional) → Skills → Skills avanzadas (opcional) → Code review → Cuándo usar qué → Hooks → Tokens
El módulo 4 (custom agents) y el módulo 5 (skills) son los más densos. Si el grupo va lento en los primeros módulos, comprime el módulo 6 (code review) y déjalo como demostración en vivo en lugar de práctica individual. La parte irrenunciable es que cada participante cree al menos un agente, una skill y un prompt file. Sin eso, el workshop pierde sentido.
No intentes cubrir todo el frontmatter de cada formato. Cubre lo mínimo viable y deja los campos avanzados (mcp-servers y similares) como lectura posterior en docs/glosario.md. Los hooks, que antes eran solo lectura posterior, ahora tienen módulo propio (módulo 8).
Los módulos 5.1, 8 y 9 no caben en las dos horas de la ruta principal. Funcionan bien como una segunda sesión de ~70 minutos (5.1 + 8 + 9 en ese orden), o como material auto-guiado. El módulo 9 no requiere teclado y funciona como cierre de conversación con equipos que ya pagan Copilot: la discusión de costos con el billing dashboard real del cliente suele ser la parte de mayor valor. Para el módulo 8, avisa a los participantes de macOS/Linux que necesitan jq instalado (brew install jq o apt install jq); en Windows se necesita PowerShell 7+.
MIT.