Skip to content

Commit 5e6358c

Browse files
committed
fix: add missing newlines for improved readability in SKILL.md
1 parent 59b5c5c commit 5e6358c

File tree

1 file changed

+19
-4
lines changed
  • .github/skills/copilot-customization-selector

1 file changed

+19
-4
lines changed

.github/skills/copilot-customization-selector/SKILL.md

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -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+
197210
1. **Agent**: `planner.agent.md` with read-only tools
198211
2. **Handoff**: Button to switch to implementation agent
199212
3. **Instructions**: Shared coding standards apply to both
200213

201214
### Consistent Test Generation
215+
202216
1. **Skill**: `webapp-testing` with test templates and utilities
203217
2. **Prompt**: `/generate-tests` that references the skill patterns
204218
3. **Instructions**: Test naming conventions and coverage requirements
205219

206220
### Security-First Development
221+
207222
1. **Instructions**: Security guidelines applied globally
208223
2. **Agent**: `security-reviewer.agent.md` for dedicated reviews
209224
3. **Prompt**: `/security-audit` for on-demand security checks

0 commit comments

Comments
 (0)