nicolas-codemate/audit-project
skills/audit-project/SKILL.md
Audits a project's Claude Code setup against real usage — mines the project's conversations (worktrees included), confronts the project's skills/agents/CLAUDE.md with best practices, and proposes adjustments or new skills/agents/rules. Use when the user asks to audit the project config, analyze project conversations, or find automation opportunities for the current project. Do NOT use for the global ~/.claude configuration (use /audit-config instead).
tools
Updated Jul 7, 2026
$ install --global
skillsauthnpx skillsauth add nicolas-codemate/claudecodeconfig audit-projectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 7, 2026, 7:00 AM364.9s2 files scanned
SKILL.md
- name:
- audit-project
- description:
- Audits a project's Claude Code setup against real usage — mines the project's conversations (worktrees included), confronts the project's skills/agents/CLAUDE.md with best practices, and proposes adjustments or new skills/agents/rules. Use when the user asks to audit the project config, analyze project conversations, or find automation opportunities for the current project. Do NOT use for the global ~/.claude configuration (use /audit-config instead).
- argument-hint:
- [--since YYYY-MM-DD | défaut: 30 jours]
- disable-model-invocation:
- true
Audit Project
Rejoue à l'échelle d'un projet la démarche : bonnes pratiques + config réelle + conversations réelles → propositions arbitrées avec l'utilisateur.
Step 1: Résoudre le périmètre du projet
- Racine =
git rev-parse --show-topleveldepuis le cwd. - Worktrees :
git worktree list --porcelain | grep '^worktree ' | cut -d' ' -f2— chaque worktree a son propre répertoire de transcripts mais appartient au même projet. Toujours inclure la liste complète. SINCE= argument--since, sinondate -d '30 days ago' +%F.
Step 2: Extraire les digests de conversations
bash ${CLAUDE_SKILL_DIR}/scripts/extract-sessions.sh <scratchpad>/digests "$SINCE" <worktree-path>...
Produit un fichier par répertoire de transcripts : en-tête par session (start, models, cmds) + messages utilisateur tronqués à 400 chars. Si le total dépasse ~1 Mo, ne pas lire les digests dans le thread principal — les agents du Step 4 s'en chargent.
Step 3: Stats agrégées (inline, avant les agents)
grep -h "^### " <digests>/*.txt | grep -o "models=[^|]*" | tr ',' '\n' | sed 's/models=//;s/ *$//' | sort | uniq -c | sort -rn
grep -h "^### " <digests>/*.txt | grep -o "cmds=[^|]*" | sed 's/cmds=//' | tr ',' '\n' | sed 's/ *$//;/^$/d' | sort | uniq -c | sort -rn
Repérer : commandes/skills projet jamais invoquées, volume batch vs interactif, modèles utilisés. Caveat à garder pour le rapport : seules les commandes tapées sont capturées — une skill auto-invoquée par le modèle n'apparaît pas, les zéros sont des bornes basses.
Step 4: Analyses parallèles (2 agents en background)
Lancer en un seul message :
Agent A — frictions (general-purpose) : lit tous les digests et catégorise (1) corrections répétées → candidates règle CLAUDE.md/hook, (2) instructions récurrentes → candidates skill/commande/MCP, (3) frustrations et leurs causes, (4) workflows manuels répétitifs → automatisables. Exiger : verbatims courts, fréquence estimée, recommandation concrète par friction, classement par fréquence. Ne rapporter que ce qui apparaît plusieurs fois.
Agent B — config projet vs best practices (Explore) : audite .claude/ du projet (skills, agents, settings.local.json, ticket-config.json) et le CLAUDE.md/AGENTS.md projet contre ~/.claude/docs/claude-cookbook-best-practices.md. Vérifie : formule de description, frontmatter sous-exploité, règles advisory convertibles en hooks/permissions, taille et fraîcheur du CLAUDE.md (règles obsolètes vs code actuel). Respecter les marqueurs <!-- audit:keep-as-is --> et <!-- audit:keep-model-invocation -->.
Step 5: Synthèse et arbitrage
- Croiser A + B + stats : chaque proposition = Constat (avec fréquence/verbatim), Recommandation, Impact (low/medium/high), Effort (trivial/minor/moderate). Inclure les créations (nouvelle skill projet, outil MCP, règle CLAUDE.md, agent) et les suppressions/archivages (config morte).
- Présenter le rapport classé par ratio impact/effort, puis arbitrer avec AskUserQuestion (multiSelect) avant d'appliquer quoi que ce soit.
- Appliquer uniquement les éléments validés, dans le projet (
.claude/, CLAUDE.md — attention aux symlinks type CLAUDE.md → AGENTS.md : écrire dans la cible réelle). Ne pas committer.
Contraintes
- Ne lire que les conversations du projet résolu au Step 1 — jamais celles des autres projets.
- Pas de proposition purement cosmétique ; chaque item doit être ancré dans une friction observée ou un écart aux best practices.
- Si
.claude/n'existe pas dans le projet, le rapport le dit et propose seulement des règles CLAUDE.md + skills à créer.
Related Skills
nicolas-codemate/perf-landing
development
VerifiedTrustedCommunity
Method to diagnose and raise the Lighthouse performance score of a public page (landing, marketing, home). Use when asked to improve Lighthouse/PageSpeed scores, when auditing the first uncached paint of a public page, or when a landing embedded in a SPA must reach a top score. Do NOT use for in-app screen performance (data loading, rendering). For a brand-new landing, the first recommendation is static HTML with no framework runtime — most of this skill exists for when that is not an option.
SKILL.mdUpdated Jul 26, 2026
nicolas-codemate/mentor
development
VerifiedTrustedCommunity
Coaching workflow orchestrator. Guides the developer through implementation without writing code.
SKILL.mdUpdated Jul 7, 2026
nicolas-codemate/architect-refactor
development
VerifiedTrustedCommunity
Disciplined methodology for code architecture refactoring. Use when the user asks to refactor architecture, decouple code, restructure a family of classes, redesign an interface, or rename/reorganize a set of related components. Forces a big-picture analysis before any code is written. Do NOT use for simple bug fixes, feature additions, or single-file refactoring.
SKILL.mdUpdated Jul 7, 2026
nicolas-codemate/aep
development
VerifiedTrustedCommunity
Analyse-Explore-Plan methodology for thorough analysis and planning before development. Use when starting a new feature, investigating a problem, or needing to understand a codebase before making changes. Provides structured workflow with parallel exploration agents and clarification questions. Integrates with Architect skill for high-quality implementation plans. Do NOT use for ticket-based planning (use /resolve <ticket> --plan-only instead) or when a saved plan is needed (use /create-plan instead).
SKILL.mdUpdated Jul 7, 2026