Arch Linux Local Troubleshooting
Always use this skill for Arch Linux and Arch-based distribution troubleshooting on this machine. Prioritize EndeavourOS first and CachyOS second when distro context matters. Prefer the installed local ArchWiki (arch-wiki-docs) before web searches. The user should not need to say “use local ArchWiki first”; if the issue looks Arch/Linux-related, start with local ArchWiki retrieval.
Setup requirement
This skill requires the local ArchWiki documentation package:
sudo pacman -S arch-wiki-docs
If /usr/share/doc/arch-wiki/html/en/ is missing or empty, warn the user to install arch-wiki-docs with the command above and abort ArchWiki-local troubleshooting. If the extension command is available, the user can also run /archwiki-local-setup to install it when non-interactive sudo/root access permits.
After package/corpus changes, verify local behavior with /archwiki-smoke-test or archwiki_smoke_test({ maxSearchResults: 5 }).
Required workflow
- Start with
archwiki_search({ query, limit: 5, includeSnippets: false }) for Arch/Linux issues.
- Use
archwiki_sections({ page, maxSections: 40-80 }) when the right page is found but the relevant heading is unclear.
- Prefer exact
archwiki_extract({ page, section, maxChars: 4000-8000, maxSections: 2-5 }) for final citations.
- Use query extraction only for exploration, then switch to exact section names when possible.
- Use
archwiki_read only when broad page context is needed.
- Use
archwiki_related when the issue spans subsystems.
- Detect the distro when relevant, especially EndeavourOS or CachyOS, using read-only evidence.
- Load distro-specific reference docs when the distro is known or mentioned.
- Run read-only local diagnostics when system evidence is relevant.
- Compare documentation guidance with observed system state.
- Cite local ArchWiki page paths and section names in final answers.
- Ask before destructive or user-facing system changes.
Source priority
- Local ArchWiki from
/usr/share/doc/arch-wiki/html/en/ via the ArchWiki tools for shared Arch foundations.
- Local distro/system evidence:
/etc/os-release, package metadata, repositories, service status, logs, config files.
- Packaged distro reference notes, especially EndeavourOS and CachyOS.
- Official online ArchWiki, Arch Linux docs, or official distro docs only when local docs are missing, stale, or insufficient.
- Other sources only when necessary and clearly labeled.
Tool usage
archwiki_search({ query, limit, includeSnippets }): find candidate pages. Keep limit at 5 unless exploring broadly; snippets default off.
archwiki_sections({ page, maxSections }): inspect available headings before extracting from large pages.
archwiki_extract({ page, section, maxChars, maxSections }): retrieve focused exact sections; best for final answers.
archwiki_extract({ page, query, maxChars, maxSections }): retrieve query-relevant sections; best for exploration.
archwiki_read({ page, maxChars }): retrieve clean readable page text; use sparingly.
archwiki_related({ page, limit }): discover linked local pages.
archwiki_smoke_test({ maxSearchResults }): verify parser/search/extract/read behavior after package or corpus updates.
Diagnostics policy
Prefer read-only commands first. Examples:
cat /etc/os-release
hostnamectl
pacman-conf --repo-list
uname -a
pacman -Q
pacman -Qi <pkg>
pacman -Qo <file>
systemctl status <unit>
journalctl -b -u <unit>
ip addr
ip route
resolvectl status
loginctl session-status
lsblk -f
findmnt
Avoid mutation without explicit user approval:
pacman -R
pacman -Syu
rm -rf
mkfs.*
systemctl disable <unit>
systemctl mask <unit>
mount # with write-changing intent
Token/output discipline
- Prefer
search -> sections -> exact section extract for final answers.
- Keep search limits small (
limit: 5-10) and snippets off unless needed.
- Use
maxSections around 2-5 and maxChars around 4000-8000 for focused extracts.
- If
omittedSectionCount or truncated: true affects confidence, say so explicitly.
Citation format
Use local source citations like:
Sources:
- /usr/share/doc/arch-wiki/html/en/Systemd.html — Basic systemctl usage
- /usr/share/doc/arch-wiki/html/en/Pacman/Package_signing.html — Signature checking
See references:
references/troubleshooting-policy.md
references/query-expansions.md
references/safety-rules.md
references/arch-based-distros.md
references/distros/endeavouros.md (priority distro)
references/distros/cachyos.md (priority distro)
references/distros/manjaro.md
references/distros/garuda.md
references/distros/artix.md
references/distros/blackarch.md
1---2name: arch-linux-local3description: Always use for Arch Linux and Arch-based distro troubleshooting, especially EndeavourOS and CachyOS, including pacman, systemd/init, NetworkManager/DNS/Wi-Fi, PipeWire/audio, boot/initramfs/mkinitcpio, GPU/Wayland, Bluetooth, filesystems, or package/signature issues. Use local ArchWiki evidence before web sources; the user should not need to explicitly ask for local ArchWiki.4metadata:5 source: https://skillmd.com/skills/firstp1ck/arch-linux-local6---78# Arch Linux Local Troubleshooting910Always use this skill for Arch Linux and Arch-based distribution troubleshooting on this machine. Prioritize EndeavourOS first and CachyOS second when distro context matters. Prefer the installed local ArchWiki (`arch-wiki-docs`) before web searches. The user should not need to say “use local ArchWiki first”; if the issue looks Arch/Linux-related, start with local ArchWiki retrieval.1112## Setup requirement1314This skill requires the local ArchWiki documentation package:1516```bash17sudo pacman -S arch-wiki-docs18```1920If `/usr/share/doc/arch-wiki/html/en/` is missing or empty, warn the user to install `arch-wiki-docs` with the command above and abort ArchWiki-local troubleshooting. If the extension command is available, the user can also run `/archwiki-local-setup` to install it when non-interactive sudo/root access permits.2122After package/corpus changes, verify local behavior with `/archwiki-smoke-test` or `archwiki_smoke_test({ maxSearchResults: 5 })`.2324## Required workflow25261. Start with `archwiki_search({ query, limit: 5, includeSnippets: false })` for Arch/Linux issues.272. Use `archwiki_sections({ page, maxSections: 40-80 })` when the right page is found but the relevant heading is unclear.283. Prefer exact `archwiki_extract({ page, section, maxChars: 4000-8000, maxSections: 2-5 })` for final citations.294. Use query extraction only for exploration, then switch to exact section names when possible.305. Use `archwiki_read` only when broad page context is needed.316. Use `archwiki_related` when the issue spans subsystems.327. Detect the distro when relevant, especially EndeavourOS or CachyOS, using read-only evidence.338. Load distro-specific reference docs when the distro is known or mentioned.349. Run read-only local diagnostics when system evidence is relevant.3510. Compare documentation guidance with observed system state.3611. Cite local ArchWiki page paths and section names in final answers.3712. Ask before destructive or user-facing system changes.3839## Source priority40411. Local ArchWiki from `/usr/share/doc/arch-wiki/html/en/` via the ArchWiki tools for shared Arch foundations.422. Local distro/system evidence: `/etc/os-release`, package metadata, repositories, service status, logs, config files.433. Packaged distro reference notes, especially EndeavourOS and CachyOS.444. Official online ArchWiki, Arch Linux docs, or official distro docs only when local docs are missing, stale, or insufficient.455. Other sources only when necessary and clearly labeled.4647## Tool usage4849- `archwiki_search({ query, limit, includeSnippets })`: find candidate pages. Keep `limit` at 5 unless exploring broadly; snippets default off.50- `archwiki_sections({ page, maxSections })`: inspect available headings before extracting from large pages.51- `archwiki_extract({ page, section, maxChars, maxSections })`: retrieve focused exact sections; best for final answers.52- `archwiki_extract({ page, query, maxChars, maxSections })`: retrieve query-relevant sections; best for exploration.53- `archwiki_read({ page, maxChars })`: retrieve clean readable page text; use sparingly.54- `archwiki_related({ page, limit })`: discover linked local pages.55- `archwiki_smoke_test({ maxSearchResults })`: verify parser/search/extract/read behavior after package or corpus updates.5657## Diagnostics policy5859Prefer read-only commands first. Examples:6061```bash62cat /etc/os-release63hostnamectl64pacman-conf --repo-list65uname -a66pacman -Q67pacman -Qi <pkg>68pacman -Qo <file>69systemctl status <unit>70journalctl -b -u <unit>71ip addr72ip route73resolvectl status74loginctl session-status75lsblk -f76findmnt77```7879Avoid mutation without explicit user approval:8081```bash82pacman -R83pacman -Syu84rm -rf85mkfs.*86systemctl disable <unit>87systemctl mask <unit>88mount # with write-changing intent89```9091## Token/output discipline9293- Prefer `search -> sections -> exact section extract` for final answers.94- Keep search limits small (`limit: 5-10`) and snippets off unless needed.95- Use `maxSections` around 2-5 and `maxChars` around 4000-8000 for focused extracts.96- If `omittedSectionCount` or `truncated: true` affects confidence, say so explicitly.9798## Citation format99100Use local source citations like:101102```txt103Sources:104- /usr/share/doc/arch-wiki/html/en/Systemd.html — Basic systemctl usage105- /usr/share/doc/arch-wiki/html/en/Pacman/Package_signing.html — Signature checking106```107108See references:109- `references/troubleshooting-policy.md`110- `references/query-expansions.md`111- `references/safety-rules.md`112- `references/arch-based-distros.md`113- `references/distros/endeavouros.md` (priority distro)114- `references/distros/cachyos.md` (priority distro)115- `references/distros/manjaro.md`116- `references/distros/garuda.md`117- `references/distros/artix.md`118- `references/distros/blackarch.md`