Principe de fonctionnement

SlideOps se présente comme une paire d'Agent Skills compatible avec Claude Code et d’autres agents de génération de code. Le principe central est de traiter la documentation comme un artefact de build : chaque diapositive est générée à partir d’un fichier source et le lien entre le fragment affiché et son origine est enregistré. Dès la création, le système scanne le dépôt, propose un sujet, un public, une longueur et un thème, puis produit un outline à valider avant d’écrire le HTML ou le Markdown.

./install.sh
npx skills add glukicov/slideops
/plugin install slideops@slideops

Mécanismes de détection et de réparation

Le cœur de la vérification réside dans le script scripts/check.py, écrit uniquement avec la bibliothèque standard Python. En quelques millisecondes, il parcourt le répertoire wholedocs/slides/, identifie chaque commentaire de citation du type , calcule le hash SHA‑256 du fragment source et le compare au hash stocké. Si le code a changé, le script signale la diapositive concernée et génère un brief JSON que l’agent peut consommer pour régénérer uniquement les sections dérivées, préservant ainsi le rythme narratif initial.

Cette approche élimine tout besoin de modèle externe, de connexion réseau ou de consommation de tokens, ce qui garantit une exécution hors‑ligne fiable et rapide.

Installation et intégration

SlideOps s’installe via trois méthodes : ajout au marketplace interne (/plugin marketplace add glukicov/slideops), installation directe du plugin (/plugin install slideops@slideops) ou clonage du dépôt Git suivi de ./install.sh. Une fois installé, les quatre agents lisent le même fichier SKILL.md, évitant toute duplication de logique. Le système supporte la génération de présentations HTML et de documents Markdown depuis la version v1.1.0, ce dernier incluant les citations invisibles et le commit de build en première ligne.

Limites et perspectives

Le modèle repose sur la présence explicite de commentaires de citation ; toute omission empêche la détection de dérive. De plus, la vérification de PDF repose sur une comparaison d’images rendues, ce qui ne détecte pas les erreurs de contenu non visibles à l’image. Enfin, la mise à jour automatique des marketplaces est désactivée par défaut, nécessitant une activation manuelle ou une exécution périodique de /plugin marketplace update slideops. Malgré ces contraintes, SlideOps propose une chaîne de documentation entièrement automatisée, où chaque diapositive possède une traçabilité cryptographique et une capacité de réparation ciblée, réduisant ainsi le coût de maintenance des présentations techniques.