Skip to content
TakoAPI
Back to skills

claude-optimised

by hexnickk

Coding Agents & IDEs
3.9kDownloads reported by clawskills.sh
9Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Guide for writing and optimizing CLAUDE.md files.

Description

What This Skill Does

A guide for writing lean, effective CLAUDE.md files that Claude Code will actually follow. Covers what to include, what to cut, file placement, and how to maintain the file over time.

Most CLAUDE.md files are too long, causing Claude to skip critical rules — this guide enforces a pruning-first mindset that keeps instructions short enough to actually work.

When to Use It

  • Creating a CLAUDE.md for a new project from scratch
  • Auditing an existing CLAUDE.md that Claude seems to be ignoring
  • Deciding which conventions are worth documenting vs. leaving implicit
  • Setting up subdirectory-level CLAUDE.md files for monorepos
  • Trimming a bloated CLAUDE.md after it grows past 50 lines

Example Workflow

INPUT

User asks: review my CLAUDE.md and help me improve it

AGENT
  1. 1

    Reads the existing CLAUDE.md file

  2. 2

    Checks each line against the 'would removing this cause mistakes?' test

  3. 3

    Identifies redundant rules, obvious patterns, and prose that should be bullets

  4. 4

    Suggests removals and rewrites remaining content as terse bullet points

  5. 5

    Outputs a revised CLAUDE.md under 50 lines

OUTPUT

A trimmed CLAUDE.md containing only non-obvious conventions, critical warnings, and project-specific commands

Installation

clawhub install hexnickk/claude-optimised

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links