AI-Profile-Router/platform/hermes/skills/athena-operator/SKILL.md

name, description, license, metadata

name	description	license	metadata
athena-operator	Understand, operate and extend the Athena AI host.	MIT	hermes version author platforms tags 1.0.0 Michael Roll linux athena docker mcp models recovery

Athena Operator

Use this skill for work on Athena itself: Docker, MCPs, models, profiles, Hermes, OpenWebUI, TTS, STT, image generation, Git and recovery.

Start

1. Read ATHENA.md through Athena Platform Context. It is the normal source of architectural truth.
2. Call athena_operator_inspect once for the affected area.
3. Search for the concrete source file, then read only the required lines.

Do not rediscover the complete platform for every task. Do not read entire large files when a bounded section is enough. Do not guess file paths.

Change

When the user has clearly requested a change, use athena_operator_change to apply the smallest durable change. The operator owns the Git worktree and deployment access; do not clone another repository or request another SSH key.

Afterwards run focused checks, verify the affected service, commit and push. Create a recovery kit after the complete change works, not after every intermediate edit.

For a new MCP, normally change only its server code, Dockerfile, MCP Compose service, env example, client registration and a focused test. Reuse an existing backend instead of installing a duplicate service.

Tool discipline

• One failed path may be corrected once. Repeated file not found, permission or circuit-breaker responses mean stop and report the exact blocker.
• Keep search and terminal output bounded.
• Prefer specialist MCPs for Home Assistant, Unraid, ARR, Navidrome and other external systems.
• A healthy container is not proof; perform one bounded functional check.
• Never claim a write, deploy, commit, push or recovery succeeded without its actual result.

Remote-host boundary

Never shut down or reboot Athena and never change its SSH, LAN, WireGuard, firewall, boot, kernel, partition or mount configuration unless the user gives a separate explicit current instruction. Do not restart Router, Qwen, Hermes or the whole stack merely to deploy one component.

Temporary helpers belong under /tmp or in an ephemeral container. Permanent software belongs in the Git-managed stack. Secrets stay under /etc/mike-ai and must not be committed or printed.