Cómo enseñar a un asistente de IA a entender Azure igual que un Solutions Architect
Últimamente me encontré pensando: nos hemos acostumbrado a que GitHub Copilot o Claude Code sepan casi todo, pero en cuanto se trata de detalles de la nube, comienzan las alucinaciones. La red neuronal podría darte una configuración de Azure Functions que lleva obsoleta unos tres años, o sugerir una arquitectura que viola los límites integrados de suscripción. El problema es que el conocimiento del modelo está limitado al momento de su entrenamiento, y la documentación de Microsoft Learn cambia casi diariamente.
Me topé con el repositorio Agent-Skills de la gente de Microsoft. La idea es simple pero increíblemente útil: en lugar de hacer que la IA "recuerde" la documentación, le proporcionas habilidades estructuradas. Es como una guía de referencia para el agente que vive directamente en tu proyecto y le dice: "Cuando trabajes con Azure, mira aquí, usa estos patrones y no olvides estas limitaciones".
¿Qué es esto exactamente?
El proyecto es un enorme catálogo de casi doscientas habilidades listas para usar cuando trabajas con Azure. No son solo enlaces a documentación. Cada habilidad es un conjunto de instrucciones en formato Markdown que el asistente de IA lee antes de sugerirte código.
Los desarrolladores de Microsoft tomaron el camino de "documentación como código". Tomaron una montaña de contenido de Microsoft Learn — mejores prácticas, árboles de decisión, errores comunes y requisitos de seguridad — y lo empaquetaron en instrucciones compatibles con LLMs. Como resultado, el agente no solo escribe código; entiende el contexto del servicio específico.
¿Por qué molestarse en agregar esto a tu proyecto?
Si trabajas con Azure, sabes cuántas sutilezas hay. Por ejemplo, puedes configurar Azure Container Apps de una docena de formas, pero solo un par de ellas cumplirán con los estándares de Enterprise.
Esto es lo que estas habilidades te dan en la práctica:
- El agente deja de adivinar y comienza a usar patrones de API actuales.
- Las respuestas incluyen enlaces directos a las secciones relevantes de Microsoft Learn.
- La IA comienza a advertirte sobre límites y peculiaridades de configuración antes de que implementes una configuración rota.
- El agente obtiene listas de verificación listas para usar para la solución de problemas.
Cómo funciona internamente
En su núcleo hay un estándar abierto de Agent Skills. Cada habilidad vive en su propia carpeta dentro del directorio skills/. La estructura del archivo SKILL.md se ve algo así:
---
name: azure-functions
description: Инструкции по разработке и развертыванию Azure Functions
---
# Azure Functions
## Инструкции
[Тут идут конкретные шаги для агента]
## Примеры
[Примеры правильного использования сервиса]
Curiosamente, el sistema funciona según un principio de revelación progresiva. Primero, el agente ve solo el nombre y la breve descripción en el encabezado YAML. Si tu solicitud coincide con el tema de la habilidad, el agente "despliega" la instrucción completa y comienza a actuar según ella. Esto ahorra la ventana de contexto del modelo sin saturarla con cosas innecesarias.
Cómo poner esto en marcha
La forma más fácil es instalar todo como un plugin. Para VS Code, lo haces a través de la paleta de comandos: selecciona Chat: Install Plugin From Source y pega el enlace del repositorio https://github.com/MicrosoftDocs/agent-skills.
Si prefieres tener control total o usas Cursor, puedes simplemente clonar el repositorio y copiar las carpetas necesarias de skills/ a tu directorio de proyecto. La ruta varía para cada herramienta:
- GitHub Copilot:
.github/skills/ - Cursor:
.cursor/skills/ - Claude Code:
.claude/skills/
Por cierto, para VS Code necesitas recordar habilitar la configuración chat.agent.skills, de lo contrario la magia no sucederá.
Beneficios prácticos y categorías
El repositorio actualmente tiene 193 habilidades. Están divididas por categoría, así que no tienes que arrastrar todo — puedes elegir solo lo que necesitas para tu stack específico:
- Compute (13 habilidades): App Service, Functions, Batch.
- AI & ML (23 habilidades): todo sobre Azure AI Services y bots.
- Seguridad (19 habilidades): Active Directory, Key Vault y más.
- Infraestructura (52 habilidades): aquí está lo más pesado — AKS, Arc y configuraciones de red.
Si no sabes por dónde empezar, la carpeta docs/BUNDLES.md tiene colecciones curadas. Por ejemplo, el paquete "Quick Start" incluye 7 servicios básicos que serán útiles para cualquier desarrollador de Azure.
¿Vale la pena probar?
El proyecto parece una excelente manera de "anclar" asistentes de IA en tareas reales. En lugar de copiar y pegar fragmentos de documentación en el chat de Copilot cada vez, conectas el repositorio una vez y obtienes un asistente competente que conoce las reglas del juego en el ecosistema de Microsoft.
Esto será especialmente útil para equipos que están migrando a Azure o comenzando a usar servicios complejos como Durable Functions o Azure API Management. Es fácil configurarlos incorrectamente, y corregirlos después consume mucho tiempo y es costoso.
El único inconveniente es que el proyecto todavía está en preview, y algunas características requieren habilitar flags experimentales en el IDE. Pero incluso en modo manual, copiar los archivos .md necesarios a tu proyecto da un impulso notable a la calidad de generación de código. Si estás fuertemente invertido en Azure, este repositorio definitivamente pertenece a tus marcadores.
Proyectos relacionados