DEV Community

Shapovalov Valentine
Shapovalov Valentine

Posted on Originally published at apovalov.com

Claude Code skills: stop onboarding your agent every Monday

Writing the same long prompt for the same task every time is like onboarding a new intern every Monday.

Skills are how you stop.

A skill sits somewhere between a program and a prompt. At its core is a SKILL.md file of instructions for one specific job. It can also include reference material, templates, and scripts. The aim is a repeatable workflow, not a guarantee of an identical result.

Claude Code has them. Anthropic published the format as an open standard in December 2025. Codex and Cursor support skills too.

What changes in practice

Think about a skill for writing blog posts. Instead of leaving "write a post" open to interpretation, you can specify a workflow: read your previous posts, check for repeats, look for fresh data, ask a couple of clarifying questions, suggest a few options, then write in your voice. That's the difference between a stranger on the street and an assistant who's worked with you for six months.

Describe the logic once, then invoke it when you need that job done.

A monthly content plan. Sorting a folder full of documents. A proposal tailored to one client.

One skill to start each workflow.

Why skills scale better than one long prompt

The Agent Skills standard uses progressive disclosure: the agent starts with skill names and descriptions, then loads the full instructions when a skill is activated. You can also invoke a skill directly.

That keeps the full procedures out of context until you need them. The names and descriptions still take up space.

For me, that's the reason to keep task-specific procedures in skills. I want the workflow for the current job loaded when I need it, rather than carrying every procedure into every conversation.

Think of a tool as an action with a clear contract, like sending an email. A skill describes the workflow around those actions: what to check, which tools to call, and what the finished result should look like.

Building your first one

The Claude Code documentation explains how to create and invoke skills. There are already skill packs for development, like Superpowers. There are even skills for building skills.

The ones I'd tried felt closer to one-shot generation than to working through the design with a brainstorming partner. I wanted a process that helped me decide what the skill should do before writing it.

So I built my own: SuperSkill Creator. You answer questions, it checks for overlap with existing skills, and it helps you choose ready-made building blocks. Then it writes the skill, pressure-tests it with you, and saves it. The design happens in conversation; you do not have to hand-write the instructions.

If you want agents to take over everyday work and you'd rather not write code, skills are where I'd start. Pick one task you do every week and make it your first skill.

Top comments (0)