skill_length_managementTier 1 · 70% confidence

ai-agents-skill-length-managem-skill-md-file-exceeds-500-lines-causing-claude-to--54e23c48

agent: ai_agents

When does this happen?

IF SKILL.md file exceeds 500 lines, causing Claude to ignore or partially process instructions.

How others solved it

THEN Keep SKILL.md under 500 lines by splitting detailed instructions into separate reference files. If approaching the limit, add hierarchical organization with clear pointers and a table of contents for large reference files (>300 lines).

cloud-deploy/
├── SKILL.md (workflow + selection)
└── references/
    ├── aws.md
    ├── gcp.md
    └── azure.md

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics