skill-improvement

Patch Claude Code skills by proposing targeted improvements from session gaps.

2|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/mouchegmouradian/claude-code-skills --skill skill-improvement-mouchegmouradian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-improvement
Source: https://github.com/mouchegmouradian/claude-code-skills/tree/main/skills/skill-improvement
Command: npx skills add https://github.com/mouchegmouradian/claude-code-skills --skill skill-improvement-mouchegmouradian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects when a Claude Code session reveals a gap, bug, or improvement in an existing skill, then proposes a targeted patch and (with user approval) creates a local git branch and commit in the skills repo. Trigger this skill whenever you notice during a session that: a skill gave wrong or incomplete guidance, you had to correct or supplement a skill's instructions, a workaround was needed that should be documented, or the user says something like "the skill missed this", "add this to the skill", or "we should update the skill". Also trigger proactively at the end of any session that used a skill and produced fixes or new knowledge. Never wait for the user to ask.

Core Features & Use Cases

  • Identify gaps in skills from real-session observations and surface them for patching.
  • Propose minimal, surgical diffs to SKILL.md and guidance on patch scope.
  • Create a patch workflow that, with user approval, generates a local git branch and commit in the skills repo.
  • Proactively surface improvements at natural session wrap-ups to keep skills up to date.

Quick Start

Trigger this workflow whenever you detect a gap in a skill and want to propose a patch to the corresponding skill.

Frequently Asked Questions about skill-improvement

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

FAQPage Schema
How do I patch Claude Code skills when a session reveals incorrect or incomplete guidance?

To patch Claude Code skills, this skill captures gaps discovered during sessions, proposes targeted improvements, and generates a git branch and commit in the local skills repo upon user approval.

What is the workflow for updating SKILL.md frontmatter after fixing a bug?

The workflow for updating SKILL.md frontmatter involves reading the existing frontmatter to identify the target skill, proposing a surgical diff to correct the bug, and committing the patch to a local git branch in the skills repository.

Can I automatically generate git commits for Claude Code skill improvements at the end of a session?

Yes, you can automatically generate git commits for skill improvements by proactively triggering this skill at session wrap-ups to surface new knowledge or fixes and create a corresponding patch proposal in the local skills repo.

Do I need a local skills repository set up to propose patches?

Yes, you need access to the local skills repository to propose patches, as the skill reads the SKILL.md frontmatter from this directory to identify the target skill and format the patch.

When should I propose a patch to a Claude Code skill?

You should propose a patch whenever a session reveals a gap, requires a workaround that needs documenting, or when the user indicates that the skill missed specific instructions or gave wrong guidance.