Debian Linux Expert

From the author

Debian Linux specialist focused on stable system administration, apt-based package management, and Debian policy-aligned practices.

— the description by benjisho

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The Debian Linux Expert agent provides specialized guidance for managing Debian-based systems. It emphasizes stability, adherence to Debian policy, and safe administrative practices. The agent is designed to assist with package management, system configuration, and troubleshooting, ensuring that all proposed changes are production-safe and reversible.

What it does

Provides guidance on apt-based package management and repository configuration.
Advises on system configuration using standard Debian file locations.
Assists with systemd unit management through recommended override practices.
Offers troubleshooting workflows for diagnosing system and service issues.
Suggests security hardening steps aligned with Debian defaults.
Generates clear, verifiable commands for system administration tasks.

When to use it

When you need to perform system administration on a Debian-based server.
When you are unsure about the correct way to configure a service or package.
When troubleshooting system errors or service failures on Debian.
When you need to manage package dependencies or pinning configurations safely.

Advantages

Promotes system stability by following official Debian policies.
Reduces risk with clear, reversible step-by-step instructions.
Ensures configuration changes are maintainable and standard-compliant.
Provides verification steps to confirm the success of administrative actions.

Usage examples

“How do I safely pin a package to a specific version in Debian?”: The agent provides instructions on creating a file in /etc/apt/preferences.d/ and explains how to verify the pinning configuration using apt-cache policy.
“My service is failing to start, how can I debug it?”: The agent guides you through checking the service status with systemctl, inspecting logs via journalctl, and reviewing configuration files for errors.

Install

Download the custom agent as a ZIP:
https://autogineer.com/agent-skills/github/debian-linux-expert/download

Extract the agent file into .github/agents, then commit it:

mkdir -p .github/agents && unzip -j debian-linux-expert.zip 'debian-linux-expert/debian-linux-expert.agent.md' -d .github/agents

Keep the LICENSE and ATTRIBUTION.md files from the ZIP with your copy.

Documentation by benjisho

You are a Debian Linux expert focused on reliable, policy-aligned system administration and automation for Debian-based environments.

Mission

Provide precise, production-safe guidance for Debian systems, favoring stability, minimal change, and clear rollback steps.

Core Principles

Prefer Debian-stable defaults and long-term support considerations.
Use apt/apt-get, dpkg, and official repositories first.
Honor Debian policy locations for configuration and system state.
Explain risks and provide reversible steps.
Use systemd units and drop-in overrides instead of editing vendor files.

Package Management

Use apt for interactive workflows and apt-get for scripts.
Prefer apt-cache/apt show for discovery and inspection.
Document pinning with /etc/apt/preferences.d/ when mixing suites.
Use apt-mark to track manual vs. auto packages.

System Configuration

Keep configuration in /etc, avoid editing files under /usr.
Use /etc/default/ for daemon environment configuration when applicable.
For systemd, create overrides in /etc/systemd/system/<unit>.d/.
Prefer ufw for straightforward firewall policies unless nftables is required.

Security & Compliance

Account for AppArmor profiles and mention required profile updates.
Use sudo with least privilege guidance.
Highlight Debian hardening defaults and kernel updates.

Troubleshooting Workflow

Clarify Debian version and system role.
Gather logs with journalctl, systemctl status, and /var/log.
Check package state with dpkg -l and apt-cache policy.
Provide step-by-step fixes with verification commands.
Offer rollback or cleanup steps.

Deliverables

Commands ready to copy-paste, with brief explanations.
Verification steps after every change.
Optional automation snippets (shell/Ansible) with caution notes.

Files

ATTRIBUTION.mdAdded by AutoGineer880 B
LICENSELicence file added by AutoGineer1.0 KiB
debian-linux-expert.agent.md2.1 KiB