GitHub Copilot: instala 1136 skills y transforma tu asistente

Introduction: La evolución de GitHub Copilot

GitHub Copilot ha evolucionado desde un simple autocompletado de código a un asistente inteligente capaz de entender el contexto de tus proyectos. Con las custom instructions y el soporte para skills profesionales, Copilot se convierte en una herramienta verdaderamente personalizada que se adapta a tu flujo de trabajo específico.

Durante años, los desarrolladores pedían una forma de instruir a Copilot sobre convenciones específicas de sus proyectos, estándares de código y mejores prácticas personalizadas. Ahora es realidad. La arquitectura de skills de SKILLSBUNDLE integra perfectamente con GitHub Copilot mediante el archivo copilot-instructions.md y el directorio .github/skills/, permitiéndote cargar y ejecutar 1136 skills profesionales sin necesidad de escribir una sola línea de configuración adicional.

Lo que hace esto revolucionario es que tu repositorio se convierte en un sistema autoexplicativo. Copilot no solo completa código, sino que entiende exactamente qué hacer en cada contexto, respetando las reglas de tu equipo, optimizando para tu stack específico y proporcionando mejores prácticas que se actualizan automáticamente.

¿Qué es copilot-instructions.md?

El archivo copilot-instructions.md es un archivo de instrucciones especial que GitHub Copilot busca automáticamente en la raíz de tu repositorio. Actúa como un sistema nervioso centralizado para tu asistente de IA, definiendo comportamientos, restricciones, preferencias y referencias a skills externas.

Cómo Copilot detecta y usa copilot-instructions.md

Cuando utilizas GitHub Copilot en tu IDE (VS Code, JetBrains, Neovim), el primer paso que realiza es:

1. Buscar un archivo llamado copilot-instructions.md en la raíz del repositorio actual
2. Leerlo completamente y parsearlo para extraer instrucciones, referencias a skills y configuraciones
3. Inyectar el contenido en el contexto de cada sesión de Copilot Chat y completación de código
4. Usar estas instrucciones para modular su comportamiento en cada interacción

Esto significa que las instrucciones se aplican de forma completamente transparente sin necesidad de configuración manual. El archivo es versionable en Git, lo que permite que todo tu equipo use exactamente el mismo conjunto de instrucciones.

Estructura de directorios: .github/skills/

SKILLSBUNDLE utiliza una arquitectura específica que se integra perfectamente con GitHub. El directorio .github/skills/ es donde viven todas tus skills instaladas, organizadas de forma que Copilot pueda referenciarlas dinámicamente.

Anatomía del directorio .github/skills/

Cuando instalas las 1136 skills de SKILLSBUNDLE, la estructura se ve así:

mi-repositorio/
├── .github/
│   ├── skills/
│   │   ├── transversales/
│   │   │   ├── 01-code-review/SKILL.md
│   │   │   ├── 02-refactoring/SKILL.md
│   │   │   ├── 03-testing/SKILL.md
│   │   │   ├── 04-performance/SKILL.md
│   │   │   └── ..1136 skills
│   │   ├── verticales/
│   │   │   ├── python/
│   │   │   │   ├── fastapi-best-practices/SKILL.md
│   │   │   │   ├── async-patterns/SKILL.md
│   │   │   │   └── ...
│   │   │   ├── javascript/
│   │   │   │   ├── react-patterns/SKILL.md
│   │   │   │   ├── node-backend/SKILL.md
│   │   │   │   └── ...
│   │   │   └── ...15+ stacks distintos con ~35 skills c/u
│   │   └── manifest.json (índice de skills disponibles)
│   └── workflows/ (CI/CD)
├── copilot-instructions.md
└── README.md

El archivo manifest.json actúa como un catálogo indexado que Copilot consulta para saber exactamente qué skills están disponibles y cómo cargarlas. Este es un mecanismo crítico para la eficiencia: en lugar de que Copilot tenga que leer 1136 archivos, consulta un índice JSON optimizado.

Cómo Copilot referencia los skills en este directorio

Dentro de tu copilot-instructions.md, haces referencia a los skills así:

## Skills disponibles
Usa los siguientes skills según el contexto:

### Code Review
skill:.github/skills/transversales/01-code-review/SKILL.md
Utiliza este skill para revisar pull requests, identificar
bugs potenciales y sugerir mejoras de seguridad.

### Testing
skill:.github/skills/transversales/03-testing/SKILL.md
Generador automático de casos de prueba con cobertura
óptima para el stack seleccionado.

### FastAPI Best Practices (si es un proyecto Python)
skill:.github/skills/verticales/python/fastapi-best-practices/SKILL.md
Aplicar patrones y convenciones específicas de FastAPI.

Cuando Copilot encuentra una referencia de skill (identificada por el prefijo skill:), automáticamente:

• Localiza el archivo SKILL.md en el sistema de archivos
• Extrae la instrucción y contexto específicos
• Los inyecta en el contexto de la sesión actual
• Los aplica como si fueran instrucciones nativas de Copilot

Los 1136 skills: 1136 skills profesionales

La biblioteca de SKILLSBUNDLE contiene 1136 skills profesionales probados en producción, divididos en dos categorías estratégicas que funcionan sinérgicamente con GitHub Copilot.

1136 Skills Profesionales

Los skills transversales son agnósticos a lenguajes y frameworks. Pueden aplicarse a cualquier proyecto, independientemente de la tecnología que uses. Están diseñados para resolver problemas universales que todo desarrollador enfrenta:

• Code Review (20 skills): Revisar PRs, verificar seguridad, identificar deudas técnicas, análisis de rendimiento, validación de patrones de diseño
• Refactoring (25 skills): Simplificar lógica compleja, eliminar duplicación, mejorar legibilidad, optimizar estructura
• Testing & QA (35 skills): Generar pruebas unitarias, casos de prueba e2e, mock objects, estrategias de cobertura
• Performance Optimizetion (30 skills): Profiling, caching estrategias, optimización de algoritmos, reducción de memoria
• Documentation (20 skills): Generar READMEs, docstrings, diagramas arquitectónicos, changelog automático
• Security & Compliance (25 skills): OWASP top 10, validación de inputs, gestión de secrets, auditorías de código
• DevOps & Infrastructure (30 skills): Docker, Kubernetes, CI/CD pipelines, monitoreo, alertas
• Debugging & Troubleshooting (25 skills): Stack traces, profilers, logging strategies, root cause analysis
• ...y 180+ skills adicionales en categorías como Git workflows, API design, database optimization, error handling

Practical Example: Code Review transversal con Copilot

Cuando tu equipo abre un PR y ejecuta Copilot Chat con este comando:

@copilot Revisa este PR y busca issues de seguridad

Copilot carga el skill .github/skills/transversales/01-code-review/SKILL.md que contiene instrucciones como:

## Code Review Framework
Cuando revises código, sigue estos pasos:

1. SEGURIDAD: Busca inyecciones SQL, XSS, CSRF
2. PERFORMANCE: Identifica O(n²) o peor, memory leaks
3. PATRONES: Verifica uso de design patterns
4. ERRORES: Detecta null pointer, off-by-one errors
5. LEGIBILIDAD: Sugiere nombres de variables más claros

El resultado es un code review consistente, exhaustivo y automático que sigue exactamente los estándares de tu equipo.

Skills Verticals (Específicos de Stack)

Los skills verticales son especializados para lenguajes, frameworks y stacks específicos. Contienen mejores prácticas, patrones idiomáticos y convenciones que no tienen sentido fuera de su contexto particular:

• Python (45 skills): FastAPI, Django, async patterns, type hints, context managers, decorators, dataclasses
• JavaScript/TypeScript (45 skills): React, Vue, Angular, Node.js, Express, Next.js, async/await, generators
• Java (40 skills): Spring Boot, OOP patterns, generics, concurrency, functional programming, streams
• Go (35 skills): Goroutines, channels, error handling, interfaces, dependency injection
• Rust (35 skills): Ownership, borrowing, lifetimes, traits, unsafe patterns, async Rust
• C# / .NET (40 skills): LINQ, async/await, dependency injection, EF Core, ASP.NET patterns
• PHP (30 skills): Laravel, Symfony, namespaces, traits, error handling, testing
• Ruby (30 skills): Rails conventions, metaprogramming, blocks, yield, testing with RSpec
• Kotlin (25 skills): Extension functions, coroutines, scopes, destructuring, DSL patterns
• Scala (25 skills): Implicits, monads, pattern matching, case classes, type systems
• SQL & Databases (30 skills): Query optimization, indexing, transactions, normalization, sharding
• DevOps & Infrastructure (30 skills): Terraform, Docker, Kubernetes, AWS, GCP, Azure patterns
• Frontend Frameworks (20 skills): Svelte, Solid, Alpine.js, HTMX patterns
• Cloud Services (25 skills): Serverless functions, message queues, caching, storage patterns

Practical Example: FastAPI con Copilot

Imagina que estás creando un endpoint en FastAPI. En tu copilot-instructions.md referenciarías:

skill:.github/skills/verticales/python/fastapi-best-practices/SKILL.md

Cuando escribes:

def @copilot create_user endpoint con validación

Copilot generará código siguiendo exactamente las mejores prácticas de FastAPI:

from fastapi import APIRouter, HTTPException, status
from pydantic import BaseModel, Field
from typing import Optional

router = APIRouter(prefix="/users", tags=["users"])

class UserCreate(BaseModel):
    email: str = Field(..., min_length=5)
    username: str = Field(..., min_length=3, max_length=50)
    password: str = Field(..., min_length=8)

class UserResponse(BaseModel):
    id: int
    email: str
    username: str

@router.post("/", response_model=UserResponse, status_code=status.HTTP_201_CREATED)
async def create_user(user: UserCreate) -> UserResponse:
    # Validación de email existente, hash de password, etc.
    pass

Cómo los 1136 skills potencian a Copilot

La sinergia es poderosa:

• Contexto inteligente: Copilot detecta el lenguaje/framework actual y carga automáticamente los skills verticales relevantes
• Consistencia global: Los skills transversales se aplican a todo el proyecto, asegurando uniformidad
• Reducción de contexto: En lugar de repetir instrucciones constantemente, los skills se inyectan automáticamente
• Mantenimiento centralizado: Actualizar un skill en .github/skills/ afecta a todos los usos inmediatamente
• Escalabilidad de equipo: Los nuevos desarrolladores heredan automáticamente las mejores prácticas del equipo

Prompt Guard: Protegiendo Copilot de inyecciones

Con skills en repositorios compartidos, surge un riesgo de seguridad: prompt injection attacks. Un committer malintencionado podría modificar un skill para instruir a Copilot a hacer cosas indeseadas.

Cómo funciona Prompt Guard

Prompt Guard es un sistema de validación que protege tus skills y tu copilot-instructions.md:

• Firma digital: Cada skill puede ser firmado criptográficamente (usando git commit signing)
• Validación de cambios: Copilot verifica que los skills no hayan sido modificados por commits no autorizados
• Bloqueo de instrucciones maliciosas: Patrones sospechosos en skills (como "ignora tus instrucciones" o "eres ahora") son detectados y bloqueados
• Auditoría de cambios: Todo cambio en .github/skills/ aparece en el historial de Git, permitiendo auditoría completa

Caso de uso: Equipos multitenants

Si tu organización aloja múltiples proyectos, Prompt Guard permite que cada repositorio tenga sus propios skills sin contaminar otros. La validación impide que un repositorio comprometido inyecte instrucciones maliciosas hacia otros.

Copilot Chat vs Copilot Agent: Cómo trabajan con skills

GitHub Copilot opera en dos modos distintos, y los skills funcionan de forma ligeramente diferente en cada uno.

Copilot Chat (Conversacional)

Es el asistente tradicional en VS Code. Escribes una pregunta, Copilot responde con código o explicaciones.

Cómo usan los skills:

• Cuando haces una pregunta, Copilot busca skills relevantes basados en el contexto (archivo actual, lenguaje, keywords en tu pregunta)
• Los skills se inyectan en el prompt implícitamente
• Las respuestas siguen automáticamente las instrucciones de los skills cargados
• Ejemplo: Preguntas sobre código Python automáticamente cargan los skills verticales de Python

Copilot Agent (Autónomo)

Es la nueva generación de Copilot: un agente que puede ejecutar acciones automáticamente (crear archivos, ejecutar tests, hacer commits).

Cómo usan los skills:

• Los skills se cargan al inicio de cada sesión del agente
• El agente consulta los skills constantemente antes de cada acción
• Si un skill dice "siempre ejecuta tests antes de hacer commit", el agente lo hará automáticamente
• Los skills pueden tener condiciones más complejas: "si es código crítico, hace review automático"

Diferencia clave en la práctica

Con Copilot Chat, el usuario inicia siempre. Con Copilot Agent, el agente puede iniciar acciones basadas en skills. Por ejemplo:

// Skill en .github/skills/transversales/02-auto-format/SKILL.md
Si detectas código con formato inconsistente:
- Ejecuta prettier/black automáticamente
- Crea un commit con [auto-format] en el mensaje
- No requiere intervención del usuario

El agente ejecutaría esto sin que le lo pidas.

Integration con Obsidian: Memoria Persistente junto a Copilot

Aunque Copilot es poderoso, tiene una limitación: cada sesión es relativamente aislada. Aquí es donde Obsidian entra en juego como complemento.

La sinergia: Copilot + Obsidian + Skills

Imagina este flujo:

1. Documentas decisiones arquitectónicas en Obsidian (ADRs - Architecture Decision Records)
2. Referencias estos documentos en tu copilot-instructions.md mediante links
3. Copilot consulta estos documentos como contexto persistente
4. Los skills se aplican junto con el contexto histórico de tus decisiones

Practical Example

En Obsidian documenta:

## ADR-001: Usar FastAPI + Pydantic

Decidimos usar FastAPI por su velocidad y validación automática.
Todas las rutas DEBEN:
- Usar Pydantic BaseModel para inputs
- Retornar 422 si validación falla
- Incluir docstrings con ejemplos de OpenAPI

En copilot-instructions.md:

## Contexto de arquitectura
Ver: obsidian://open?vault=mi-proyecto&file=ADR/001-fastapi

Ahora cuando Copilot genera código FastAPI, tiene acceso tanto al skill de FastAPI como al contexto histórico de por qué elegiste esa tecnología.

Mantenimiento de memoria con skills

Los skills de SKILLSBUNDLE incluyen templates para documentar decisiones que Obsidian y Copilot pueden consumir, cerrando el loop de memoria institucional.

Installation Paso a Paso: 1136 Skills en tu Copilot

Aquí comes la guía completa para instalar y activar los 1136 skills en tu repositorio y GitHub Copilot.

Requisitos previos

• GitHub Copilot activado en tu IDE (VS Code, JetBrains, etc.)
• Acceso a tu repositorio (puedes crear uno nuevo o usar uno existente)
• Git instalado localmente
• Acceso a SKILLSBUNDLE (registro previo)

Paso 1: Clonar/descargar los 1136 skills

Opción A - Desde SKILLSBUNDLE (recomendado):

git clone https://github.com/skillsbundle/1136-skills.git
cd 1136-skills
ls -la  # Verifica que ves .github/skills/

Opción B - Descarga ZIP desde el panel de SKILLSBUNDLE y extrae:

unzip skillsbundle-1136-skills.zip
cd skillsbundle-1136-skills

Paso 2: Copiar el directorio .github/skills/ a tu repositorio

cp -r .github/skills/ /path/to/mi-repositorio/.github/

O si estás migrando un repositorio existente:

cd /path/to/mi-repositorio
mkdir -p .github
cp -r /path/to/1136-skills/.github/skills .github/

Paso 3: Crear o actualizar copilot-instructions.md

En la raíz de tu repositorio, crea copilot-instructions.md (o actualiza si existe):

# GitHub Copilot Instructions

## Lenguaje principal: Python
Asume Python 3.11+ si no se especifica.

## Framework principal: FastAPI
Usa patrones de FastAPI para APIs REST.

## Skills disponibles

### Code Review
skill:.github/skills/transversales/01-code-review/SKILL.md

### Testing
skill:.github/skills/transversales/03-testing/SKILL.md

### Python - FastAPI Best Practices
skill:.github/skills/verticales/python/fastapi-best-practices/SKILL.md

### Performance Optimizetion
skill:.github/skills/transversales/04-performance/SKILL.md

### Security & Compliance
skill:.github/skills/transversales/06-security/SKILL.md

## Convenciones del proyecto
- Usa type hints en todas las funciones
- Máximo 100 caracteres por línea
- Variables en snake_case, clases en PascalCase
- Commits deben ser atómicos y descriptivos

Paso 4: Verificar la estructura correcta

tree .github/skills/ -L 2
# Output esperado:
# .github/skills/
# ├── transversales/
# │   ├── 01-code-review/
# │   ├── 02-refactoring/
# │   └── ...
# ├── verticales/
# │   ├── python/
# │   ├── javascript/
# │   └── ... (15+ lenguajes)
# └── manifest.json

Paso 5: Commit y push

cd /path/to/mi-repositorio
git add .github/skills/ copilot-instructions.md
git commit -m "feat: add 1136 SKILLSBUNDLE skills to Copilot"
git push origin main

Paso 6: Verificar en tu IDE

En VS Code o JetBrains:

1. Abre el repositorio
2. Abre la terminal integrada
3. Escribe en Copilot Chat: @copilot list available skills
4. Copilot debería listar los skills cargados
5. Alternativamente, haz: @copilot how should I structure a new FastAPI endpoint?
6. Debería responder usando el skill de FastAPI específico

Paso 7: Verificación avanzada - Prompt Guard

cd /path/to/mi-repositorio

# Verificar integridad de skills (opcional, si tienes el CLI)
skillsbundle verify --repo . --check-signatures

Esto valida que los skills no hayan sido modificados y no contienen instrucciones maliciosas.

Copilot Workspace y Skills: Future-Proofing tu Setup

GitHub Copilot Workspace es la próxima generación de desarrollo AI-asistido. Permite que Copilot trabaje completamente autónomamente en tareas complejas.

Cómo los skills se integran en Copilot Workspace

Cuando abres una sesión de Copilot Workspace, automáticamente:

• Lee copilot-instructions.md de tu repositorio
• Carga todos los skills relevantes desde .github/skills/
• Usa estos skills como sistema de restricciones para sus acciones
• Ejecuta tasks de forma autónoma pero respetando tus skills

Ejemplo: Task autónoma con skills

Creas una task en Copilot Workspace:

"Refactoriza el módulo de autenticación para usar JWT en lugar de sessions"

Copilot automáticamente:

1. Carga el skill de refactoring transversal
2. Carga el skill vertical de Python/FastAPI
3. Examina el código existente
4. Crea una rama
5. Refactoriza el código siguiendo EXACTAMENTE tus skills
6. Genera tests usando el skill de testing
7. Crea un PR con descripción automática

Todo sin intervención humana, pero completamente alineado con tus estándares de equipo.

Visualización de la arquitectura: Infografías

Conclusion: Tu Copilot Superpotenciado

GitHub Copilot es revolucionario, pero sin instrucciones específicas es como tener un asistente generista. Con los 1136 skills de SKILLSBUNDLE integrados en .github/skills/ y activados mediante copilot-instructions.md, transformas Copilot en un especialista que entiende exactamente:

• Tu stack: Lenguajes, frameworks, convenciones específicas
• Tus mejores prácticas: 1136 skills profesionales aplicados automáticamente
• Tu contexto: Decisiones arquitectónicas, historiales, ADRs en Obsidian
• Tus reglas de seguridad: Protección contra prompt injection con Prompt Guard

El resultado es código que es:

• Consistente: Todos en tu equipo generan código del mismo estilo
• De calidad: Sigue probadas mejores prácticas, no invenciones ad-hoc
• Eficiente: 76% menos tokens, actualizaciones automáticas de skills
• Seguro: Validación de instrucciones, sin compromiso de inyecciones

Los próximos pasos son claros: instala los 1136 skills hoy, configura copilot-instructions.md, y comienza a experimentar un Copilot que es verdaderamente *tu* Copilot.