Créer un skill

Guide complet pour créer vos propres skills ATOOX.

Structure d'un skill

my-skill/
├── SKILL.md           # Instructions du skill (obligatoire)
├── assets/            # Ressources optionnelles
│   ├── templates/
│   └── examples/
└── references/        # Documentation de référence

SKILL.md

Le fichier SKILL.md définit le comportement du skill.

Structure de base

# My Skill

> Description courte du skill (1 ligne)

## Triggers

- trigger1
- trigger2
- "phrase exacte"

## Instructions

[Instructions détaillées pour Claude Code]

## Modes

### --mode1

Description du mode 1.

### --mode2

Description du mode 2.

## Output

[Format de sortie attendu]

Exemple : Skill d'audit GraphQL

# GraphQL Audit

> Audit complet d'une API GraphQL : schéma, performance, sécurité.

## Triggers

- audit graphql
- graphql review
- check graphql schema
- /graphql-audit

## Instructions

Tu es un expert GraphQL (Lee Byron, Dan Schafer).
Analyse l'API GraphQL selon ces critères :

### 1. Schéma
- Conventions de nommage (camelCase)
- Types nullables vs non-nullables
- Pagination (Relay-style connections)
- Input types pour mutations

### 2. Performance
- N+1 queries (DataLoader)
- Complexity limiting
- Depth limiting
- Query batching

### 3. Sécurité
- Introspection désactivée en prod
- Rate limiting
- Query cost analysis
- Injection prevention

### 4. Best Practices
- Error handling
- Deprecation strategy
- Documentation des types
- Versioning

## Modes

### --full

Audit complet de tous les critères.

### --quick

Vérification rapide des issues critiques.

### --security

Focus sur la sécurité uniquement.

### --perf

Focus sur la performance uniquement.

## Output

Rapport structuré avec :
- Score global (A-F)
- Issues par catégorie
- Recommandations priorisées
- Exemples de correction

Installation d'un skill

Méthode 1 : Placement manuel

# Copier le dossier du skill
cp -r my-skill/ ~/.claude/skills/

Méthode 2 : Via CLI

atoox install ./my-skill

Méthode 3 : Via Skill Forge (PRO)

/atoox-skill-forge "créer skill pour [description]"

Bonnes pratiques

1. Instructions claires

## Instructions

# Bon ✅
Tu es un expert en [domaine].
Pour chaque fichier analysé :
1. Vérifier [critère 1]
2. Vérifier [critère 2]
3. Produire un rapport avec [format]

# Mauvais ❌
Analyse le code et dis ce qui ne va pas.

2. Modes bien définis

## Modes

### --full
Analyse exhaustive. Temps estimé : 5-10 min.
Active tous les critères d'audit.

### --quick
Vérification rapide. Temps estimé : 1-2 min.
Ne vérifie que les issues critiques et hautes.

3. Output structuré

## Output

Produire un rapport au format :

╔══════════════════════════════════════════════════════════════╗
║  [NOM DU SKILL] — Résultats                                  ║
╠══════════════════════════════════════════════════════════════╣
║  Score global : [A-F]                                        ║
║  Fichiers analysés : [N]                                     ║
║  Issues trouvées : [N] (Critical: X, High: Y, Medium: Z)     ║
╚══════════════════════════════════════════════════════════════╝

Issues par catégorie :
  [Catégorie 1]
    - [Issue 1] (severity) : [description]
    - [Issue 2] (severity) : [description]

Recommandations :
  1. [Action prioritaire 1]
  2. [Action prioritaire 2]

4. Exemples intégrés

## Exemples

### Exemple 1 : Audit basique

Input :
/graphql-audit src/schema.graphql

Output attendu :
Score: B
Issues: 3 (0 critical, 1 high, 2 medium)

Assets et références

Ajouter des templates

my-skill/
├── SKILL.md
└── assets/
    └── templates/
        ├── report.md
        └── fix-example.ts

Référencer dans SKILL.md :

## Output

Utiliser le template : `@assets/templates/report.md`

Ajouter de la documentation

my-skill/
├── SKILL.md
└── references/
    ├── graphql-spec.md
    └── best-practices.md

Référencer :

## Instructions

Se baser sur les standards définis dans `@references/graphql-spec.md`.

Skill Forge (PRO)

Le Skill Forge génère automatiquement des skills complets.

/atoox-skill-forge "créer un skill pour auditer les Dockerfiles"

Processus

  1. Analyse de l'intention

    • Comprend le domaine
    • Identifie les experts pertinents

  2. Génération de la structure

    • SKILL.md avec instructions complètes
    • Modes appropriés
    • Templates de sortie

  3. Validation

    • Vérifie la cohérence
    • Test du skill sur un exemple

  4. Installation

    • Place le skill dans ~/.claude/skills/
    • Enregistre dans le registre

Options

# Avec exemples intégrés
/atoox-skill-forge --with-examples "skill pour [X]"

# Mode guidé
/atoox-skill-forge --interactive

# À partir d'un skill existant
/atoox-skill-forge --extend atoox-sonar-pro "ajouter support Rust"

Publier un skill

1. Valider le skill

atoox validate my-skill/

2. Créer un package

atoox pack my-skill/
# → my-skill-1.0.0.atoox

3. Publier (PRO)

atoox publish my-skill-1.0.0.atoox

4. Partager

# Via URL
atoox install https://example.com/my-skill.atoox

# Via GitHub
atoox install github:username/my-skill

Exemples de skills

Skill de validation PR

# PR Validator

> Valide une PR selon les standards de l'équipe.

## Triggers

- validate pr
- check pr
- /pr-check

## Instructions

Vérifier :
1. Titre suit les Conventional Commits
2. Description présente et complète
3. Tests ajoutés ou justification
4. Pas de console.log/debugger
5. Pas de TODO/FIXME non documentés
6. Changements dans CHANGELOG si nécessaire

## Output

✅ PR OK ou ❌ PR KO avec liste des corrections.

Skill de migration

# Database Migration Helper

> Guide les migrations de schéma de base de données.

## Triggers

- create migration
- db migrate
- schema change

## Instructions

Pour chaque migration :
1. Vérifier la rétrocompatibilité
2. Proposer Expand-Contract si breaking change
3. Générer rollback
4. Documenter l'impact sur les requêtes

Prochaines étapes