How to Build a Fast and Reliable Workflow: Refactoring Agent Skills

- If your Skills feel “slow and flaky,” you probably built documentation, not capabilities. - Progressive disclosure is the only scalable pattern: keep `SKILL.md` tiny, push detail into references/scripts that load only when needed. - A practical heuristic emerged from the trenches: 200 lines for the entry point (and if you can’t fit it, your Skill is too wide). - The biggest mental shift: organize Skills by workflow stage (capabilities), not by tool (Cloudflare/Tailwind/whatever).