skill-add-service

Create standardized NixOS service modules using serenitea-pot conventions.

14|3|Updated Jul 23, 2023
One-click install
npx skills add https://github.com/codgician/serenitea-pot --skill skill-add-service
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-add-service
Source: https://github.com/codgician/serenitea-pot/tree/main/.opencode/skills/skill-add-service
Command: npx skills add https://github.com/codgician/serenitea-pot --skill skill-add-service

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams create a standardized NixOS service module following serenitea-pot conventions, reducing boilerplate and ensuring consistency.

Core Features & Use Cases

  • Load templates from the templating system (fact-nix) to generate a standard service module.
  • Wrap existing NixOS services when available, or create a custom systemd unit when needed.
  • Provide guidance to enable the module on hosts, register secrets, and configure reverse proxies and DNS as part of a deployment workflow.

Quick Start

Create a new service module named after your service using the serenitea-pot conventions.

Frequently Asked Questions about skill-add-service

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

FAQPage Schema
How do I add a new NixOS service module with secrets and reverse proxy configuration?

To add a NixOS service module, you provide required inputs like service name, package, port, and reverse proxy details. The skill automates module creation, wraps existing NixOS services, and registers secrets and DNS in host configuration following serenitea-pot conventions.

What is needed to create a standardized NixOS service module?

A standardized NixOS service module requires inputs including the service name, package, port, reverse proxy, secrets, and persistence settings. A step-by-step validation workflow enforces these required inputs to ensure configuration consistency.

Can I wrap an existing NixOS service instead of building a custom systemd unit?

Yes, you can wrap existing NixOS services when available. The skill prioritizes wrapping existing modules to add service functionality, automatically creating a custom systemd unit only when a suitable existing NixOS service is not found.

How do I register secrets and DNS when deploying a new NixOS service?

To register secrets and DNS for a NixOS service, the skill provides deployment workflow guidance. It automatically registers required secrets and configures DNS entries within the host configuration as part of the standardized service module setup.

Does this NixOS service automation tool work without external dependencies?

Yes, this NixOS service automation tool works without external dependencies. It operates independently to load templates from the fact-nix templating system and generate standard service modules following serenitea-pot conventions.

When should I use a custom systemd unit instead of wrapping an existing NixOS module?

You should create a custom systemd unit when an existing NixOS service module is unavailable for your package. This approach ensures the service is properly configured while still adhering to required serenitea-pot module conventions.