>_

Cinco Pasos para Crear una Skill

Una guia paso a paso para crear tu primera Agent Skill.

Paso 1: Identifica Tu Necesidad Principal

Antes de escribir cualquier contenido, define claramente:

  • Problema: Que desafio resuelve tu skill?
  • Audiencia: Quien usara esta skill?
  • Alcance: Que deberia cubrir la skill (y que no)?

Preguntas a Responder

  1. Que tareas realizara la IA con esta skill?
  2. Que conocimiento del dominio se requiere?
  3. Que comportamientos deberia exhibir la IA?
  4. Que errores comunes deben evitarse?

Ejemplo

Problema: Los desarrolladores necesitan retroalimentacion consistente en revisiones de codigo Audiencia: Equipos de desarrollo que usan pull requests Alcance: Calidad de codigo, seguridad y estilo - no gestion de proyectos

Paso 2: Escribe el Campo de Nombre

El nombre de tu skill deberia ser:

  • Descriptivo: Indicar claramente que hace la skill
  • Conciso: Maximo 3-5 palabras
  • Unico: Distinguirse de skills similares

Buenos Nombres

  • "React Component Guidelines"
  • "API Security Checker"
  • "Brand Voice Guide"

Malos Nombres

  • "My Skill" (no descriptivo)
  • "The Ultimate Complete Development Guide for Everything" (muy largo)
  • "Helper" (no especifico)

Paso 3: Escribe la Descripcion

La descripcion aparece en los resultados de busqueda y tarjetas de skills. Hazla valer:

  • Primeros 100 caracteres: Lo mas importante - se muestra en las vistas previas
  • Incluye palabras clave: Ayuda a los usuarios a encontrar tu skill
  • Se especifico: Menciona caracteristicas clave o casos de uso

Plantilla

[Accion] para [audiencia] que [beneficio clave]. Cubre [caracteristicas principales].

Ejemplo

Code review guidelines for development teams that ensure consistent, high-quality feedback. Covers security, performance, and style checks.

Paso 4: Escribe el Contenido Principal

Estructura tu contenido para claridad y efectividad:

Seccion de Contexto

Proporciona informacion de fondo:

markdown
## Context

This skill helps AI assistants review code with a focus on:
- Security vulnerabilities
- Performance optimization
- Code style consistency
- Best practice adherence

Seccion de Directrices

Lista reglas especificas:

markdown
## Guidelines

1. Always check for input validation
2. Look for potential SQL injection
3. Verify error handling exists
4. Check for hardcoded credentials
5. Review logging practices

Seccion de Ejemplos

Muestra el comportamiento esperado:

markdown
## Examples

### Security Review Comment
"Consider using parameterized queries here to prevent SQL injection.
The current string concatenation is vulnerable to malicious input."

### Performance Review Comment
"This loop iterates over the entire array for each element.
Consider using a Set or Map for O(1) lookups instead of O(n)."

Paso 5: Sube y Prueba

Crear el Repositorio

  1. Ve a GitHub y crea un nuevo repositorio
  2. Agrega tu archivo SKILL.md en la raiz
  3. Haz el repositorio publico

Enviar al Index

  1. Visita /submit en el marketplace
  2. Ingresa la URL de tu repositorio
  3. Haz clic en "Submit"

Probar Tu Skill

Despues del envio:

  1. Instala la skill en tu plataforma preferida
  2. Prueba con varios prompts
  3. Verifica que la IA siga tus directrices
  4. Itera y mejora basandote en los resultados

Lista de Verificacion de Pruebas

Antes de publicar, prueba estos escenarios:

Operacion Normal

  • [ ] La IA sigue correctamente las directrices principales
  • [ ] Los ejemplos se aplican apropiadamente
  • [ ] El tono y estilo coinciden con las expectativas

Casos Limite

  • [ ] Maneja entradas inusuales con gracia
  • [ ] No entra en conflicto con otras skills
  • [ ] Funciona en todas las plataformas soportadas

Fuera del Alcance

  • [ ] La IA correctamente difiere en temas no relacionados
  • [ ] No excede los limites de la skill
  • [ ] Maneja con gracia solicitudes fuera del alcance

Proximos Pasos

Editar esta página en GitHub