Cinq etapes pour creer une competence

Un guide etape par etape pour creer votre premier Agent Skill.

Etape 1 : Identifier votre besoin principal

Avant d'ecrire quoi que ce soit, definissez clairement :

• Probleme : Quel defi votre competence resout-elle ?
• Public : Qui utilisera cette competence ?
• Portee : Que doit couvrir la competence (et ne pas couvrir) ?

Questions a repondre

1. Quelles taches l'IA effectuera-t-elle avec cette competence ?
2. Quelles connaissances du domaine sont requises ?
3. Quels comportements l'IA doit-elle adopter ?
4. Quelles erreurs courantes doivent etre evitees ?

Exemple

Probleme : Les developpeurs ont besoin de retours coherents lors des revues de code Public : Equipes de developpement utilisant des pull requests Portee : Qualite du code, securite et style - pas la gestion de projet

Etape 2 : Ecrire le champ Name

Le nom de votre competence doit etre :

• Descriptif : Indique clairement ce que fait la competence
• Concis : 3-5 mots maximum
• Unique : Se distingue des competences similaires

Bons noms

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

Mauvais noms

• "My Skill" (pas descriptif)
• "The Ultimate Complete Development Guide for Everything" (trop long)
• "Helper" (pas specifique)

Etape 3 : Ecrire la description

La description apparait dans les resultats de recherche et les cartes de competences. Faites-la compter :

• Premiers 100 caracteres : Les plus importants - affiches dans les apercut
• Inclure des mots-cles : Aider les utilisateurs a trouver votre competence
• Etre specifique : Mentionner les fonctionnalites cles ou les cas d'utilisation

Modele

Exemple

Etape 4 : Ecrire le contenu principal

Structurez votre contenu pour la clarte et l'efficacite :

Section Context

Fournissez des informations de base :

## Context

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

Section Guidelines

Listez des regles specifiques :

## 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

Section Examples

Montrez le comportement attendu :

## 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)."

Etape 5 : Telecharger et tester

Creer le depot

1. Allez sur GitHub et creez un nouveau depot
2. Ajoutez votre fichier SKILL.md a la racine
3. Rendez le depot public

Soumettre au Index

1. Visitez /submit sur le marketplace
2. Entrez l'URL de votre depot
3. Cliquez sur "Submit"

Tester votre competence

Apres soumission :

1. Installez la competence sur votre plateforme preferee
2. Testez avec divers prompts
3. Verifiez que l'IA suit vos directives
4. Iterez et ameliorez en fonction des resultats

Liste de verification des tests

Avant de publier, testez ces scenarios :

Operation normale

• [ ] L'IA suit correctement les directives principales
• [ ] Les exemples sont appliques de maniere appropriee
• [ ] Le ton et le style correspondent aux attentes

Cas limites

• [ ] Gere les entrees inhabituelles avec elegance
• [ ] N'entre pas en conflit avec d'autres competences
• [ ] Fonctionne sur toutes les plateformes supportees

Hors portee

• [ ] L'IA defere correctement sur les sujets non lies
• [ ] Ne depasse pas les limites de la competence
• [ ] Gere avec elegance les demandes hors portee

Prochaines etapes

• Format SKILL.md - Reference complete du format
• Bonnes pratiques - Conseils pour des competences efficaces
• Exemples - Apprenez des competences existantes