instruction-improver

Analyze conversation history to extract feedback patterns and propose CLAUDE.md improvements.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/voznik/dotfiles --skill instruction-improver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instruction-improver
Source: https://github.com/voznik/dotfiles/tree/main/.rulesync/skills/instruction-improver
Command: npx skills add https://github.com/voznik/dotfiles --skill instruction-improver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mine conversation history for user feedback patterns (frustrations, corrections, praise, successes) and update CLAUDE.md files with learnings.

Core Features & Use Cases

  • Mine conversation history for user feedback patterns and identify recurring mistakes and wins.
  • Generate CLAUDE.md or AGENTS.md improvements based on identified patterns.
  • Support both user-level and project-level CLAUDE.md updates, with explicit scope decisions.

Quick Start

Analyze conversation history to extract feedback patterns and propose CLAUDE.md improvements.

Frequently Asked Questions about instruction-improver

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

FAQPage Schema
How do I update CLAUDE.md files based on recurring user feedback patterns?

You can update CLAUDE.md from user feedback by mining memex conversation history to identify recurring frustrations, corrections, and successes, then proposing and implementing explicit edits to your guidelines.

What is the process for turning conversation history into CLAUDE.md improvements?

Turning conversation history into CLAUDE.md improvements involves reading existing rules, surfacing actionable feedback patterns from memex conversations, obtaining your explicit approval on findings, and implementing edits to chosen files.

Can I apply CLAUDE.md improvements to both user-level and project-level files?

Yes, you can apply CLAUDE.md improvements to both user-level and project-level files, allowing you to make explicit scope decisions and propose targeted changes for one or both configuration files as needed.

How do I extract recurring mistakes and wins from memex conversations?

Extracting recurring mistakes and wins from memex conversations requires analyzing historical interactions to detect feedback patterns, which are then surfaced as actionable findings for your review and guideline updates.

Do I need to approve CLAUDE.md edits before they are implemented?

Yes, you need to approve CLAUDE.md edits before implementation, as the workflow reads existing rules, presents identified feedback patterns as findings, and requires your explicit approval before applying any changes to the files.