cli-configuration-management

What problem does it solve?

This Skill provides a comprehensive framework for managing configuration files in command-line interface (CLI) tools, ensuring consistency, security, and user-friendliness.

Core Features & Use Cases

• Config File Formats: Supports TOML, YAML, JSON, JSON5/JSONC, and INI with recommendations.
• XDG Base Directory Spec: Adheres to standard locations for config, data, and cache files.
• Config Precedence: Defines a clear hierarchy for merging settings (env vars > flags > project > user > defaults).
• Secret Handling: Guides against storing secrets in config files, recommending OS keyring or environment variables.
• Validation & Migration: Integrates Zod for schema validation and versioned migration strategies.
• CLI Subcommands: Outlines patterns for init, config set, config get, and config list.
• Use Case: When developing a new CLI tool, use this Skill's patterns to implement a flexible and secure configuration system that respects user preferences and environment variables.

Quick Start

Implement CLI configuration management by following the XDG Base Directory spec and defining a clear precedence order for settings.