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
Use with care
50/ 100 5-point scale 2.5 / 5
1 2 3 4 5 6
1Trust17 / 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.

2Reliability7 / 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.

3Adaptability10 / 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.

4Convention7 / 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.

5Effectiveness6 / 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.

6Verifiability3 / 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
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
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 does this skill do, and when should you 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.

What are this skill's strengths and limitations?

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 do you install this skill?

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 do you use this skill?

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

Project Instruction Builder

Turn conversation patterns and preferences into a durable project instruction file.

Dev & Engineering ✓ Microsoft · Official

Custom Agent Builder

Create a focused .agent.md agent from a job description and the user’s conversation context.

Dev & Engineering ✓ Microsoft · Official

Reusable Prompt Creator

Turn recurring tasks into reusable .prompt.md files.

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

Repository Learning Capture

Turn important repository discoveries into reusable skills or instructions.

Dev & Engineering ✓ Microsoft · Official

Code OSS Development Log Viewer

Locate and inspect the latest Code OSS development logs.

Dev & Engineering ✓ Microsoft · Official

Copilot Session Troubleshooter

Explain unexpected Copilot CLI behavior from session-log evidence.

Dev & Engineering ✓ Microsoft · Official

Copilot Chat Troubleshooter

Explain unexpected agent behavior, latency, and tool failures from Copilot Chat debug logs.

Dev & Engineering ✓ Microsoft · Official

Codebase Customization Initializer

Explore a codebase and create or update customization files that help AI coding agents work effectively.

Dev & Engineering ✓ Microsoft · Official

Copilot Chat OpenTelemetry Instrumentation

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

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

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.

Design & Frontend ✓ Microsoft · Official

VS Code CSS Layout Standards

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

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

CPU Profile Analyzer

Find performance bottlenecks in V8 and DevTools performance files.

Dev & Engineering ✓ Microsoft · Official

VS Code Telemetry Error Fix Guide

Trace unhandled telemetry errors to invalid-data producers instead of masking the crash site.

Dev & Engineering ✓ Microsoft · Official

Branch Merge Assistant

Safely merges session work from a topic branch back into its base branch.

Automation & Ops ✓ Microsoft · Official

CI Failure Fixer

Diagnose pull request CI failures and iterate toward a fix.

Related skills