{"version":1,"type":"story","url":"https://digestai.news/story/opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b","json":"https://digestai.news/story/opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b.json","markdown":"https://digestai.news/story/opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b.md","slug":"opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b","headline":"Opinion: Splitting long Claude Code skills may cut line count but not boost rule adherence","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. \n\nA 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.\n\nAnthropic’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.","keyPoints":["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."],"whyItMatters":"Long instruction files consume context, reducing Claude's rule adherence; keeping skills concise improves performance and cost for users building AI agents.","category":{"slug":"agents","name":"Agents & Tools","url":"https://digestai.news/category/agents"},"entities":{"companies":["Anthropic"],"models":["Claude"],"people":[]},"firstPublishedAt":"2026-09-18T04:00:00Z","updatedAt":"2026-09-18T04:00:00Z","sourceCount":1,"hasPrimarySource":false,"sources":[{"outlet":"note.com","title":"[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","url":"https://note.com/nikokobo/n/nc9713ad824f3?hl=en","publishedAt":"2026-09-18T04:00:00Z","type":"press","primary":false,"lead":true}],"sourceNotes":null,"discussions":[],"thread":null,"cite":{"text":"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","publisher":"Digest AI","title":"Opinion: Splitting long Claude Code skills may cut line count but not boost rule adherence","datePublished":"2026-09-18T04:00:00Z","url":"https://digestai.news/story/opinion-splitting-long-claude-code-skills-may-cut-line-count-but-not-b"},"generatedBy":"Written by Digest AI's editorial model from the linked sources; the sources are the record.","license":"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"}