Anthropic just said skills are hard

It is worth reading, but it's a map of work you should not have to do. The Claude Code team wrote a piece on how they use agent skills. If you make skills, read it. It is honest and tells you something important: making a good skill is real work. Here's what the guide covers. It sorts skills into nine categories. It explains progressive disclosure, where the agent knows which files to load and when. It covers scripts, config files, combining skills together, and writing the description so the model reaches for the skill at the right moment. All of that is true and useful.