Ubuntu documentation-first workflow for Ubuntu-specific questions, maintenance, updates, upgrades, package management, system administration, service troubleshooting, networking, storage, logs, release behavior, and diagnostics. Use when the request materially depends on Ubuntu or Ubuntu-specific tooling/behavior such as Ubuntu release behavior, `apt`/`apt-get`/`dpkg`/`snap`, `systemd`/`systemctl`/`journalctl`, Netplan, NetworkManager, package repair, repository/key issues, service failures, boot issues, mounts/`fstab`, permissions, users/groups, or non-trivial Ubuntu maintenance/troubleshooting. Do not use for generic shell, git, Python, Docker, or Linux questions unless Ubuntu-specific semantics matter.
Use a docs-first workflow for Ubuntu-specific work. Prefer Ubuntu manpages at https://manpages.ubuntu.com/manpages/ for command and utility behavior, use official Ubuntu documentation when the task is broader than a manpage, consult cached local copies under .Ubuntu-Encyclopedia/ before re-fetching, and record useful authoritative excerpts plus environment-specific operational learnings so future work gets faster and safer.
This skill is for the Ubuntu distro/admin layer. It should trigger for Ubuntu-specific package, service, networking, storage, and release-behavior questions — not for generic Linux/shell/dev tooling questions that merely happen to be asked from an Ubuntu machine.
Classify the task
Check local cache first
.Ubuntu-Encyclopedia/ as the local knowledge/cache root..Ubuntu-Encyclopedia/manpages/manpages.ubuntu.com/....Ubuntu-Encyclopedia/docs/....Ubuntu-Encyclopedia/notes/components/....Ubuntu-Encyclopedia/notes/patterns/....Ubuntu-Encyclopedia/inventory/...Consult authoritative Ubuntu sources before answering or acting
Cache consulted docs locally
.Ubuntu-Encyclopedia/manpages/manpages.ubuntu.com/.....Ubuntu-Encyclopedia/docs/....scripts/cache_manpage.py or scripts/cache_doc.py when appropriate.Separate authoritative documentation from local observations
.Ubuntu-Encyclopedia/manpages/.....Ubuntu-Encyclopedia/docs/.....Ubuntu-Encyclopedia/notes/components/.Ubuntu-Encyclopedia/notes/patterns/.Ubuntu-Encyclopedia/inventory/Record useful local learnings
Use this workspace-local root for cache and notes:
.Ubuntu-Encyclopedia/Expected structure:
.Ubuntu-Encyclopedia/manpages/manpages.ubuntu.com/....Ubuntu-Encyclopedia/docs/....Ubuntu-Encyclopedia/notes/components/....Ubuntu-Encyclopedia/notes/patterns/....Ubuntu-Encyclopedia/inventory/...Use scripts/init_workspace.py to create or repair the expected directory structure.
.Ubuntu-Encyclopedia/notes/components/<component-name>.md.Ubuntu-Encyclopedia/notes/patterns/<topic>.md.Ubuntu-Encyclopedia/inventory/*.md.Ubuntu-Encyclopedia/manpages/manpages.ubuntu.com/....Ubuntu-Encyclopedia/docs/...scripts/init_workspace.py — create or repair the .Ubuntu-Encyclopedia/ directory tree.scripts/cache_manpage.py — fetch and cache a consulted Ubuntu manpage under .Ubuntu-Encyclopedia/manpages/....scripts/cache_doc.py — fetch and cache a consulted official Ubuntu docs page under .Ubuntu-Encyclopedia/docs/....references/workflow.md — detailed operating workflow and evidence-handling rules.references/cache-layout.md — canonical .Ubuntu-Encyclopedia/ directory structure.references/topic-map.md — useful Ubuntu topic groupings for faster authoritative lookup.