Your Claude Code skill's description is being cut: the 1,536-char cap and the shared listing budget

Short summary

Claude Code silently truncates skill metadata through two limits: a 1,536-character per-entry cap on each skill's description and a shared listing budget (1% of context window) that drops least-used skills first. Use /doctor and /context to diagnose whether your skills are being cut, then trim descriptions, demote rarely-used skills via skillOverrides, or raise the budget fraction as a last resort.

• •Each skill description is capped at 1,536 chars; the tail is silently cut
• •A shared listing budget (1% of context) drops descriptions for least-used skills when exceeded
• •Use /doctor and /context to diagnose budget issues
• •Fix by trimming descriptions, demoting low-priority skills, or raising skillListingBudgetFraction

Generated with AI, which can make mistakes.