home-server-role-creator

Guide developers in adding self-hosted applications to home-server Ansible infrastructure.

Updated Aug 11, 2025
One-click install
npx skills add https://github.com/ndelucca/environment --skill home-server-role-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: home-server-role-creator
Source: https://github.com/ndelucca/environment/tree/main/.claude/skills/home-server-role-creator
Command: npx skills add https://github.com/ndelucca/environment --skill home-server-role-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance for adding new self-hosted applications to the home-server Ansible infrastructure. It documents all established patterns, conventions, and integration requirements to ensure consistent, secure, and maintainable role implementations.

Core Features & Use Cases

  • Role Creation Workflow: Step-by-step patterns for creating new Ansible roles for services, including directory structures and task organization.
  • Integration Patterns: Guidance on firewall, NGINX, SELinux, and DNS integration to simplify deployment.
  • Installation Method Guidance: Binary, package, and container deployment patterns with illustrated examples.

Quick Start

Use the home-server-role-creator skill to add a new service to the home-server Ansible infrastructure, following the workflow described in the Reference Files.

Frequently Asked Questions about home-server-role-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new self-hosted application to my Ansible infrastructure?

Adding a self-hosted application to Ansible infrastructure involves creating a role following established patterns for directory structure, task organization, and integration points. This Skill documents the complete workflow for binary, package, and container deployment methods, including firewall, NGINX, SELinux, and DNS configuration to ensure secure, maintainable deployments.

What are the standard patterns for integrating a service with firewall, NGINX, SELinux, and DNS in Ansible?

The home-server infrastructure defines explicit integration patterns for these components. Firewall rules expose ports, NGINX proxies traffic, SELinux enforces security contexts, and DNS registers hostnames. This Skill provides the conventions and variable definitions for each integration so new roles deploy consistently with existing services.

Should I deploy my self-hosted service as a binary, package, or container?

Each installation method—binary, package, or container—suits different scenarios. This Skill illustrates patterns and trade-offs for all three, showing how role structure, dependencies, and testing procedures adapt to each approach within the home-server Ansible infrastructure.

How do I structure an Ansible role for a new service on my home server?

Role structure follows conventions for directory layout, variable definitions, and task organization documented in this Skill. Proper structure ensures your new service integrates cleanly with firewall, NGINX, SELinux, DNS, and testing procedures already established in the home-server infrastructure.

What testing procedures should I follow after deploying a new role?

This Skill defines explicit testing procedures to verify web access, service functionality, and integration with firewall, NGINX, SELinux, and DNS. Testing ensures the new role meets functional and technical requirements and behaves consistently with existing home-server deployments.

Do I need to write custom variable definitions for each new service role?

Yes. This Skill specifies variable definition patterns and integration requirements for firewall, NGINX, SELinux, and DNS so each new role declares its configuration explicitly. Consistent variable definitions simplify maintenance and enable reliable automation across your home-server infrastructure.