Skip to main content
hc
Submit
skillsFirst-partyReview first Safety · Privacy ·

Unraid API Automation Operator Skill

Build practical Unraid API automations for server operations, health checks, and routine maintenance with safe execution controls.

by JSONbored·added 2026-04-10·
Claude CodeCodexWindsurfGeminiCursorCLI
HarnessClaude CodeCodexWindsurfGeminiCursorCLI
Level:advancedType:generalVerified:draft
Review first — review before installing

Open the source and read safety notes before installing.

Prerequisites

  • Unraid server with API access configured
  • Scoped API key with least required permissions
  • Clear maintenance tasks and operating window

Schema details

Install type
package
Reading time
7 min
Difficulty score
73
Troubleshooting
Yes
Breaking changes
No
Package metadata
Package verified
Yes
SHA-256
64de5cc69848cd40c32125cbc81f12b07c4f64c9db8975b1a95dc99517ffe87a
Skill and platform metadata
Skill type
general
Skill level
advanced
Verification
draft
Verified at
2026-04-10
Retrieval sources
https://docs.unraid.net/API/
Tested platforms
ClaudeCodexOpenClawCursorWindsurfGemini
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.md or tool-specific context file
Full copyable content
# Trigger
"Use the Unraid API automation operator skill for this operation workflow."

# Required output
1) Automation scope and guardrails
2) API operation plan
3) Idempotency and rollback handling
4) Alerting/reporting output

About this resource

Overview

This skill helps AI agents create safe and repeatable Unraid automations. It focuses on real operational tasks such as health checks, backup verification, container lifecycle actions, and maintenance windows.

Compatibility

Native

  • Claude Code / Claude: native skill usage via SKILL.md.
  • Codex/OpenAI workflows: compatible with Agent Skills-style SKILL.md content as reusable workflow instructions.

Manual Adaptation

  • Gemini CLI: native skill usage via .gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md where supported.
  • Cursor: use the generated .cursor/rules/*.mdc adapter for project rules.
  • OpenClaw and similar agents: use the same skill content as a reusable prompt/workflow file when native skill import is unavailable.

Prerequisites

  • Operational policy for when automation may modify host state
  • Backup and restore baseline
  • Alert channel for actionable failures

What This Skill Delivers

  • Task-level automation design with execution boundaries
  • API request sequencing with safety checks
  • Retry/backoff and rollback considerations
  • Human-readable run summary and escalation guidance

How to Use This Skill

  1. Define allowed operations and protected resources.
  2. Map API calls to deterministic execution steps.
  3. Add pre-checks and post-checks for each action.
  4. Add failure handling and rollback branches.
  5. Emit concise run report for ops visibility.

Troubleshooting

Issue: Automation retries create duplicate side effects
Fix: Add idempotency keys and state checks before write operations.

Issue: API calls fail intermittently
Fix: Add bounded retries with backoff and explicit timeout policy.

Issue: Hard to trust autonomous changes
Fix: Add human approval for destructive or high-risk operations.

Knowledge Freshness

Treat tooling details as time-sensitive. Re-validate APIs, limits, pricing, auth models, and deployment flags immediately before implementation. If docs conflict with prior memory, follow current official docs and release notes.

Retrieval Sources

Output Contract

  1. Return a concrete plan with implementation order.
  2. Provide production-ready commands/config/code snippets (not placeholders).
  3. Include explicit assumptions and unresolved risks.
  4. Include a verification checklist with pass/fail criteria.

Quality Gates

  • All commands are copy/paste ready.
  • Security-sensitive steps call out secret handling and least privilege.
  • Version-sensitive guidance cites current docs used.
  • Rollback path is included for risky changes.
  • Final output includes quick validation commands/tests.
Content outline
#unraid#homelab#automation#api#operations

Source citations

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.