Service Reviewer
Use this skill to review a new or updated service against the homelab standards.
Review focus
Prioritize:
- •Secrets or sensitive data in tracked files
- •Missing labels (Traefik/Homepage)
- •Env hygiene (env_file usage, no
environment:block) - •Healthcheck present and correct
- •README completeness
- •Root file edits (should be avoided)
- •Taskfile usage only when needed
- •Cron setup only when needed
Workflow
- •Identify changed files for the service.
- •Check compose file for:
- •
env_fileonly (noenvironment:) - •Traefik + Homepage labels
- •Healthcheck
- •Correct ports with defaults matching image
- •
- •Check
.env.<name>.example:- •No secrets/paths/domains
- •Optional values commented out
- •Check README:
- •Purpose, URLs, healthcheck, volumes, init steps
- •If cron or hooks exist, confirm they’re justified.
- •Summarize findings by severity.
Output
- •Findings list (highest severity first)
- •Any open questions
- •Readiness to commit
Reference
See references/review-checklist.md.