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

Claude Code can truncate skill metadata in two ways: each skill description is capped at 1,536 characters, and all listings share a limited context budget.

When the shared budget is tight, less-used skills may lose their descriptions entirely, making them harder for Claude to match to the right task.

This can make installed skills seem broken even when they are present, reducing automation reliability.

The article points to diagnostic tools like /doctor and /context, plus config options such as skillOverrides and budget-related settings, to inspect and tune the limits.