A skill is a folder, not just a markdown file. You should think of the entire file system as a form of context engineering and progressive disclosure. Tell Claude what files are in your skill, and it will read them at appropriate times. The simplest form is to point to other markdown files — e.g., split detailed function signatures and usage examples into references/api.md. You can have folders of references, scripts, examples, etc.
Tip 3: Use the File System & Progressive Disclosure
When this pattern helps
Use this as a pattern to evaluate, not a universal rule. Check the current Claude Code documentation and your own workflow constraints, then keep the parts that measurably improve reliability, clarity, or delivery time.
这是一种值得评估的实践，不是放之四海皆准的规则。结合当前 Claude Code 文档和自己的工作约束验证，只保留确实改善可靠性、清晰度或交付时间的部分。