Skip to content

Commit e30f35d

Browse files
authored
Merge branch 'staged' into addDataverseMcpInstaller
2 parents a629773 + 3de857c commit e30f35d

222 files changed

Lines changed: 1466 additions & 1188 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.all-contributorsrc

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,9 @@
2929
"symbol": "🧰",
3030
"description": "Specialized skills for GitHub Copilot"
3131
},
32-
"collections": {
32+
"plugins": {
3333
"symbol": "🎁",
34-
"description": "Curated collections of related content"
34+
"description": "Curated plugins for GitHub Copilot"
3535
}
3636
},
3737
"ignoreList": [
@@ -51,7 +51,7 @@
5151
"contributions": [
5252
"agents",
5353
"code",
54-
"collections",
54+
"plugins",
5555
"doc",
5656
"infra",
5757
"instructions",
@@ -75,7 +75,7 @@
7575
"profile": "https://www.buymeacoffee.com/troystaylor",
7676
"contributions": [
7777
"agents",
78-
"collections",
78+
"plugins",
7979
"instructions",
8080
"prompts"
8181
]
@@ -97,7 +97,7 @@
9797
"profile": "https://calva.io/",
9898
"contributions": [
9999
"agents",
100-
"collections",
100+
"plugins",
101101
"instructions",
102102
"prompts"
103103
]
@@ -109,7 +109,7 @@
109109
"profile": "https://danielscottraynsford.com/",
110110
"contributions": [
111111
"agents",
112-
"collections",
112+
"plugins",
113113
"instructions",
114114
"prompts"
115115
]
@@ -403,7 +403,7 @@
403403
"profile": "https://www.linkedin.com/in/griffinashe/",
404404
"contributions": [
405405
"agents",
406-
"collections"
406+
"plugins"
407407
]
408408
},
409409
{
@@ -576,7 +576,7 @@
576576
"avatar_url": "https://avatars.githubusercontent.com/u/129743?v=4",
577577
"profile": "http://brunoborges.io/",
578578
"contributions": [
579-
"collections",
579+
"plugins",
580580
"instructions"
581581
]
582582
},
@@ -865,7 +865,7 @@
865865
"profile": "https://github.com/kewalaka",
866866
"contributions": [
867867
"agents",
868-
"collections",
868+
"plugins",
869869
"instructions"
870870
]
871871
},
@@ -957,7 +957,7 @@
957957
"profile": "https://www.linkedin.com/in/niksac",
958958
"contributions": [
959959
"agents",
960-
"collections"
960+
"plugins"
961961
]
962962
},
963963
{
@@ -1110,7 +1110,7 @@
11101110
"avatar_url": "https://avatars.githubusercontent.com/u/10256765?v=4",
11111111
"profile": "https://github.com/oleksiyyurchyna",
11121112
"contributions": [
1113-
"collections",
1113+
"plugins",
11141114
"prompts"
11151115
]
11161116
},
@@ -1821,6 +1821,15 @@
18211821
"contributions": [
18221822
"plugin"
18231823
]
1824+
},
1825+
{
1826+
"login": "bhect0",
1827+
"name": "Héctor Benedicte",
1828+
"avatar_url": "https://avatars.githubusercontent.com/u/96436904?v=4",
1829+
"profile": "https://github.com/bhect0",
1830+
"contributions": [
1831+
"code"
1832+
]
18241833
}
18251834
]
18261835
}

.github/aw/actions-lock.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,34 @@
11
{
22
"entries": {
3+
"actions/checkout@v6.0.2": {
4+
"repo": "actions/checkout",
5+
"version": "v6.0.2",
6+
"sha": "de0fac2e4500dabe0009e67214ff5f5447ce83dd"
7+
},
8+
"actions/download-artifact@v6": {
9+
"repo": "actions/download-artifact",
10+
"version": "v6",
11+
"sha": "018cc2cf5baa6db3ef3c5f8a56943fffe632ef53"
12+
},
313
"actions/github-script@v8": {
414
"repo": "actions/github-script",
515
"version": "v8",
616
"sha": "ed597411d8f924073f98dfc5c65a23a2325f34cd"
717
},
18+
"actions/upload-artifact@v6": {
19+
"repo": "actions/upload-artifact",
20+
"version": "v6",
21+
"sha": "b7c566a772e6b6bfb58ed0dc250532a479d7789f"
22+
},
823
"github/gh-aw/actions/setup@v0.45.7": {
924
"repo": "github/gh-aw/actions/setup",
1025
"version": "v0.45.7",
1126
"sha": "5d8900eb6f6230c9d41a3c30af320150a2361285"
27+
},
28+
"github/gh-aw/actions/setup@v0.46.1": {
29+
"repo": "github/gh-aw/actions/setup",
30+
"version": "v0.46.1",
31+
"sha": "874bdd8271bf8c21902b068fb1ca6a22d2dc4b7a"
1232
}
1333
}
1434
}

.github/workflows/publish.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,6 @@ jobs:
4949
git config user.name "github-actions[bot]"
5050
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
5151
git add -A
52-
git add -f plugins/*/agents/ plugins/*/commands/ plugins/*/skills/
52+
git add -f plugins/*/agents/ plugins/*/skills/
5353
git commit -m "chore: publish from staged [skip ci]" --allow-empty
5454
git push origin HEAD:main --force

.github/workflows/validate-agentic-workflows-pr.yml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,12 +25,16 @@ jobs:
2525
id: check
2626
run: |
2727
# Check for YAML/lock files in workflows/ and any .github/ modifications
28+
# Allow .github/aw/actions-lock.json which is needed for workflow compilation
2829
forbidden=$(git diff --name-only --diff-filter=ACM origin/${{ github.base_ref }}...HEAD -- \
2930
'workflows/**/*.yml' \
3031
'workflows/**/*.yaml' \
3132
'workflows/**/*.lock.yml' \
3233
'.github/*' \
33-
'.github/**')
34+
'.github/**' \
35+
| grep -v '^\.github/aw/actions-lock\.json$' \
36+
| grep -v '^\.github/workflows/validate-agentic-workflows-pr\.yml$' \
37+
|| true)
3438
3539
if [ -n "$forbidden" ]; then
3640
echo "❌ Forbidden files detected:"

AGENTS.md

Lines changed: 10 additions & 30 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
@@ -17,7 +16,6 @@ The Awesome GitHub Copilot repository is a community-driven collection of custom
1716
```
1817
.
1918
├── agents/ # Custom GitHub Copilot agent definitions (.agent.md files)
20-
├── prompts/ # Task-specific prompts (.prompt.md files)
2119
├── instructions/ # Coding standards and guidelines (.instructions.md files)
2220
├── skills/ # Agent Skills folders (each with SKILL.md and optional bundled assets)
2321
├── hooks/ # Automated workflow hooks (folders with README.md + hooks.json)
@@ -55,23 +53,16 @@ npm run skill:create -- --name <skill-name>
5553

5654
## Development Workflow
5755

58-
### Working with Agents, Prompts, Instructions, Skills, and Hooks
56+
### Working with Agents, Instructions, Skills, and Hooks
5957

60-
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:
58+
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:
6159

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

68-
#### Prompt Files (*.prompt.md)
69-
- Must have `agent` field (value should be `'agent'` wrapped in single quotes)
70-
- Must have `description` field (wrapped in single quotes, not empty)
71-
- File names should be lower case with words separated by hyphens
72-
- Recommended to specify `tools` if applicable
73-
- Strongly recommended to specify `model` field
74-
7566
#### Instruction Files (*.instructions.md)
7667
- Must have `description` field (wrapped in single quotes, not empty)
7768
- Must have `applyTo` field specifying file patterns (e.g., `'**.js, **.ts'`)
@@ -102,12 +93,10 @@ All agent files (`*.agent.md`), prompt files (`*.prompt.md`), and instruction fi
10293
- Each workflow is a standalone `.md` file in the `workflows/` directory
10394
- Must have `name` field (human-readable name)
10495
- Must have `description` field (wrapped in single quotes, not empty)
105-
- Should have `triggers` field (array of trigger types, e.g., `['schedule', 'issues']`)
10696
- Contains agentic workflow frontmatter (`on`, `permissions`, `safe-outputs`) and natural language instructions
10797
- File names should be lower case with words separated by hyphens
10898
- Only `.md` files are accepted — `.yml`, `.yaml`, and `.lock.yml` files are blocked by CI
109-
- Optionally includes `tags` field for categorization
110-
- Follow the [GitHub Agentic Workflows specification](https://github.github.com/gh-aw)
99+
- Follow the [GitHub Agentic Workflows specification](https://github.github.com/gh-aw/reference/workflow-structure/)
111100

112101
#### Plugin Folders (plugins/*)
113102
- Each plugin is a folder containing a `.github/plugin/plugin.json` file with metadata
@@ -120,9 +109,9 @@ All agent files (`*.agent.md`), prompt files (`*.prompt.md`), and instruction fi
120109

121110
### Adding New Resources
122111

123-
When adding a new agent, prompt, instruction, skill, hook, workflow, or plugin:
112+
When adding a new agent, instruction, skill, hook, workflow, or plugin:
124113

125-
**For Agents, Prompts, and Instructions:**
114+
**For Agents and Instructions:**
126115
1. Create the file with proper front matter
127116
2. Add the file to the appropriate directory
128117
3. Update the README.md by running: `npm run build`
@@ -140,7 +129,7 @@ When adding a new agent, prompt, instruction, skill, hook, workflow, or plugin:
140129

141130
**For Workflows:**
142131
1. Create a new `.md` file in `workflows/` with a descriptive name (e.g., `daily-issues-report.md`)
143-
2. Include frontmatter with `name`, `description`, `triggers`, plus agentic workflow fields (`on`, `permissions`, `safe-outputs`)
132+
2. Include frontmatter with `name` and `description`, plus agentic workflow fields (`on`, `permissions`, `safe-outputs`)
144133
3. Compile with `gh aw compile --validate` to verify it's valid
145134
4. Update the README.md by running: `npm run build`
146135
5. Verify the workflow appears in the generated README
@@ -207,7 +196,7 @@ When creating a pull request:
207196
3. **File naming**: Verify all new files follow the lower-case-with-hyphens naming convention
208197
4. **Build check**: Run `npm run build` before committing to verify README generation
209198
5. **Line endings**: **Always run `bash scripts/fix-line-endings.sh`** to normalize line endings to LF (Unix-style)
210-
6. **Description**: Provide a clear description of what your agent/prompt/instruction does
199+
6. **Description**: Provide a clear description of what your agent/instruction does
211200
7. **Testing**: If adding a plugin, run `npm run plugin:validate` to ensure validity
212201

213202
### Pre-commit Checklist
@@ -222,13 +211,6 @@ Before submitting your PR, ensure you have:
222211

223212
### Code Review Checklist
224213

225-
For prompt files (*.prompt.md):
226-
- [ ] Has markdown front matter
227-
- [ ] Has `agent` field (value should be `'agent'` wrapped in single quotes)
228-
- [ ] Has non-empty `description` field wrapped in single quotes
229-
- [ ] File name is lower case with hyphens
230-
- [ ] Includes `model` field (strongly recommended)
231-
232214
For instruction files (*.instructions.md):
233215
- [ ] Has markdown front matter
234216
- [ ] Has non-empty `description` field wrapped in single quotes
@@ -266,13 +248,11 @@ For workflow files (workflows/*.md):
266248
- [ ] File has markdown front matter
267249
- [ ] Has `name` field with human-readable name
268250
- [ ] Has non-empty `description` field wrapped in single quotes
269-
- [ ] Has `triggers` array field listing workflow trigger types
270251
- [ ] File name is lower case with hyphens
271252
- [ ] Contains `on` and `permissions` in frontmatter
272253
- [ ] Workflow uses least-privilege permissions and safe outputs
273254
- [ ] No `.yml`, `.yaml`, or `.lock.yml` files included
274-
- [ ] Follows [GitHub Agentic Workflows specification](https://github.github.com/gh-aw)
275-
- [ ] Optionally includes `tags` array field for categorization
255+
- [ ] Follows [GitHub Agentic Workflows specification](https://github.github.com/gh-aw/reference/workflow-structure/)
276256

277257
For plugins (plugins/*/):
278258
- [ ] Directory contains a `.github/plugin/plugin.json` file
@@ -295,7 +275,7 @@ This is a community-driven project. Contributions are welcome! Please see:
295275

296276
## MCP Server
297277

298-
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.
278+
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.
299279

300280
## License
301281

0 commit comments

Comments
 (0)