>_

Escribir Descripciones Efectivas

La descripcion de tu skill es crucial para la descubribilidad y comprension del usuario.

Las Dos Descripciones

1. Descripcion del Frontmatter (200 caracteres)

Aparece en:

  • Resultados de busqueda
  • Tarjetas de skills
  • Listados del marketplace

Objetivo: Comunicar rapidamente el valor y alcance.

2. Descripcion del Contenido (ilimitada)

Aparece en:

  • Pagina de detalle de la skill
  • Documentacion

Objetivo: Proporcionar comprension completa.

Consejos para la Descripcion del Frontmatter

Comienza con el Valor

Empieza con lo que el usuario obtiene, no con lo que es la skill.

Bueno:

"Write cleaner React code with component patterns, performance tips, and accessibility guidelines."

Malo:

"This skill contains guidelines for React development."

Incluye Palabras Clave

Ayuda a los usuarios a encontrar tu skill a traves de la busqueda.

Bueno:

"TypeScript type safety guidelines: generics, type guards, utility types, and strict mode best practices."

Malo:

"Guidelines for type-safe code."

Se Especifico Sobre el Alcance

Establece expectativas claras.

Bueno:

"API security checklist: authentication, authorization, input validation, and rate limiting for REST APIs."

Malo:

"Security best practices."

Usa Lenguaje Activo

Hazlo orientado a la accion.

Bueno:

"Build accessible React components with ARIA labels, keyboard navigation, and screen reader support."

Malo:

"Accessibility information for React."

Plantillas

Para Skills de Directrices

[Action] [domain] with [key feature 1], [key feature 2], and [key feature 3].

Ejemplo:

"Write maintainable CSS with BEM naming, utility classes, and responsive design patterns."

Para Skills de Revision

[Review type] for [audience]: [check 1], [check 2], and [check 3].

Ejemplo:

"Code review guidelines for teams: security checks, performance analysis, and style consistency."

Para Skills de Integracion

[Integrate/Connect] [technology] with [approach]: [feature 1] and [feature 2].

Ejemplo:

"Integrate Stripe payments with best practices: webhook handling and error recovery."

Errores Comunes

Muy Vago

Problema: "Guidelines for better code." Mejor: "Python code quality: PEP 8 style, type hints, and documentation standards."

Muy Largo

Problema: Descripciones de mas de 300 caracteres que se truncan. Mejor: Manten menos de 180 caracteres. Usa la seccion de contenido para detalles.

Jerga Sin Contexto

Problema: "SOLID principles for DDD with CQRS patterns." Mejor: "Clean architecture patterns: single responsibility, dependency injection, and domain modeling."

Sin Diferenciador

Problema: "React development guidelines." Mejor: "React server components: streaming, suspense, and data fetching patterns."

Estrategia de Palabras Clave

Incluye terminos que los usuarios podrian buscar:

| Categoria | Palabras Clave | |----------|----------| | Tecnologia | React, TypeScript, Python, AWS | | Dominio | authentication, payments, analytics | | Tarea | review, testing, deployment | | Calidad | security, performance, accessibility |

Probando Tu Descripcion

  1. Prueba de busqueda: Encontrarias esto buscando terminos relacionados?
  2. Prueba de escaneo: Puedes entender la skill en 5 segundos?
  3. Prueba de diferenciacion: En que se diferencia de skills similares?
  4. Prueba de accion: Esta claro que haras con esta skill?

Proximos Pasos

Editar esta página en GitHub