changelog-narratorlisted
Install: claude install-skill KirKruglov/claude-skills-kit
# Changelog Narrator
This skill compares two versions of a business document and produces a structured, human-readable changelog — without git, CLI, or "Track Changes". Designed for non-technical users who receive updated drafts and need to understand what changed at a glance.
**Input:**
- Two local files (`.md` or `.txt`) in the Cowork workspace — old version (v1) and new version (v2)
- Optional: version labels if filenames are ambiguous; optional focus area (e.g., "only compare Section 3")
**Output:**
- Markdown changelog: Summary → Added → Removed → Modified → Notes
---
## Language Detection
Detect the user's language from their message:
- If Russian (or contains Cyrillic): respond in Russian
- If English (or other Latin-script language): respond in English
- If ambiguous: respond in the language of the trigger phrase used
---
## Instructions
### Step 1: Identify and Validate Files
1. Check that exactly two files are provided
- If only one file is given: stop — "Two documents are required. Please provide both the old version (v1) and the new version (v2)."
- If no files are given: scan the Cowork workspace for `.md` and `.txt` files; list them and ask the user to specify which two to compare
2. Read both files
- If a file is unreadable (binary, corrupted, unsupported format): stop — "Could not read [filename]. changelog-narrator works with .md and .txt files only."
3. Determine version order (which is v1, which is v2)
- Infer from filename markers: