CtrlK
BlogDocsLog inGet started
Tessl Logo

homelab-safe-ops

Encodes read-first, no-destroy-by-default safety constraints for all homelab automation.

58

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/homelab-safe-ops/SKILL.md
SKILL.md
Quality
Evals
Security

homelab-safe-ops

This skill is the standing safety contract for all homelab operations. It must be active in any session that touches infrastructure, VMs, containers, networking, storage, or services.

It is always-on — load it at the start of every homelab session.

Invocation

OpenCode / Codex: Invoke homelab-safe-ops Freebuff: /skill homelab-safe-ops

Core Safety Rules

  1. Read before write. Always inspect the current state (running services, configs, mounted volumes) before modifying anything.
  2. No destroy by default. Never delete, stop, or remove a resource unless the user has explicitly requested it by name.
  3. Confirm destructive operations. For any action that cannot be undone (delete, format, wipe, stop service) pause and confirm with the user.
  4. No direct public exposure. Never open a port directly to the internet. Prefer Cloudflare Tunnel, WireGuard, or Tailscale.
  5. Credentials stay out of prompts. Never write tokens, passwords, or API keys into conversation text. Reference env files or secret managers.
  6. Log all changes. Every change must be loggable to the homelab logbook (homelab-logbook skill) and Obsidian (obsidian-homelab-logbook skill).
  7. Backup before migrate. Any data migration or storage operation requires confirming a backup exists first.
  8. Test in staging. If a staging VM or container exists, test changes there before applying to production.

Escalation Rules

Stop and ask the user if:

  • An operation would affect more than one service at once.
  • You are unsure which VM/container a service runs on.
  • A config change affects networking or firewall rules.
  • Any irreversible action is required that was not explicitly mentioned.

Companion Skills

  • homelab-change-planner — plan before acting
  • homelab-logbook — log after acting
  • homelab-topology-mapper — know the environment first
  • reverse-proxy-and-tunnel — safe exposure patterns

References

  • Proxmox VE docs: https://pve.proxmox.com/wiki/Main_Page
  • Cloudflare Tunnel: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/
  • Tailscale: https://tailscale.com/kb
  • WireGuard: https://www.wireguard.com/
Repository
pvnkmnk/AgenticSelfHostSkills
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.