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.