Skip to content

Commit a71a8bb

Browse files
trsdntrsdn
committed
feat: add professional repository structure with auto-release workflow
- Add comprehensive README with badges, TOC, installation methods - Add CONTRIBUTING.md with detailed contribution guidelines - Add CODE_OF_CONDUCT.md (Contributor Covenant v2.1) - Add SECURITY.md with vulnerability reporting process - Add issue templates (bug report, feature request) - Add PR template with structured checklist - Add automatic release workflow with semantic versioning - Add installation script for easy integration - Configure repository topics for discoverability
1 parent 6a8739d commit a71a8bb

22 files changed

+2549
-25
lines changed

‎.github/ISSUE_TEMPLATE/bug_report.yml‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
name: Bug Report
2+
description: Report a bug or unexpected behavior
3+
title: '[Bug]: '
4+
labels: ['bug', 'needs-triage']
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for taking the time to report a bug! Please fill out the form below.
10+
11+
- type: textarea
12+
id: description
13+
attributes:
14+
label: Bug Description
15+
description: A clear and concise description of what the bug is.
16+
placeholder: Describe the bug...
17+
validations:
18+
required: true
19+
20+
- type: textarea
21+
id: reproduce
22+
attributes:
23+
label: Steps to Reproduce
24+
description: Steps to reproduce the behavior
25+
placeholder: |
26+
1. Go to '...'
27+
2. Run command '...'
28+
3. See error
29+
validations:
30+
required: true
31+
32+
- type: textarea
33+
id: expected
34+
attributes:
35+
label: Expected Behavior
36+
description: What you expected to happen
37+
placeholder: I expected...
38+
validations:
39+
required: true
40+
41+
- type: textarea
42+
id: actual
43+
attributes:
44+
label: Actual Behavior
45+
description: What actually happened
46+
placeholder: Instead, this happened...
47+
validations:
48+
required: true
49+
50+
- type: input
51+
id: os
52+
attributes:
53+
label: Operating System
54+
description: What OS are you using?
55+
placeholder: e.g., macOS 14.0, Windows 11, Ubuntu 22.04
56+
validations:
57+
required: true
58+
59+
- type: input
60+
id: vscode
61+
attributes:
62+
label: VS Code Version
63+
description: What version of VS Code are you running?
64+
placeholder: e.g., 1.85.0
65+
validations:
66+
required: true
67+
68+
- type: input
69+
id: copilot
70+
attributes:
71+
label: GitHub Copilot Version
72+
description: What version of GitHub Copilot extension?
73+
placeholder: e.g., 1.150.0
74+
75+
- type: checkboxes
76+
id: affected
77+
attributes:
78+
label: Affected Files/Components
79+
description: Which customization files are affected?
80+
options:
81+
- label: Custom Agent (.agent.md)
82+
- label: Prompt File (.prompt.md)
83+
- label: Instructions File (.instructions.md)
84+
- label: Agent Skill (SKILL.md)
85+
- label: Other
86+
87+
- type: textarea
88+
id: context
89+
attributes:
90+
label: Additional Context
91+
description: Add any other context about the problem here
92+
placeholder: Screenshots, error messages, or log output can be helpful
93+
94+
- type: textarea
95+
id: solution
96+
attributes:
97+
label: Possible Solution
98+
description: (Optional) If you have ideas on how to fix this issue
99+
placeholder: Maybe we could...
100+

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: 💬 Question or Discussion
4+
url: https://github.com/trsdn/github-copilot-agent/discussions
5+
about: Ask questions and discuss ideas with the community
6+
- name: 📚 Documentation
7+
url: https://github.com/trsdn/github-copilot-agent#readme
8+
about: Read the documentation for guidance

‎.github/ISSUE_TEMPLATE/feature_request.yml‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
name: Feature Request
2+
description: Suggest a new feature or enhancement
3+
title: '[Feature]: '
4+
labels: ['enhancement', 'needs-triage']
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for suggesting a new feature! Please fill out the form below.
10+
11+
- type: textarea
12+
id: description
13+
attributes:
14+
label: Feature Description
15+
description: A clear and concise description of the feature you'd like to see
16+
placeholder: I'd like to see...
17+
validations:
18+
required: true
19+
20+
- type: textarea
21+
id: problem
22+
attributes:
23+
label: Problem Statement
24+
description: What problem does this feature solve? Why is it needed?
25+
placeholder: Currently, users face...
26+
validations:
27+
required: true
28+
29+
- type: textarea
30+
id: solution
31+
attributes:
32+
label: Proposed Solution
33+
description: Describe how you envision this feature working
34+
placeholder: The feature would work by...
35+
validations:
36+
required: true
37+
38+
- type: textarea
39+
id: usecase
40+
attributes:
41+
label: Use Case
42+
description: Provide a concrete example of how this feature would be used
43+
placeholder: |
44+
Example scenario:
45+
User wants to: [describe]
46+
Feature enables: [describe]
47+
validations:
48+
required: true
49+
50+
- type: textarea
51+
id: alternatives
52+
attributes:
53+
label: Alternative Solutions
54+
description: Have you considered any alternative approaches?
55+
placeholder: I've also considered...
56+
57+
- type: checkboxes
58+
id: type
59+
attributes:
60+
label: Feature Type
61+
description: What type of contribution is this?
62+
options:
63+
- label: New Agent Skill
64+
- label: New Prompt Template
65+
- label: New Custom Agent
66+
- label: New Instructions File
67+
- label: Enhancement to existing customization
68+
- label: Documentation improvement
69+
- label: Other
70+
71+
- type: textarea
72+
id: context
73+
attributes:
74+
label: Additional Context
75+
description: Add any other context, mockups, or examples
76+
placeholder: Here are some additional details...
77+
78+
- type: checkboxes
79+
id: contribute
80+
attributes:
81+
label: Willingness to Contribute
82+
description: Can you help implement this?
83+
options:
84+
- label: I'd be willing to implement this feature
85+
- label: I'd need help implementing this
86+
- label: I'm just suggesting the idea
87+

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
## Description
2+
3+
<!-- Provide a clear and concise description of your changes -->
4+
5+
## Type of Change
6+
7+
<!-- Mark the relevant option with an 'x' -->
8+
9+
- [ ] 🐛 Bug fix (non-breaking change that fixes an issue)
10+
- [ ] ✨ New feature (non-breaking change that adds functionality)
11+
- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
12+
- [ ] 📚 Documentation update
13+
- [ ] 🎨 Style/formatting change
14+
- [ ] ♻️ Code refactoring
15+
- [ ] ⚡ Performance improvement
16+
- [ ] ✅ Test update
17+
18+
## What Changed?
19+
20+
<!-- Describe the changes in detail -->
21+
22+
### Files Added/Modified
23+
24+
-
25+
-
26+
27+
### Customization Type
28+
29+
- [ ] Custom Agent (`.agent.md`)
30+
- [ ] Prompt File (`.prompt.md`)
31+
- [ ] Instructions File (`.instructions.md`)
32+
- [ ] Agent Skill (`SKILL.md`)
33+
- [ ] Workflow/CI
34+
- [ ] Documentation
35+
- [ ] Other: ___________
36+
37+
## Motivation and Context
38+
39+
<!-- Why is this change required? What problem does it solve? -->
40+
<!-- If it fixes an open issue, please link to the issue here -->
41+
42+
Closes #
43+
44+
## Testing
45+
46+
### How Has This Been Tested?
47+
48+
<!-- Describe the tests you ran to verify your changes -->
49+
50+
- [ ] Tested in VS Code with Copilot Chat
51+
- [ ] Verified prompt template with various inputs
52+
- [ ] Checked agent behavior with different contexts
53+
- [ ] Tested skill functionality
54+
- [ ] Validated file generation
55+
56+
### Test Configuration
57+
58+
- **VS Code Version**:
59+
- **GitHub Copilot Version**:
60+
- **OS**:
61+
62+
## Screenshots (if appropriate)
63+
64+
<!-- Add screenshots to help explain your changes -->
65+
66+
## Checklist
67+
68+
<!-- Mark completed items with an 'x' -->
69+
70+
- [ ] My code follows the style guidelines of this project
71+
- [ ] I have performed a self-review of my own changes
72+
- [ ] I have commented my code, particularly in hard-to-understand areas
73+
- [ ] I have made corresponding changes to the documentation
74+
- [ ] My changes generate no new warnings or errors
75+
- [ ] I have tested my changes thoroughly
76+
- [ ] Any dependent changes have been merged and published
77+
78+
## Additional Notes
79+
80+
<!-- Add any other context about the pull request here -->

‎.github/agents/copilot-customization-builder.agent.md‎

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
description: Create and maintain Copilot customizations (agents, prompt files, instructions, MCP) for VS Code and GitHub Copilot
2+
description: Create and maintain Copilot customizations (agents, prompt files, instructions, skills, MCP) for VS Code and GitHub Copilot
33
name: Copilot Customization Builder
44
tools: ['search', 'fetch', 'editFiles', 'runCommand', 'runSubagent']
55
infer: true
@@ -11,6 +11,7 @@ You help create and evolve GitHub Copilot and VS Code customization artifacts:
1111
- Custom agents (`.agent.md`)
1212
- Prompt files (`.prompt.md`) invoked with `/...`
1313
- Custom instructions (`.github/copilot-instructions.md`, `*.instructions.md`, optional `AGENTS.md`)
14+
- Agent Skills (`.github/skills/<name>/SKILL.md`) for portable, specialized capabilities
1415
- MCP server configurations (`mcp.json`) and related guidance
1516

1617
You are opinionated about correctness, safety, and matching repository conventions.
@@ -28,12 +29,13 @@ You are opinionated about correctness, safety, and matching repository conventio
2829
When a user asks for a new customization, do this:
2930

3031
1. **Clarify the intent**
31-
- Are we creating an *agent*, a *prompt file*, *instructions*, or an *MCP* setup?
32+
- Are we creating an *agent*, a *prompt file*, *instructions*, a *skill*, or an *MCP* setup?
3233
- Scope: workspace-only (this repo) vs user profile vs org/enterprise.
3334
- Target environment: `vscode`, `github-copilot`, or both.
3435

3536
2. **Align with repo conventions**
3637
- Inspect existing `.github/agents/*.agent.md` and `.github/prompts/*.prompt.md`.
38+
- Inspect existing `.github/skills/*/SKILL.md` for skill conventions.
3739
- Match naming, tool naming, and tone.
3840

3941
3. **Design before writing files**
@@ -78,6 +80,28 @@ Frontmatter guidelines:
7880
- File-pattern scoped: `*.instructions.md` with `applyTo: '<glob>'`
7981
- Optional: `AGENTS.md` for repository-level guidance (often used by coding agents)
8082

83+
### Agent Skills
84+
85+
Agent Skills are portable folders of instructions, scripts, and resources that AI agents can load when relevant.
86+
87+
- Project skills: `.github/skills/<skill-name>/SKILL.md` (recommended) or `.claude/skills/<skill-name>/SKILL.md` (legacy)
88+
- Personal skills: `~/.copilot/skills/<skill-name>/SKILL.md` (recommended) or `~/.claude/skills/<skill-name>/SKILL.md` (legacy)
89+
90+
SKILL.md frontmatter:
91+
- `name` (required): Unique identifier, lowercase with hyphens, max 64 chars (e.g., `webapp-testing`)
92+
- `description` (required): What the skill does and when to use it, max 1024 chars. Be specific to help Copilot decide when to load.
93+
94+
Skill body should include:
95+
- What the skill accomplishes
96+
- When to use it (specific triggers and use cases)
97+
- Step-by-step procedures
98+
- Examples of expected input/output
99+
- References to included scripts/resources using relative paths (e.g., `[template](./template.js)`)
100+
101+
Skills can include additional files (scripts, examples, documentation) in the skill directory. These are loaded progressively only when needed.
102+
103+
Skills work across VS Code, Copilot CLI, and Copilot coding agent (portable, open standard).
104+
81105
## Tools, MCP, and safety
82106

83107
- Be mindful of tool approval and URL approval requirements.
@@ -117,6 +141,8 @@ Some frontmatter fields have different behavior depending on where the agent run
117141
- Custom agents (VS Code): https://code.visualstudio.com/docs/copilot/customization/custom-agents
118142
- Prompt files (VS Code): https://code.visualstudio.com/docs/copilot/customization/prompt-files
119143
- Custom instructions (VS Code): https://code.visualstudio.com/docs/copilot/customization/custom-instructions
144+
- Agent Skills (VS Code): https://code.visualstudio.com/docs/copilot/customization/agent-skills
145+
- Agent Skills standard: https://agentskills.io/
120146
- Language models (VS Code): https://code.visualstudio.com/docs/copilot/customization/language-models
121147
- MCP servers (VS Code): https://code.visualstudio.com/docs/copilot/customization/mcp-servers
122148
- Chat tools & approvals (VS Code): https://code.visualstudio.com/docs/copilot/chat/chat-tools

0 commit comments

Comments
 (0)