Create a Skill in Studio

Use Studio›Skills ↗ to package a reusable method, checklist, or procedure that an AI assistant can apply when a task matches.

A Skill is different from a saved Prompt. A Prompt stores reusable text or instructions. A Skill stores when to use a method, the method itself, and optional files such as examples, templates, or reference material.

By the end you will have a Skill with a clear description, instructions, visibility settings, and a test plan.

Time to complete: ~10 minutes

• An active Studio account.
• A repeatable task you want to standardize. Good first candidates are review checklists, report formats, or domain-specific analysis steps.

1. Open Studio›Studio ↗.
2. In the sidebar, open Build > Skills.
3. Click New Skill.

Fill in the Skill details. The description is the most important field because it determines when the assistant loads the Skill.

Write the description as a condition:

• Vague: "Helps with contracts."
• Specific: "Use when reviewing customer contracts to identify renewal dates, termination clauses, liability caps, and missing approvals."

In the instructions field, write the procedure the Skill follows:

When given a customer contract:

1. Extract renewal date, notice period, termination rights, and liability cap.
2. Flag missing approvals or unusual commercial terms.
3. Return a summary table with Risk, Evidence, and Recommended action.

Do not invent missing terms. Mark unknown values as Not found.

Keep the Skill focused on one job. If you need several unrelated procedures, create separate Skills with separate descriptions.

Attach files when the Skill needs examples or reference material:

• A checklist in checklist.md.
• A preferred output template in template.md.
• A sample reviewed contract with comments.

Supporting files are subject to a file-count limit. If you need more material, split the method into smaller Skills or use focused reference files that the instructions call out explicitly. See Structure large Skills with progressive disclosure for guidance.

1. Click Create Skill.
2. Open the saved Skill from the Skills list.
3. Confirm the details page shows the title, description, instructions, attached files, and first version.

From the Skill details page, control where the Skill is available:

1. Click Share.
2. Choose whether to keep the Skill private or share it with the entire workspace.
3. If you want to use the Skill in Vibe, click Publish to Vibe.

Private Skills are visible only to you. Workspace Skills can be found and used by members of the workspace.

Sharing and Vibe availability are separate controls: Share controls who can access the Skill in Studio, while Publish to Vibe makes the Skill available in Vibe.

1. Open the surface where you want to use the Skill.
2. Run a realistic task that matches the description.
3. Compare the output with your expected format.

If you clicked Publish to Vibe, open Vibe Work and run the test there.

Create a new version when you want to change the Skill without overwriting the version that assistants or workflows already use. Studio creates the new version after you save changes.

1. Open the Skill from the Skills list.
2. Update the instructions or attached files.
3. Add version notes that explain what changed, such as Adds liability cap checks or Updates the summary table format.
4. Click Save.
5. Confirm the version history shows the new version.

Older versions stay available for review and rollback. Test the new version before promoting it for production use.

Your Skill is ready if:

• It appears in the Skills list.
• The description explains exactly when the Skill applies.
• The output follows the procedure, format, and constraints you wrote.
• Attached files are relevant and referenced by the instructions.
• Its visibility is correct: private to you or shared with the workspace.
• It is published to Vibe if you need to use it in Vibe Work.
• The version history shows your original version and the updated version.