optimize-claude-md

Diagnose CLAUDE.md and memory rules for conflicts and redundancies.

8|2|Updated May 3, 2026
One-click install
npx skills add https://github.com/ejoongseok/claude-settings --skill optimize-claude-md-ejoongseok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimize-claude-md
Source: https://github.com/ejoongseok/claude-settings/tree/main/claude-code/skills/optimize-claude-md
Command: npx skills add https://github.com/ejoongseok/claude-settings --skill optimize-claude-md-ejoongseok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies conflicts, redundancies, and misplacements in CLAUDE.md and related memory/rules settings so your Claude behavior becomes more predictable and easier to maintain.

Core Features & Use Cases

  • CLAUDE.md 진단 & 개선안 도출: CLAUDE.md와 메모리/규칙/훅 정책을 교차 분석해 수정 제안을 정리합니다.
  • 집중 분석 모드 제공: 입력한 문제 설명($ARGUMENTS)을 기준으로 해당 이슈 해결에 초점을 맞춘 개선안을 만듭니다.
  • 확장 수단을 정확히 분류: 메모리 파일 수정/재배치가 가능한 항목과 Hook/Skill/서브에이전트/.claude/rules로 옮겨야 하는 항목을 구분해 제시합니다.

Quick Start

Run the optimize-claude-md skill to analyze your CLAUDE.md and memory/rules configuration, then apply the approved improvements.

Frequently Asked Questions about optimize-claude-md

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

FAQPage Schema
How do I fix conflicting instructions in CLAUDE.md memory files?

To fix conflicting instructions in CLAUDE.md memory files, you diagnose and cross-analyze your CLAUDE.md with related memory and rules configuration to identify conflicts, producing grouped change proposals for approval.

What is the best way to refactor Claude rules and hook policies?

The best way to refactor Claude rules and hook policies is to classify extension targets, distinguishing which instructions belong in memory files versus Hook, Skill, sub-agent, or .claude/rules configurations.

Can I run a focused analysis on a specific Claude behavior issue?

Yes, you can run a focused analysis on a specific Claude behavior issue by providing a problem description as input, which generates targeted improvement proposals centered on resolving that exact conflict.

How does agent delegation work for CLAUDE.md configuration optimization?

Agent delegation for CLAUDE.md configuration optimization works by reading target files and delegating analysis to the claude-md-analyzer agent, utilizing a fallback path to produce actionable improvement suggestions if the agent is unavailable.

When should I move instructions from CLAUDE.md to .claude/rules?

You should move instructions from CLAUDE.md to .claude/rules when the configuration optimization identifies misplaced policies, reclassifying extension targets to ensure predictable behavior and reduce redundant memory file instructions.