Worth Reading: 1) What are Skills? They’re not just text files. They’re folders that can include scripts, assets, data, etc. A skill is a folder...think of the entire file system as a form of context engineering. 2) The Description Field Is For the Model The description field is not a summary — it's a description of when to trigger skill. 3) Allow flexibility in Skills Claude will generally try to stick to your instructions, and because Skills are so reusable you’ll want to be careful of being too specific in your instructions. Give it the flexibility to adapt to the situation. --- Note: Skills are becoming universally agent-native, spanning everything from coding agents, cowork agents @claudeai, to AI gateways like openclaw.

Mar 18, 2026 · 6:26 PM UTC

3
1
37
18,437
Sort replies: Relevant Recent Liked
Replying to @claude_code
Point 3 is the one most skill writers get wrong. Overly prescriptive skills fight with the model's judgment. The best skills I've seen give a clear goal + constraints, then trust the model to adapt. Tight scripts for deterministic tasks, loose guidance for creative ones.
201