| name | linux-system-manager-maintainer |
| description | Maintain, enhance, and extend the system-agnostic linux-system-manager toolset. Use this skill when adding new features, modifying distro menus, replicating functionality across all distros, managing systemd services, or running tests. |
| version | 1.1.0 |
| triggers | ["how to add a new feature to linux-system-manager","add distro-agnostic capability","replicate functionality to all distros","manage linux-system-manager project"] |
| intent | system |
| config_dir | ./config |
| created_at | 2026-07-06T00:00:00.000Z |
| updated_at | 2026-07-06T00:00:00.000Z |
Linux-System-Manager Project Maintainer & Developer Guide
This local skill governs the design, maintenance, and expansion of the linux-system-manager project.
1. Project Philosophy & Core Architecture
The linux-system-manager toolset is a stateless, configuration-driven system management pipeline. It is designed around complete isolation between presentation and implementation:
- Parent Orchestrator (
linux-system-manager.sh): Distro-blind. Handles terminal clearance, interactive menus, OS detection (/etc/os-release), dynamic JSON menu parsing, and process execution context.
- Distribution Modules (
distros/<distro_id>/): Self-contained. Declare their capabilities in menu.json and implement execution logic in distro-native scripts/binaries.
- Privilege Boundary: The parent orchestrator and main menu run as a regular user. Distro-specific scripts must call
sudo internally if they perform privileged actions (like checking systemd configs or writing backups).
2. Directory Layout Reference
linux-system-manager/
├── linux-system-manager.sh # Main menu runner (distro-agnostic)
├── install.py # Service and hooks installer (distro-agnostic)
├── test_sys_manager.py # Unit test suite
├── SKILL.md # Local maintainer & developer guide
├── services/ # System-scope units → /etc/systemd/system
│ ├── sys-manager-cleanup.service
│ ├── personal-services.target # WantedBy=multi-user.target
│ └── user/ # User-scope units → ~/.config/systemd/user
│ └── personal-services.target # WantedBy=default.target
├── distros/ # Distro-specific logic folders
│ ├── arch/
│ │ ├── menu.json # Capabilities menu mapping
│ │ ├── install_hooks.sh # Hooks copy script
│ │ └── *.sh # Inspection & management scripts
│ └── <new-distro>/
│ ├── menu.json
│ ├── install_hooks.sh
│ └── ...
└── SKILL.md # This maintainer guide
3. Workflow: Replicating a New Feature Across All Distros
To add a new option or section (e.g., "Disk Space Analyzer" or "Logs Monitor") and make it available across all supported distributions, use this sequence:
Step 1: Scan for Available Distributions
Run a command or inspect the file system to list directories in distros/:
ls -d distros/*/ | grep -v
