Aiops service operations
Skill LinLin00000000/aiops-vault-template/skills/aiops-service-operations
Local-first, agent-friendly AIOps vault template with Markdown/JSONL truth sources and thin companion skills.
npx -y skills add LinLin00000000/aiops-vault-template --skill aiops-service-operationsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use this skill with aiops-vault when the user asks an agent to deploy, inspect, restart, monitor, troubleshoot, migrate, back up, or expose a small self-hosted service. It provides a portable operations workflow for Docker Compose, systemd, reverse proxies, service cards, backup checks, and consumer-side validation without duplicating the user's private inventory.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.0 KB, as published. Nobody here has run it
AIOps Service Operations
This optional skill complements aiops-vault. It describes the operations workflow after the vault has supplied current facts.
Scope
Use for small services and agent-operated infrastructure:
- Docker Compose projects.
- systemd services.
- reverse proxy routes.
- service data directories.
- backup/restore checks.
- health checks and log triage.
- service-card updates.
Do not store service facts in this skill. Use the AIOps vault and live inspection.
Operation workflow
- Load
aiops-vaultfirst when available. - Identify the target service and host through
aiops.py service <name>orresources --section. - Read the service card or project README if present.
- Inspect runtime state safely:
- Docker:
docker ps,docker compose ps,docker compose logs --tail. - systemd:
systemctl status,journalctl --since,systemctl cat. - HTTP:
curl -Ior a real health endpoint. - proxy: read route config without printing secrets.
- Docker:
- Separate desired change from risky side effects.
- Execute the smallest reversible step.
- Verify from the consumer side, not just the process side.
- Update current docs and append a maintenance-log entry.
Deployment defaults
For small cloud-hosted services, prefer:
- deployment files under
/opt/<service>/; - persistent data under
/data/<service>/; - app ports bound to
127.0.0.1behind Caddy/Nginx when public HTTPS is needed; - SSH/admin access on a private network when possible;
- explicit backup and restore notes before trusting a service with important data.
Adjust these defaults to the user's platform and existing conventions.
Troubleshooting lens
Classify failures by layer:
- DNS / client route.
- reverse proxy.
- app listener / container / systemd unit.
- upstream API/provider.
- storage / permissions / disk.
- authentication / secret location.
Use logs and real probes to distinguish layers. Do not guess from the service name.
Documentation write-back
- If host, URL, port, runtime, config path, data path, backup boundary, security boundary, or status changed: update
resources.mdor the service card. - If local runbook details changed: update the service card or service README.
- If the event matters for future recovery: append
maintenance-log.jsonl. - If a secret moved: update
secrets-location.mdwith location metadata only.
Final report shape
End with:
- target and resource pool;
- files changed;
- commands run and important output summaries;
- verification result;
- maintenance-log entry status;
- follow-ups or blockers.