knack
← all posts

Claude Cowork Skill Development: Draft, Test, Ship

Skill development for Claude Cowork is a loop, not a one-shot: draft the SKILL.md, run it on real work, fix the misses, version the fix. Here is the loop.

Claude Cowork skill development is a loop, not a one-shot: you draft a SKILL.md in plain English, run it on real work in Cowork, fix what it missed, and save that fix as a new version. No code is required at any step. The draft takes an afternoon. The loop is what turns it into something your whole team trusts.

Most of the writing about Cowork skills stops at the draft. That is a shame, because the draft is the easy part, and it is also the least valuable part. A skill that has survived ten real runs and three corrections is a different asset from a skill that got written once and prayed over. This article covers the whole development cycle: creating, testing, iterating, versioning, and sharing, and what each step looks like when you cannot and do not want to code.

What does skill development mean for Cowork?

Using a skill means installing someone's SKILL.md folder and letting Cowork load it when a task matches. Developing a skill means owning that folder: writing it, watching it perform, and changing it when it drifts.

The raw material is friendly. A skill is a folder with a SKILL.md file inside, a name and description up top and plain-English instructions underneath, per Anthropic's Agent Skills overview. It is the open format that Cowork runs natively, and the same folder works in Claude Code, the Claude apps, Codex, Cursor, and Gemini CLI. So "development" here does not mean programming. It means the same thing it means for a good onboarding doc: write it, watch a real person (agent) follow it, and edit where they stumbled.

If you have never touched a skill before, read what is Claude Cowork first and come back. This article assumes you know what the product is and want to build for it.

How do you create a skill for Cowork without code?

You have three honest paths, and they all end at the same folder.

The first is Anthropic's skill creator, described on the Claude skills page: you tell Claude what you want in conversation, and it drafts the folder structure and the SKILL.md for you. Fast, chatty, and good when you already know exactly what the instructions should say.

The second is a structured interview. Knack builds the same open-format SKILL.md by asking you questions about how you actually do the task: the steps, the tone, the edge cases you handle on autopilot and forgot were decisions. For processes you have never written down, the interview format tends to surface rules the chat format lets you skip. I build skill tooling for a living and I still get caught by the "wait, I do handle that case differently" moment mid-interview.

The third is starting from someone else's work. The Knack marketplace has a few hundred free skills in the open format; pull one that is close to your task, like meeting-minutes for turning transcripts into structured minutes, and edit the instructions toward your own process. Editing a working skill is a gentler on-ramp than a blank page, and there are purpose-built skills like skill-writer whose whole job is helping an agent draft and improve other skills.

Whichever door you take, hold the scope rule from our no-code skill guide: one skill, one job. A skill that tries to do four things triggers at the wrong times and does none of them well.

How do you test a Cowork skill before you rely on it?

Run it on real inputs, three times, before you call it done.

Pick the actual folder of receipts, the actual meeting transcript, the actual report template, and give Cowork the task the skill is meant to handle. Watch the plan it proposes before approving, because the plan tells you how Cowork interpreted your instructions, and misreadings show up there before they show up in the deliverable. Run one, read the output the way you would read a junior hire's first draft. Then run it twice more on different inputs, because a skill that works on the clean example and falls over on the messy one is not done, it is lucky.

Two Cowork-specific behaviors matter during testing. First, Cowork does not auto-crawl folders, so your skill's instructions should tell it where the inputs live, or your test brief should. A thin result usually means Claude saw less context than you assumed, a gotcha our Cowork setup guide covers in detail. Second, the description field is the trigger: Cowork matches your request against it to decide when the skill loads. If the skill fired when you did not want it, or sat silent when you did, the fix is almost always a sharper description, not longer instructions.

There are skills for this step too. writing-skills packages the create-edit-verify discipline so the agent itself checks a skill before you deploy it.

How do you iterate when the skill misses?

Treat every miss as an edit, immediately, while you still remember it.

The failure mode that kills most skills is silent drift: the skill misses an edge case, you fix the output by hand, and the fix never makes it back into the instructions. So the skill misses the same way next week, and by week four you have quietly stopped using it. The discipline that prevents this is boring: when Cowork gets it wrong, open the skill and add the rule you just applied in your head. "If the invoice has no date, use the email date." "Never include the internal codename in client docs." Small rules like that are the entire difference between a skill that compounds and one that decays.

This is the loop Knack automates, for what it is worth: runs are logged, and when a skill misses, the correction gets captured as a new rule and shipped as a version bump, so the next run anywhere picks it up. But the loop matters more than the tool. Even editing the file by hand, the habit of miss-to-rule-same-day is what makes skill development development rather than a one-time craft project.

How do you version and share a Cowork skill with a team?

The moment a second person runs your skill, copies start to drift, and you need version control.

The failure pattern is the same one that hits every shared document: you paste the skill into Slack, three teammates save three copies, someone edits one, and a month later nobody can say which version is live. Skills are plain-text folders, so anything that versions files works: a shared drive with discipline, a Git repo if someone on the team is comfortable there, or Knack, which gives each skill immutable, git-style version history with one-click rollback, no terminal involved. Publish once, teammates pull the current version with a single CLI line, and an update ships to everyone instead of forking into private copies.

For heavier team distribution, Cowork has its own packaging rung above single skills: plugins, which bundle skills, connectors, and sub-agents so an admin can provision a whole role's toolkit at once, including through private plugin marketplaces. The progression that works in practice: develop the skill alone, share it when it survives your own runs, and only reach for a plugin when the workflow needs tool connections or the whole team runs it.

Do Claude Code skills work in Cowork?

Yes, unchanged. The SKILL.md format is an open standard, and Anthropic's docs are explicit that the same skill runs across Claude Code, the Claude apps, and the API without modification. Cowork reads the identical folder.

For skill development this cuts both ways, usefully. A developer on your team can author and test a skill in Claude Code, and you run it in Cowork by clicking. You can develop a skill with no code at all, and the engineer down the hall runs your folder from their terminal. The comparison piece on Cowork vs Claude Code goes deeper, but the development takeaway is simple: build once, and do not worry about which surface your teammates prefer.

FAQ

Do I need to know how to code to develop a Cowork skill?

No. A skill is plain-English instructions in a text file with a small labeled header. Anthropic's skill creator drafts one from a conversation, and Knack drafts one from a structured interview. Code only enters the picture if you want to attach optional helper scripts, and most useful skills never need one.

How long does it take to build a working Cowork skill?

The first draft takes an afternoon, including testing it on three real inputs. Getting it trustworthy takes a week or two of actually using it, because the valuable edits come from real misses. Budget for the loop, not just the draft.

How do I test a skill in Claude Cowork?

Run it on real inputs, not toy examples, and read the plan Cowork proposes before approving. Three runs on three different inputs is the minimum before relying on it. When output comes back thin, point the skill at the exact files first; Cowork does not crawl folders on its own.

Why does my Cowork skill not trigger?

The description field is the trigger. Cowork reads every installed skill's description and loads one when your request matches it, so a vague description fires at the wrong times or not at all. Rewrite it to say concretely what the skill does and when to use it, and you can also invoke a skill directly by name.

How do I update a skill without breaking it for teammates?

Version it. Skills are plain-text folders, so Git works if your team is technical; Knack gives non-coders the same thing with immutable version history and one-click rollback. The rule that matters: teammates should pull a published version, never paste a copy, because pasted copies drift and cannot be rolled back.

Can I sell or share Claude Cowork skills?

You can share them freely: the folder is portable, and routes range from a zip file to a Git repo to a marketplace listing. The Knack marketplace hosts free skills today, and Cowork plugins add team-level distribution with private marketplaces for organizations. Paid skill marketplaces exist in the ecosystem too, though the open format means nothing locks a buyer in.

The short version of all of it: draft cheap, test on real work, capture every miss as a rule, version every change, and share one canonical copy instead of ten pasted ones. That is skill development. The draft is Tuesday. The asset is what is left after a month of Mondays.