# Opinion: Splitting long Claude Code skills may cut line count but not boost rule adherence

Digest AI · Agents & Tools · published 2026-09-18T04:00:00Z

Canonical: https://digestai.news/story/opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b

## Summary

The author, a long‑time Claude Code user, tracked twelve skills that each grew beyond Anthropic’s 500‑line recommendation, totaling 9,770 lines. The longest skill – a note‑publishing procedure – reached 1,225 lines, with 74 lines marked as absolute warnings. Following Anthropic’s guidance to keep CLAUDE.md under 200 lines and skills under 500, the author split the files, reducing the combined length to 3,369 lines – a 65 % drop. 

A month later the same twelve skills had swelled to 3,988 lines, an increase of 619 lines (18 %). Most skills grew again, the weekly‑review skill adding 137 lines, while the number of warning lines fell from 351 to 158 after the split but rose to 353 by the end of the month. The author notes that, despite the reduction, they have not measured whether Claude follows rules more reliably after splitting, so any improvement remains uncertain. Currently none of the 88 total skills exceed 500 lines, though eight still surpass 450 lines.

Anthropic’s documentation stresses that longer instruction files consume more context and can diminish adherence, prompting the author to recommend separating “map” lines that are needed every time from “content” lines needed only for specific tasks. This practice, the author suggests, can help users keep instruction files concise and more effective.

## Key points

- 12 Claude Code skills exceeded 500 lines, totaling 9,770 lines before splitting.
- Splitting cut total lines to 3,369 (65% reduction), then rose 619 lines (18%) after a month.
- Anthropic advises keeping CLAUDE.md under 200 lines and each skill under 500 lines.

## Why it matters

Long instruction files consume context, reducing Claude's rule adherence; keeping skills concise improves performance and cost for users building AI agents.

## Sources

1. [AI Design When Claude Code Doesn't Follow Rules, I Split Instead of Adding—What I Learned from 12 Skills Exceeding 500 Lines: Instructions Get Read Less as They Grow](https://note.com/nikokobo/n/nc9713ad824f3?hl=en) (note.com, 2026-09-18)

## Cite

Digest AI, "Opinion: Splitting long Claude Code skills may cut line count but not boost rule adherence", 18 September 2026, https://digestai.news/story/opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b

---

Written by Digest AI's editorial model from the linked sources; the sources are the record. Headlines, digests and key points are written by Digest AI and may be quoted with a link to the story page. Linked articles belong to their publishers. Terms: https://digestai.news/terms#reuse
JSON: https://digestai.news/story/opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b.json