self-maintainer

Self-Maintainer

Self-auditing and self-improving skill for the awesome-skills maintenance system.

Core Principle

This skill follows the same patterns it maintains. When it improves itself, it uses these same instructions. This creates a positive feedback loop where the maintenance system gets better at maintaining itself.

Workflow

1. Audit Current Skills Health

cd /Volumes/waku/github-维护/awesome/awesome-skills-repos/.skills

echo "=== Skills Directory Health Check ===\n"

# Check all SKILL.md files exist and are valid
echo "Skill directories:"
for skill in */; do
    name=$(basename "$skill")
    if [ -f "$skill/SKILL.md" ]; then
        size=$(wc -c < "$skill/SKILL.md")
        lines=$(wc -l < "$skill/SKILL.md")
        echo "  ✅ $name - ${size}B, ${lines} lines"
    else
        echo "  ❌ $name - MISSING SKILL.md"
    fi
done

echo ""
echo "Total skills: $(ls -d */ | wc -l | tr -d ' ')"
echo "Total SKILL.md files: $(find . -name 'SKILL.md' | wc -l | tr -d ' ')"

2. Check for Skill Anti-Patterns

python3 << 'PYEOF'
import os
import re
from pathlib import Path

SKILLS_DIR = Path("/Volumes/waku/github-维护/awesome/awesome-skills-repos/.skills")
issues = []

for skill_dir in SKILLS_DIR.iterdir():
    if not skill_dir.is_dir():
        continue
    
    skill_name = skill_dir.name
    skill_md = skill_dir / "SKILL.md"
    
    if not skill_md.exists():
        issues.append(f"❌ {skill_name}: SKILL.md missing")
        continue
    
    content = skill_md.read_text()
    
    # Check frontmatter
    if not content.startswith('---'):
        issues.append(f"❌ {skill_name}: Missing YAML frontmatter")
    
    # Check required fields
    if 'name:' not in content[:500]:
        issues.append(f"❌ {skill_name}: Missing 'name:' in frontmatter")
    if 'description:' not in content[:500]:
        issues.append(f"❌ {skill_name}: Missing 'description:' in frontmatter")
    
    # Check for common issues
    if len(content) < 500:
        issues.append(f"⚠️ {skill_name}: SKILL.md is very short ({len(content)} bytes)")
    
    # Check for README files (anti-pattern)
    for f in skill_dir.iterdir():
        if f.name.startswith('README') and f.suffix == '.md':
            issues.append(f"⚠️ {skill_name}: Has {f.name} (should be in SKILL.md or references/)")
    
    # Check for excessive nesting
    for root, dirs, files in os.walk(skill_dir):
        depth = root.replace(str(skill_dir), '').count(os.sep)
        if depth > 2:
            issues.append(f"⚠️ {skill_name}: Excessive nesting at depth {depth}")
    
    # Check description is comprehensive
    desc_match = re.search(r'description:\s*["\'](.+?)["\']', content[:1000], re.DOTALL)
    if desc_match:
        desc_len = len(desc_match.group(1))
        if desc_len < 50:
            issues.append(f"⚠️ {skill_name}: description is very short ({desc_len} chars)")

if issues:
    print("=== Issues Found ===")
    for issue in issues:
        print(f"  {issue}")
else:
    print("✅ All skills pass basic health checks!")
PYEOF