awesome-copilot-agents repo

.github/ISSUE_TEMPLATE/feature-template.yaml

@@ -0,0 +1,51 @@
+name: Feature Request
+description: Suggest a new Copilot instruction, prompt, skill or agent pattern or improvement
+title: "[FEATURE] <title>"
+labels: ["Feature", "Needs Triage"]
+body:
+- type: checkboxes
+  attributes:
+    label: Is there an existing issue for this?
+    description: Please search to see if an issue already exists for the feature.
+    options:
+    - label: I have searched the existing issues
+      required: true
+- type: dropdown
+  id: file-type
+  attributes:
+    label: What type of feature is this?
+    multiple: true
+    options:
+      - Instruction
+      - Prompt
+      - Custom Agent
+      - Skill
+- type: textarea
+  id: feature-description
+  attributes:
+    label: Describe the Solution
+    description: A concise description of the proposed solution.
+  validations:
+    required: true
+- type: textarea
+  id: alternatives
+  attributes:
+    label: Describe Alternatives
+    description: Mention any patterns, workarounds, or tools you've tried that help Copilot behave better.
+  validations:
+    required: false
+- type: textarea
+  id: additional-context
+  attributes:
+    label: Additional Context
+    description: List relevant languages/frameworks (e.g., Node.js, Terraform), link to examples, or add screenshots.
+  validations:
+    required: false
+- type: checkboxes
+  id: terms
+  attributes:
+    label: Code of Conduct
+    description: By submitting this issue, you agree to follow our Code of Conduct.
+    options:
+      - label: I agree to follow this project's Code of Conduct
+        required: true

.github/workflows/lint.yaml

@@ -0,0 +1,40 @@
+name: Lint
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  markdown-lint:
+    runs-on: ubuntu-latest
+    name: Lint Markdown Files
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '18'
+
+    - name: Install linting tools
+      run: |
+        npm install -g markdownlint-cli2
+        npm install -g awesome-lint
+
+    - name: Run markdownlint
+      run: markdownlint-cli2 "**/*.md" "#node_modules"
+
+    - name: Run awesome-lint
+      run: awesome-lint
+
+    - name: Lint summary
+      if: failure()
+      run: echo "❌ Markdown linting failed. Please fix the issues above and try again."
+
+    - name: Lint success
+      if: success()
+      run: echo "✅ All markdown files are properly formatted!"

.gitignore

@@ -0,0 +1,23 @@
+# OS
+Thumbs.db
+Desktop.ini
+
+# Editors
+.vscode/
+!.vscode/extensions.json
+!.vscode/settings.json
+
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+dist/
+build/
+
+# Python
+__pycache__/
+*.pyc
+.pytest_cache/
+.venv/

.markdownlint.json

@@ -0,0 +1,6 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD033": false,
+  "MD041": false
+}

CODE-OF-CONDUCT.md

@@ -0,0 +1,31 @@
+# Code of Conduct
+
+This project follows the Contributor Covenant Code of Conduct.
+
+## Our Pledge
+
+We pledge to make participation in our community a harassment-free experience for everyone.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment include:
+
+- Being respectful and considerate
+- Giving and gracefully accepting constructive feedback
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior include:
+
+- Harassment or discrimination
+- Trolling, insulting/derogatory comments, and personal attacks
+- Publishing others' private information without permission
+
+## Enforcement
+
+Project maintainers are responsible for clarifying and enforcing standards.
+
+Report issues to the maintainers via GitHub issues or discussions in this repository.
+
+## Attribution
+
+Adapted from the Contributor Covenant, version 2.1: <https://www.contributor-covenant.org/version/2/1/code_of_conduct/>

CONTRIBUTING.md

@@ -0,0 +1,64 @@
+# Contributing
+
+Thanks for contributing to `ReactSphere/awesome-copilot-agents`.
+
+## What To Contribute
+
+We accept:
+
+- Instructions: `*.instructions.md`
+- Prompts: `*.prompt.md`
+- Custom agents: `*.agent.md`
+- Skills: folders that contain a `SKILL.md`
+- MCP links: additions to the README list
+
+## Folder Layout
+
+- `instructions/`
+- `prompts/`
+- `agents/`
+- `skills/`
+- `.refs/` (assets used by docs)
+
+## Conventions
+
+### Markdown Front Matter
+
+Prefer YAML front matter at the top of instruction, prompt, and agent files.
+
+Example:
+
+```yaml
+---
+description: Short description
+applyTo: "**/*.ts"
+---
+```
+
+### Naming
+
+- Instructions: `something.instructions.md`
+- Prompts: `something.prompt.md`
+- Agents: `something.agent.md`
+
+### Content Quality
+
+- Be specific and actionable.
+- Avoid “always do X” rules that conflict with common repositories.
+- Prefer a small number of strong constraints over long checklists.
+
+## Adding A New Entry
+
+1. Add the markdown file to the appropriate folder.
+2. Add a link to it in `README.md` under the correct category.
+3. Ensure links are relative where possible.
+
+## Local Validation (Optional)
+
+If you use markdown linting in your editor or CI, fix warnings before submitting.
+
+## Submitting A Pull Request
+
+1. Create a feature branch.
+2. Commit your change with a short, clear message.
+3. Open a PR describing what you added and why.

README.md

@@ -0,0 +1,101 @@
+# Awesome Copilot Agents [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re)
+
+[![Awesome Copilot Agents](.refs/imgs/awesome-github-copilot.svg)](.refs/imgs/awesome-github-copilot.svg)
+
+A curated list of instructions, prompts, skills, MCPs, and custom agent markdown files to enhance your GitHub Copilot experience.
+
+---
+
+## Contents
+
+- [Why Copilot Agents](#why-copilot-agents)
+- [Instructions](#instructions)
+  - [Boilerplates \& Templates](#boilerplates--templates)
+  - [Languages \& Stacks](#languages--stacks)
+  - [Workflows](#workflows)
+- [Prompts](#prompts)
+- [Custom Agents](#custom-agents)
+- [Agent Skills](#agent-skills)
+- [MCPs](#mcps)
+- [How to Use](#how-to-use)
+
+## Why Copilot Agents
+
+Customized instructions, prompts, skills, MCPs, and custom agents help guide GitHub Copilot by adding repository context: coding standards, toolchains, frameworks, conventions, and preferred workflows.
+
+Tip: Learn more about customizing GitHub Copilot in VS Code in the [VS Code documentation](https://code.visualstudio.com/docs/copilot/customization/overview).
+
+## Instructions
+
+Instructions provide Copilot with repository-specific context to improve suggestions.
+
+### Boilerplates \& Templates
+
+- [Standard Language Template](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/boilerplate-and-templates/standard-language.instructions.md) - A minimal template for new instruction files.
+
+### Languages \& Stacks
+
+- [JavaScript (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/javascript/javascript.instructions.md) - Modern JS for Node.js and browsers.
+- [TypeScript (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/typescript/typescript.instructions.md) - TS in React/Node with strictness and ergonomic patterns.
+
+### Workflows
+
+- [PRD Creation](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/workflows/ai-development-instructions/prd-creation.instructions.md) - Create a Product Requirements Document.
+- [Task Generation](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/workflows/ai-development-instructions/task-generation.instructions.md) - Break a PRD into actionable tasks.
+- [Task Execution](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/workflows/ai-development-instructions/task-execution.instructions.md) - Execute tasks with testing and Git hygiene.
+
+## Prompts
+
+Prompts are reusable task definitions that guide Copilot to produce a specific output.
+
+- [PRD Creation Prompt](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/prompts/ai-development-tasks/prd-creation.prompt.md) - Create a PRD from a feature idea.
+- [Task Generation Prompt](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/prompts/ai-development-tasks/task-generation.prompt.md) - Turn a PRD into a task list.
+- [Task Execution Prompt](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/prompts/ai-development-tasks/task-execution.prompt.md) - Execute a single task safely.
+
+## Custom Agents
+
+Custom agents let you define specialized Copilot personas (planner, architect, debugger, reviewer) as version-controlled markdown.
+
+- [Architect](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/ai-development-mode/architect.agent.md) - Design and plan systems.
+- [Clean Code](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/ai-development-mode/clean-code.agent.md) - Improve readability and maintainability.
+- [Debugger](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/ai-development-mode/debugger.agent.md) - Diagnose and fix bugs.
+- [PRD Creation](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/ai-development-mode/prd-creation.agent.md) - Produce PRDs from rough ideas.
+
+## Agent Skills
+
+Agent Skills are portable, version-controlled folders of instructions and resources that agents can load on demand.
+
+- [Calculator](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/skills/calculator/SKILL.md) - Perform precise arithmetic and conversions.
+
+## MCPs
+
+MCPs (Model Context Protocol servers) connect agents to tools and data sources.
+
+- [GitHub MCP Server](https://github.com/github/github-mcp-server) - Repo, issues, PRs, and workflows.
+- [Model Context Protocol Servers](https://github.com/modelcontextprotocol/servers) - Official reference servers.
+
+## How to Use
+
+### VS Code Setup
+
+1. Install and sign in to GitHub Copilot.
+2. Keep your reusable assets version-controlled so your whole team can share them.
+
+### File Types
+
+| Type                | Purpose                                  |
+| ------------------- | ---------------------------------------- |
+| `*.instructions.md` | Contextual instructions.                 |
+| `*.prompt.md`       | Reusable prompts.                        |
+| `*.agent.md`        | Custom agents (personas).                |
+| `SKILL.md`          | Skill definition inside a skill folder.  |
+
+### Formatting
+
+Use YAML front matter for metadata such as `description`, `mode`, and `applyTo`.
+
+## Contributing
+
+Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Licensed under the MIT License. See [LICENSE](LICENSE).

agents/ai-development-mode/architect.agent.md

@@ -0,0 +1,21 @@
+---
+description: Design and plan systems with clear tradeoffs.
+mode: agent
+---
+
+# Architect
+
+You help design software systems and changes.
+
+## Operating Rules
+
+- Ask clarifying questions when requirements are ambiguous.
+- Prefer small, incremental designs that can ship.
+- Call out assumptions and tradeoffs explicitly.
+- Produce diagrams in ASCII when helpful.
+
+## Deliverables
+
+- A short design summary
+- Key decisions and alternatives
+- A step-by-step implementation outline

agents/ai-development-mode/clean-code.agent.md

@@ -0,0 +1,21 @@
+---
+description: Improve readability, naming, and maintainability.
+mode: agent
+---
+
+# Clean Code
+
+You refactor and review code for clarity and maintainability.
+
+## Priorities
+
+- Make behavior explicit.
+- Reduce surprising control flow.
+- Prefer clear names and small functions.
+- Avoid over-engineering.
+
+## Output
+
+- Suggested edits
+- A brief rationale
+- Any risks or required tests