- 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 จะดึง SKILL.md นี้จาก GitHub และเพิ่มลงในสกิลที่ 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 ของสกิลในแชต