К основному содержанию
скилл CX Codex

submit-catalog-update — скилл для Claude Code

Скилл submit-catalog-update формирует и отправляет issue для обновления расширения companion в каталоге spec-kit. Пригодится мейнтейнерам при выпуске минорных и мажорных версий.

MIT ★ 110 обновлён 2026-11-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add alfredoperez/speckit-companion --skill submit-catalog-update -a claude-code
Открыть на GitHub

Что делает submit-catalog-update

Скилл готовит заявку на обновление каталога расширений в репозитории github/spec-kit. По регламенту каталога прямые пулл-реквесты отклоняются, поэтому публикация оформляется только через issue по шаблону Extension Submission.

Внутри запускается скрипт render_submission.py, который скачивает актуальный шаблон .github/ISSUE_TEMPLATE/extension_submission.yml из апстрима и строит текст без ручной подгонки заголовков. Данные берутся из apps/speckit-extension/extension.yml и свежих записей в CHANGELOG.md между зафиксированной версией и текущим релизом.

Инструмент рассчитан только на мажорные и минорные релизы: патчи в каталог не отправляются, так как пользователи патчей получают сборку companion-latest. Для работы требуются утилиты gh, git, curl, python3 и авторизация в GitHub CLI.

Какие задачи решает

  • оформить заявку на обновление версии расширения в каталоге spec-kit
  • собрать описание релиза из CHANGELOG без расхождения заголовков с шаблоном
  • проверить наличие дубликатов issue перед отправкой тикета
  • подтвердить контрольные проверки манифеста и архива релиза

Примеры запросов агенту

  • Обнови запись companion в каталоге spec-kit
  • /submit-catalog-update
  • Создай тикет на обновление каталога для новой версии

Как установить submit-catalog-update

1Через Skills CLI (Vercel)

npx skills add alfredoperez/speckit-companion --skill submit-catalog-update -a claude-code

2Вручную: положить файлы

~/.claude/skills/submit-catalog-update/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/submit-catalog-update/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о submit-catalog-update

Как установить submit-catalog-update в Claude Code?

Выполните команду npx skills add alfredoperez/speckit-companion --skill submit-catalog-update -a claude-code в терминале.

Почему скилл создаёт issue, а не открывает pull request?

Репозиторий github/spec-kit отклоняет прямые правки файла каталога через PR. Все обновления принимаются мейнтейнерами исключительно через форму Extension Submission.

Когда следует запускать этот скилл?

Команда нужна только после публикации минорного или мажорного релиза speckit-ext-v$V. Для патч-версий отправка блокируется, потому что они подтягиваются автоматически через latest-архив.

Исходный текст

SKILL.md · MIT
---
name: submit-catalog-update
description: File the spec-kit community-catalog update for the `companion` extension as an Extension Submission ISSUE on github/spec-kit (never a PR — direct catalog PRs are rejected). Renders the issue body from the LIVE upstream issue-form template so our headings can't drift from theirs. Minor and major releases only. Use when the user says "/submit-catalog-update", "update the catalog", "file the catalog issue", "the catalog is stale", or right after /publish-speckit-ext cuts a minor or major spec-kit-extension release.
allowed-tools: Bash(gh *), Bash(curl *), Bash(python3:*), Bash(git *), Bash(unzip *), Bash(mkdir *), Bash(uname *), Bash(specify *), Read
---

# Submit a community-catalog update

The catalog entry for `companion` is version-pinned, so a release only reaches catalog users once the entry is bumped. This files that bump.

Deliberately no `Edit`/`Write`: this skill writes to a third-party repository and must not be able to mutate ours.

## Hard-won rules (do not skip)

1. **Never open a PR against `extensions/catalog.community.json`.** github/spec-kit#3937 was closed unmerged — *"Updates to extensions must use the extension submission issue template."* The publishing guide is explicit: *"Do not open a pull request directly to edit `extensions/catalog.community.json`."* Both first listings and version updates go through the **[Extension Submission] issue**. If you find yourself typing `gh pr create` against `github/spec-kit`, you are in the wrong workflow.
2. **Never hardcode the `###` headings.** GitHub serializes an issue form as `### <label>` / blank / value, and maintainers' validation parses that. `render_submission.py` fetches the live `.github/ISSUE_TEMPLATE/extension_submission.yml` and renders from its labels — including the `(optional)` suffixes. If it cannot fetch the template it aborts; it never falls back to a remembered shape, because that fallback is the failure this skill exists to prevent.
3. **The download URL is the version-pinned asset** — `…/releases/download/speckit-ext-v$V/companion-$V.zip`. Never `companion-latest/companion.zip`: the catalog requires the declared version to equal the downloaded bits. This issue body is the only place a pinned URL belongs, and it is generated into a scratch dir, never committed.
4. **Minor and major only.** A patch does not touch the catalog; patch users ride `companion-latest`. Compare against the catalog's *current pin*, not against `.0` — going 0.11.0 → 0.20.2 is a minor bump and correctly pins at the newest patch of the new line.
5. **Never rebuild the catalog JSON.** The script deep-copies the live entry and applies deltas, because that entry carries `verified`, `downloads`, `stars`, and `created_at` which exist nowhere in `extension.yml`. Rebuilding drops them and reads as a destructive edit.
6. **Do not pass `--label`.** We hold only `pull` on github/spec-kit; `gh issue create --label` errors for a user without triage rights and nothing gets filed. Maintainers apply `extension-submission` at triage — that is the documented flow.
7. **`--body-file`, never `--body`.** The body carries em dashes, backticks, `$`, and fenced blocks.
8. **The `sha256` comes from the pinned asset, never from the live entry.** The deep copy in rule 5 carries the previous release's checksum, and Spec Kit's bot hashes the download and fails on a mismatch; `render_submission.py` recomputes it, so never hand-edit it back. If validation fails anyway, fix the field in the issue body and comment once: the bot re-runs only when a maintainer re-applies `extension-submission`, which we cannot do.

## Steps

1. **Resolve the version.** `V` = `extension.version` from `apps/speckit-extension/extension.yml`. Everything keys off it; the script aborts if it disagrees with what you pass.

2. **Confirm the shape of the run.** Working tree clean and on `main`; `speckit-ext-v$V` exists as a release; the pinned asset returns 200 and unzips to a single `companion-$V/` whose manifest reports `$V`:
   ```bash
   git status --porcelain && git branch --show-current
   gh release view speckit-ext-v$V --json tagName
   curl -sIL -o /dev/null -w '%{http_code}\n' \
     https://github.com/alfredoperez/speckit-companion/releases/download/speckit-ext-v$V/companion-$V.zip
   ```

3. **Read the cadence verdict.** Fetch the live entry's `version`. If `$V` is only a patch ahead of it, **stop** and say patch fixes ride `companion-latest`. If the entry already carries `$V`, stop — nothing to submit. If there is no `companion` entry at all, this is a first listing, not an update: say so and confirm before continuing.

4. **Check for a duplicate before doing any work.** Two passes, because titles get reworded but field values do not:
   ```bash
   gh issue list --repo github/spec-kit --state all --limit 100 \
     --search 'in:title "[Extension]" "Companion" author:@me' --json number,title,state,url,body
   ```
   Then parse the value under the live template's `Version` heading out of each hit. Any issue — open or closed — already carrying `$V` means it is filed; stop. An **open** issue for an older version is still in triage, so comment on it rather than opening a second.

5. **Review the drift diff.** Run the renderer and read `report.json`'s `catalog_now` against `proposed`. Get explicit approval for anything that is not a version bump — `description`, `tags`, and `category` are editorial changes and must never ride along silently.

6. **Draft the two human fields.** `Key Features` is seeded from every `## [x.y.z]` section of `apps/speckit-extension/CHANGELOG.md` strictly between the catalog's pin and `$V` — everything the catalog has never seen. Five to eight bullets, `**Bold lead** — what it means for a user`. Every bullet must trace to a changelog line or a shipped command; invent nothing. `Example Usage` is raw content with **no inner fence** (the template already wraps it in ```` ```markdown ````, and the accepted #2926 submission has no nested fence). `Testing Details` states what was actually run — `uname -sr`, `specify --version`, and the real scenarios.

7. **Attestation gate — ask once.** The script mechanically proves the manifest, README, LICENSE, release, command files, and id convention. It cannot prove: all commands execute without errors · documentation is complete and accurate · no security vulnerabilities identified · tested on at least one real project. List those four, plus a confirmation that Testing Details describes what actually happened, and require an explicit yes. Anything else aborts. Never tick an attestation the user did not give.

8. **Render.**
   ```bash
   python3 .claude/skills/submit-catalog-update/render_submission.py \
     --version $V --root . --category process --description "<catalog copy>" \
     --features-file $S/features.md --example-file $S/example.md \
     --testing-details-file $S/testing.md --context-file $S/context.md \
     --attest yes --auto-checks-passed yes \
     --out-body $S/body.md --out-title $S/title.txt --out-report $S/report.json
   ```
   `--category`/`--description` default to the live values; pass them only for a deliberate change. Exit 3 means the template grew a required field the script cannot fill — read the message, add a filler, re-run. Never work around a gate.

9. **Show the full body and title verbatim.** No summarizing. Confirm by eye: headings carry the `(optional)` suffixes; the catalog fence is `json` and preserves `verified`/`downloads`/`stars`/`created_at`; the download URL is pinned; every required checkbox is `[x]`. Cheap cross-check — the heading set should be identical to the accepted submission:
   ```bash
   diff <(gh issue view 2926 --repo github/spec-kit --json body --jq .body | grep '^### ' | sort) \
        <(grep '^### ' $S/body.md | sort)
   ```

10. **Re-check for duplicates**, then file:
    ```bash
    gh issue create --repo github/spec-kit \
      --title "$(cat $S/title.txt)" --body-file $S/body.md
    ```

11. **Verify what landed.** Diff the stored body against what you sent, normalizing trailing newlines — GitHub appends one, which is not mangling:
    ```bash
    diff <(sed -e :a -e '/^\n*$/{$d;N;ba' -e '}' $S/body.md) \
         <(gh issue view <n> --repo github/spec-kit --json body --jq .body | sed -e :a -e '/^\n*$/{$d;N;ba' -e '}')
    ```
    Any real difference means the create path mangled something.

12. **Report** the issue URL, the version transition, the template SHA rendered against, and any drift the report listed. Say plainly that maintainers apply `extension-submission` at triage, which starts automated validation — no label request, no follow-up PR — and that existing users are unaffected meanwhile because they update through `companion-latest`.

© alfredoperez · MIT · alfredoperez/speckit-companion

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
gh-axi Kun Chen (kunchenguid) Скилл gh-axi для Claude Code управляет GitHub через CLI: от issue и pull request до релизов и Actions. Агент подключает его для задач, связанных с GitHub. CX Codex +1 10 400установок context-mode-ops mksglu Скилл context-mode-ops для Claude Code запускает 10–20 параллельных субагентов для работы с GitHub-репозиторием. Включается при триаже issues, ревью PR и выпуске версий. CX Codex +1 1 700установок release-management OrchestKit Скилл release-management выпускает релизы на GitHub через gh release: подбирает версию по semver и собирает заметки из смёрдженных PR. Пригодится при тегировании и публикации changelog. CX Codex +1 220установок groove-admin-update andreadellacorte Скилл groove-admin-update для Claude Code обновляет скиллы groove и применяет миграции к локальному состоянию. Обновляет конфиг и память после выхода новой версии. CX Codex +1 529установок pack-submit aeonfun Скилл pack-submit для Claude Code. Упаковывает скилл в публичный репозиторий и открывает PR в реестр aeon, делая его доступным другим агентам. CX Codex +1 ★ 797звёзд репо github-release jezweb Скилл github-release готовит GitHub-релиз: проверяет код перед публикацией, создаёт тег и выпускает релиз через gh. Нужен перед открытой публикацией репозитория. CX Codex +1 1 400установок

Из того же набора83

Весь набор →
publish-all Команда publish-all для Claude Code выпускает четыре компонента проекта, когда изменения готовы и прошли QA. CX Codex +1 ★ 110звёзд репо speckit.companion.doctor Команда speckit.companion.doctor проверяет здоровье пайплайна спецификаций: находит незавершённые шаги, пропущенные тесты, утечки задач и ложные отметки о дрифте. Работает только на чтение. CX Codex +1 ★ 110звёзд репо speckit.plan Субагент speckit.plan проходит этапы планирования по шаблону и создаёт исследовательские и проектные артефакты. Запускайте его после подготовки спецификации функции. CX Codex +1 ★ 110звёзд репо speckit.taskstoissues Субагент speckit.taskstoissues для Claude Code превращает задачи из tasks.md в пронумерованные GitHub-issues, сохраняя порядок зависимостей. Создаёт issues из плана задач. CX Codex +1 ★ 110звёзд репо feature-clip Скилл feature-clip ведёт сборку коротких зацикленных роликов SpecKit Companion от захвата в Storybook до файлов для сайта и документации. CX Codex +1 ★ 110звёзд репо publish-speckit-ext Команда publish-speckit-ext для публикации расширения spec-kit в релиз на GitHub. Позволяет другим разработчикам устанавливать расширение через каталог без локального клона репозитория. CX Codex +1 ★ 110звёзд репо speckit.constitution Субагент speckit.constitution создаёт и актуализирует конституцию проекта в .specify/memory/constitution.md на основе принципов команды. CX Codex +1 ★ 110звёзд репо ship-ticket Команда ship-ticket берёт уже готовую ветку, проверяет сборку и проводит изменения через код-ревью, PR и слияние. Она пригодится, когда код уже написан в SpecKit Companion. CX Codex +1 ★ 110звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой