Claude skills should split prose, scripts, and tools instead of keeping everything as text
socialwithaayan · x · 2026-07-24
The author argues that in Claude skills, the important distinction is not whether a capability is written as prose or code, but whether it should be expressed as an instruction, a script, or a tool call.
Their rule of thumb is:
- Keep prose for judgment, tone, and context-sensitive adaptation.
- Move deterministic work to scripts: calculations, format conversions, file operations, validation checks, and any task that should always produce the same output.
- Use real tools/connectors when the skill needs to do actual work rather than merely describe how work should happen.
The broader lesson is that skills rot when they stay as instructions for things that should have been automated.
More from coding & agent
- Warp's six non-engineering teams all run on Linear and Claude Code — mon__lim · 2026-09-11
- Is inference latency becoming the biggest bottleneck for production AI agents? — Euphoric_Sea632 · 2026-09-11
- Anthropic researcher: 99% of engineers now run swarms of 300+ self-improving agents — AlishaOutridge · 2026-09-11
- Gergely Orosz: Shipping 10x PRs With AI Agents, Sites Fill With Small Regressions — ducha_aiki · 2026-09-11
- Same Echo Maze prompt, three frontier models: all passed visually but shipped the same hidden bug — eyishazyer · 2026-09-11
- Astra storyboards plus Minimax H3 per-shot generation boost video success rates — Hailuo_AI · 2026-09-11