aytordev-options-design

Enforce aytordev.* namespaces and standard option patterns for module configuration.

1|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/aytordev/system --skill aytordev-options-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aytordev-options-design
Source: https://github.com/aytordev/system/tree/main/modules/common/ai-tools/skills/aytordev/options-design
Command: npx skills add https://github.com/aytordev/system --skill aytordev-options-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams struggle with inconsistent and scattered option definitions across modules, leading to misconfigurations, collisions, and hard maintenance. This skill provides a unified rule set to enforce aytordev.* namespaces and standard patterns for options across projects, improving consistency and governance.

Core Features & Use Cases

  • Namespace enforcement: All module options must live under aytordev.* to prevent collisions and enable centralized governance.
  • Standard option patterns: Recommends and demonstrates common patterns (e.g., options under options.aytordev..., using lib.aytordev mkOpt, and guarded config) to reduce boilerplate and errors.
  • Context-aware guidance: Provides rules for safely accessing user context and system configuration (osConfig) to avoid runtime issues.

Quick Start

Apply the aytordev naming convention to all module options across your configuration.

Frequently Asked Questions about aytordev-options-design

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

FAQPage Schema
How do I prevent option name collisions in NixOS module configurations?

To prevent option name collisions in NixOS module configurations, enforce a strict namespace convention like aytordev.* for all module options. This provides centralized governance and ensures consistent option design across projects.

What is the best way to standardize NixOS option patterns across multiple modules?

The best way to standardize NixOS option patterns is to use unified helpers like mkOpt and follow standard option patterns. This reduces boilerplate and errors while enforcing consistent module configuration under a dedicated namespace.

How do I safely access osConfig and user context in NixOS modules?

To safely access osConfig and user context in NixOS modules, apply context-aware guidance rules that guard system configuration and user data. This prevents runtime issues by ensuring secure and predictable context access.

Why do I need a namespace convention for NixOS options?

You need a namespace convention for NixOS options to resolve configuration collisions and avoid scattered option definitions. Organizing options under a namespace like aytordev.* enables centralized governance and simplifies maintenance.

Can I use mkOpt to reduce boilerplate in NixOS module options?

Yes, you can use mkOpt to reduce boilerplate in NixOS module options. It provides standard option patterns that enforce namespace conventions and reduce configuration errors across your NixOS modules.

What are the limitations of not enforcing option namespaces in NixOS?

Without enforcing option namespaces in NixOS, teams face inconsistent option definitions, misconfigurations, and hard maintenance. Scattered options cause collisions and prevent centralized governance across module configurations.