fix: kaputte YAML-Frontmatter in 48 Skills reparieren

Welle 23 (ASCII-Quote-Sweep) hatte unescapte Anführungszeichen in
SKILL.md-description-Strings hinterlassen — Claude Code lädt diese
Skills mit leerer Metadata, plugin validate --strict bricht.

- 47 Skills: description in single-quoted YAML umwandeln (sicher gegen ")
- grosskanzlei-corporate-ma: ungültiges \&-Escape zu & korrigieren
- nachbarschaftsstreit-pruefer: nutzloses Plugin-Root-CLAUDE.md entfernt
  (wird laut Spec ohnehin nicht geladen)
- 2 README-Plugin-Download-Blöcke ergänzt (bgb-at-pruefer, dsa-dma-digitalregulierung)

Neue Validatoren in scripts/:
- validate-with-claude-cli.sh: ruft offizielles 'claude plugin validate --strict' auf
- validate-yaml-frontmatter.py: echter YAML-Parse-Check (fängt unescapte Quotes,
  ungültige Escapes, Plugin-Root-CLAUDE.md, Komma-Zahl-Sequenzen)

Beide Validatoren laufen jetzt grün über alle 102 Plugins.

Workflow-Empfehlung vor Push:
  python3 scripts/validate-yaml-frontmatter.py
  ./scripts/validate-with-claude-cli.sh
  node scripts/validate-plugin-structure.mjs
This commit is contained in:
Klotzkette
2026-05-28 16:48:03 +00:00
parent a9f647d96e
commit c6d6b502d5
53 changed files with 316 additions and 62 deletions
+77
View File
@@ -0,0 +1,77 @@
#!/usr/bin/env bash
# Schaerfere Validierung mit der offiziellen Claude Code CLI.
# Faengt genau das ab, was der User-Client beim "Install from .zip" prueft.
#
# Voraussetzung:
# npm install -g @anthropic-ai/claude-code
#
# Aufruf:
# ./scripts/validate-with-claude-cli.sh # alle Plugins + marketplace
# ./scripts/validate-with-claude-cli.sh <slug> # nur eines
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
cd "$ROOT"
if ! command -v claude >/dev/null 2>&1; then
echo "FEHLER: claude CLI fehlt. Installation:" >&2
echo " npm install -g @anthropic-ai/claude-code" >&2
exit 2
fi
VERSION="$(claude --version 2>&1 | head -1)"
echo "Claude CLI: $VERSION"
echo ""
FAILED=0
validate_one() {
local target="$1"
local label="$2"
if ! claude plugin validate --strict "$target" 2>&1 | tail -10; then
echo "FEHLER bei $label" >&2
FAILED=$((FAILED + 1))
fi
echo ""
}
if [ $# -gt 0 ]; then
for slug in "$@"; do
if [ ! -d "$slug" ]; then
echo "FEHLER: $slug nicht gefunden" >&2
exit 2
fi
echo "=== Plugin: $slug ==="
validate_one "$slug" "$slug"
done
else
echo "=== Marketplace ==="
validate_one ".claude-plugin/marketplace.json" "marketplace.json"
echo "=== Alle Plugins (strict) ==="
python3 -c "
import json
m = json.load(open('.claude-plugin/marketplace.json'))
for p in m['plugins']:
print(p['name'])
" | while read -r slug; do
if [ -d "$slug" ]; then
echo "--- $slug ---"
if ! claude plugin validate --strict "$slug" 2>&1 | grep -E '(passed|FAIL|error|warn)' | tail -3; then
FAILED=$((FAILED + 1))
fi
else
echo "WARN: $slug nicht im Repo-Root gefunden" >&2
fi
done
fi
if [ "$FAILED" -gt 0 ]; then
echo ""
echo "FEHLER: $FAILED Plugin(s) sind nicht strict-konform." >&2
exit 1
fi
echo ""
echo "OK: Alle Plugins haben 'claude plugin validate --strict' bestanden."
+111
View File
@@ -0,0 +1,111 @@
#!/usr/bin/env python3
r"""
Echter YAML-Parser-Check für alle SKILL.md im Repo.
Fängt genau das ab, was 'claude plugin validate --strict' moniert:
- Unescapte " innerhalb von "..."-Strings (Quote-Sweep-Fehler)
- \& oder andere ungültige YAML-Escapes
- Defektes Frontmatter generell
Aufruf: python3 scripts/validate-yaml-frontmatter.py
Exit 0 bei OK, 1 bei Fehlern.
"""
import os, sys, re
try:
import yaml
except ImportError:
print("FEHLER: pyyaml fehlt. Installation: pip3 install pyyaml", file=sys.stderr)
sys.exit(2)
REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
os.chdir(REPO)
errors = []
warnings = []
for root, dirs, files in os.walk('.'):
if '.git' in dirs:
dirs.remove('.git')
if 'node_modules' in dirs:
dirs.remove('node_modules')
for f in files:
if f != 'SKILL.md':
continue
p = os.path.join(root, f)
with open(p, encoding='utf-8') as fh:
content = fh.read()
if not content.startswith('---'):
errors.append(f"{p}: keine Frontmatter")
continue
try:
end_idx = content.index('\n---', 3)
except ValueError:
errors.append(f"{p}: Frontmatter nicht terminiert (--- fehlt)")
continue
fm_str = content[4:end_idx]
try:
fm = yaml.safe_load(fm_str)
except yaml.YAMLError as e:
errors.append(f"{p}: YAML-Parse-Fehler: {e}")
continue
if not isinstance(fm, dict):
errors.append(f"{p}: Frontmatter ist kein Dict")
continue
# Pflichtfelder
if 'name' not in fm:
errors.append(f"{p}: 'name' fehlt")
if 'description' not in fm:
errors.append(f"{p}: 'description' fehlt")
# name-Validierung
name = fm.get('name', '')
if not isinstance(name, str):
errors.append(f"{p}: 'name' muss String sein, ist {type(name).__name__}")
elif not re.match(r'^[a-z0-9-]{1,64}$', name):
errors.append(f"{p}: 'name' '{name}' invalid (kebab-case, max 64)")
# Ordnername == name
skill_dir = os.path.basename(os.path.dirname(p))
if name != skill_dir:
errors.append(f"{p}: 'name' '{name}' != Ordnername '{skill_dir}'")
# description-Validierung
desc = fm.get('description', '')
if not isinstance(desc, str):
errors.append(f"{p}: 'description' muss String sein, ist {type(desc).__name__}")
elif len(desc) > 1024:
errors.append(f"{p}: 'description' zu lang ({len(desc)} > 1024)")
elif len(desc) == 0:
errors.append(f"{p}: 'description' leer")
# XML-Tag-Verbot
if isinstance(desc, str) and re.search(r'<[a-zA-Z]', desc):
warnings.append(f"{p}: 'description' enthält möglicherweise XML-Tags")
# Komma-Zahl-Pattern (Cowork-Validator)
if isinstance(desc, str) and re.search(r'\d\s*,\s*\d', desc):
errors.append(f"{p}: 'description' enthält Zahl-Komma-Zahl (Cowork bricht)")
# Verbotene Felder
for vk in ['triggers','when_to_use','language','rechtsgebiet','license','argument-hint','user-invocable','allowed_tools','tools','model','adapted_from','version','related_skills']:
if vk in fm:
errors.append(f"{p}: verbotenes Feld '{vk}'")
# Unbekannte Felder
allowed = {'name','description','allowed-tools'}
for k in fm:
if k not in allowed and k not in ['triggers','when_to_use','language','rechtsgebiet','license','argument-hint','user-invocable','allowed_tools','tools','model','adapted_from','version','related_skills']:
warnings.append(f"{p}: unbekanntes Feld '{k}'")
# Plugin-Root CLAUDE.md (von Claude Code als Warnung gemeldet)
for d in sorted(os.listdir('.')):
if not os.path.isdir(d) or d.startswith('.'):
continue
if not os.path.isfile(os.path.join(d, '.claude-plugin', 'plugin.json')):
continue
if os.path.isfile(os.path.join(d, 'CLAUDE.md')):
errors.append(f"{d}/CLAUDE.md: Plugin-Root-CLAUDE.md wird nicht geladen — als Skill verschieben oder löschen")
print(f"validate-yaml-frontmatter: {len(errors)} Fehler, {len(warnings)} Warnungen")
if warnings:
for w in warnings[:20]:
print(f" WARN: {w}")
if errors:
for e in errors:
print(f" FEHLER: {e}", file=sys.stderr)
sys.exit(1)
print("OK")