skills.rest
clearcmos
clearcmosCOMMUNITY
Explore all skills by this author →
GitHub

update-this

Audit NixOS documentation against .nix files and apply atomic fixes.

Updated Aug 23, 2026
Search Tags:#documentation#workflow automation#codebase#audit#sync#nixos
One-click install
npx skills add https://github.com/clearcmos/nixos --skill update-this
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-this
Source: https://github.com/clearcmos/nixos/tree/main/claude-config/skills/update-this
Command: npx skills add https://github.com/clearcmos/nixos --skill update-this

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, jq, nixos-rebuild, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the common issue of documentation becoming outdated and out of sync with the actual codebase, leading to confusion and errors.

Core Features & Use Cases

  • Comprehensive Audit: Cross-references documentation (CLAUDE.md, docs/) against the live NixOS configuration.
  • Automated Fixes: Applies necessary updates to documentation and code references.
  • Use Case: When your NixOS configuration changes, use this skill to ensure all related documentation, including service descriptions and module statuses, accurately reflects the current state of your infrastructure.

Quick Start

Run the update-this skill to audit and synchronize documentation with the current codebase.

Frequently Asked Questions about update-this

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

FAQPage Schema
How do I keep NixOS infrastructure documentation in sync with my codebase?▼

To keep NixOS documentation in sync, you can run an audit workflow that cross-references CLAUDE.md and docs/ against your live .nix files and module states, automatically applying atomic fixes to outdated references.

What is the best way to automate documentation updates when NixOS configuration changes?▼

Automating documentation updates for NixOS involves using parallel agents to audit system facts and module states, then applying necessary fixes to documentation and code references to accurately reflect the current infrastructure state.

Do I need git and jq to automate a NixOS documentation audit?▼

Yes, you need git, jq, and nixos-rebuild installed in your environment to execute the audit workflow, apply documentation fixes, and verify the current state of your NixOS infrastructure.

Can this workflow cross-reference CLAUDE.md files against live NixOS module states?▼

Yes, the workflow specifically cross-references CLAUDE.md and docs/ directories against live NixOS configuration files, system facts, and module states to identify and correct outdated documentation.

Why does my documentation audit fail to apply atomic fixes to NixOS code references?▼

Documentation audits fail to apply atomic fixes if dependencies like git, jq, or nixos-rebuild are missing, preventing the workflow from verifying and synchronizing documentation against the actual codebase state.

Related Skills

Explore More Software Engineering Skills→
johnnymo87johnnymo87
4

Rebuilding the Devbox

Rebuild NixOS devbox systems and apply user configuration changes.

Community
Advanced
bolivian-perubolivian-peru
113

system-packages

Manage NixOS packages by editing configuration.nix and running nixos-rebuild.

Community
Intermediate
belokonmbelokonm
8

powershell-7-expert

Automate cross-platform PowerShell 7 tasks across Windows, Linux, and macOS.

Community
Advanced
0xHarbs0xHarbs
1

drift

Detect architectural drift across code, documentation, ADRs, and dependencies.

Community
Advanced