Dev & Engineering ✓ Microsoft · Official skill-authoringworkflow-designconversation-analysismarkdownagent-customization

Workflow Skill Builder

Turns a conversation's working method into a reusable SKILL.md.

FollowSkills review · FSRS-2.0
Not recommended
50/ 100 5-point scale 2.5 / 5
Trust17 / 25 · 3.4/5

The skill asks the user to review conversation context, clarify scope, and iterate before finalizing; no malware, credential theft, covert exfiltration, or high-risk external action is evident. However, saving SKILL.md lacks explicit confirmation, sensitive-data handling, rollback, and data-flow disclosure, so points are deducted.

Reliability7 / 20 · 1.8/5

The workflow is internally coherent: extract a workflow, clarify when needed, draft, iterate, and summarize. Reliability is reduced because it depends on the unavailable agent-customization/skills.md and gives no diagnosable handling for unclear workflows, invalid input, or save failures.

Adaptability10 / 15 · 3.3/5

The audience and core scenario are clear: turning an existing conversation into a reusable SKILL.md, with workspace/personal and checklist/full-workflow choices. Trigger boundaries, non-fit cases, Chinese-language support, and local-network fit are not specified, so points are deducted.

Convention7 / 15 · 2.3/5

The file has usable name, description, argument-hint, and invocation metadata and is concise. It lacks installation guidance, versioning, changelog, explicit maintenance ownership, limitation disclosure, and a self-contained dependency guide, so points are deducted.

Effectiveness6 / 15 · 2.0/5

It plausibly covers the core task of extracting a workflow, drafting a skill, eliciting weak points, and suggesting example prompts. Template quality criteria, output-completeness checks, and comparative benefit evidence are limited, and the result still requires human review, limiting the static score.

Verifiability3 / 10 · 1.5/5

The SKILL.md is auditable primary material and supports limited conclusions about the intended workflow. There are no skill-specific tests, representative generated outputs, execution records, or third-party corroboration; the supplied CI evidence does not cover this path, so points are deducted.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 5b3e1be7be9e
Before you use it
  • The referenced agent-customization guidance is not included in the evidence, so template, naming, and quality standards may not be reproducible without it.
  • The save step does not specify confirmation before writing, sensitive-content redaction, or recovery after failure.
  • There is no clear stop condition or error feedback when a conversation does not yield a coherent workflow.
  • Chinese-language behavior, cross-platform conditions, and mainland-China network suitability are unspecified.
See the full review method →

What it does & when to use it

This skill guides users in creating a reusable SKILL.md that packages a workflow. It reviews the conversation to extract steps, branching decisions, and completion criteria; when no clear workflow exists, it asks about the outcome, scope, and desired level of detail. It drafts and saves the skill, asks about its most ambiguous or weak areas, and, after finalization, summarizes the result, suggests example prompts, and proposes related customizations. The skill is located in the Copilot assets of the microsoft/vscode repository, which is licensed under MIT.

It reviews the conversation history to determine whether a generalizable multi-step workflow or methodology is present. From that workflow, it extracts the sequence of actions, decision points, quality criteria, and completion checks. If no clear workflow emerges, it asks what the skill should produce, whether it is workspace-scoped or personal, and whether it should be a quick checklist or a full workflow. It then drafts and saves a SKILL.md, identifies the most ambiguous or weak parts and asks about them; after finalization, it summarizes the output, suggests example prompts, and proposes related customizations. It also instructs the user to follow the agent-customization skill and skills.md for templates and principles.

  1. A developer has completed a debugging or implementation process in a conversation and wants to make it reusable.
  2. A team member repeats the same code-review process and wants its decision points and completion criteria captured in SKILL.md.
  3. A skill author has a rough working method but has not defined its output, scope, or workflow depth.
  4. A user has a draft skill and wants iterative questions to expose ambiguous or weak sections.
  5. A user wants trial prompts and ideas for related customizations after the skill is finalized.

Pros & cons

Pros
  • Extracts steps, branching logic, and quality criteria from an existing conversation rather than producing only a generic description.
  • Clarifies the desired output, scope, and workflow depth when no clear process is available.
  • Includes drafting, saving, weakness discovery, questioning, and final summarization.
  • Provides example prompts and related customization suggestions after finalization.
Limitations
  • It depends on the agent-customization skill and skills.md, whose specific template and principles are not included in the supplied source.
  • The source does not document a standalone installation command, installation location, or exact invocation syntax.
  • It provides no documented validation or test procedure for the generated SKILL.md.
  • Its frontmatter uses disable-model-invocation, so clients that do not support that field require adaptation.

How to install

Obtain the repository from https://github.com/microsoft/vscode and use extensions/copilot/assets/prompts/skills/create-skill/ as this skill's directory; it contains SKILL.md. The README does not document a separate installation command, target installation location, or other installation procedure for this skill or the bundled collection. The repository as a whole uses the MIT license.

How to use

Manually invoke the skill in a compatible environment, then ask it to create a skill; for example: “Create a reusable SKILL.md from the code-review process we followed above.” Answer its questions about the intended output, scope, workflow format, and weak sections in the draft. SKILL.md disables model invocation, so it should not be assumed to trigger automatically from ordinary conversation; the source does not specify an invocation syntax.

FAQ

Does this skill have an additional cost?
The source does not state separate pricing for the skill. It is included in the microsoft/vscode repository, which uses the MIT license, but costs associated with a particular runtime are outside the supplied information.
What does it read or modify?
It reviews the current conversation history and, as instructed, drafts and saves a SKILL.md. The source does not show a need for network access, a shell, MCP, or other external dependencies.
Can it discover a workflow automatically?
It first looks for a clear multi-step process in the conversation. If none is present, it switches to clarification questions, so the user must provide the intended outcome, scope, and workflow format when the conversation is insufficient.
Will it work unchanged in every Agent Skills client?
The core artifact is a SKILL.md, but its frontmatter includes disable-model-invocation. It can be used as-is in Claude Code; other clients may need that field removed or adapted, depending on their support.

More skills from this repository

All from microsoft/vscode

Dev & Engineering ✓ Microsoft · Official

Tool Rename Compatibility Check

Protect existing prompts and tool configurations when built-in tools are renamed.

Dev & Engineering ✓ Microsoft · Official

Copilot Chat OpenTelemetry Instrumentation

A repository-specific guide for consistent OpenTelemetry instrumentation in Copilot Chat.

Dev & Engineering ✓ Microsoft · Official

VS Code Configuration Policy Maintainer

Standardize VS Code policy registration, export, and validation.

Design & Frontend ✓ Microsoft · Official

VS Code Design Philosophy

Turn vague UI discomfort into concrete fixes using shared values, principles, and design moves.

Dev & Engineering ✓ Microsoft · Official

Agent Host E2E Test Assistant

Maintain VS Code Agent Host end-to-end tests with strict replay fixtures.

Dev & Engineering ✓ Microsoft · Official

VS Code Integrated Browser Architecture

A practical architecture guide for safely changing VS Code's cross-process integrated browser.

Dev & Engineering ✓ Microsoft · Official

VS Code Agents Window Sessions

Safely implement and repair VS Code Agents window features.

Dev & Engineering ✓ Microsoft · Official

Commit Assistant

Creates repository-style commit messages and safely commits code changes.

Dev & Engineering ✓ Microsoft · Official

Agent Host Log Investigator

Trace session, transport, and host failures in Agent Host debug exports.

Dev & Engineering ✓ Microsoft · Official

VS Code Unit Test Runner

Run VS Code repository unit tests by file, test name, or compiled-output glob.

Dev & Engineering ✓ Microsoft · Official

VS Code Agent Customization Assistant

Create, repair, and troubleshoot VS Code Agent customization files and their loading behavior.

Dev & Engineering ✓ Microsoft · Official

Code OSS Launch & Debug

Launch a built-from-source VS Code with isolated profiles, Playwright control, and multi-process debugging ports.

Dev & Engineering ✓ Microsoft · Official

VS Code Accessibility Development Guide

A practical specification for accessible interactive features in VS Code.

Design & Frontend ✓ Microsoft · Official

VS Code CSS Layout Standards

Build reliable VS Code-style CSS layouts and text truncation behavior

Dev & Engineering ✓ Microsoft · Official

VS Code Chat Performance Lab

Benchmark chat rendering and detect memory growth across VS Code builds.

Dev & Engineering ✓ Microsoft · Official

Component Fixtures for Screenshot Testing

Create stable, theme-aware VS Code component fixtures for isolated screenshot testing.

Dev & Engineering ✓ Microsoft · Official

VS Code Smoke Test Assistant

Run, filter, and debug VS Code end-to-end smoke tests.

Dev & Engineering ✓ Microsoft · Official

VS Code Crash Dump Symbolicator

Turn native VS Code crash dumps into readable backtraces with method names.

Dev & Engineering ✓ Microsoft · Official

Local VS Code Web Workbench

Validate VS Code workbench and Agents window changes in a local vscode.dev instance.

Dev & Engineering ✓ Microsoft · Official

Feedback Action

Reads current-session feedback and applies the requested code changes.

Related skills