>_

Rediger des descriptions efficaces

La description de votre competence est cruciale pour la decouverte et la comprehension par les utilisateurs.

Les deux descriptions

1. Description du frontmatter (200 caracteres)

Apparait dans :

  • Resultats de recherche
  • Cartes de competences
  • Listes du marketplace

Objectif : Communiquer rapidement la valeur et la portee.

2. Description du contenu (illimitee)

Apparait dans :

  • Page de detail de la competence
  • Documentation

Objectif : Fournir une comprehension complete.

Conseils pour la description du frontmatter

Commencer par la valeur

Commencez par ce que l'utilisateur gagne, pas ce qu'est la competence.

Bien :

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

Mal :

"This skill contains guidelines for React development."

Inclure des mots-cles

Aidez les utilisateurs a trouver votre competence via la recherche.

Bien :

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

Mal :

"Guidelines for type-safe code."

Etre specifique sur la portee

Definissez des attentes claires.

Bien :

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

Mal :

"Security best practices."

Utiliser un langage actif

Rendez-le oriente vers l'action.

Bien :

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

Mal :

"Accessibility information for React."

Modeles

Pour les competences de directives

[Action] [domaine] with [fonctionnalite cle 1], [fonctionnalite cle 2], and [fonctionnalite cle 3].

Exemple :

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

Pour les competences de revue

[Type de revue] for [public]: [verification 1], [verification 2], and [verification 3].

Exemple :

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

Pour les competences d'integration

[Integrate/Connect] [technologie] with [approche]: [fonctionnalite 1] and [fonctionnalite 2].

Exemple :

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

Erreurs courantes

Trop vague

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

Trop long

Probleme : Descriptions de plus de 300 caracteres qui sont tronquees. Mieux : Gardez moins de 180 caracteres. Utilisez la section contenu pour les details.

Jargon sans contexte

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

Pas de differenciateur

Probleme : "React development guidelines." Mieux : "React server components: streaming, suspense, and data fetching patterns."

Strategie de mots-cles

Incluez les termes que les utilisateurs pourraient rechercher :

| Categorie | Mots-cles | |----------|----------| | Technologie | React, TypeScript, Python, AWS | | Domaine | authentication, payments, analytics | | Tache | review, testing, deployment | | Qualite | security, performance, accessibility |

Tester votre description

  1. Test de recherche : Trouveriez-vous ceci en recherchant des termes connexes ?
  2. Test de scan : Pouvez-vous comprendre la competence en 5 secondes ?
  3. Test de differenciation : En quoi est-ce different des competences similaires ?
  4. Test d'action : Est-il clair ce que vous ferez avec cette competence ?

Prochaines etapes

Modifier cette page sur GitHub