Crée des jeux d'instructions réutilisables pour des workflows spécialisés. Définis des workflows personnalisés, ajoute des fichiers de support et apprends à Bob des tâches spécialisées pour des résultats cohérents.

Les skills sont des jeux d'instructions réutilisables qui apprennent à Bob de nouveaux workflows et tâches spécialisées. Pense à eux comme des recettes que Bob suit pour accomplir des types de travail spécifiques de manière cohérente et reproductible.

Pourquoi utiliser les skills

Réutilisabilité : Définis des workflows une fois et utilise-les dans plusieurs conversations.

Cohérence : Assure-toi que Bob suit la même approche à chaque fois pour des tâches spécifiques.

Spécialisation : Crée une expertise spécifique à un domaine pour les revues de code, les tests, la documentation, etc.

Collaboration d'équipe : Partage des workflows standardisés avec ton équipe via le contrôle de version.

Flexibilité : Inclus des fichiers de support comme des checklists, des modèles et des matériaux de référence.

Prérequis

Les skills ne sont disponibles qu'en mode Advanced. Cela garantit que Bob a accès à tous les outils nécessaires pour exécuter efficacement les workflows basés sur des skills.

Comment fonctionnent les skills

Lorsque tu actives un skill, Bob reçoit les instructions du skill et accède à tous les fichiers de support dans le répertoire du skill. Bob suit ensuite ces instructions pour accomplir ta tâche selon le workflow défini.

Les skills se chargent une fois par conversation pour éviter les prompts dupliqués. Bob détermine automatiquement quand activer un skill en fonction de ta demande et de la description du skill.

Créer un skill

Configuration de base

Crée un dossier dans .bob/skills/ à la racine de ton projet, ou utilise ~/.bob/skills/ pour les skills globaux.

Ajoute un fichier SKILL.md dans ce dossier.

Structure exemple :

SKILL.md

Format de SKILL.md

Le fichier SKILL.md utilise un frontmatter YAML suivi des instructions du skill :

---
name: code-review
description: Review code for bugs, security issues, and best practices
---

When reviewing code, check for:
- Security vulnerabilities
- Performance issues
- Missing error handling at API boundaries
- Unused imports and dead code

Provide a summary with severity levels for each finding.

Champs obligatoires :

name : Le nom d'affichage du skill dans l'interface Bob

description : Un résumé clair qui aide Bob à décider quand activer ce skill — les skills sans description sont ignorés

Section instructions : Tout ce qui se trouve après le délimiteur --- devient les instructions que Bob reçoit lorsque le skill est activé.

Ajouter des fichiers de support

Tu peux inclure des fichiers supplémentaires et des sous-dossiers à côté de SKILL.md pour fournir des matériaux de référence, des modèles, des checklists, des scripts ou d'autres ressources. Bob peut lire ces fichiers automatiquement une fois le skill activé.

Exemple avec fichiers de support :

SKILL.md

checklist.md

severity-guide.md

analyze.sh

report-generator.py

Les fichiers et dossiers de support peuvent inclure :

Checklists et modèles

Documentation de référence

Exemples de configuration

Scripts et utilitaires dans des sous-dossiers

Guides de style

Toute autre ressource nécessaire pour le skill

Emplacements des skills

Les skills peuvent être définis à deux niveaux :

Emplacement	Portée	Cas d'utilisation
`<project>/.bob/skills/`	Spécifique au projet	Workflows propres à ce projet
`~/.bob/skills/`	Global	Workflows personnels ou à l'échelle de l'organisation

Priorité : Si les deux emplacements contiennent un skill avec le même nom, le skill au niveau du projet a la priorité.

Approuver les skills

Par défaut, Bob demande ta permission avant d'activer un skill. Cela te donne le contrôle sur l'application des workflows spécialisés.

Pour ignorer le prompt d'approbation :

Ouvre les paramètres Bob.

Navigue vers la section Approbation automatique.

Active le toggle pour Skills.

Avec ce paramètre activé, Bob active automatiquement les skills quand c'est approprié sans demander la permission.

Onglet des paramètres Skills

L'onglet Skills dans les paramètres Bob t'offre un endroit central pour voir et gérer les skills disponibles dans ton workspace. Utilise-le pour voir quels skills sont chargés, vérifier leurs emplacements et confirmer que les skills de tes répertoires de projet ou globaux sont correctement détectés.

Écrire des skills efficaces

Descriptions claires

Rédige des descriptions qui indiquent clairement quand le skill doit être utilisé. Bob s'appuie sur ces descriptions pour déterminer la pertinence du skill.

Bien : « Review code for bugs, security issues, and best practices »

À éviter : « Code review skill »

Instructions ciblées

Garde le fichier SKILL.md principal focalisé sur le workflow principal. Déplace le matériel de référence détaillé, les exemples et les checklists vers des fichiers de support.

Exemple :

---
name: api-documentation
description: Generate API documentation following OpenAPI standards
---

Generate API documentation that includes:
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example requests and responses

Follow the style guide in `api-style-guide.md` and use the template in `api-template.md`.

Étapes actionnables

Structure les instructions comme des étapes claires et actionnables que Bob peut suivre de manière systématique.

Exemple :

---
name: feature-implementation
description: Implement new features following team standards
---

<Steps>
<Step>
Review the feature requirements.

</Step>

<Step>
Create a plan with file changes needed.

</Step>

<Step>
Implement the feature with tests.

</Step>

<Step>
Update documentation.

</Step>

<Step>
Verify all tests pass.

</Step>
</Steps>

Follow coding standards in `coding-standards.md`.

Exemples de skills

Skill de revue de code

---
name: security-review
description: Review code for security vulnerabilities and best practices
---

Perform a security-focused code review:

<Steps>
<Step>
Check for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Authentication/authorization issues
- Sensitive data exposure

</Step>

<Step>
Review security best practices:
- Input validation
- Output encoding
- Secure configuration
- Error handling

</Step>

<Step>
Provide findings with:
- Severity level (Critical, High, Medium, Low)
- Location in code
- Recommended fix
- Reference to security standards

</Step>
</Steps>

Use the severity guide in `severity-levels.md` for classification.

Skill de documentation

---
name: api-docs
description: Generate comprehensive API documentation
---

Create API documentation that includes:

<Steps>
<Step>
Overview section:
- Purpose and use cases
- Authentication requirements
- Base URL and versioning

</Step>

<Step>
For each endpoint:
- HTTP method and path
- Description and purpose
- Request parameters
- Request body schema
- Response codes and schemas
- Example requests and responses

</Step>

<Step>
Additional sections:
- Error handling
- Rate limiting
- Pagination

</Step>
</Steps>

Follow the template in `api-doc-template.md` and examples in `api-examples.md`.

Conseils et bonnes pratiques

Commence simplement : Commence avec des instructions basiques et affine en fonction des résultats.

Utilise les fichiers de support : Garde SKILL.md concis en déplaçant le contenu détaillé vers des fichiers complémentaires.

Teste soigneusement : Vérifie que les skills fonctionnent comme prévu avant de les partager avec ton équipe.

Contrôle de version : Inclus les skills du projet dans ton dépôt pour la cohérence de l'équipe.

Nommage clair : Utilise des noms de skills descriptifs qui indiquent leur objectif.

Responsabilité unique : Crée des skills ciblés pour des tâches spécifiques plutôt que d'essayer de gérer plusieurs workflows non liés.

Skills

Sur cette page