Skip to content

docs: add SKILL.md update procedures for all 47 apps - #41

Open
mrishab wants to merge 1 commit into
masterfrom
docs/update-skills-per-app
Open

docs: add SKILL.md update procedures for all 47 apps#41
mrishab wants to merge 1 commit into
masterfrom
docs/update-skills-per-app

Conversation

@mrishab

@mrishab mrishab commented Aug 9, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a SKILL.md file in each app directory documenting the official upgrade/update procedure. This makes it easy to look up how to update any app without hunting through external docs.

What's included

All 47 apps in the repo now have an update SKILL.md covering:

Apps with special upgrade requirements

App Key constraint
Nextcloud ⚠️ Sequential major versions only (can't skip)
Immich ⚠️ Must read release notes for breaking changes
Airflow ⚠️ Sequential major versions + DB migrations
ELK ⚠️ Elasticsearch must upgrade one major at a time

Standard apps (tag bump + docker compose pull/up)

adguardhome, affine, bentopdf, cadvisor, cloudflared, codeserver, ddns, deluge, dockovpn, duplicati, epg, freshrss, ghost, grafana, hermes, homarr, jupyter, lazylibrarian, n8n, nexus, nzbget, ollama, ombi, open-webui, pgadmin, plex, postiz, prowlarr, registry, sftpgo, sonarqube, stirling-pdf, tautulli, threadfin, upsnap, wikijs

Infrastructure & multi-service apps

  • media server (Sonarr + Radarr + Lidarr + Bazarr — independent updates)
  • reverse-proxy (nginx + certbot + exporter)
  • load balancer (nginx)
  • Jellyfin / Plex (+ GPU transcoding verification)
  • calibre (calibre + calibre-web dual container)

File format

Each SKILL.md follows a consistent structure:

  • Frontmatter (name, description)
  • How to check for new versions (link to GitHub releases / Docker Hub)
  • Exact image field to update in docker-compose.yml
  • Any special migration or database steps
  • Verification steps after upgrade

Adds a SKILL.md file in each app directory documenting the official
upgrade/update procedure. Covers:

- Major apps with special procedures (Nextcloud: sequential only,
  Immich: read release notes first, Airflow: sequential versions)
- Standard apps (simple tag bump + docker compose pull/up)
- Infrastructure apps (reverse-proxy, lb)
- Media stack apps (Sonarr, Radarr, Lidarr, Bazarr)

Each SKILL.md includes:
- How to check for new versions
- The exact image field to update
- Any special migration/database steps
- Verification steps after update
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant