Skip to content

Commit 9e10967

Browse files
Copilotaaronpowell
andcommitted
Update documentation to remove prompts references
Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>
1 parent 9ef6a28 commit 9e10967

3 files changed

Lines changed: 73 additions & 124 deletions

File tree

AGENTS.md

Lines changed: 7 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,9 @@
22

33
## Project Overview
44

5-
The Awesome GitHub Copilot repository is a community-driven collection of custom agents, prompts, and instructions designed to enhance GitHub Copilot experiences across various domains, languages, and use cases. The project includes:
5+
The Awesome GitHub Copilot repository is a community-driven collection of custom agents and instructions designed to enhance GitHub Copilot experiences across various domains, languages, and use cases. The project includes:
66

77
- **Agents** - Specialized GitHub Copilot agents that integrate with MCP servers
8-
- **Prompts** - Task-specific prompts for code generation and problem-solving
98
- **Instructions** - Coding standards and best practices applied to specific file patterns
109
- **Skills** - Self-contained folders with instructions and bundled resources for specialized tasks
1110
- **Hooks** - Automated workflows triggered by specific events during development
@@ -16,7 +15,6 @@ The Awesome GitHub Copilot repository is a community-driven collection of custom
1615
```
1716
.
1817
├── agents/ # Custom GitHub Copilot agent definitions (.agent.md files)
19-
├── prompts/ # Task-specific prompts (.prompt.md files)
2018
├── instructions/ # Coding standards and guidelines (.instructions.md files)
2119
├── skills/ # Agent Skills folders (each with SKILL.md and optional bundled assets)
2220
├── hooks/ # Automated workflow hooks (folders with README.md + hooks.json)
@@ -53,23 +51,16 @@ npm run skill:create -- --name <skill-name>
5351

5452
## Development Workflow
5553

56-
### Working with Agents, Prompts, Instructions, Skills, and Hooks
54+
### Working with Agents, Instructions, Skills, and Hooks
5755

58-
All agent files (`*.agent.md`), prompt files (`*.prompt.md`), and instruction files (`*.instructions.md`) must include proper markdown front matter. Agent Skills are folders containing a `SKILL.md` file with frontmatter and optional bundled assets. Hooks are folders containing a `README.md` with frontmatter and a `hooks.json` configuration file:
56+
All agent files (`*.agent.md`) and instruction files (`*.instructions.md`) must include proper markdown front matter. Agent Skills are folders containing a `SKILL.md` file with frontmatter and optional bundled assets. Hooks are folders containing a `README.md` with frontmatter and a `hooks.json` configuration file:
5957

6058
#### Agent Files (*.agent.md)
6159
- Must have `description` field (wrapped in single quotes)
6260
- File names should be lower case with words separated by hyphens
6361
- Recommended to include `tools` field
6462
- Strongly recommended to specify `model` field
6563

66-
#### Prompt Files (*.prompt.md)
67-
- Must have `agent` field (value should be `'agent'` wrapped in single quotes)
68-
- Must have `description` field (wrapped in single quotes, not empty)
69-
- File names should be lower case with words separated by hyphens
70-
- Recommended to specify `tools` if applicable
71-
- Strongly recommended to specify `model` field
72-
7364
#### Instruction Files (*.instructions.md)
7465
- Must have `description` field (wrapped in single quotes, not empty)
7566
- Must have `applyTo` field specifying file patterns (e.g., `'**.js, **.ts'`)
@@ -107,9 +98,9 @@ All agent files (`*.agent.md`), prompt files (`*.prompt.md`), and instruction fi
10798

10899
### Adding New Resources
109100

110-
When adding a new agent, prompt, instruction, skill, hook, or plugin:
101+
When adding a new agent, instruction, skill, hook, or plugin:
111102

112-
**For Agents, Prompts, and Instructions:**
103+
**For Agents and Instructions:**
113104
1. Create the file with proper front matter
114105
2. Add the file to the appropriate directory
115106
3. Update the README.md by running: `npm run build`
@@ -186,7 +177,7 @@ When creating a pull request:
186177
3. **File naming**: Verify all new files follow the lower-case-with-hyphens naming convention
187178
4. **Build check**: Run `npm run build` before committing to verify README generation
188179
5. **Line endings**: **Always run `bash scripts/fix-line-endings.sh`** to normalize line endings to LF (Unix-style)
189-
6. **Description**: Provide a clear description of what your agent/prompt/instruction does
180+
6. **Description**: Provide a clear description of what your agent/instruction does
190181
7. **Testing**: If adding a plugin, run `npm run plugin:validate` to ensure validity
191182

192183
### Pre-commit Checklist
@@ -201,13 +192,6 @@ Before submitting your PR, ensure you have:
201192

202193
### Code Review Checklist
203194

204-
For prompt files (*.prompt.md):
205-
- [ ] Has markdown front matter
206-
- [ ] Has `agent` field (value should be `'agent'` wrapped in single quotes)
207-
- [ ] Has non-empty `description` field wrapped in single quotes
208-
- [ ] File name is lower case with hyphens
209-
- [ ] Includes `model` field (strongly recommended)
210-
211195
For instruction files (*.instructions.md):
212196
- [ ] Has markdown front matter
213197
- [ ] Has non-empty `description` field wrapped in single quotes
@@ -262,7 +246,7 @@ This is a community-driven project. Contributions are welcome! Please see:
262246

263247
## MCP Server
264248

265-
The repository includes an MCP (Model Context Protocol) Server that provides prompts for searching and installing resources directly from this repository. Docker is required to run the server.
249+
The repository includes an MCP (Model Context Protocol) Server for searching and installing resources directly from this repository. Docker is required to run the server.
266250

267251
## License
268252

CONTRIBUTING.md

Lines changed: 6 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributing to Awesome GitHub Copilot
22

3-
Thank you for your interest in contributing to the Awesome GitHub Copilot repository! We welcome contributions from the community to help expand our collection of custom instructions and prompts.
3+
Thank you for your interest in contributing to the Awesome GitHub Copilot repository! We welcome contributions from the community to help expand our collection of custom instructions and skills.
44

55
## How to Contribute
66

@@ -33,34 +33,6 @@ description: 'Instructions for customizing GitHub Copilot behavior for specific
3333
- Any additional context or examples
3434
```
3535

36-
### Adding Prompts
37-
38-
Prompts are ready-to-use templates for specific development scenarios and tasks.
39-
40-
1. **Create your prompt file**: Add a new `.prompt.md` file in the `prompts/` directory
41-
2. **Follow the naming convention**: Use descriptive, lowercase filenames with hyphens and the `.prompt.md` extension (e.g., `react-component-generator.prompt.md`)
42-
3. **Include frontmatter**: Add metadata at the top of your file (optional but recommended)
43-
4. **Structure your prompt**: Provide clear context and specific instructions
44-
45-
#### Example prompt format
46-
47-
```markdown
48-
---
49-
agent: 'agent'
50-
tools: ['codebase', 'terminalCommand']
51-
description: 'Brief description of what this prompt does'
52-
---
53-
54-
# Prompt Title
55-
56-
Your goal is to...
57-
58-
## Specific Instructions
59-
60-
- Clear, actionable instructions
61-
- Include examples where helpful
62-
```
63-
6436
### Adding an Agent
6537

6638
Agents are specialized configurations that transform GitHub Copilot Chat into domain-specific assistants or personas for particular development scenarios.
@@ -113,7 +85,7 @@ Skills are self-contained folders in the `skills/` directory that include a `SKI
11385

11486
### Adding Plugins
11587

116-
Plugins group related agents, commands (prompts), and skills around specific themes or workflows, making it easy for users to install comprehensive toolkits via GitHub Copilot CLI.
88+
Plugins group related agents, commands, and skills around specific themes or workflows, making it easy for users to install comprehensive toolkits via GitHub Copilot CLI.
11789

11890
1. **Create your plugin**: Run `npm run plugin:create` to scaffold a new plugin
11991
2. **Follow the naming convention**: Use descriptive, lowercase folder names with hyphens (e.g., `python-web-development`)
@@ -165,13 +137,13 @@ plugins/my-plugin-id/
165137

166138
1. **Fork this repository**
167139
2. **Create a new branch** for your contribution
168-
3. **Add your instruction, prompt file, chatmode, or plugin** following the guidelines above
140+
3. **Add your instruction, skill, agent, or plugin** following the guidelines above
169141
4. **Run the update script**: `npm start` to update the README with your new file (make sure you run `npm install` first if you haven't already)
170142
- A GitHub Actions workflow will verify that this step was performed correctly
171143
- If the README.md would be modified by running the script, the PR check will fail with a comment showing the required changes
172144
5. **Submit a pull request** targeting the `staged` branch with:
173145
- A clear title describing your contribution
174-
- A brief description of what your instruction/prompt does
146+
- A brief description of what your instruction/skill/agent does
175147
- Any relevant context or usage notes
176148

177149
> [!IMPORTANT]
@@ -206,7 +178,7 @@ To maintain a safe, responsible, and constructive community, we will **not accep
206178
## Quality Guidelines
207179

208180
- **Be specific**: Generic instructions are less helpful than specific, actionable guidance
209-
- **Test your content**: Ensure your instructions or prompts work well with GitHub Copilot
181+
- **Test your content**: Ensure your instructions or skills work well with GitHub Copilot
210182
- **Follow conventions**: Use consistent formatting and naming
211183
- **Keep it focused**: Each file should address a specific technology, framework, or use case
212184
- **Write clearly**: Use simple, direct language
@@ -231,10 +203,9 @@ We welcome many kinds of contributions, including the custom categories below:
231203
| Category | Description | Emoji |
232204
| --- | --- | :---: |
233205
| **Instructions** | Custom instruction sets that guide GitHub Copilot behavior | 🧭 |
234-
| **Prompts** | Reusable or one-off prompts for GitHub Copilot | ⌨️ |
235206
| **Agents** | Defined GitHub Copilot roles or personalities | 🎭 |
236207
| **Skills** | Specialized knowledge of a task for GitHub Copilot | 🧰 |
237-
| **Plugins** | Installable packages of related prompts, agents, or skills | 🎁 |
208+
| **Plugins** | Installable packages of related agents, commands, or skills | 🎁 |
238209

239210
In addition, all standard contribution types supported by [All Contributors](https://allcontributors.org/emoji-key/) are recognized.
240211

0 commit comments

Comments
 (0)