Git Changelog Generator

Generate changelogs from git commits. Supports markdown, plain text, and JSON output with date ranges and tag-based filtering.

Security Scan

The skill's code and instructions are consistent with a changelog generator: it only reads git history and prints formatted output and does not request credentials, network access, or unrelated system resources.

Purpose & Capability

Name/description match the included script and SKILL.md. The script operates on a local git repository and produces markdown/plain/text/JSON changelogs as advertised. No unrelated binaries, env vars, or config paths are requested. (Minor note: the script shebang points to /opt/homebrew/bin/bash, but examples call it with 'bash scripts/changelog.sh', so this is not an operational mismatch.)

Instruction Scope

Runtime instructions only invoke the included shell script against a repo path. The script only runs git commands, changes to the provided repository path, and formats commit metadata. It does not reference external endpoints, other system config, or environment variables. Users should be aware that commit messages/metadata may contain sensitive information and will be output.

Install Mechanism

No install spec; skill is instruction-only with one included script. Nothing is downloaded or written to disk by an installer. Dependencies are limited to git and bash, which matches the script's behavior.

Credentials

No environment variables, credentials, or config paths are required. The script does not read shell history or other unrelated files. There is no disproportionate access requested.

Persistence & Privilege

always is false and the skill does not request persistent presence or modify other skill/system configs. It can be invoked by the agent (normal default), but it does not autonomously elevate privileges or store tokens.

Assessment

The skill appears to do what it says: run the provided script against a local git repository to generate a changelog. Before using: (1) inspect or run the script in a sandbox — although harmless-looking, it will output all commit messages and metadata (these can contain secrets); (2) note the shebang points to /opt/homebrew/bin/bash but examples invoke it with 'bash', which avoids shebang issues; (3) ensure you run it only on repositories you trust or where exposing commit text is acceptable. Overall it's coherent and does not request extra permissions or network access.

Git Changelog

When to use

Generate a human-readable changelog from git commit history. Works with any git repository.

Setup

No dependencies required. Uses only git and bash.

How to

Basic changelog (last 30 days or since last tag)

bash scripts/changelog.sh --repo /path/to/repo

Since a specific date

bash scripts/changelog.sh --repo /path/to/repo --since "2026-01-01"

Date range

bash scripts/changelog.sh --repo /path/to/repo --since "2026-01-01" --until "2026-02-01"

JSON output (for programmatic use)

bash scripts/changelog.sh --repo /path/to/repo --format json

Plain text output

bash scripts/changelog.sh --repo /path/to/repo --format plain

Output Formats

Format	Description
markdown	Default. Headers, commit hashes, authors, dates
plain	Simple bullet list
json	Array of commit objects with hash, subject, author, date, type

Options

Flag	Description	Default
--repo <path>	Repository path	Current directory
--since <date>	Start date	Last tag or 30 days ago
--until <date>	End date	Now
--format <fmt>	Output format	markdown
--group	Group by conventional commit type	Off (needs bash 4+)

Notes

• Automatically detects the last git tag and uses it as the start point
• Excludes merge commits for cleaner output
• Conventional commit types (feat/fix/docs/etc) are extracted for JSON output
• --group mode requires bash 4+ (macOS ships with 3.2; install via brew install bash)