de scienceclaw43
Auditer et corriger la documentation pour les projets basés sur ToolUniverse : supprimer le contenu obsolète ou redondant, corriger les codes et liens brisés, et simplifier la documentation pour maintenir
Cette compétence fournit un flux de travail d'audit de documentation structuré et répétable pour les projets ToolUniverse. Elle exécute un processus en cinq phases (D : scan de méthode statique, E : scan de simplification, C : exécution de code en direct, A : validation automatisée, B : audit ToolUniverse) pour localiser les exemples de code incorrects, les liens brisés, les décomptes d'outils incohérents, le contenu dupliqué et d'autres problèmes de maintenance. Le résultat est actionnable : modifier ou supprimer les blocs de code problématiques, imposer des instructions de configuration à source unique, et appliquer des limites strictes de taille et de style pour rendre la documentation plus facile à maintenir et moins sujette aux erreurs.
Utilisez cette compétence avant les releases, après des changements d'API ou d'outils, lors de sprints de nettoyage de la documentation, ou lorsque vous soupçonnez des inexactitudes dans les guides destinés aux utilisateurs. Elle est particulièrement précieuse lorsque plusieurs auteurs contribuent à la documentation ou lorsque des changements d'outils automatisés ont pu invalider des exemples.
Les agents pouvant exécuter des vérifications de doc basées sur Python (type Copilot, Claude Code, exécuteurs Cursor/Codex) et les agents avec un accès repo/fichier pour patcher la documentation sont bien adaptés.
Compétence d'assurance qualité de la documentation pour le projet ToolUniverse. Aucun script intégré à exécuter — toute la logique est sous forme de heredocs Python inline dans le SKILL.md. La stratégie d'audit en cinq phases (D/E/C/A/B) est bien conçue avec des vérifications spécifiques pour les noms de méthodes erronés, les emojis, les liens brisés et la validation des blocs de code. Portée étroitement limitée au projet ScienceClaw/ToolUniverse et ne serait pas transférable à d'autres projets sans une refonte importante.
Compétence bien écrite avec une structure de phase claire et des règles de validation spécifiques. La principale limitation est la spécificité au projet — c'est essentiellement un outil de linting/audit pour la documentation d'un seul projet. Les scripts heredoc inline sont fonctionnels mais gagneraient à être dans des fichiers de script séparés. Aucune préoccupation de sécurité — toutes les opérations sont des analyses en lecture seule.
