@${CLAUDE_SKILL_DIR}/../../meta/ase-control.md @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
Format
The ChangeLog file is a Markdown formatted file named CHANGELOG.md,
and contains sections with headers in the style N.M.K (YYYY-MM-DD).
Each ChangeLog entry always starts with a line formatted as...
`<change-type/> [<artifact-kind/>]: <summary/>`
...where the is one of the following tags and their usual related changes:
- `FEATURE`: new functionality or configuration
- `IMPROVEMENT`: improved functionality or configuration
- `BUGFIX`: corrected functionality or configuration
- `UPDATE`: updated functionality or configuration
- `CLEANUP`: cleaned up functionality or configuration
- `REFACTOR`: refactored functionality or configuration
The is one or more of the following artifact tags,
classifying which kind of artifact the change primarily touches. If
multiple artifact kinds apply, comma-separate them
(e.g. [code, docs]):
- `spec`: requirement/specification artifacts
- `code`: source code artifacts
- `docs`: documentation artifacts
- `infr`: infrastructure/build/tooling artifacts
- `othr`: any other artifacts
The layout of the entries MUST follow the style of the existing entries of the ChangeLog file, especially its list item marker and indentation, its blank lines between entries, its line width, and its entry shape, e.g. a single-line , a short title line followed by an indented body of explaining sentences, or a
Each entry, including all its title and body lines, MUST be kept within about 5 lines in total. The ChangeLog entries for a single product release version are also always grouped and sorted according to the above list.
Processing
-
The ChangeLog file
CHANGELOG.mdis located in the current directory or one of the parent directories of the current project. Locate and read this file. Store its relative path in .You MUST NOT output anything, except the result with the following :
-
You MUST NOT output anything, except introduce the current operation with an output based on the following :
To update the entries of the most recent ChangeLog section, consult the Git commits plus the currently already staged changes in the Git index, but ignore the Git stash and still unstaged changes.
For finding the corresponding Git commits, first determine the correct baseline Git tag. Take the
N.M.Kfrom the first (most recent) level-2 header in the ChangeLog file and check whether a corresponding Git tag already exists with the commandgit tag --list N.M.K. If this command does produce output, the first section is already released/tagged, so use theN.M.Kfrom the first level-2 header as the baseline tag and insert a new, still-unreleased level-2 section (next patch version, current date) above it, which then becomes the first (most recent) section all subsequent steps operate on - the already released section MUST NOT be modified. If this command produces no output, the first section is still in-progress/untagged, so use theN.M.Kfrom the second level-2 header as the baseline tag instead. Then check all Git commits betweenHEADand this baseline tag with the commandgit log N.M.K..HEAD --numstat --pretty=format:'%h: %s'. If no second level-2 header exists (very first, still untagged release), skip the baseline tag and check all Git commits with the commandgit log HEAD --numstat --pretty=format:'%h: %s'instead.For finding the corresponding staged Git changes in the Git index, use the command
git diff --cached --numstat, but silently skip already existing changes to theCHANGELOG.mdfile itself. If still no corresponding ChangeLog entry exists for these staged Git changes, derive a meaningful one from agit diff --cachedcommand. -
You MUST NOT output anything, except introduce the current operation with an output based on the following :
Without immediately modifying the
CHANGELOG.mdfile, complete the entries in the first (most recent) section only, by adding the corresponding (most recent) Git commits and staged changes only.For each Git commit, reduce the Git commit messages to an entry in the style of the existing entries, kept within about 5 lines (see section Format above).
For each entry, also determine the artifact kind tag(s) from the paths of the changed files. To classify a changed file to its artifact class, call the
ase_artifact_list(kind: [ ... ])tool of theaseMCP server once, passing thekindtokens (spec,code,docs,infr,othr), and read the returnedartifactsarray of{ kind, files }objects to match each changed file to its kind. Use the matched lower-cased kind directly as its tag, and comma-separate multiple tags when more than one artifact class applies.If a is too short or especially is not comprehensible enough because of too little context information, add some essential context, especially references to the class/module/package, etc. For this, if necessary, read the related source files with a corresponding
git showcommand to get a better understanding of this context. -
You MUST NOT output anything, except introduce the current operation with an output based on the following :
Without immediately modifying the
CHANGELOG.mdfile, consolidate the entries in the first (most recent) section only, by summarizing and merging closely related entries. Perform the entry consolidation per group only. Also condense any entry of this section, which exceeds about 5 lines, by compressing its wording.Without immediately modifying the
CHANGELOG.mdfile, sort the entries in the first (most recent) section only. Instead of the chronological commit order, group the entries by the s. -
You MUST NOT output anything, except introduce the current operation with an output based on the following :
Finally, update the
CHANGELOG.mdfile with the completed, consolidated and sorted ChangeLog entries. Also, update the dateYYYY-MM-DDin theN.M.K (YYYY-MM-DD)header of the first (most recent) section.For this, you MUST use the
Edittool, replacing just the first (most recent) section, instead of re-writing the entire file with theWritetool, so that the resulting changes are shown to the user as a diff by the agent tool itself.You MUST NOT output the resulting entries a second time, any further summary, or any further explanations.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |