Create a custom skill
Build, test, and ship your own skill with the Skill Creator.
The fastest way to turn one of your repeatable workflows into a Skill is to let an agent build it with you. The Skill Creator is a built-in Skill that interviews you, drafts the manifest, tests it, and iterates — so you end up with a Skill that actually triggers when it should.
Before you start
Have a workflow in mind that you've done more than once — "rewrite a blog post for Xiaohongshu, LinkedIn, and a video script," for example. The clearer the trigger (when it should run) and the output (what it should produce), the better the result.
Start the Skill Creator
In any agent session, just ask: "Turn this into a skill" or "I do X all the time — make it a skill." The agent loads the built-in Skill Creator and starts the interview. It will ask:
- What should this Skill let the agent do?
- When should it trigger (which phrases or situations)?
- What's the expected output format?
- Should it have test cases?
Define the manifest
Together you fill in the SKILL.md — the manifest at the heart of every Skill:
- name — a short identifier.
- description — what it does and when to use it. This is the primary trigger, so be specific.
- body — the step-by-step instructions the agent follows.
The agent drafts this for you; you review and adjust. See SKILL.md format for the full field reference.
Test in the agent
The Skill Creator writes a few realistic test prompts — the kind of thing a real user would say — and runs them against the new Skill. It shows you the results so you can see whether the Skill triggers and produces the output you wanted.
Iterate until it's reliable
Based on the test results and your feedback, the agent rewrites the description and instructions and re-tests. Repeat until the Skill triggers consistently and the output is right.
Publish or keep local
When you're happy:
- Keep it local — leave the Skill in your workspace (agent or space scope). Click Refresh in Apps & Skills to see it.
- Publish it — package the Skill and put it in a GitHub repo, then list it on the Marketplace so others can install it. See Create a skill repository for the layout.
You can also write a SKILL.md by hand and drop it into the agent's workspace, then Refresh — the Skill Creator just makes the loop faster and tests it for you.