>_

Mejores Practicas

Directrices para crear Agent Skills efectivas y mantenibles.

Descripcion General

Las skills bien disenadas son la diferencia entre un asistente de IA util y uno frustrante. Sigue estas mejores practicas para crear skills que funcionen de manera confiable.

Principios Fundamentales

1. Se Especifico, No Vago

Bueno:

"Usa mayusculas de oracion para los encabezados. Capitaliza solo la primera palabra y los nombres propios."

Malo:

"Usa la capitalizacion apropiada."

2. Proporciona Ejemplos

Muestra, no solo cuentes. Incluye ejemplos concretos del comportamiento esperado.

Bueno:

When formatting dates: - Write: "January 15, 2024" - Don't write: "01/15/24" or "15 Jan 2024"

3. Define el Alcance Claramente

Indica explicitamente que cubre la skill y que no.

Bueno:

This skill covers: - React component design - State management - Performance optimization This skill does NOT cover: - Backend API design - Database schema - DevOps/deployment

4. Usa Estructura Consistente

Organiza el contenido de manera predecible para que la IA pueda encontrar informacion rapidamente.

Secciones recomendadas:

  1. Contexto/Descripcion General
  2. Directrices
  3. Que Hacer y Que No Hacer
  4. Ejemplos
  5. Referencias

5. Manten el Enfoque

Una skill = un dominio. No intentes cubrir todo.

Bueno: "React Component Guidelines" Malo: "Complete Web Development Guide"

Errores Comunes

Sobre-Ingenieria

No agregues complejidad que no proporciona valor:

  • Demasiadas reglas que se contradicen entre si
  • Casos limite que raramente ocurren
  • Informacion redundante

Sub-Especificacion

No dejes detalles importantes ambiguos:

  • Ejemplos faltantes para conceptos clave
  • Lenguaje vago como "segun corresponda"
  • Sin guia sobre casos limite

Instrucciones Conflictivas

Asegurate de que tus directrices no se contradigan:

Problema:

"Manten las respuestas concisas" y "Proporciona explicaciones detalladas"

Solucion:

"Manten las respuestas concisas. Para temas complejos, proporciona explicaciones detalladas en secciones expandibles."

Documentacion

Relacionado

Editar esta página en GitHub