gh-issue-improvement

Generate structured Markdown improvement proposals for GitHub issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines the process of creating structured improvement proposals for GitHub issues, ensuring clarity and consistency in development discussions.

Core Features & Use Cases

  • Structured Proposal Generation: Creates well-organized Markdown documents for enhancement suggestions.
  • Focus on Improvements: Specifically designed for feature enhancements, refactoring, and architectural changes, not bug fixes.
  • Use Case: After a team discussion about optimizing a specific API endpoint, use this skill to generate a formal proposal outlining the motivation, current state, proposed changes, and expected benefits.

Quick Start

Use the gh-issue-improvement skill to generate a proposal for consolidating transaction tools.

Frequently Asked Questions about gh-issue-improvement

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

FAQPage Schema
How do I draft a structured GitHub issue improvement proposal for code refactoring?

To draft a structured GitHub issue improvement proposal, you need a tool that generates well-organized Markdown documents outlining the motivation, current state, proposed changes, and expected benefits for code refactoring. This ensures clarity and strategic focus in development discussions without getting bogged down in implementation details.

What is the best way to document feature enhancements in GitHub issues?

The best way to document feature enhancements in GitHub issues is by generating structured improvement proposals. This approach creates formal Markdown documents that specifically focus on architectural changes and enhancements, ensuring consistency and strategic focus while avoiding implementation details.

Does this proposal generation method work for bug fixes?

No, this proposal generation method does not work for bug fixes. It is specifically designed to facilitate the documentation of feature enhancements, code refactoring, performance optimizations, and architectural changes, rather than addressing bug fixes or implementation details.

How do I use conversation context to generate architectural change proposals?

You can use conversation context to generate architectural change proposals by employing a skill that processes team discussions and outputs structured enhancement suggestions. It transforms the context into a formal document detailing the motivation, proposed changes, and expected benefits.

What should be included in a GitHub enhancement proposal for performance optimization?

A GitHub enhancement proposal for performance optimization should include the motivation, current state, proposed changes, and expected benefits. The content guidelines require clarity and strategic focus, specifically avoiding implementation details to streamline development workflow discussions.