From skillry-skill-library-and-installation
Use when you need to audit global and project installation paths, backups, packages, and reinstall readiness.
How this skill is triggered — by the user, by Claude, or both
Slash command
/skillry-skill-library-and-installation:74-global-installation-auditThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Verify that the Claude Code global installation under `~/.claude/` is structurally complete, internally consistent, and reinstall-ready. Check for missing required files, broken symlinks, frontmatter validity, version mismatches between `claude-system.toml` and installed components, and the presence of current backups.
Verify that the Claude Code global installation under ~/.claude/ is structurally complete, internally consistent, and reinstall-ready. Check for missing required files, broken symlinks, frontmatter validity, version mismatches between claude-system.toml and installed components, and the presence of current backups.
~/.claude/).python3 tools/claude-smoke-check.py reports errors and you need a full audit.path-hygiene-repair.skill-deduplication..claude/ directory, not the global ~/.claude/ — adjust paths accordingly.Verify the canonical global directory tree exists:
ls -la ~/.claude/
# Expected: skills/ agents/ CLAUDE.md claude-system.toml (optional: tools/ backups/)
Required paths:
~/.claude/
skills/ # 90+ skill directories
agents/ # 64 agent directories
CLAUDE.md # Global system instruction file
claude-system.toml # Version and configuration manifest
Flag any missing top-level entry.
# Count skill directories
ls ~/.claude/skills/ | wc -l
# Check each skill has a SKILL.md
for d in ~/.claude/skills/*/; do
[ ! -f "$d/SKILL.md" ] && echo "MISSING SKILL.md: $d"
done
# Check frontmatter is present in each SKILL.md
for f in ~/.claude/skills/*/SKILL.md; do
head -1 "$f" | grep -q "^---" || echo "BAD FRONTMATTER: $f"
done
# Check required frontmatter fields
for f in ~/.claude/skills/*/SKILL.md; do
grep -q "^name:" "$f" || echo "MISSING name: $f"
grep -q "^description:" "$f" || echo "MISSING description: $f"
done
# Count agent directories
ls ~/.claude/agents/ | wc -l
# Check each agent has an AGENT.md
for d in ~/.claude/agents/*/; do
[ ! -f "$d/AGENT.md" ] && echo "MISSING AGENT.md: $d"
done
# Check frontmatter fields
for f in ~/.claude/agents/*/AGENT.md; do
grep -q "^name:" "$f" || echo "MISSING name: $f"
grep -q "^description:" "$f" || echo "MISSING description: $f"
done
wc -l ~/.claude/CLAUDE.md
head -5 ~/.claude/CLAUDE.md # Should show system instruction header, not frontmatter
# Check for known required sections
grep -c "## " ~/.claude/CLAUDE.md # Count H2 sections — expect ≥3
cat ~/.claude/claude-system.toml
# Verify: version field present, skills_path and agents_path match actual paths
python3 -c "
import tomllib, pathlib
with open(pathlib.Path.home() / '.claude/claude-system.toml', 'rb') as f:
c = tomllib.load(f)
print('version:', c.get('version', 'MISSING'))
print('skills_path:', c.get('skills_path', 'MISSING'))
print('agents_path:', c.get('agents_path', 'MISSING'))
"
[ -f ~/.claude/tools/claude-smoke-check.py ] && \
python3 ~/.claude/tools/claude-smoke-check.py || \
echo "Smoke check script not found — skipping"
# Check for backups directory and recency
ls -lht ~/.claude/backups/ 2>/dev/null | head -5
# Flag if newest backup is older than 7 days
find ~/.claude/backups/ -maxdepth 1 -newer ~/.claude/CLAUDE.md 2>/dev/null | wc -l
find ~/.claude/ -type l ! -exec test -e {} \; -print
~/.claude/skills/ exists and contains ≥1 directory~/.claude/agents/ exists and contains ≥1 directory~/.claude/CLAUDE.md exists and is non-empty~/.claude/claude-system.toml exists and is parseableskills/*/SKILL.md has --- frontmatter, name:, and description:agents/*/AGENT.md has --- frontmatter, name:, and description:~/.claude/claude-system.toml paths match actual directory locations--- delimiter — breaks frontmatter parsers./Users// in config when actual home is $HOME/ — use path-hygiene-repair to fix.--- frontmatter. If it does, the file may have been accidentally overwritten.## Global Installation Audit Report
Audit date: [date]
Home directory: [~/.claude resolved path]
### Phase 1: Directory structure
- skills/: [PRESENT / MISSING]
- agents/: [PRESENT / MISSING]
- CLAUDE.md: [PRESENT / MISSING]
- claude-system.toml: [PRESENT / MISSING / PARSE ERROR]
### Phase 2: Skill integrity
- Skills found: [N]
- Missing SKILL.md: [list or "none"]
- Bad frontmatter: [list or "none"]
- Missing name/description: [list or "none"]
### Phase 3: Agent integrity
- Agents found: [N]
- Missing AGENT.md: [list or "none"]
- Bad frontmatter: [list or "none"]
### Phase 4: CLAUDE.md
- Line count: [N]
- H2 sections: [N]
- Issues: [list or "none"]
### Phase 5: claude-system.toml
- version: [value]
- skills_path: [value] — [MATCHES / MISMATCH]
- agents_path: [value] — [MATCHES / MISMATCH]
### Phase 6: Smoke check
- [PASS / FAIL / SKIPPED] — [details]
### Phase 7: Backups
- Newest backup: [date or "none found"]
- Status: [CURRENT / STALE / ABSENT]
### Phase 8: Broken symlinks
- [list or "none"]
### Summary
[HEALTHY / DEGRADED / CRITICAL] — [top 3 issues to fix, or "no issues"]
### Recommended remediation commands
1. [command]
path-hygiene-repair for targeted repairs.Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub fluxonlab/skillry --plugin skillry-skill-library-and-installation