skillweave-repo-health

facade	true
experimental	true
name	skillweave-repo-health
description	Assess repository health, classify files, detect duplicates, and produce safe cleanup plans.
argument-hint	command="[scan|report|classify|archive|duplicates|cleanup|manifest]" path="[path]"

/skillweave-repo-health

Canonical metadata is English. User-facing artifacts follow the output language setting.

Repo Assessment & Cleanup — Inventory-Scan, 5-Class-Klassifikation, Duplikatserkennung, Archivierung, Hygiene-Report.

5-Class-Klassifikation

Klasse	Bedeutung
Active Core	Aktiv genutzte Kern-Dateien (src/, tests/, config)
Consolidation	.gitkeep, readme, Doku — kann zusammengelegt werden
Legacy	Alte Build-Artefakte, Backup-Dateien, migrations/
Deprecated	pycache, .DS_Store, node_modules (sollte in .gitignore)
Needs Review	Nicht klassifizierbar — menschliche Prüfung nötig

Commands

Command	Beschreibung
scan	Inventory erstellen (alle Dateien + Metadaten)
classify	5-Category Klassifikation auf Inventory
duplicates	Duplikate via MD5/Fuzzy finden
archive	Pfade nach archive/ verschieben
restore	Aus Manifest restaurieren
cleanup	Trocken (default) oder echt ausführen
report	Hygiene-Score A–F + Empfehlungen

Safety

• dry_run=true ist Default — keine Änderungen ohne Genehmigung
• cleanup erfordert explizite --apply Flag
• archive erstellt immer ein manifest.json für Restore
• 3-Sekunden-Regel: Vor Cleanup wird gewartet + Zusammenfassung angezeigt

Testing

1. scan + classify — Inventory korrekt, Klassifikation plausibel
2. duplicates — MD5-Exact-Treffer, Fuzzy-Ähnlichkeit
3. archive + restore — Roundtrip (Datei→archiv→zurück)
4. report — Score-Berechnung A–F, alle 5 Klassen repräsentiert

Usage

Invoke the skill by its name with a command and path argument. The skill is host-neutral; no executable prefix is required — route it through any host on any supported transport (Markdown or MCP).

skillweave-repo-health command="scan" path="./src"
skillweave-repo-health command="classify" path="."
skillweave-repo-health command="report" path="."

# Dry-run cleanup (default)
skillweave-repo-health command="cleanup" path="."

# Archive duplicates
skillweave-repo-health command="duplicates" path="."
skillweave-repo-health command="archive" path="."

# Restore from manifest
skillweave-repo-health command="restore" path="./archive"

Host-specific invocation examples (non-binding adapters) live in references/adapters/.