# Doc Changelog Writer

> Description

- Skill: `jiayaoqijia/doc-changelog-writer` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add jiayaoqijia/doc-changelog-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiayaoqijia/doc-changelog-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jiayaoqijia (https://skillmd.com/u/jiayaoqijia)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jiayaoqijia/doc-changelog-writer

---


## Description

Generate CHANGELOG.md entries from git commits. Automatically categorizes commits into features, fixes, and breaking changes for release documentation.

## Inputs

```json
{
  "commits": ["list of commit messages"],
  "version": "1.0.0",
  "date": "2026-02-06"
}
```

## Outputs

```json
{
  "ok": true,
  "data": {
    "changelog": "Changelog markdown content"
  }
}
```

## Usage

### Demo Mode
```bash
python scripts/main.py --demo
```

### Generate Changelog
```bash
echo '{"commits": ["feat: add new endpoint", "fix: memory leak"], "version": "1.0.0"}' | python3 scripts/main.py
```

## Examples

### Example 1: Create Release Notes
```bash
$ echo '{"commits": ["feat: add new feature", "fix: bug fix"], "version": "1.0.0", "date": "2026-02-06"}' | python3 scripts/main.py
{
  "ok": true,
  "data": {
    "changelog": "## [1.0.0] - 2026-02-06\n\n### Features\n- add new feature\n\n### Fixes\n- bug fix"
  }
}
```

## Error Handling

When an error occurs, the skill returns:

```json
{
  "ok": false,
  "error": "Error description",
  "details": {
    "commits": "Invalid commit list"
  }
}
```