Skip to content

Repository files navigation

ClaudePlugins

Garde-fou Skills Licence

Des skills Claude Code qui portent une méthode — auditer, tester, publier, documenter, mettre en page — et lisent les spécificités de chaque dépôt dans un fichier de notes. Une leçon apprise dans un projet profite à tous les autres, sans recopier la procédure nulle part.

Marketplace dev-tools, un plugin, 13 skills. Repo public, aucune authentification requise.

flowchart LR
  subgraph repo["Dépôt ClaudePlugins — marketplace <code>dev-tools</code>"]
    direction TB
    U["<b>claude-utils</b><br/>13 skills · le processus et le produit"]
  end
  repo -->|"claude plugin install"| P["<b>Ton poste</b><br/>skills disponibles<br/>dans tous les projets"]
  P --> A["Projet A<br/><code>.claude/deploy-notes.md</code>"]
  P --> B["Projet B<br/><code>.claude/uxui-notes.md</code>"]
  P --> C["Projet C<br/><i>aucune note</i>"]
Loading

La skill porte la méthode, le projet déclare ses spécificités. C'est ce qui permet à /deploy de servir un dépôt qu'elle n'a jamais vu — et de s'arrêter plutôt que d'inventer une commande quand le dépôt n'a rien déclaré.

🚀 Installer

claude plugin marketplace add vynarim/ClaudePlugins
claude plugin install claude-utils@dev-tools

Puis recharger la fenêtre VS Code (Developer: Reload Window) — les plugins sont chargés à l'ouverture. Détails, vérification et dépannage : INSTALL.md.

Important

Scope user ou scope project, pas les deux. Si tu as lancé les commandes ci-dessus (scope poste), déclarer en plus le plugin dans le .claude/settings.json d'un projet crée une seconde installation et le fait apparaître en double dans /plugin. Le gabarit examples/project.claude-settings.json sert aux dépôts partagés, où il propose l'install à ceux qui ne l'ont pas — voir DEPLOYMENT.md.

Note

Les plugins de ce repo n'exécutent aucun code : ni hook, ni serveur MCP, ni variable d'environnement. Ils n'apportent que des skills.

🧩 Le plugin

Un seul plugin, sur deux axes. Les skills du produit portent le préfixe ui- : c'est lui qui les groupe dans le sélecteur / et dit leur axe.

Plugin Version Axes Questions auxquelles il répond
claude-utils 3.1.0 le processus de développement (11 skills) · le produit affiché à l'utilisateur (2 skills ui-) « comment je travaille sur ce dépôt ? » · « à quoi ressemble l'application ? »

Note

metadata.version de la marketplace est la version du catalogue, pas celle du plugin. Le plugin porte la sienne, dans son plugin.json et dans la colonne ci-dessus.

claude-utils — 13 skills

Famille Skills Ce que ça règle
Contexte & session eco · reprise Rester sous les limites (et condenser le CLAUDE.md via /eco claude-md), savoir où on en est, laisser une trace relue au démarrage suivant
Revue & non-régression audit · test · garde-fou Revue par axes avec journal à ids stables, batterie locale, et son pendant distant à la poussée
Livraison ship · deploy Commit/push avec messages écrits en valeur apportée, mise en production cible par cible
Documentation doc Réaligner le README sur le dépôt — axe fond et axe forme
Cohérence & maintenance kit-sync · perms · update-plugins Aligner deux projets frères, nettoyer les permissions, appliquer les nouvelles versions
Interface ui-charte · ui-frame Charte visuelle guidée (valeurs de départ ou relevé du code), cadre téléphone sur écran large — l'axe produit, préfixe ui-
Le détail des 13 skills
Skill Invocation Rôle
eco /eco Discipline tokens/contexte — une session = un objectif, /clear aux bascules, délégation aux sous-agents
audit /audit Revue de code par axes (sécurité, données, métier, perf, propreté, config) : demande l'axe, classe par gravité, déclare sa couverture et tient un journal ; /audit regression rejoue les correctifs passés
test /test Batterie de non-régression : tableau ✅/❌ par étape, et ce que la batterie n'a pas éprouvé. Ne committe rien, ne touche jamais la prod
garde-fou /garde-fou Garde-fou distant, pendant de /test : un workflow GitHub Actions qui rejoue la batterie à la poussée. N'écrit une étape que si son script existe réellement
doc /doc Réaligne le README sur le dépôt, en deux axes : fond (écarts classés périmé / absent / inventé) et forme (/doc forme : ordre de lecture, aération, mermaid, encarts)
kit-sync /kit-sync Compare un socle partagé entre projets frères : divergence classée progrès / adaptation légitime / dérive, propagation proposée jamais appliquée en silence
perms /perms Ménage des listes de permissions : entrées ombrées par un motif plus large, entrées périmées, gestes destructeurs en allow proposés en ask — jamais en deny
ship /ship Commit + push : découpe par apport, message qui dit la valeur gagnée et son axe (sécurité, données, perf…) plutôt que le geste technique ; bumpe la version si les notes du projet le demandent
deploy /deploy Mise en production : bump, vérifications, envoi via ship, déploiement cible par cible, vérification en ligne
reprise /reprise Les deux bouts de la boucle d'une session : au démarrage elle lit où en est le projet (git réel, PRs, fichier d'état) et propose une action ; à l'arrêt elle écrit la trace — état courant, trois points de reprise, dettes et fausses pistes — dans le fichier que le projet utilise déjà
update-plugins /update-plugins Met à jour les plugins d'une marketplace sur le poste, scope par scope — un plugin peut être installé plusieurs fois, et la CLI ne sait pas viser une installation projet
ui-charte /ui-charte Un guide, pas un portier. Sur un projet neuf, elle propose des échelles et une palette de rôles neutres, marquées comme remplaçables : le but n'est pas que deux applications se ressemblent, c'est qu'un projet neuf ait où ranger ses premiers écrans. Sur un dépôt qui a déjà du style, elle relève les littéraux et dérive les paliers des valeurs dominantes plutôt que d'imposer une échelle théorique. Elle ne bloque que sur cinq points — plancher de 16 px sur les champs, cible tactile, contraste, mouvement réduit, zone sûre — et propose tout le reste, garde-fous compris.
ui-frame /ui-frame Affiche une application mobile-only dans un cadre téléphone centré sur écran large : ratio portrait conservé, fond neutre autour, rien de changé sous le seuil. Traite les cinq échappées qui font rater un cadre posé à la main — scroll sur le mauvais conteneur, position: fixed qui dérive, portail hors cadre, vh calculé contre la vraie fenêtre, breakpoint JS qui lit la largeur de l'écran. S'arrête si le projet est responsive.

Méthode complète et mécanique des notes : claude-utils/README.md · Prise en main depuis un poste neuf : claude-utils/QUICKSTART.md.

Warning

Une consigne de mise en page appliquée au mauvais projet ne dégrade pas le résultat : elle casse la page. Les deux skills ui- établissent d'abord le profil du dépôt (mobile-only · mobile-first · responsive · desktop) et s'arrêtent s'il ne correspond pas, au lieu de basculer en mode dégradé.

📓 Les notes projet

Le mécanisme central du catalogue. Une skill ne devine jamais les spécificités d'un dépôt : elle les lit dans .claude/<nom>-notes.md, versionné avec le projet.

Skill Fichier Sans lui
deploy .claude/deploy-notes.md la skill s'arrête — une commande de déploiement inventée ne se rattrape pas
audit .claude/audit-notes.md tourne quand même, elle connaît juste moins le terrain
test .claude/test-notes.md tourne quand même, en déduisant les étapes de package.json
doc .claude/doc-notes.md tourne quand même, en reconstituant la carte à chaque passage
kit-sync .claude/kit-notes.md demande une fois le projet frère et le chemin du socle, puis tourne
perms .claude/perms-notes.md re-propose à chaque passage les entrées qu'on a décidé de garder
ui-frame .claude/uxui-notes.md détecte le profil et demande confirmation à chaque passage
ui-charte .claude/uxui-notes.md relève et propose, mais ne tranche aucune exception seule

garde-fou n'a pas de notes propres, et c'est voulu : elle lit celles de test et de deploy. Une skill qui réclame ses propres notes pour redire ce qui est écrit à côté fabrique la divergence.

Deux skills tiennent en plus un journal, écrit sans demander parce que c'est un fichier d'arbitrage et non du code : .claude/audit-log.md et .claude/kit-log.md.

📚 Documentation

Document Pour quoi
Tutoriel HTML Prise en main Claude Code + VS Code en ~1 h : d'un site à une PWA, déploiement Firebase, et consommation de tokens
INSTALL.md Installer, vérifier, mettre à jour, dépanner
DEPLOYMENT.md Ajouter un plugin ou une skill, publier une version, activer dans un projet
claude-utils/README.md Le détail du plugin : chaque skill, la mécanique des notes, la migration d'une skill locale
Structure du repo
Chemin Rôle
.claude-plugin/marketplace.json Catalogue dev-tools — déclare les plugins publiés
<plugin>/.claude-plugin/plugin.json Manifeste d'un plugin (version à bumper pour publier)
<plugin>/skills/<nom>/SKILL.md Une skill (dossier skills/ auto-découvert)
<plugin>/skills/<nom>/references/ Annexes d'une skill : gabarits de notes projet, checklists d'axes
examples/ Gabarit de .claude/settings.json à copier dans un projet
docs/ Source du tutoriel publié sur GitHub Pages
.claude/skills/ Skills internes au repo (skill-new, plugin-check), jamais publiées
.github/workflows/garde-fou.yml Rejoue à la poussée les contrôles de cohérence du catalogue

🔄 Mettre à jour

claude plugin marketplace update dev-tools   # rafraîchit le catalogue
claude plugin update claude-utils@dev-tools  # applique la nouvelle version

Avec claude-utils installé, /update-plugins enchaîne les deux, scope par scope.

Warning

marketplace update ne suffit pas : il rafraîchit le catalogue, pas les plugins installés. C'est claude plugin update qui applique le bump. Un plugin nouveau demande un install, que update ne fera jamais à ta place.

Pour que les versions arrivent seules, ajouter "autoUpdate": true à l'entrée dev-tools de ~/.claude/settings.json — l'option n'est pas exposée par le CLI, voir INSTALL.md.


MIT — voir LICENSE.

About

Marketplace de plugins Claude Code : des skills qui portent la méthode (audit, tests, publication, doc, UI) et lisent les spécificités de chaque dépôt dans un fichier de notes.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages