Skip to content
Development
Skill

/create-skill

Create a reusable skill (SKILL.md) that packages a workflow.

From plugin
vscode
189k26 skills
Install
$ npx -y skills add microsoft/vscode --skill create-skill --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/create-skill

Context preview

The summary Claude sees to decide when to auto-load this skill.

Create a reusable skill (SKILL.md) that packages a workflow.

SKILL.md

create-skill.SKILL.md
name: create-skill
description: 'Create a reusable skill (SKILL.md) that packages a workflow.'
argument-hint: What should this skill produce?
disable-model-invocation: true

Related skill: `agent-customization`. Load and follow **skills.md** for template and principles.

Guide the user to create a `SKILL.md`.

Extract from Conversation

First, review the conversation history. If the user has been following a multi-step workflow or methodology (e.g., debugging approach, review checklist, implementation pattern), generalize that into a reusable skill. Extract:

  • The step-by-step process being followed
  • Decision points and branching logic
  • Quality criteria or completion checks

Clarify if Needed

If no clear workflow emerges from the conversation, clarify:

  • What outcome should this skill produce?
  • Workspace-scoped or personal?
  • Quick checklist or full multi-step workflow?

Iterate

1. Draft the skill and save it. 2. Identify the most ambiguous or weak parts and ask about those. 3. Once finalized, summarize what the skill produces, suggest example prompts to try it, and propose related customizations to create next.

Remember to follow the `agent-customization` guidelines to create highly effective skills.

Ships withvscode

Visual Studio Code

Get the whole plugin
Stats
188,564
Stars
41,520
Forks
Active
Maintenance
TypeScript
Language
MIT
License
47m ago
Last commit
10y ago
Created

Repo: microsoft/vscode