← ClaudeAtlas

qtile-editlisted

qtile, literate-config, tangle, configuration, tests
lost-rob0t/skills · ★ 0 · AI & Automation · score 67
Install: claude install-skill lost-rob0t/skills
# Edit Qtile safely ## Goal Change Qtile configuration at its durable source, regenerate owned outputs, and verify syntax and behavior before reloading the live window manager. ## Workflow 1. Discover the root with `QTILE_CONFIG_ROOT`, defaulting to `$HOME/.config/qtile`. Read its local instructions before editing. 2. Classify the target before changing it: - `qtile-ai.org` is the canonical source for `config.py`. - `qtile-openrouter.org` is the canonical source for `qtile_openrouter.py`. - Standalone Python, Elisp, and shell helpers are edited at their own source. - Never make a lasting change only in a generated `config.py` or `qtile_openrouter.py`. 3. Search the source and nearby tests for the behavior. Preserve existing ownership, keybinding, event-loop, and display/server conventions. 4. Edit the canonical source. For an Org source, tangle from that file: ```sh emacs --batch --quick qtile-ai.org --funcall org-babel-tangle emacs --batch --quick qtile-openrouter.org --funcall org-babel-tangle ``` Tangle only the source that changed when possible. 5. Verify generated parity and syntax from the configuration root: ```sh python -m py_compile config.py qtile_telemetry.py qtile check -c config.py ``` 6. Run the narrowest relevant tests, then the full Qtile suite when practical. Tests must check behavior and source/generated parity, not only file existence. 7. Invoke `qtile-reload` only after validation passes, then