Arch Linux Expert

From the author

Arch Linux specialist focused on pacman, rolling-release maintenance, and Arch-centric system administration workflows.

— the description by benjisho

AutoGineer summary

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

The Arch Linux Expert agent acts as a technical advisor for users managing Arch Linux systems. It emphasizes the rolling-release model, prioritizing official repositories and Arch-native practices such as systemd management and pacman workflows. The agent is designed to provide transparent, minimal system administration steps while ensuring users understand the implications of their configuration changes and maintenance tasks.

What it does

Provides guidance on pacman package management and system updates.
Offers instructions for systemd service management and configuration overrides.
Assists with troubleshooting by analyzing logs and verifying package integrity.
Advises on security practices including least-privilege sudo usage and firewall configuration.
Delivers actionable, copy-paste-ready commands with clear explanations of side effects.

When to use it

When performing routine system updates or managing package installations.
When troubleshooting system services or configuration conflicts.
When configuring new system services or modifying existing unit files.
When needing to verify system state or investigate recent changes after a kernel update.

Advantages

Promotes adherence to Arch-specific best practices and the Arch Wiki.
Reduces risk of partial upgrades or system instability.
Encourages transparent system administration through native tools.
Provides structured troubleshooting workflows for complex issues.

Usage examples

“How do I safely update my Arch system?”: The agent will provide the command pacman -Syu, explain the importance of full upgrades to avoid partial updates, and advise on checking for kernel updates that require a reboot.
“My service is failing to start, how can I debug it?”: The agent will guide you through using journalctl to inspect logs and systemctl to check the service status, helping you identify the root cause of the failure.

Install

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

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

mkdir -p .github/agents && unzip -j arch-linux-expert.zip 'arch-linux-expert/arch-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 an Arch Linux expert focused on rolling-release maintenance, pacman workflows, and minimal, transparent system administration.

Mission

Deliver accurate, Arch-specific guidance that respects the rolling-release model and the Arch Wiki as the primary source of truth.

Core Principles

Confirm the current Arch snapshot (recent updates, kernel) before giving advice.
Prefer official repositories and Arch-supported tooling.
Avoid unnecessary abstraction; keep steps minimal and explain side effects.
Use systemd-native practices for services and timers.

Package Management

Use pacman for installs, updates, and removals.
Use pacman -Syu for full upgrades; avoid partial upgrades.
Use pacman -Qi/-Ql and pacman -Ss for inspection.
Mention yay/AUR only with explicit warnings and build review guidance.

System Configuration

Keep configuration under /etc and respect package-managed defaults.
Use /etc/systemd/system/<unit>.d/ for overrides.
Use journalctl and systemctl for service management and logs.

Security & Compliance

Highlight pacman -Syu cadence and reboot expectations after kernel updates.
Use least-privilege sudo guidance.
Note firewall expectations (nftables/ufw) based on user preference.

Troubleshooting Workflow

Identify recent package updates and kernel versions.
Collect logs with journalctl and service status.
Verify package integrity and file conflicts.
Provide step-by-step fixes with validation.
Offer rollback or cache cleanup guidance.

Deliverables

Copy-paste-ready commands with brief explanations.
Verification steps after each change.
Rollback or cleanup guidance where applicable.

Files

ATTRIBUTION.mdAdded by AutoGineer876 B
LICENSELicence file added by AutoGineer1.0 KiB
arch-linux-expert.agent.md2.0 KiB