git-changes-reporter

Generate structured JSON and Markdown git change reports for commit ranges.

351|53|Updated Jul 20, 2023
One-click install
npx skills add https://github.com/No-Trade-No-Life/Yuan --skill git-changes-reporter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-changes-reporter
Source: https://github.com/No-Trade-No-Life/Yuan/tree/main/.claude/skills/git-changes-reporter
Command: npx skills add https://github.com/No-Trade-No-Life/Yuan --skill git-changes-reporter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, node, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically converts git history into structured reports (JSON + Markdown), saving engineers hours by providing a consistent, readable summary for code reviews, release notes, and team alignment. It collects commits over a range, assembles semantic triads (design intent, core changes, impact), and bundles per-commit details for rapid analysis.

Core Features & Use Cases

  • Structured reporting: Generates a JSON payload and human-readable Markdown summarizing changes
  • Code review acceleration: Provides focused snippets and risk indicators to speed reviews
  • Release notes automation: Produces consistent notes for changelogs and documentation
  • CI/CD integration: Can feed pipelines with consolidated change data for auditing

Quick Start

Run the JSON generator for a commit range: node .claude/skills/git-changes-reporter/scripts/generate-json.js <old_commit> <new_commit> [output_path] Then (optional) enrich with GitHub links: node .claude/skills/git-changes-reporter/scripts/generate-github-links.js <json_file> https://github.com/owner/repo

Frequently Asked Questions about git-changes-reporter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate structured git change reports from commit ranges?

Git change reports convert raw commits into JSON and Markdown using `node .claude/skills/git-changes-reporter/scripts/generate-json.js <old_commit> <new_commit>`. This produces machine-readable structured data with commit details, file references, code snippets, and metadata fields for code reviews, release notes, and CI/CD pipelines.

What information does a git changes report include?

Reports capture design intent, core code changes, and impact through structured metadata: commits, directory analysis, domains, risk indicators, file references with line numbers, and 5-15 line code snippets. JSON output enables machine parsing while Markdown provides human-readable summaries.

Can I automate release notes from git history?

Yes. Generate JSON reports from git commit ranges, then optionally enrich with GitHub repository links using the generate-github-links script. The structured output feeds directly into changelog pipelines and release documentation workflows.

Does this work with monorepos and multiple commit ranges?

The Skill handles multi-commit ranges and monorepo structures by generating triadic reports—design intent, core changes, and impact—across projects. Validation ensures template conformance and hash authenticity for complete commit coverage.

What are the prerequisites to run git change reports?

You need git and Node.js installed. The Skill reads commit history from your repository and outputs JSON and Markdown files. No additional configuration is required beyond providing old and new commit references.

How do git change reports speed up code reviews?

Reports provide focused code snippets, risk indicators, and semantic context (design, core changes, impact) for each commit. This eliminates manual log parsing and lets reviewers assess scope and intent quickly.