The Agent Skills Directory

[Configuration Management Pattern]: Provides templates for loading and saving settings using a defaults-merge-overlay approach. This pattern includes input validation by only accepting known keys from a default dictionary, which helps prevent unexpected data processing from modified configuration files.
[Atomic State Persistence]: Demonstrates how to perform atomic file writes using temporary files and os.replace. This is a standard reliability pattern that prevents data corruption if a process crashes during a write operation.
[Sensitive Data Handling]: Includes guidance on managing secrets with appropriate file permissions (0600). This encourages secure storage practices for credentials and tokens.
[Concurrency Control]: Shows how to use asyncio.Lock and threading.Lock to safely manage access to state files in multi-threaded or asynchronous environments, preventing race conditions.
[Directory Structure]: Recommends XDG-compliant paths for configuration, state, and secrets, ensuring the skill follows platform-standard conventions for data isolation.

config-state-patterns