القائمة
Ajoute gitleaks (détection de secrets) à un projet existant — hook pre-commit, script pre-push, configuration .gitleaks.toml et intégration Mise.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Créer un nouveau projet Node.js avec PostgreSQL (raw SQL, migrations, conteneur Podman) basé sur les préférences de Stéphane Klein. Use when user wants to create a Node.js project with PostgreSQL, migrations, or raw SQL.
Initialize ADR/agents/docs infrastructure in a project
Génère le template (template/), le script generate.sh, le vars-example.yaml, et le SKILL.md d'un projet à partir d'un projet source existant. Use when user wants to create a project scaffolding template from an existing project.
Conventions HTTP API de Stéphane Klein — nommage, verbes, codes, pagination, erreurs, versioning, HATEOAS, filtres, embedding, upload, OpenAPI. Utiliser lors de la création, modification ou review d'une API HTTP.
Gère la todo list de Stéphane via la banque mémoire hindsight `todo` et le sous-agent `@todo`. Use when user says: ajoute à ma todo, marque comme fait, liste mes tâches, supprime une tâche, bloque/débloque une tâche, quelles sont mes priorités, importe ça dans ma todo, ou colle un bloc de texte contenant plusieurs tâches.
Guide pour la création de nouveaux skills
استنادا إلى تصنيف SOC المهني
| name | sklein-add-gitleaks |
| description | Ajoute gitleaks (détection de secrets) à un projet existant — hook pre-commit, script pre-push, configuration .gitleaks.toml et intégration Mise. |
Ajoute gitleaks à un projet existant pour détecter les fuites de secrets avant commit et avant push.
Ce skill est activé lorsque l'utilisateur demande d'ajouter gitleaks à un projet, par exemple :
github:mitsuhiko/minijinja), requis pour le rendu des templatesL'agent doit demander à l'utilisateur (use question tool) :
« Dans quel répertoire se trouve le projet cible ? »
TARGET_DIR)« Utilises-tu Jujutsu (jj) pour ce projet ? »
USE_JUJUTSU = true
scripts/setup-jj-alias.sh.jj/ dans .gitleaks.tomlsetup-jj-alias dans .mise.tomlUSE_JUJUTSU = false*« Y a-t-il des chemins supplémentaires à exclure du scan gitleaks ? (ex: certs/, .tfstate) »
| Variable | Requis | Défaut | Description |
|---|---|---|---|
TARGET_DIR | Non | Dossier courant | Répertoire racine du projet cible |
USE_JUJUTSU | Oui | — | true ou false |
EXTRA_ALLOWLIST_PATHS | Non | [] | Liste YAML des chemins supplémentaires à exclure |
GITLEAKS_VERSION | Non | 8.30.1 | Version de gitleaks à utiliser |
Avant d'écrire quoi que ce soit, l'agent doit vérifier si les fichiers suivants existent déjà dans TARGET_DIR :
.gitleaks.tomlgit-hooks/pre-commitscripts/gitleaks-check-push.shscripts/setup-git-hooks.shscripts/setup-jj-alias.sh (si USE_JUJUTSU = true)Si l'un d'eux existe, l'agent doit prévenir l'utilisateur, lister les fichiers concernés, et demander une confirmation explicite avant d'écraser.
Créer un fichier YAML temporaire /tmp/opencode/gitleaks-vars.yaml :
EXTRA_ALLOWLIST_PATHS est une liste YAML. Si l'utilisateur a fourni une chaîne séparée par des espaces, l'agent doit la convertir en liste YAML.
use_jujutsu: {{USE_JUJUTSU}}
extra_allowlist_paths: {{EXTRA_ALLOWLIST_PATHS}}
gitleaks_version: "{{GITLEAKS_VERSION}}"
Exécuter generate.sh :
/home/sklein/.config/opencode/skill/sklein-add-gitleaks/generate.sh \
/home/sklein/.config/opencode/skill/sklein-add-gitleaks/template \
/tmp/opencode/gitleaks-vars.yaml \
"{{TARGET_DIR}}"
Supprimer le fichier temporaire après exécution.
.mise.tomlL'agent doit lire .mise.toml dans TARGET_DIR (s'il existe) et l'éditer intelligemment :
[tools]"aqua:gitleaks/gitleaks" est déjà présent dans une section [tools]"aqua:gitleaks/gitleaks" = "{{GITLEAKS_VERSION}}" dans la section [tools] existanteSi .mise.toml n'existe pas, le créer avec :
[tools]
"aqua:gitleaks/gitleaks" = "{{GITLEAKS_VERSION}}"
Ajouter uniquement les tâches absentes dans le fichier. Pour chaque tâche, vérifier si [tasks.<name>] existe déjà :
| Tâche | Condition | Contenu |
|---|---|---|---|
| setup-git-hooks | Toujours | run = "scripts/setup-git-hooks.sh" |
| setup-jj-alias | Si USE_JUJUTSU = true | run = "scripts/setup-jj-alias.sh" |
| gitleaks-check-push | Toujours | run = "scripts/gitleaks-check-push.sh" |
| gitleaks-scan | Toujours | run = "gitleaks dir --no-banner -v {{config_root}}" (littéral, avec {{config_root}} qui sera résolu par Mise) |
| gitleaks-history-scan | Si USE_JUJUTSU = true | description = "Scan entire jj commit history for secrets with gitleaks"run = "gitleaks git --no-banner -v .git" |
Pour l'insertion, ajouter chaque tâche manquante à la fin du fichier (avant-dernière ligne si un [hooks.enter] existe, sinon tout à la fin).
README.mdL'agent doit lire README.md dans TARGET_DIR (s'il existe).
Chercher les motifs suivants (insensible à la casse) :
Secret detection with gitleaks## Gitleakssecret detectionSi l'un d'eux est trouvé, ne pas modifier README.md (la documentation gitleaks existe déjà).
Si aucune section gitleaks n'existe :
Chercher une section ## Contribution dans le README.md
### Secret detection with gitleaks à la fin de cette section## Contribution avec le sous-titre ### Secret detection with gitleaks à la fin du fichierTexte à insérer (adapter selon USE_JUJUTSU) :
Si USE_JUJUTSU = true :
### Secret detection with gitleaks
[Gitleaks](https://github.com/gitleaks/gitleaks) scans for secrets before they
reach the remote repository. It runs at two points:
- **`git commit`** — the `git-hooks/pre-commit` hook checks staged files.
- **`jj publish`** — local alias that runs `mise run gitleaks-check-push` before
`jj git push`.
Configuration is in `.gitleaks.toml`.
**One-time setup after clone:**
mise install mise run setup-git-hooks mise run setup-jj-alias
**Manual scan** (outside of hooks):
mise run gitleaks-scan # working directory scan
mise run gitleaks-check-push # pre-push scan (called by jj publish)
mise run gitleaks-history-scan # scan entire jj commit history
Si `USE_JUJUTSU = false` :
```markdown
### Secret detection with gitleaks
[Gitleaks](https://github.com/gitleaks/gitleaks) scans for secrets before they
reach the remote repository.
- **`git commit`** — the `git-hooks/pre-commit` hook checks staged files.
Configuration is in `.gitleaks.toml`.
**One-time setup after clone:**
mise install mise run setup-git-hooks
**Manual scan** (outside of hooks):
mise run gitleaks-scan # full project scan mise run gitleaks-check-push # pre-push scan
L'agent doit exécuter les commandes suivantes dans TARGET_DIR :
chmod +x scripts/gitleaks-check-push.sh scripts/setup-git-hooks.sh
Et si USE_JUJUTSU = true :
chmod +x scripts/setup-jj-alias.sh
Puis informer l'utilisateur des prochaines étapes :
Configuration gitleaks ajoutée. Prochaines étapes :
1. mise install # Installe gitleaks (via aqua)
2. mise run setup-git-hooks # Active le hook pre-commit
Si USE_JUJUTSU = true, ajouter :
3. mise run setup-jj-alias # Crée l'alias jj publish
Ce skill a un périmètre strict : ajouter gitleaks au projet et rien d'autre.
Une fois les fichiers créés, .mise.toml et README.md mis à jour, et la confirmation envoyée, l'agent doit s'arrêter sans rien faire d'autre.