# Claudemd Optimizer

> Optimize CLAUDE.md files based on Claude 4 best practices from Anthropic's official documentation. Use when reviewing or improving CLAUDE.md, creating new project instructions, analyzing prompt effectiveness, or applying Claude 4 model-specific optimizations. Triggers: "CLAUDE.mdを最適化", "プロジェクト指示を改善", "optimize CLAUDE.md", "review system prompt".

- Skill: `majiayu000/claudemd-optimizer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/claudemd-optimizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/claudemd-optimizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/claudemd-optimizer

---


# CLAUDE.md Optimizer

Claude 4公式ベストプラクティスに基づき、CLAUDE.mdファイルを最適化するスキル。

## Execution Flow

### 1. Read target CLAUDE.md
既存の内容を確認。なければ新規作成を提案。

### 2. Analyze against Claude 4 principles
詳細は `claude4-principles.md` を参照。主要評価軸:
- **明示性**: 指示が具体的か。修飾語（"as many as possible"）を使っているか
- **コンテキスト**: なぜそのルールが必要か説明しているか
- **構造**: XMLタグで整理されているか（必要な場合）
- **過剰防止**: 過度なエンジニアリングを抑制する指示があるか

### 3. Apply optimizations
チェックリストは `checklist.md` を参照。主要な最適化:
- 曖昧な指示 → 明示的・具体的な指示に変換
- ルールのみ → 理由（なぜ）を追加
- 過度な冗長性 → 簡潔かつ必要十分に
- 不足している重要指示を追加（過剰エンジニアリング防止など）

### 4. Report improvements
変更点とClaude 4原則への対応を説明。

## Output Format
課題 → 改善案 → 変更点（テーブル形式）の順で報告。

## Reference Files
- `claude4-principles.md`: Claude 4モデル固有のベストプラクティス詳細
- `checklist.md`: CLAUDE.md最適化チェックリスト