improve-command

Analyze skill usage and generate structured improvement proposals for GitHub issues.

Updated Nov 6, 2025
One-click install
npx skills add https://github.com/toumakido/my-claude --skill improve-command
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-command
Source: https://github.com/toumakido/my-claude/tree/main/skills/improve-command
Command: npx skills add https://github.com/toumakido/my-claude --skill improve-command

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes skill usage and creates improvement proposals for skills.

Core Features & Use Cases

  • Inspects conversation history to identify gaps between expected and actual skill behavior.
  • Generates structured improvement proposals with concrete SKILL.md changes, workflow examples, and edge-case considerations.
  • Produces ready-to-use content for GitHub issue creation, including guidance for public repositories and optional generalization for private repos.

Quick Start

Use the /improve-command command followed by the target skill name, for example: /improve-command migrate-aws-sdk The tool will validate the target skill, analyze recent interactions, and output a ready-to-post improvement proposal.

Frequently Asked Questions about improve-command

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

FAQPage Schema
How do I generate improvement proposals for Claude Code skills?

To generate improvement proposals for Claude Code skills, analyze skill usage and conversation history to identify behavioral gaps, then output structured proposals with concrete SKILL.md changes and workflow examples ready for GitHub issue creation.

What is the best way to create GitHub issues for skill improvement from conversation history?

The best way to create GitHub issues for skill improvement is to inspect conversational history to surface gaps between expected and actual behavior, then generate ready-to-use structured proposals with edge-case considerations for repository submission.

Do I need the gh CLI to analyze skill usage and create pull request proposals?

Yes, you need the gh CLI installed and repository access to analyze skill usage and create improvement proposals, as the tool requires repository permissions to validate target skills and output structured content for GitHub issue creation.

Can I create skill improvement proposals for private repositories without exposing sensitive data?

Yes, you can create skill improvement proposals for private repositories by generalizing the proposal content, ensuring sensitive repository details are abstracted while still providing actionable SKILL.md changes and workflow examples.

How do I analyze gaps between expected and actual skill behavior in Claude Code?

To analyze gaps between expected and actual skill behavior in Claude Code, inspect the conversation history where the skill was invoked, identify discrepancies in the workflow, and generate a structured improvement proposal addressing those specific gaps.

What limitations exist when generating improvement proposals for used skills across repositories?

Limitations when generating improvement proposals include dependency on gh CLI repository access for validation, and the need to manually generalize content for private repositories to avoid exposing sensitive structural or conversational data in public issue submissions.