Creer sa premiere skill, pas a pas#

mkdir -p .claude/skills/convention-sql-equipe/reference

New-Item -ItemType Directory -Force .claude/skills/convention-sql-equipe/reference

.claude/skills/convention-sql-equipe/
├── SKILL.md
└── reference/
    ├── style-sql.md
    └── squelette.sql

---
name: convention-sql-equipe
description: Applique les conventions SQL de l'equipe data (nommage des tables, colonnes
  et CTE, formatage, interdictions) a toute requete ecrite ou relue. A utiliser des que
  l'utilisateur ecrit, corrige ou relit du SQL, un modele dbt, une vue, une CTE, ou
  mentionne BigQuery, Snowflake, un fichier .sql ou le dossier models/.
allowed-tools: Read, Grep, Glob
---

# Conventions SQL de l'equipe data

## Regles non negociables

1. Jamais de `SELECT *` en dehors d'une CTE d'exploration temporaire.
2. Toujours filtrer les lignes de test : `WHERE is_test = FALSE`.
3. Les montants sont stockes en centimes : diviser par 100 et suffixer la colonne
   en `_eur`.
4. Toute jointure precise son type en toutes lettres : `INNER JOIN`, `LEFT JOIN`.
   Jamais `JOIN` tout court.
5. Aucune valeur en dur en production : passer par une CTE nommee `parametres`.

## Procedure

Quand tu ecris ou relis une requete :

- [ ] Etape 1 : lire [reference/style-sql.md](reference/style-sql.md)
- [ ] Etape 2 : ecrire ou corriger la requete
- [ ] Etape 3 : relire la requete contre les 5 regles non negociables
- [ ] Etape 4 : si une regle est violee, corriger et recommencer l'etape 3
- [ ] Etape 5 : livrer la requete finale

Ne livre jamais une requete qui n'a pas passe l'etape 3.

## Squelette de requete

Pars toujours du squelette de [reference/squelette.sql](reference/squelette.sql) :
CTE `parametres`, puis une CTE de filtrage, puis une CTE `final`, et la requete se
termine par `select * from final`.

## Ressources

- Conventions detaillees et anti-patterns : [reference/style-sql.md](reference/style-sql.md)
- Squelette de requete : [reference/squelette.sql](reference/squelette.sql)

# Conventions SQL detaillees

## Sommaire
- Nommage des objets
- Nommage des colonnes
- Formatage
- Anti-patterns interdits
- Cas particuliers dbt

## Nommage des objets

| Type | Prefixe | Exemple |
| --- | --- | --- |
| Modele de staging | `stg_` | `stg_commandes` |
| Modele intermediaire | `int_` | `int_commandes_enrichies` |
| Table de faits | `fct_` | `fct_ventes_journalieres` |
| Table de dimension | `dim_` | `dim_client` |

Tout en snake_case, en minuscules, au singulier sauf les tables de faits.

## Nommage des colonnes

| Contenu | Convention | Exemple |
| --- | --- | --- |
| Identifiant technique | suffixe `_id` | `client_id` |
| Date sans heure | prefixe `date_` | `date_commande` |
| Horodatage UTC | suffixe `_at_utc` | `created_at_utc` |
| Montant en euros | suffixe `_eur` | `montant_ttc_eur` |
| Montant brut en centimes | suffixe `_cents` | `montant_ttc_cents` |
| Booleen | prefixe `is_` ou `has_` | `is_test` |
| Comptage | prefixe `nb_` | `nb_commandes` |

## Formatage

- Mots-cles SQL en minuscules, une colonne par ligne dans le `select`.
- Alias toujours explicites avec `as`. Indentation a 4 espaces.
- Une CTE par bloc, separee par une ligne vide.
- La requete se termine toujours par `select * from final`.

## Anti-patterns interdits

| Interdit | Pourquoi | A la place |
| --- | --- | --- |
| `select *` en production | Casse au moindre changement de schema | Lister les colonnes |
| `JOIN` sans type | Ambigu a la relecture | `inner join` ou `left join` |
| Sous-requetes a plus de 2 niveaux | Illisible, indebogable | Des CTE nommees |
| Date en dur dans le `where` | Non reutilisable | Une CTE `parametres` |
| Alias d'une lettre | Illisible | Un alias parlant : `cmd`, `cli` |
| Oublier `is_test = false` | Fausse tous les chiffres | Le filtre systematique |

## Cas particuliers dbt

- Toujours `{{ ref('nom_modele') }}`, jamais le nom de table en dur.
- Toujours `{{ source('schema', 'table') }}` pour les sources brutes.
- Tout nouveau modele a une entree dans le `schema.yml` du dossier, avec au
  minimum une `description` et les tests `unique` + `not_null` sur la cle primaire.

with parametres as (
    select
        date '2026-01-01' as date_debut,
        date '2026-12-31' as date_fin
),

commandes_filtrees as (
    select
        commande_id,
        client_id,
        date_commande,
        montant_ttc_cents / 100.0 as montant_ttc_eur
    from stg_commandes
    cross join parametres
    where is_test = false
      and date_commande between parametres.date_debut and parametres.date_fin
),

final as (
    select
        date_trunc(date_commande, month) as mois,
        count(distinct commande_id)      as nb_commandes,
        sum(montant_ttc_eur)             as chiffre_affaires_eur
    from commandes_filtrees
    group by 1
)

select * from final

Ecris-moi une requete qui donne le chiffre d'affaires mensuel par region
sur l'exercice en cours, a partir de stg_commandes et dim_magasin.

SELECT region, DATE_TRUNC(date_commande, MONTH) AS m, SUM(montant_ttc_cents) AS ca
FROM stg_commandes c JOIN dim_magasin d ON c.magasin_id = d.magasin_id
WHERE date_commande >= '2026-01-01'
GROUP BY 1, 2

J'ai ecrit cette skill mais elle ne se declenche pas quand je demande
[TA_DEMANDE_TYPE_MOT_POUR_MOT].
Voici la description actuelle : [COLLE_LA_DESCRIPTION].
Reecris-la a la troisieme personne pour qu'elle se declenche sur ce type de demande,
en integrant les mots declencheurs que j'emploie vraiment. Garde-la sous 3 phrases.

Quand cette skill est active et que je demande [TYPE_DE_DEMANDE], l'agent oublie
systematiquement [LA_REGLE_OUBLIEE].
Voici le SKILL.md actuel : [COLLE_LE_FICHIER].
Propose une reorganisation pour rendre cette regle impossible a manquer.
Ne rallonge pas le fichier de plus de 10 lignes.

On vient de faire ensemble : [RESUME_DE_LA_TACHE].
Pendant cet echange, je t'ai donne ces informations que je redonne a chaque fois :
- [INFO_1 : schema, table, convention]
- [INFO_2]
- [INFO_3]

Cree une skill qui capture ca.
Contraintes :
- nom en minuscules avec tirets, sans accent
- description a la troisieme personne, ce que ca fait ET quand l'utiliser, avec ces
  mots declencheurs : [MOT_1], [MOT_2], [MOT_3]
- SKILL.md sous 80 lignes : mets le detail dans reference/[NOM_FICHIER].md
- n'explique pas ce que tu sais deja faire, ne garde que mes regles a moi
- ecris les fichiers dans .claude/skills/[NOM_DE_LA_SKILL]/