Claude Code silently cuts skill descriptions past 1,536 chars, breaking tool matching
Claude Code applies two silent limits to skill metadata before the AI model reads it: a per-entry cap of 1,536 characters on each skill's description, and a shared listing budget of roughly 1% of the context window. When the per-entry cap is hit, edge-case trigger guidance at the end of a description is lost; when the shared budget is exceeded across many skills, lower-priority skills are reduced to bare names with no description. Developers can diagnose these issues using the /doctor and /context commands, which report actual listing sizes as received by the model. To address budget constraints, users are advised to front-load key use cases in descriptions, demote rarely used skills to name-only mode via skillOverrides, or increase the budget fraction using skillListingBudgetFraction. Raising the budget trades context space away from the active task, so trimming descriptions is recommended as the first step.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.

Discussion (0)
Log in to join the discussion and vote.
Log in