Skills

I write and review a lot of Agent Skills, and find myself frequently pushing back in reviews, as many authors assume they’re writing “just another markdown prompt” without considering that they’re actually working with one component of agentic system. The TLDR of my feedback is usually along the lines of: The description’s only job is to tell the agent when the skill should be triggered. Keep the description as terse as possible while still triggering. The SKILL.md should be lean with detail pushed to reference files. Put repeatable work in scripts rather than relying on model inference. And I recommend they use my skill-creator-primer skill which aims to catch these, along with most of what’s covered below. ...

I follow a simple, yet effective flow for agentic coding that helps me to efficiently develop software using AI coding agents while keeping them on track, focused on the task at hand and ensuring they have access to the right tools and information. The flow is simple: Setup -> Plan -> Act -> Review & Iterate. It’s a cycle rather than a straight line - what you learn in each pass feeds back into your setup and plans for the next. ...