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).