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

skillshare-changelog — скилл для Claude Code

Скилл skillshare-changelog собирает запись в CHANGELOG.md из коммитов в conventional-формате и переносит её на страницу changelog сайта.

MIT ★ 3 269 обновлён 2026-10-29

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

Что делает skillshare-changelog

Скилл берёт коммиты между прошлым опубликованным тегом и головой Release PR, раскладывает их по типам conventional commits и пишет из этого запись для CHANGELOG.md. Разделы привычные: feat уходит в New Features, fix в Bug Fixes, perf в Performance, breaking changes — в отдельный блок с заметками о миграции. Тесты, CI и правки документации в заметки не попадают.

Перед работой скилл просит запустить python3 scripts/ai-context.py release: этот топик задаёт правила доступа и синхронизации. Версию он не выбирает, её берут из .github/release-please-manifest.json на ветке Release PR. Тон и структуру скилл копирует у 2-3 последних записей в CHANGELOG.md, потому что жёсткого шаблона нет.

Дальше python3 scripts/release/release.py sync и check внутри devcontainer переносят свежую запись на website/src/pages/changelog.md и сохраняют frontmatter со старыми записями. Публикация, теги и анонсы в область скилла не входят — для полного цикла есть /release.

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

  • собрать запись CHANGELOG.md из коммитов между тегами
  • разложить коммиты по разделам New Features, Bug Fixes и Performance
  • переписать историю изменений с точки зрения пользователя
  • синхронизировать запись со страницей changelog сайта
  • вычистить из заметок тесты, CI и правки документации

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

  • Собери запись в CHANGELOG.md для v0.17 из коммитов с прошлого тега
  • Что изменилось с последнего релиза? Оформи это как новую запись в changelog
  • Обнови CHANGELOG.md и синхронизируй website/src/pages/changelog.md

Как установить skillshare-changelog

1Через Skills CLI (Vercel)

npx skills add runkids/skillshare --skill skillshare-changelog -a claude-code

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

~/.claude/skills/skillshare-changelog/SKILL.md

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

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

Вопросы о skillshare-changelog

Как установить skillshare-changelog в Claude Code?

Выполните npx skills add runkids/skillshare --skill skillshare-changelog -a claude-code. Файл скилла появится по пути ~/.claude/skills/skillshare-changelog/SKILL.md.

Что делает skillshare-changelog?

Читает коммиты в заданном диапазоне тегов, группирует их по типам conventional commits и пишет пользовательскую запись в CHANGELOG.md. Затем переносит её на страницу changelog сайта.

Нужен ли Python для работы скилла?

Да. Сначала запускается python3 scripts/ai-context.py release, а синхронизация сайта идёт через python3 scripts/release/release.py sync и check в devcontainer.

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

SKILL.md · MIT
---
name: skillshare-changelog
description: >-
  Generate CHANGELOG.md entry from recent commits in conventional format. Also
  syncs the website changelog page. Use this skill whenever the user asks to:
  generate a changelog, document what changed between tags, or create a new
  CHANGELOG entry. If you see requests like "write the changelog for v0.17",
  "what changed since last release", this is the skill to use. Do NOT manually
  edit CHANGELOG.md without this skill — it ensures proper formatting,
  user-perspective writing, and website changelog sync. For full release
  workflows (Release PR review, tests, draft assets, publication, announcements),
  use /release instead.
argument-hint: "[tag-version]"
metadata:
  targets: [claude, universal]
---

Review or generate a user-facing changelog entry. Prefer the open Release Please PR and its manifest version for an upcoming release. For historical work, $ARGUMENTS specifies the requested tag or commit range.

**Scope**: This skill updates `CHANGELOG.md` and syncs the website changelog (`website/src/pages/changelog.md`). It does NOT generate RELEASE_NOTES, choose a new version, or handle the full release workflow — use `/release` for that.

Before acting, run `python3 scripts/ai-context.py release`. That topic is the source of truth for authorization, changelog content and synchronization rules; this skill retains the entry-generation workflow.

## Workflow

### Step 1: Determine Version Range

For an upcoming release, work on the Release PR branch and read `.github/release-please-manifest.json`. Verify the latest published tag and use its range to the Release PR head. Keep the proposed version; this skill does not authorize a version change. Tags may exist for unpublished drafts, so do not assume the highest local tag is the latest published release.

For historical work, use the user-requested tags or range.

### Step 2: Collect Commits

```bash
git log <previous-published-tag>..<release-pr-head-or-requested-tag> --oneline --no-merges
```

Review the generated Release Please entry before writing. Preserve useful manual examples and migration notes. Do not add a second entry for the same version.

### Step 3: Categorize Changes

Group commits by conventional commit type:

| Prefix | Category |
|--------|----------|
| `feat` | New Features |
| `fix` | Bug Fixes |
| `perf` | Performance |
| breaking change | Breaking Changes and migration notes |
| `revert` | Reverts, when user-visible |

Exclude test-only, CI-only, pure refactoring, documentation-only and internal maintenance entries from published notes.

### Step 4: Read Existing Entries for Style Reference

Before writing, read the most recent 2-3 entries in `CHANGELOG.md` to match the established tone and structure. The style evolves over time — always match the latest entries, not a hardcoded template.

### Step 5: Write User-Facing Entry

Write from the **user's perspective**. Only include changes users will notice or care about.

**Include**:
- New features with usage examples (CLI commands, code blocks)
- Bug fixes that affected user-visible behavior
- Breaking changes (renames, removed flags, scope changes)
- Performance improvements users would notice

**Exclude**:
- Internal test changes (smoke tests, test refactoring)
- Implementation details (error propagation, internal structs)
- Dev toolchain changes (Makefile cleanup, CI tweaks)
- Pure documentation adjustments

**Wording guidelines**:
- Don't use "first-class", "recommended" for non-default options
- Be factual: "Added X" / "Fixed Y" / "Renamed A to B"
- Include CLI example when introducing a new feature
- Use em-dash (`—`) to separate feature name from description
- Group related features under `####` sub-headings when there are 2+ distinct areas

### Step 6: Update CHANGELOG.md

Edit the existing generated entry on the Release PR branch. If the requested historical entry does not exist, insert it at the appropriate position. Match the style of the most recent entries.

Structural conventions (based on actual entries):
```markdown
## [X.Y.Z] - YYYY-MM-DD

### New Features

#### Feature Area Name

- **Feature name** — description with `inline code` for commands and flags
  ```bash
  skillshare command --flag    # usage example
  ```
  Additional context as sub-bullets or continuation text

#### Another Feature Area

- **Feature name** — description

### Bug Fixes

- Fixed specific user-visible behavior — with context on what changed
- Fixed another issue

### Performance

- **Improvement name** — description of what got faster

### Breaking Changes

- Renamed `old-name` to `new-name`
```

Key style points:
- Version numbers use `[X.Y.Z]` without `v` prefix in the heading
- Feature bullets use `**bold name** — em-dash description` format
- Code blocks use `bash` language tag for CLI examples
- Bug fixes describe the symptom, not the implementation
- Only include sections that have content (skip empty Performance, Breaking Changes, etc.)

### Step 7: Sync Website Changelog

The website has its own changelog page at `website/src/pages/changelog.md`. After updating `CHANGELOG.md`, sync the new entry to the website version.

**Differences between the two files**:
- Website file has MDX frontmatter (`title`, `description`) and an intro paragraph — preserve these, don't overwrite
- Website file has a `---` separator after the intro, before the first version entry
- The release entries themselves are identical in content

For an upcoming Release PR, run inside the devcontainer:

```bash
python3 scripts/release/release.py sync
python3 scripts/release/release.py check
```

The helper normalizes the generated version heading, replaces or prepends only the newest website entry, and synchronizes the built-in skill metadata to the already proposed manifest version. It preserves website frontmatter, intro and historical entries. It does not choose or bump a version.

For historical corrections, edit the matching entry in both files directly; the helper handles only the current manifest release. Review the diff and run `python3 scripts/ai-context.py check`.

## Rules

Apply the `release` topic. This adapter is changelog-only and does not broaden authorization to commit, tag, push or publish.

© runkids · MIT · runkids/skillshare

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

Все скиллы по теме «Git и GitHub» →
changelog-gen rohitg00 Плагин changelog-gen генерирует списки изменений из истории Git с разбором формата Conventional Commits. Собирает журнал релизов прямо в терминале агента. ★ 2 858звёзд репо devkit.generate-changelog Giuseppe Trisciuoglio Команда devkit.generate-changelog собирает CHANGELOG.md по стандарту Keep a Changelog из истории Git и дописывает секции перед релизом, чтобы не переписывать их руками. CX Codex +1 ★ 372звёзд репо changelog-automation Seth Hobson Скилл changelog-automation для Claude Code собирает changelog и release notes из коммитов, PR и релизов. Настраивает процесс релизов и единые правила коммитов. CX Codex +1 13 733установок Changelog Generator claude-office-skills Скилл Changelog Generator группирует коммиты и списки правок в готовые описания релизов. Пригодится разработчикам и лидам перед публикацией новой версии проекта. CX Codex +1 4 800установок om-auto-update-changelog open-mercato Скилл om-auto-update-changelog собирает запись в CHANGELOG.md по всем PR, влитым с прошлого релиза, и отдаёт правку в om-auto-create-pr. Пригодится в момент выпуска версии. CX Codex +1 4 100установок changelog-writer patricio0312rev Скилл changelog-writer собирает CHANGELOG и release notes из git-коммитов, заголовков PR и ссылок на issues. Пригодится перед релизом, когда нужно разложить изменения по типам и подобрать версию. CX Codex +1 631установок

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

Весь набор →
skillshare-update-docs Скилл skillshare-update-docs синхронизирует документацию проекта skillshare с кодом на Go и сверяет флаги CLI с исходниками. Пригодится после добавления новых команд или опций. CX Codex +1 ★ 3 269звёзд репо skillshare-code-review Скилл skillshare-code-review для Claude Code проверяет изменения в skillshare до создания PR или в открытом pull request. Запускается по просьбе разобрать diff, ветку, диапазон коммитов или PR. CX Codex +1 ★ 3 269звёзд репо skillshare-windows-utm Скилл skillshare-windows-utm проверяет работу skillshare на гостевой Windows в UTM: собирает коммит в devcontainer, передаёт бинарники в виртуалку и запускает E2E-тесты путей и симлинков. CX Codex +1 ★ 3 269звёзд репо skillshare-implement-feature Скилл skillshare-implement-feature ведёт реализацию Go-фичи от спецификации до проверок по TDD. Подходит для новых CLI-команд, флагов и внутренних пакетов. CX Codex +1 ★ 3 269звёзд репо skillshare-devcontainer Скилл skillshare-devcontainer гоняет команды ss, Go-тесты и веб-интерфейс skillshare внутри devcontainer, чтобы на macOS не получить тихо неверный результат. CX Codex +1 ★ 3 269звёзд репо skillshare-release Скилл skillshare-release помогает готовить и проверять релизы skillshare: сверяет PR от Release Please, обновляет документацию и инспектирует черновики. CX Codex +1 ★ 3 269звёзд репо skillshare Управляет ресурсами Skillshare CLI: синхронизирует скиллы и настройки между инструментами, проверяет конфигурацию и работает с общей памятью. CX Codex +1 ★ 3 269звёзд репо skillshare-ui-website-style Скилл skillshare-ui-website-style для Claude Code держит дизайн-систему Skillshare в React-дашборде и сайте на Docusaurus. Покрывает правку стилей и добавление компонентов без расхождения с токенами. CX Codex +1 ★ 3 269звёзд репо

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

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