I'm learning to author and use Agent Skills in Claude and Codex. I gained some insights and I would like to share them here today.
Skill content comes in three types: instructions, scripts, and resources. Skills are organized as files/folders that Claude can draw from via a filesystem-style interface. Claude does progressive disclosure: it does not need to load the entire Skill into the context window upfront, and can fetch only the relevant files as needed. [^1]
Skill content types have different strengths: