@@ -50,92 +50,104 @@ What do you want to achieve?
5050
5151## Detailed Guidance
5252
53- ### Use Custom Instructions when:
53+ ### Use Custom Instructions when
5454
5555** Perfect for:**
56+
5657- Enforcing coding standards across all requests
5758- Setting language/framework conventions (e.g., "always use TypeScript strict mode")
5859- Defining commit message or PR description guidelines
5960- Applying rules to specific file types via ` applyTo ` glob patterns
6061- Sharing team coding practices in version control
6162
6263** File types:**
64+
6365| File | Location | Behavior |
6466| ------| ----------| ----------|
6567| ` copilot-instructions.md ` | ` .github/ ` | Applies to all requests |
6668| ` *.instructions.md ` | ` .github/instructions/ ` | Conditional via ` applyTo ` |
6769| ` AGENTS.md ` | Root or subfolders | Multi-agent compatible |
6870
6971** Example use cases:**
72+
7073- "Always use functional React components"
7174- "Follow PEP 8 for Python files"
7275- "Include JSDoc comments for all public functions"
7376- "Use conventional commits format"
7477
7578---
7679
77- ### Use Prompt Files when:
80+ ### Use Prompt Files when
7881
7982** Perfect for:**
83+
8084- Creating reusable workflows (e.g., ` /create-react-form ` , ` /security-review ` )
8185- Scaffolding components, API routes, or modules
8286- Generating tests with consistent patterns
8387- Running the same task repeatedly with variations
8488- Need to specify tools and agent for a specific task
8589
8690** Key features:**
91+
8792- Invoked with ` /promptName ` in chat
8893- Can specify ` agent ` , ` tools ` , and ` model ` in frontmatter
8994- Support variables like ` ${selection} ` , ` ${file} ` , ` ${input:name} `
9095- Can reference instruction files for consistent guidelines
9196
9297** Example use cases:**
98+
9399- ` /create-component ` - Generate a new React component with tests
94100- ` /code-review ` - Perform a security-focused code review
95101- ` /api-route ` - Scaffold a new API endpoint
96102- ` /migration-plan ` - Generate a database migration strategy
97103
98104---
99105
100- ### Use Custom Agents when:
106+ ### Use Custom Agents when
101107
102108** Perfect for:**
109+
103110- Creating specialized AI personas (planner, reviewer, architect)
104111- Restricting available tools (e.g., read-only for planning)
105112- Defining sequential workflows with ** handoffs**
106113- Different tasks need different tool configurations
107114- Using a specific model for certain tasks
108115
109116** Key features:**
117+
110118- Define ` tools ` list to control what the agent can do
111119- Use ` handoffs ` for guided multi-step workflows
112120- Specify ` model ` for optimal performance per task
113121- Set ` infer: false ` to prevent use as subagent
114122
115123** Example agents:**
124+
116125- ** Planner** - Read-only tools, generates implementation plans
117126- ** Reviewer** - Focus on security vulnerabilities and code quality
118127- ** Architect** - Design patterns and system architecture decisions
119128- ** Implementer** - Full editing capabilities for coding tasks
120129
121130---
122131
123- ### Use Agent Skills when:
132+ ### Use Agent Skills when
124133
125134** Perfect for:**
135+
126136- Creating capabilities that work across VS Code, CLI, and coding agent
127137- Need to include scripts, examples, or resources
128138- Building specialized testing/debugging/deployment workflows
129139- Sharing capabilities with the community
130140- Want progressive loading (only loaded when relevant)
131141
132142** Key features:**
143+
133144- Open standard at [ agentskills.io] ( https://agentskills.io/ )
134145- Three-level loading: discovery → instructions → resources
135146- Can include scripts, templates, and example files
136147- Works across GitHub Copilot in VS Code, CLI, and coding agent
137148
138149** Example skills:**
150+
139151- ` webapp-testing ` - Testing workflows with test templates
140152- ` github-actions-debug ` - Debug CI/CD workflows with log analysis
141153- ` api-documentation ` - Generate OpenAPI specs with examples
@@ -194,16 +206,19 @@ What do you want to achieve?
194206## Common Combinations
195207
196208### Planning → Implementation Workflow
209+
1972101 . ** Agent** : ` planner.agent.md ` with read-only tools
1982112 . ** Handoff** : Button to switch to implementation agent
1992123 . ** Instructions** : Shared coding standards apply to both
200213
201214### Consistent Test Generation
215+
2022161 . ** Skill** : ` webapp-testing ` with test templates and utilities
2032172 . ** Prompt** : ` /generate-tests ` that references the skill patterns
2042183 . ** Instructions** : Test naming conventions and coverage requirements
205219
206220### Security-First Development
221+
2072221 . ** Instructions** : Security guidelines applied globally
2082232 . ** Agent** : ` security-reviewer.agent.md ` for dedicated reviews
2092243 . ** Prompt** : ` /security-audit ` for on-demand security checks
0 commit comments