- 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.
FAQ
게시자에게서 .claude/skills/edit-catalog/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/ajnart/self-host에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.