sklein-devbox-chezmoi

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

Décompose un commit Jujutsu (jj) en plusieurs commits atomiques — enrichis si nécessaire pour la cohérence — par itérations récursives, avec validation humaine avant chaque application.

Script de déploiement par envoi de payload via SSH sans Ansible.

Génération de SQL pour PostgreSQL selon le style "river" et les conventions de Stéphane Klein.

Doctrine de Stéphane pour évaluer les dépendances logicielles. Utiliser cette skill chaque fois qu'il s'agit d'ajouter une librairie, de choisir entre plusieurs candidats, de décider d'écrire soi-même vs dépendre, ou de retirer une dépendance existante. S'applique à tous les langages et écosystèmes.

Convention de nommage des volumes nommés Docker/Podman pour éviter les collisions entre projets et instances via un hash du chemin absolu dans Mise. Utiliser lors de toute création ou audit de projet avec compose.yaml et volumes nommés.

Ajoute gitleaks (détection de secrets) à un projet existant — hook pre-commit, script pre-push, configuration .gitleaks.toml et intégration Mise.

Stéphane préfère les images PostgreSQL basées **Debian** aux images Alpine, sauf contrainte explicite d'un projet dont il n'est pas l'auteur.

Compare plusieurs projets open source d'un même écosystème sur 4 axes : âge, stack technique, popularité (stars GitHub), et modèle économique (community / VC-backed / open core / AGPL). Commence par une phase de découverte multi-sources (GitHub search, awesome lists, HN Algolia, web) pour identifier les projets pertinents, collecte les métriques via un script shell utilisant l'API GitHub, analyse le modèle économique de chaque projet via inspection de la licence, du README, du site web et de Crunchbase, puis produit un tableau comparatif Markdown. Déclencher sur : "compare", "comparer", "choisir entre", "quel projet open source", "écosystème", ou toute demande d'évaluation d'alternatives open source.

Style d'écriture de Stéphane Klein : narration du processus intellectuel. Pour toute rédaction (notes, documentation, messages). Français et anglais.

Analyse si un texte adopte un registre professoral ou non, et identifie les mécanismes précis qui le produisent. Utilise ce skill dès que l'utilisateur demande à évaluer le ton d'un texte, à détecter un style académique ou professoral, à rendre un texte moins formel ou moins distant, ou à vérifier si une écriture "sonne" trop théorique, trop scolaire, ou trop savante. Déclenche aussi si l'utilisateur colle un extrait et demande un retour sur le style, le ton, ou la lisibilité.

Gère le frontmatter de provenance IA (ai_origin, ai_model, date, ai_note, reviewed_at) sur les notes Markdown personnelles (PKM, brouillons, réflexions). À consulter chaque fois qu'un fichier Markdown est généré, complété ou retravaillé à partir d'un thread de conversation avec un agent IA — même sans demande explicite de l'utilisateur — pour déterminer le bon niveau de paternité (human / human-edited / collab / ai-drafted / ai-generated) et tenir le frontmatter à jour au fil des éditions.

Préférences Markdown de Stéphane Klein. Conventions de formatage pour les listes, les tableaux, la structure et la mise en forme.

Créer ou itérer sur un playground (spike / POC) pour apprendre une technologie de fond en comble et lever tous les pièges avant la prod. À utiliser quand l'utilisateur dit "playground", "spike", "POC", "apprendre", "explorer", ou valide une techno pour la prod.

Paradigmes de programmation Node.js de Stéphane Klein. Utiliser lors de l'écriture de code Node.js.

Créer un nouveau projet Node.js basé sur les préférences de Stéphane Klein.

Build a Node.js CLI with yargs following the Cobra/Viper pattern — subcommands, env vars, config files (TOML/YAML) with CLI > env > local config > global config > defaults priority. Use when creating a CLI in Node.js, adding subcommands, or setting up argument/env/config parsing.

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.

Build a throwaway prototype to flesh out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".

Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.

Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.

Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.

Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.

Génère un script generate.sh en shell brut + minijinja (sans framework complexe type Cookiecutter) à partir d'un dossier template contenant des fichiers .jinja, des fichiers statiques et un vars-example.yaml. Use when user wants to create a generate.sh script from a template directory with .jinja files, static files, and vars-example.yaml.

Conventions for writing issues — todo section formatting rules by sklein

Conventions pour la rédaction dans le PKM (Personal Knowledge Management) de Stéphane Klein sur notes.sklein.xyz. Utilise la syntaxe Obsidian.

Conventions pour la création de scripts helper dans des dossiers scripts/

Use when the user asks about OpenCode Go base URL, OpenAI-compatible endpoint, models list, opencode-go models.

Create GitHub issues using gh-issue-sync

Guidelines for proposing git commit messages for Stéphane Klein's projects. English by default, no conventional commit prefixes unless the project explicitly defines them.