- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ajnart/self-host --skill edit-catalog -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ajnart/self-host --skill edit-catalog -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ajnart/self-host --skill edit-catalog -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add ajnart/self-host --skill edit-catalog -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/ajnart/self-host/tree/HEAD/.claude/skills/edit-catalog來自發布者
Read CONTEXT.md for App, Recipe and Catalog, and docs/agents/generated-data.md for what is derived from what. For a new App, copy the shape of the last one: git show --stat ca78641b (Cleanuparr).
Pick the branch, then run its steps in order:
internal/catalog/specs/<id>.yaml exists, edit that file. Otherwise edit the App's package under internal/apps/; its directory is the id without hyphens or a shorter name (paperless-ngx lives in paperlessngx), so find it with grep -rl 'ID: "<id>"' internal/apps.defaultRecipes in internal/catalog/recipes.go, then steps 6, 7 and 8.unavailable in internal/catalog/catalog.go with the reason and the issue that tracks the way back, then steps 6, 7 and 8.Take the image, tag, ports, volumes and env from the project's own docs or registry page, not from memory or an aggregator.
Done: each fact has a source URL you can put in the PR body.
Search internal/apps/, internal/catalog/, dcm/src/tools/ and ALIASES in dcm/src/lib/selfhost.ts for the product under every spelling (actualbudget against actual-budget).
Done: no hit, so you add one App, or you edit the existing App and add none. Every Container for the same product in dcm/src/tools has the App's id or an ALIASES key for it; otherwise DCM lists the product twice. Add the missing ALIASES entry in the same change.
Write docs/catalog/traps/<id>.md (it keeps the hyphens) and then the App. The description is at most 100 characters in plain words (internal/catalog/descriptions_test.go enforces it). Extra services are named <id>-....
setup.kind: no-account), write internal/catalog/specs/<id>.yaml: copy specs/ollama.yaml and read "Declarative spec" in docs/catalog/adding-apps.md for the keys. No Go, no test and no registration; <id>.yaml is the file name and its first line is # Traps: docs/catalog/traps/<id>.md.internal/apps/<name>/<name>.go and its test, where <name> is the id without hyphens. Info().ID is the id itself. Setup follows internal/helpers/ and the Protected invariants in AGENTS.md: credentials stay in the private Project .env, and public Host settings are filtered before output.Done: go test ./internal/appspec/ ./internal/catalog/ passes for a spec, go test ./internal/apps/<name>/ for Go.
A spec is embedded and needs no registration; skip to step 5. For a Go App, run go run ./tools/registrygen. It scans internal/apps/ and rewrites internal/catalog/apps_gen.go; never edit that file by hand.
Done: git diff internal/catalog/apps_gen.go shows your App's import and registration, and go test ./internal/catalog/ passes. A parity_test.go failure on a ported App means a legacy fact changed: add a deviations entry with the reason; leave legacy-facts.json as it is.
Usually nothing. The icon defaults to svg/<id>.svg on Dashboard Icons, and sitegen checks that a new path exists. Add the id to iconOverrides in tools/sitegen/icons.go only when the icon lives at another path ("" for none). The star repository comes from Docs when it is a github.com/<owner>/<repo> URL; otherwise add the upstream repository to starRepoOverrides in tools/sitegen/stars.go ("" for none). Nothing fails when an App has no repository; its star count never appears.
Done: go run ./tools/sitegen passes, and Docs is the GitHub repository or the id is in starRepoOverrides.
go run ./tools/sitegen
Add standalone_guide (or StandaloneGuide() in Go) only when its standalone Compose needs a sentence of guidance; sitegen fails when the guide names a variable or folder the converted Compose lacks.
Done: a second run changes nothing, and git status shows only your files plus site/src/data/catalog.json and dcm/src/data/selfhost.json.
App and Recipe counts are computed, so no README or e2e/acceptance.md number moves. Regenerate the two files that record the Catalog:
go test ./internal/tui -update
go test ./e2e -run TestAcceptanceInventory -update
Read both diffs: in the goldens only the N more line moves, and e2e/testdata/inventory.json gains or loses the App.
Done: go test ./e2e/ ./internal/tui passes and git status shows no README.md change.
Run the Go gate from AGENTS.md, then the web gate: generated data changed. Never run Docker, e2e or the installer.
Done: both exit 0 and git status shows only files that belong to this change.
Catalog edits in YAML or Go. Use for any task that adds an App, changes an App's image, port, Compose, env, notes or StandaloneGuide (even a one-line image bump), changes a Recipe, or hides or unhides
---name: edit-catalogdescription: Catalog edits in YAML or Go. Use for any task that adds an App, changes an App's image, port, Compose, env…---# .claude/skills/edit-catalog/SKILL.md總覽
Catalog edits in YAML or Go. Use for any task that adds an App, changes an App's image, port, Compose, env, notes or StandaloneGuide (even a one-line image bump), changes a Recipe, or hides or unhides an App. Each of these changes generated site and DCM data and the generated e2e inventory. DCM-only Containers go to add-container; Homarr wiring goes to docs/agents/homarr-integrations.md.
常見問題
從發布者下載 .claude/skills/edit-catalog/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/ajnart/self-host。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。