Info::Claude:skills
KEYWORDS: CLAUDE CODE, SKILLS, COMPETENCES
Le 15/11/2026: Depuis la version 1.28, pcClaudeMdGenerator inclue deux skills: - gpcgui: skill qui explique comment créer un gpcxxx à partir d'un programme xxx - pc-nouveau-produit: skill qui indique les grandes lignes à la création d'un nouveau projet
Skills Claude Code — inventaire et recommandations
| Élément | Valeur |
|---|---|
| Document | skill.wiki |
| Version | 1.01 |
| Date | 2026-11-15 |
| Auteur | Claude Code (analyse des transcripts ~/.claude/projects)
|
| Périmètre | Sessions Claude Code de l'utilisateur, Atelier /home/local/src/Atelier
|
Fonctionnement
Un skill est un paquet d'instructions chargé à la demande par Claude Code (outil Skill) quand la tâche correspond à sa description.
~/.claude/skills/<nom>/
SKILL.md (frontmatter name + description, puis les consignes)
reference/ (fichiers annexes : code, gabarits, scripts)
Le frontmatter de SKILL.md décide du déclenchement : la ligne description doit dire quand l'utiliser.
- Invocation automatique : Claude l'appelle quand la description correspond.
- Invocation manuelle :
/nom-du-skilldans le prompt (ex./code-review high).
Squelette minimal :
--- name: pc-exemple description: Quand utiliser ce skill (mots-clés précis). --- # Titre Consignes, checklist, pièges.
Skills déjà utilisés
Relevé effectué dans les transcripts (invocations de l'outil Skill).
| Skill | Origine | Invocations | Projets concernés |
|---|---|---|---|
gpc-gui |
Perso (~/.claude/skills/gpc-gui, installé par pcClaudeMdGenerator --install-skills) |
26 | pcSecret (V1.02, V1.03), pcArpScan V1.02, pcClaude V1.06, pcLuks V1.12, pcSysBench V1.02 |
update-config |
Intégré | 3 (une seule demande) | Session dans /root : permission Bash pour ssh vers srv18 (root@192.168.1.18)
|
Commandes slash les plus utilisées (hors skills) : /model (22), /clear (5), /compact (4), /usage (3).
Skills disponibles — détail
Skill personnel
gpc-gui
- Rôle : conventions des programmes graphiques Qt6
gpc*(Graphic Patrick Chevalier). - Contenu : système de thèmes (
ClassThemeManager,ClassThemeColors,ClassThemeDialog), contraste WCAG garanti parTestThemeContrast, menu Thème, dialogues, structuresrc/gui, vérification visuelle par capture. - Déclenchement : tout nom commençant par
gpc, ou tout travail Qt / couleurs / QSS dans l'Atelier. Rendu obligatoire parAtelier/CLAUDE.md. - Maintenance : référence =
pcSecret/V1.02; resynchroniser par~/.claude/skills/gpc-gui/reference/sync.sh. Sauvegarde :SKILL.md.old. - Exemple : « ajoute un thème sombre à gpcCoursDuJaune ».
pc-nouveau-produit (créé le 2026-11-15)
Voir la section pc-nouveau-produit — skill créé plus bas.
Skills intégrés à Claude Code
update-config
- Rôle : modifier
settings.json/settings.local.json(permissions, variables d'environnement, hooks). - Quand : « autorise
sshvers srv18 », « à chaque fois que X, fais Y » (nécessite un hook : seul le harnais l'exécute, une mémoire ne suffit pas). - Exemple :
/update-config autoriser Bash(ssh root@192.168.1.18:*). - Déjà utilisé : oui (permission srv18).
code-review
- Rôle : relire le diff courant (ou une PR / branche) pour détecter les bugs de correction, avec pistes de simplification.
- Syntaxe :
/code-review [low|medium|high|xhigh] [cible] [--fix] [--comment].--fixapplique les corrections ;--commentposte sur la PR. - Exemple :
/code-review highavant de livrer une version. - Intérêt Atelier : relecture des pièges listés dans le profil (UB, fuites, races, injection SQL).
simplify
- Rôle : relire le code modifié (réutilisation, simplification, efficacité) puis appliquer les corrections. Qualité uniquement, ne cherche pas les bugs.
- Exemple :
/simplifyaprès une grosse session de développement.
security-review
- Rôle : audit sécurité des changements en attente sur la branche courante.
- Exemple :
/security-reviewsur pcCrypt, pcSecret, pcPwd, pcProxy, pcLuks, pcsshpass. - Remarque : l'Atelier n'est pas un dépôt git : l'outil fonctionne mieux sur un dépôt (diff disponible).
fewer-permission-prompts
- Rôle : analyser les transcripts, repérer les commandes Bash/MCP en lecture seule très fréquentes et proposer une liste d'autorisations dans
.claude/settings.json. - Exemple :
/fewer-permission-prompts(utile : sessions nombreuses en root).
loop
- Rôle : relancer un prompt ou une commande à intervalle régulier, ou à rythme auto-géré si aucun intervalle n'est donné.
- Syntaxe :
/loop <intervalle> <prompt ou /commande>. - Exemple :
/loop 5m vérifie l'état du build de pcNrgy7. - À éviter : tâche ponctuelle.
run
- Rôle : lancer et piloter l'application du projet pour constater qu'un changement fonctionne vraiment (CLI, serveur, TUI, GUI), avec captures si besoin.
- Exemple :
/runaprès modification d'un programme gpc*.
init
- Rôle : générer un
CLAUDE.mdà partir de l'analyse de la base de code. - Remarque : redondant avec
pcClaudeMdGenerator, qui produit déjà lesCLAUDE.md/AGENTS.md.
claude-api
- Rôle : référence de l'API Anthropic / SDK (identifiants de modèles, tarifs, streaming, tool use, caching, migration de modèle).
- Quand : tout produit qui appelle Claude (pcClaude, pcRagCount…) ou question sur les modèles et limites.
dataviz
- Rôle : charte de visualisation de données (choix de graphique, palettes accessibles clair/sombre, tuiles KPI, infobulles, légendes).
- Quand : tout graphique ou tableau de bord (courbes pcNrgy, production solaire, TRADING, météo…).
artifact-design et artifact-diagramming
- Rôle : conception de pages publiées (Artifacts) et de schémas SVG lisibles en thème clair et sombre.
- Quand : publication d'une page HTML partageable (ex. rapport, schéma d'architecture).
workflow-authoring
- Rôle : référence pour écrire un script de workflow multi-agents (API, reprise, motifs de qualité).
- Remarque : ne s'utilise que si vous demandez explicitement une orchestration multi-agents.
keybindings-help
- Rôle : personnaliser les raccourcis clavier (
~/.claude/keybindings.json), touches enchaînées comprises. - Exemple : « change la touche d'envoi du prompt ».
plugin-authoring
- Rôle : créer un « mod » de l'interface de Claude Code (thème, panneau, ligne d'état, commande slash, hook sur les appels d'outils).
- Exemple : adapter
statusline-command.shsous forme de mod.
Skills à créer — détail
Principe : un skill est rentable quand une consigne est répétée à chaque projet ou quand un oubli coûte cher. Ce qui est court et universel reste dans CLAUDE.md.
| Skill proposé | Priorité | Statut | Remplace / complète |
|---|---|---|---|
| pc-nouveau-produit | 1 | Créé | modele, pcGenModele, règles du profil
|
| pc-release | 1 | À créer | pcClaudeMdGenerator --check, pcPurgeVersions
|
| pc-doc-wiki | 1 | À créer | règle « un .wiki par programme » |
| pc-sql | 2 | À créer | pcLibSql, pcCrudGen
|
| pc-energie | 2 | À créer | section énergie d'Atelier/CLAUDE.md
|
| pc-bash | 2 | À créer | règles Bash du profil |
| pc-i18n | 2 | À créer | règle .po FR/UK (partiellement couvert par pc-nouveau-produit) |
| pc-deploy-srv | 3 | À créer | pcDeploy, pcMakePaquetDeb
|
| pc-revue-pieges | 3 | À créer | /code-review
|
| pc-atelier-garde-fous | 3 | Hook conseillé | lecture seule des versions figées |
Priorité 1
pc-release
- Problème résolu : oublis de synchronisation
PROJECT_VERSION/ répertoireVx.yy/ date du jour /.wiki. - Déclenchement : « livre », « commit », « nouvelle version », « bump ».
- Contenu :
- Vérifier que
PROJECT_VERSION= nom du répertoire etPC_DATE= date du jour. - Aligner
--help,--versionet le.wiki. - Lancer
pcClaudeMdGenerator --check(exit 1 si divergence). - Créer la version suivante par copie ; ne jamais modifier les anciennes versions ; proposer
pcPurgeVersions. - Rappeler de garder les
.pc*debuild/.
- Vérifier que
- Exemple :
/pc-releasedanspcArpScan/V1.02.
pc-doc-wiki
- Problème résolu : documentation MediaWiki incohérente d'un produit à l'autre.
- Déclenchement : « documente », « .wiki », « mets à jour la doc ».
- Contenu : gabarit (tableau version/date, Fonctionnement, Syntaxe, Options avec un exemple chacune, Compilation, Voir aussi), règles de rédaction, lien avec
listPcProgs.catalog.wiki, conseil de dériver la table des options de--help. - Exemple :
/pc-doc-wiki pcGetRadios.
Priorité 2
pc-sql
- Problème résolu : requêtes préparées et transactions à répéter, différences MariaDB / PostgreSQL à signaler à chaque fois.
- Contenu : gabarits RAII
libmariadbetlibpqxx; table des différences (AUTO_INCREMENT/SERIAL,ON DUPLICATE KEY UPDATE/ON CONFLICT, guillemets d'identifiants,LIMIT, types de date) ; pièges d'injection ; paquetslibmariadb-dev,libpqxx-dev. - Exemple :
/pc-sql ajouter une table hosts avec upsert.
pc-energie
- Problème résolu : contraintes physiques et algorithmiques des produits pcNrgy / pcSolar / pcShelly oubliées hors contexte.
- Contenu : irradiation ≥ 0, ensoleillement ≤ 3600 s/h, robustesse au bruit, anti-yo-yo (inertie, hystérésis), formats EM340 et MQTT Shelly, Open-Meteo, tests de cohérence.
- Déclenchement : tout produit dont le nom commence par pcNrgy, pcSolar, pcShelly ou
solarRouter.
pc-bash
- Problème résolu : scripts shell non robustes.
- Contenu : en-tête
set -euo pipefail,trapsur EXIT/INT/TERM, quoting strict, portabilité POSIX si pertinent, passage parshellcheck, règle des 80 caractères (commande longue = fichier script). - Exemple :
/pc-bash script de sauvegarde avec nettoyage sur signal.
pc-i18n
- Problème résolu : traductions FR/UK incomplètes.
- Contenu :
make pot,msgmergepour mettre à jouren.po, détection des chaînes non encadrées parTR(), cas Qt (QTR). - Remarque : à fusionner avec pc-nouveau-produit si le besoin reste léger.
Priorité 3
pc-deploy-srv
- Contenu : procédure de déploiement vers srv18 et autres hôtes (ssh, copie, systemd), vérifications avant écriture distante, retour arrière, paquets
.deb(pcMakePaquetDeb). - Prudence : ne jamais stocker de mots de passe ni de clés dans le skill.
pc-revue-pieges
- Contenu : checklist de relecture C++17 (RAII,
const, exceptions, absence d'API obsolète ou inventée, races, UB), à enchaîner avec/code-review.
pc-atelier-garde-fous
- Constat : « versions figées en lecture seule »,
*.discontinued,TodayBackup/YesterdayBackupintouchables. - Recommandation : garder dans
CLAUDE.mdet ajouter un hookPreToolUseviaupdate-config: seul un hook interdit réellement.
pc-nouveau-produit — skill créé
| Élément | Valeur |
|---|---|
| Version | 1.00 |
| Date | 2026-11-15 |
| Emplacement | ~/.claude/skills/pc-nouveau-produit/
|
| Modèle suivi | /home/local/src/Atelier/pcArpScan/V1.02 (CMake, i18n gettext, Version.h, .wiki)
|
Fonctionnement
Le skill guide Claude pour créer un produit complet et conforme au profil utilisateur :
- Poser une seule question groupée si le nom, la description, la version ou les dépendances manquent (nom en
gpc*: invoquer aussigpc-gui). - Détecter un produit existant : dans ce cas, créer la version suivante par copie, sans toucher aux anciennes versions.
- Créer l'arborescence, puis les fichiers à partir des gabarits.
- Vérifier compilation, aide, traductions et cohérence version/date.
- Rendre compte : commandes de build, paquets Debian, pièges.
Arborescence produite
/home/local/src/Atelier/<Produit>/Vx.yy/ ├── CMakeLists.txt ├── <Produit>.wiki ├── src/ main.cpp, ClassI18n.cpp, Class<Nom>.cpp ├── includes/ ClassI18n.h, Version.h.in, Class<Nom>.h ├── po/ <Produit>.pot, en.po ├── tests/ └── build/ (fichiers .pc* préservés)
Fichiers du skill
| Fichier | Rôle |
|---|---|
SKILL.md |
Procédure, règles de code, vérifications, compte rendu |
reference/CMakeLists.txt.tpl |
C++17, PROJECT_VERSION, PC_DATE, gettext (make pot, .mo), pcShowDir à la première compilation
|
reference/main.cpp.tpl |
UK, exceptions |
reference/ClassI18n.h, ClassI18n.cpp |
Copie de pcArpScan : macro TR(), I18n::init
|
reference/Version.h.in |
Génère PC_PROGRAM_VERSION et PC_PROGRAM_DATE
|
reference/produit.wiki.tpl |
Gabarit de documentation MediaWiki |
Placeholders des gabarits : @PRODUIT@, @VERSION@, @DATE@, @DESCRIPTION@.
Syntaxe d'utilisation
/pc-nouveau-produit <NomProduit> [description]
Ou, en langage naturel : « crée un nouveau programme pcTruc qui … ».
Exemples
- Création :
/pc-nouveau-produit pcTruc surveille la température du salon→Atelier/pcTruc/V1.01/complet. - Nouvelle version : « fais pcArpScan V1.03 » → copie de V1.02 en V1.03 avec version et date mises à jour.
- Graphique :
/pc-nouveau-produit gpcTruc …→ le skillgpc-guiest chargé en plus.
Vérifications intégrées
cd build && cmake .. && make ./pcTruc --help ./pcTruc --language UK --help make pot pcClaudeMdGenerator --check
Paquets Debian
apt install g++ cmake libboost-program-options-dev gettext
Plus les dépendances du produit (libmariadb-dev, libpqxx-dev, nlohmann-json3-dev, libeigen3-dev, qt6-base-dev).
Limites et évolutions
- Les gabarits sont copiés de pcArpScan V1.02 : si cette référence évolue, recopier les fichiers dans
reference/(idée : un petitsync.shcomme pour gpc-gui). - Le skill ne crée pas encore l'accès SQL : prévoir de l'appeler avec le futur
pc-sql. - À ajouter dans
pcClaudeMdGenerator/V1.28/skills/pour que--install-skillsle déploie sur hal et la machine cible.
Bonnes pratiques de création
- Description précise : mots-clés et chemins déclencheurs (voir
gpc-gui). - SKILL.md court, détails dans
reference/. - Source de vérité unique (comme
sync.shpour gpc-gui). - Rappel dans CLAUDE.md : « invoquer SYSTÉMATIQUEMENT le skill X » garantit le déclenchement.
- Installation multi-machines : étendre
--install-skillsdepcClaudeMdGenerator. - Test : appeler le skill à la main sur un projet réel avant de compter dessus.
- Sauvegarde : garder un
SKILL.md.oldavant refonte.
Voir aussi
~/.claude/CLAUDE.md— profil global/home/local/src/Atelier/CLAUDE.md— règles de l'AtelierlistPcProgs.catalog.wiki— catalogue des programmes