describe-changes

Compose a high-level summary of code changes across functional, test, and documentation files.

43|21|Updated Jun 3, 2025
One-click install
npx skills add https://github.com/blockscout/mcp-server --skill describe-changes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: describe-changes
Source: https://github.com/blockscout/mcp-server/tree/main/.claude/skills/describe-changes
Command: npx skills add https://github.com/blockscout/mcp-server --skill describe-changes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps confirm an AI agent's understanding of code modifications required for a feature or fix by generating a high-level summary of changes.

Core Features & Use Cases

  • Scope Confirmation: Articulates specific modifications needed across files.
  • Accuracy Check: Ensures the agent has read and understood relevant files before describing changes.
  • Use Case: After discussing a new feature, invoke this skill to get a clear, concise list of all files that will be modified, including functional, test, and documentation updates.

Quick Start

Use the describe-changes skill to get a summary of all code modifications required for the discussed feature.

Frequently Asked Questions about describe-changes

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

FAQPage Schema
How do I generate a summary of code changes needed for a new feature?

To generate a summary of code changes needed, invoke the describe-changes skill after discussing the feature. It reads relevant files to validate understanding, then produces a concise, high-level list of functional, test, and documentation modifications required.

What is the best way to summarize code modifications across functional, test, and documentation files?

Summarizing code modifications across functional, test, and documentation files is best handled by validating that the relevant files have been read first. This ensures the generated description accurately reflects the actual scope of required updates before changes are implemented.

How can I check if an AI agent has actually read the files before describing required code changes?

Checking if an AI agent has read files before describing required code changes is enforced by mandating file reading prior to inclusion. The agent validates its understanding by reading relevant files, preventing inaccurate or hallucinated summaries of code modifications.

How do I confirm the scope of code updates for feature implementation?

Confirming the scope of code updates for feature implementation involves articulating specific modifications needed across files. The skill generates a clear, concise list of all functional, test, and documentation files that will be modified to implement the discussed functionality.

When do I need a high-level description of required code changes?

You need a high-level description of required code changes after discussing a new feature or fix. It helps confirm the AI agent's understanding of the modifications required, ensuring scope alignment before actual development and testing work begins.

Does this code change summarizer work without any external dependencies?

Yes, this code change summarizer works without external dependencies. It operates independently to compose a concise, high-level description of required code modifications, relying solely on its internal logic to read files and validate agent understanding.