Manjaro Skill for AI Coding Assistants

Keywords: manjaro, arch-linux, pacman, aur, yay, systemd, btrfs, timeshift, docker, opencode, claude-code, ai-agent, linux-administration

A unified Manjaro Linux system administration skill for AI coding assistants (OpenCode, Claude Code, Codex, Cursor). Makes AI agents prefer native Manjaro tools — pacman, yay, systemd — over generic cross-platform alternatives.

The Problem

Ask any AI assistant to install software on Manjaro → it defaults to pip install -g, npm -g, snap, or brew. These bypass pacman and create dependency conflicts.

This skill fixes that.

Features

• Pacman-first package resolution — Decision tree that enforces official repos → AUR → language-specific installers (only in isolation)
• Unified /manjaro command — Slash command with subcommands: check, install, rescue
• Systemd recipes — Unit file templates for daemons, timers, user services, Docker containers, socket activation
• Docker & Timeshift — Native Docker workflow, snapshot workflow before risky operations
• 12 troubleshooting flows — Structured diagnosis → fix for broken updates, GPU issues, boot failures, and more
• Equivalence tables — Maps generic commands (pip, npm, snap, brew) to Manjaro equivalents

Compatibility

Agent	Path
OpenCode	~/.config/opencode/skills/manjaro/
Claude Code	~/.claude/skills/
Codex	~/.agents/skills/
Cursor	~/.cursor/skills/

Install

Via skills.sh (recommended)

npx skills add ankaboot-source/manjaro-skill

Manual install

git clone https://github.com/ankaboot-source/manjaro-skill.git
cp -r manjaro-skill ~/.config/opencode/skills/manjaro

Claude Code

claude install ankaboot-source/manjaro-skill

Manual

# OpenCode
cp -r manjaro ~/.config/opencode/skills/

# Claude Code
cp -r manjaro ~/.claude/skills/

Use

Once installed, the skill triggers automatically when you mention Manjaro, Arch, pacman, systemd, or any system administration task on a Manjaro host.

Slash command:

/manjaro check                System health check
/manjaro install <package>    Smart package installer (pacman/AUR-first)
/manjaro rescue <symptoms>    Guided troubleshooting

Package Resolution

When you ask to install software on a Manjaro system, this skill enforces:

1. pacman (official repos)
2. yay (AUR)
3. Language-specific installers ONLY in isolation (venv, node_modules, etc.)
   NEVER: sudo pip install, npm -g, or any global install

Before / After

Instead of...	Use...
brew install htop	pamac-installer htop
snap install code	pamac-installer visual-studio-code-bin --build
curl ... | sh	Check repos first: pacman -Ss <name>
npm -g install neovim	pamac-installer neovim

Contents

manjaro/
├── SKILL.md                              # Core skill (auto-loaded)
├── commands/
│   └── manjaro.md                        # /manjaro slash command
└── references/
    ├── packages.md                       # Full pacman/yay reference + equivalence tables
    ├── systemd-recipes.md                # Unit templates, timers, hardening
    └── troubleshooting.md               # 12 common issues with fix flows

Resources

Marketplace	Link
GitHub	https://github.com/ankaboot-source/manjaro-skill
Skills.sh	npx skills add ankaboot-source/manjaro-skill
LobeHub	https://lobehub.com/skills/ankaboot-source/manjaro-skill
SkillsHub	https://skillshub.wtf/ankaboot/manjaro-system-administration

⚠️ Safety

This skill helps AI suggest correct Manjaro commands. You always retain control.

Recommended OpenCode Configuration

Add this to ~/.config/opencode/opencode.json to require approval before running system changes:

{
  "permission": {
    "bash": {
      "*": "ask",
      "pacman -Ss *": "allow",
      "yay -Ss *": "allow",
      "systemctl status *": "allow",
      "journalctl *": "allow",
      "git *": "allow"
    }
  }
}

This ensures:

• sudo pacman -S ..., yay -S ... → requires approval
• Search queries, status checks, git → auto-allow

Best Practices

• Always review commands before running, especially those with sudo
• Create Timeshift snapshots before major changes
• The AI suggests commands — you decide what runs

License

GPL-3.0

Update

Via skills.sh

npx skills update ankaboot-source/manjaro-skill

Manual (git)

# Navigate to your skill directory
cd ~/.config/opencode/skills/manjaro

# Or wherever you installed it
git pull origin master

Reinstall (clean)

# Remove old version
rm -rf ~/.config/opencode/skills/manjaro

# Fresh install
git clone https://github.com/ankaboot-source/manjaro-skill.git ~/.config/opencode/skills/manjaro