Info::Claude:skills

De wiki_pcwiki2
Aller à la navigationAller à la recherche

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-skill dans 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 par TestThemeContrast, menu Thème, dialogues, structure src/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 par Atelier/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 ssh vers 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]. --fix applique les corrections ; --comment poste sur la PR.
  • Exemple : /code-review high avant 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 : /simplify après une grosse session de développement.

security-review

  • Rôle : audit sécurité des changements en attente sur la branche courante.
  • Exemple : /security-review sur 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 : /run aprè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à les CLAUDE.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.sh sous 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épertoire Vx.yy / date du jour / .wiki.
  • Déclenchement : « livre », « commit », « nouvelle version », « bump ».
  • Contenu :
    1. Vérifier que PROJECT_VERSION = nom du répertoire et PC_DATE = date du jour.
    2. Aligner --help, --version et le .wiki.
    3. Lancer pcClaudeMdGenerator --check (exit 1 si divergence).
    4. Créer la version suivante par copie ; ne jamais modifier les anciennes versions ; proposer pcPurgeVersions.
    5. Rappeler de garder les .pc* de build/.
  • Exemple : /pc-release dans pcArpScan/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 libmariadb et libpqxx ; table des différences (AUTO_INCREMENT/SERIAL, ON DUPLICATE KEY UPDATE/ON CONFLICT, guillemets d'identifiants, LIMIT, types de date) ; pièges d'injection ; paquets libmariadb-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, trap sur EXIT/INT/TERM, quoting strict, portabilité POSIX si pertinent, passage par shellcheck, 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, msgmerge pour mettre à jour en.po, détection des chaînes non encadrées par TR(), 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/YesterdayBackup intouchables.
  • Recommandation : garder dans CLAUDE.md et ajouter un hook PreToolUse via update-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 :

  1. Poser une seule question groupée si le nom, la description, la version ou les dépendances manquent (nom en gpc* : invoquer aussi gpc-gui).
  2. Détecter un produit existant : dans ce cas, créer la version suivante par copie, sans toucher aux anciennes versions.
  3. Créer l'arborescence, puis les fichiers à partir des gabarits.
  4. Vérifier compilation, aide, traductions et cohérence version/date.
  5. 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 skill gpc-gui est 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 petit sync.sh comme 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-skills le 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.sh pour gpc-gui).
  • Rappel dans CLAUDE.md : « invoquer SYSTÉMATIQUEMENT le skill X » garantit le déclenchement.
  • Installation multi-machines : étendre --install-skills de pcClaudeMdGenerator.
  • Test : appeler le skill à la main sur un projet réel avant de compter dessus.
  • Sauvegarde : garder un SKILL.md.old avant refonte.

Voir aussi

  • ~/.claude/CLAUDE.md — profil global
  • /home/local/src/Atelier/CLAUDE.md — règles de l'Atelier
  • listPcProgs.catalog.wiki — catalogue des programmes