heinzel-housekeeping

Featured

Run a heinzel housekeeping (health) inspection on a server — disk, memory, load, pending updates, firewall, SSL certs, failed systemd units, logs, kernel reboot status, and service-specific checks. Use when the user asks to "run housekeeping", "housekeeping report", "run a health check on <host>", or "do routine inspection". Do NOT auto-invoke for ambiguous requests like "check server <host>" — that's reserved for quick queries. Covers Linux (Debian, Ubuntu, RHEL, CentOS, Fedora, SUSE) and macOS.

DevOps & Infrastructure 91 stars 13 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
65
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# heinzel-housekeeping Routine health inspection for a server or the local machine. **Never run automatically** — only on explicit user request. The whole of the heinzel first-connection onboarding pipeline still applies before any of this runs. ## Workflow 1. **Load overrides.** Before running any check, apply the full heinzel rule-override chain (later wins): - `memory/custom-rules/heinzel-housekeeping.md` if present (global custom overrides for this skill — `## Add:`, `## Replace:`, `## Remove:` prefixes per `CLAUDE.md`). - `memory/housekeeping.md` if present (additional cross- server custom checks — free-form Markdown, gitignored by default). - `memory/servers/<hostname>/memory.md` (service list, last-known state, per-server quirks). - `memory/servers/<hostname>/rules.md` if present (per-server rule overrides — same prefixes as above, highest precedence). Note: `memory/custom-rules/all.md` is already loaded by the CLAUDE.md session-start preflight — do not re-read it. 2. **Select checks.** Run all baseline checks for the detected OS plus any service-specific checks triggered by entries in the server's `memory.md` (e.g. PostgreSQL, nginx, Docker). The backup-presence check from `references/backup-presence.md` runs on every host, independent of `memory.md` entries. 3. **Run the version check** procedure from `rules/version-check.md` for all Tier 1 software and include the "Versions" section in the repor...

Details

Author
wintermeyer
Repository
wintermeyer/heinzel
Created
6 months ago
Last Updated
2 days ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category