Skip to main content

create-instructions

Create an instructions file (.instructions.md) for a project rule or convention.

Jump to install

Source facts

Repository
microsoft/vscode
Last source activity
April 8, 2026 at 10:59
Detected SKILL.md language
English
Stars
192,746
Forks
42,911

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
create-instructions
description
Create an instructions file (.instructions.md) for a project rule or convention.
argument-hint
What rule or convention to enforce?
disable-model-invocation
true
Related skill: `agent-customization`. Load and follow **instructions.md** for template and principles. Guide the user to create an instructions file. ## Extract from Conversation First, review the conversation history. If the user has been correcting the agent's output or asking for specific patterns (e.g., "always use X", "never do Y", "follow this style"), generalize that into a persistent instruction. Extract: - Corrections or preferences mentioned during the conversation - Coding patterns the user enforced or requested - Project-specific conventions referenced ## Clarify if Needed If no clear rule emerges from the conversation, clarify: - Should this apply everywhere or only to specific files? - Which technologies or file types are affected? - Is this a hard rule or a preference? Explore the codebase using subagents if you need more context. ## Iterate 1. Draft the instruction and save it. 2. Identify the most ambiguous or weak parts and ask about those. 3. Once finalized, summarize what the instruction enforces, suggest example prompts to see it in action, and propose related customizations to create next. Remember to follow the `agent-customization` guidelines to create highly effective instructions.
View on GitHub