DebianClub AI Skills
DebianClub AI Skills for safer Debian/Linux AI assistance with verified system facts and read-only diagnostics
DebianClub AI Skills are reliability rules for AI coding assistants and terminal agents working on Debian/Linux systems. They do not replace documentation. They make the agent identify the environment, verify package names, inspect logs, and review command risk before giving advice.
The first skill in this repository is skills/debian-linux-reliability/. It uses one main skill with focused submodules and defaults to read-only diagnostics with no automatic system modification.
Skills Catalog
registry v1Debian Linux Reliability
Version 0.2.0Safer Debian/Linux diagnostics for AI agents
bash skills/scripts/install-skill.sh debian-linux-reliabilitybash skills/scripts/install-skill.sh --replace debian-linux-reliabilitybash skills/scripts/validate-all.shbash skills/scripts/package-skill.sh debian-linux-reliabilitybash skills/scripts/publish-skill-release.sh debian-linux-reliability --dry-runSection Guide
| Page | What it solves |
|---|---|
| Install & Distribution | Install from the repository, replace an existing install, read the registry, and build local packages |
| Usage | Invoke the skill in an AI agent and separate facts, inference, and proposed changes |
| Modules | Choose between environment, APT, command safety, systemd, networking, GPU, containers, and other modules |
| Safety Boundary | Read-only defaults, approval before changes, risky command detection, and redaction rules |
| Evaluation & Maintenance | Run validation, score real responses, add regression samples, and release versions |
Why This Exists
AI mistakes on Linux often come from:
- Applying Ubuntu, Arch, or macOS commands to Debian
- Inventing package names
- Ignoring stable, backports, testing, and unstable differences
- Guessing service failures without checking
systemctlandjournalctl - Recommending risky commands such as
curl | sh,rm -rf, orchmod -R - Missing WSL, containers, non-systemd environments, or non-amd64 architectures
DebianClub AI Skills make the agent collect facts first.
Current Skill
| Skill | Purpose | Default behavior |
|---|---|---|
debian-linux-reliability | Debian/Linux development, administration, and troubleshooting reliability workflow | Read-only diagnosis, no automatic system modification |
DebianClub Documentation Binding
The skill prefers DebianClub repository content for explanations, including:
- APT Package Management
- Debian Backports
- deb822 Sources
- Network Configuration
- NVIDIA Optimus
- Podman
- System Security
Live state must still come from the user's machine. Documentation explains. Read-only probes verify current facts.
Quick Invocation
In an AI agent that supports skills, invoke:
Use $debian-linux-reliability to diagnose this Debian package installation issue.Repository files:
skills/debian-linux-reliability/SKILL.md
skills/debian-linux-reliability/references/
skills/debian-linux-reliability/scripts/Next, read Install & Distribution, then Usage.
Zed Editor Installation & Usage
Step-by-step guide to installing and using Zed, a high-performance Rust-based code editor with built-in AI features, on Debian.
Install & Distribution
Install DebianClub AI Skills locally, replace an existing install, read the registry, build packages, and run release checks.