73f9c986a8
Documents the /housekeeping skill: purpose, usage, how it works, and which scripts it orchestrates. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
---
|
|
name: skill-housekeeping
|
|
description: Cross-project health check skill — runs git-status-report, unreflected-logs, validate-skill, and checks knowledge pipeline state
|
|
type: reference
|
|
---
|
|
|
|
# /housekeeping Skill
|
|
|
|
## Purpose
|
|
|
|
Cross-project health check that gathers information and suggests actions. Runs at the start of a session or periodically to understand what needs attention across all projects.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/housekeeping
|
|
```
|
|
|
|
No arguments. Information only — never takes action.
|
|
|
|
## How It Works
|
|
|
|
Runs five checks via bang-commands and tool calls:
|
|
|
|
1. **`git-status-report ~/dev/claude`** — Finds dirty repos, uncommitted changes, unpushed commits
|
|
2. **`unreflected-logs ~/dev/claude`** — Finds session logs not yet processed by `/reflect-logs`
|
|
3. **`validate-skill ~/dev/claude/projects/custom-claude-skills/skills`** — Validates all SKILL.md files
|
|
4. **Knowledge pipeline state** — Reads `.distill-state.json` and compares stored SHAs against current HEADs to determine if `/reflect-logs` or `/distill-best-practices` would be productive
|
|
5. **Structured report** — Summarises findings and produces prioritised action suggestions
|
|
|
|
## Output
|
|
|
|
Structured report with sections:
|
|
- Git Status Summary (dirty/clean repos)
|
|
- Unreflected Logs (counts and date ranges per project)
|
|
- Skill Validation (errors/warnings per skill)
|
|
- Knowledge Pipeline Status (reflect-logs and distill recommendations)
|
|
- Suggested Actions (prioritised: should address soon / worth doing / informational)
|
|
|
|
## Dependencies
|
|
|
|
- `git-status-report` script (in `~/sbin`, source: `small-scripts/scripts/git-status-report`)
|
|
- `unreflected-logs` script (in `~/sbin`, source: `small-scripts/scripts/unreflected-logs`)
|
|
- `validate-skill` script (in `~/sbin`, source: `small-scripts/scripts/validate-skill`)
|
|
- `best-practices/.distill-state.json` in claude-foundations (for distill check)
|
|
|
|
## Gotchas
|
|
|
|
- Bang-commands use `~/` paths — works in Paul's environment but would need adjustment for other users or sandboxed environments (validator warns about this, acceptable)
|
|
- The distill state check requires comparing git SHAs, which means projects must be git repos for that check to work
|