Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
## Summary

-

## What Changed

-

## Verification

-

## Checklist

- [ ] Links in `README.md` work
- [ ] `npx -y markdownlint-cli2 "**/*.md" "#node_modules"` passes
- [ ] `npx -y awesome-lint` passes
38 changes: 38 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ A curated list of instructions, prompts, skills, MCPs, and custom agent markdown
- [Instructions](#instructions)
- [Boilerplates \& Templates](#boilerplates--templates)
- [Languages \& Stacks](#languages--stacks)
- [Frameworks \& Libraries](#frameworks--libraries)
- [Tools](#tools)
- [Workflows](#workflows)
- [Prompts](#prompts)
- [Custom Agents](#custom-agents)
Expand All @@ -32,15 +34,41 @@ Instructions provide Copilot with repository-specific context to improve suggest
### 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.
- [Standard IaC Tools Boilerplate](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/boilerplate-and-templates/standard-iac-tools.instructions.md) - Boilerplate for infrastructure-as-code repos.

### Languages \& Stacks

- [C (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/c/c.instructions.md) - System utilities and libraries.
- [C# (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/csharp/csharp.instructions.md) - Modern .NET applications.
- [C++ (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/cplusplus/cplusplus.instructions.md) - Modern C++ patterns and performance.
- [Go (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/go/go.instructions.md) - Services and CLIs.
- [Java (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/java/java.instructions.md) - Backend services.
- [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.
- [Kotlin (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/kotlin/kotlin.instructions.md) - Android and JVM services.
- [Lua (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/lua/lua.instructions.md) - Scripting and automation.
- [Python (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/python/python.instructions.md) - Services, scripts, and libraries.
- [Rust (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/rust/rust.instructions.md) - Safe systems programming.
- [Swift (Standard Focus)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/languages/swift/swift.instructions.md) - iOS/macOS apps.
- [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.

### Frameworks \& Libraries

- [Charmbracelet + Cobra CLI (Go)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/frameworks/cobra-cli-go/charmbracelet-cli.instructions.md) - Build interactive CLIs.
- [Express API (Node.js + TypeScript)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/frameworks/nodejs-typescript/express-api.instructions.md) - REST APIs with Express.
- [Next.js (React)](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/frameworks/react/nextjs.instructions.md) - Next.js app conventions.

### Tools

- [Docker](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/tools/docker/docker.instructions.md) - Containerization guidance.
- [GitHub Actions](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/tools/github-actions/github-actions.instructions.md) - Workflow conventions.
- [Terraform](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/tools/infra-as-code/terraform/terraform.instructions.md) - IaC conventions and safety.
- [Playwright](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/tools/testing/playwright/playwright.instructions.md) - Browser test stability.

### Workflows

- [Code Review](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/workflows/code-review.instructions.md) - Review for correctness, security, and regressions.
- [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.
- [Release](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/instructions/workflows/release.instructions.md) - Prepare releases and notes.
- [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.

Expand All @@ -51,6 +79,9 @@ Prompts are reusable task definitions that guide Copilot to produce a specific o
- [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.
- [Bug Triage Prompt](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/prompts/debugging/bug-triage.prompt.md) - Triage a bug report into next steps.
- [Code Review Prompt](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/prompts/code-review/review-changes.prompt.md) - Review a diff/PR for risks.
- [README Writing Prompt](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/prompts/documentation/write-readme.prompt.md) - Draft or improve a README.

## Custom Agents

Expand All @@ -60,12 +91,19 @@ Custom agents let you define specialized Copilot personas (planner, architect, d
- [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.
- [Documentation Writer](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/review-and-quality/documentation.agent.md) - Improve docs and onboarding.
- [Performance Engineer](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/review-and-quality/performance.agent.md) - Identify performance bottlenecks.
- [Security Reviewer](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/review-and-quality/security-reviewer.agent.md) - Review for security risks.
- [Release Manager](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/agents/release/release-manager.agent.md) - Prepare releases and changelogs.

## 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.
- [Git CLI](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/skills/git-cli/SKILL.md) - Safe Git workflows and troubleshooting.
- [Issue Triage](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/skills/issue-triage/SKILL.md) - Turn bug reports into actionable work.
- [Markdown Editor](https://github.com/ReactSphere/awesome-copilot-agents/tree/main/skills/markdown-editor/SKILL.md) - Maintain lint-friendly markdown.

## MCPs

Expand Down
14 changes: 14 additions & 0 deletions agents/release/release-manager.agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
description: Prepare releases and changelogs.
mode: agent
---

# Release Manager

You help prepare releases.

## Output

- Version recommendation
- Release notes draft
- Risk checklist
15 changes: 15 additions & 0 deletions agents/review-and-quality/documentation.agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
description: Improve docs for clarity, correctness, and onboarding.
mode: agent
---

# Documentation Writer

You improve documentation quality and developer onboarding.

## Focus

- Clear examples
- Correct commands
- Troubleshooting tips
- Avoiding outdated guidance
20 changes: 20 additions & 0 deletions agents/review-and-quality/performance.agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
description: Identify performance bottlenecks and propose practical fixes.
mode: agent
---

# Performance Engineer

You focus on runtime performance, memory, and responsiveness.

## Rules

- Prefer measuring before optimizing.
- Call out algorithmic complexity.
- Avoid micro-optimizations that reduce clarity.

## Output

- Bottlenecks and why they matter
- Minimal improvements
- How to measure impact
22 changes: 22 additions & 0 deletions agents/review-and-quality/security-reviewer.agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
description: Review changes for security risks and safe-by-default patterns.
mode: agent
---

# Security Reviewer

You review code and configuration for security issues.

## Focus Areas

- Secrets handling
- Authn/Authz correctness
- Injection risks (SQL, command, template)
- SSRF, path traversal, deserialization
- Dependency and supply-chain concerns

## Output

- Findings ordered by severity
- Concrete mitigation suggestions
- Suggested tests or checks
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
description: Boilerplate instructions for Infrastructure-as-Code repositories.
applyTo: "**/*.{tf,tfvars,tmpl,yaml,yml,json,sh,ps1}"
---

# Standard IaC Tools Instructions

Use these rules when generating or editing IaC code.

## General

- Prefer small, composable modules over monolith templates.
- Keep configuration deterministic and reviewable (avoid generated diffs).
- Treat secrets as out-of-repo. Never inline credentials in code.

## Naming

- Use consistent resource naming (prefix, environment, region).
- Avoid abbreviations unless they are already standard in the org.

## Safety

- Default to least privilege for IAM policies and roles.
- Avoid destructive operations unless explicitly requested.
- If a change can cause downtime, call it out and propose a rollout plan.

## Documentation

- Document module inputs/outputs.
- Add examples for non-obvious usage.
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
description: Instructions for Cobra-based CLIs with Charmbracelet UI.
applyTo: "**/*.go"
---

# Charmbracelet + Cobra CLI Instructions

## UX

- Commands should have clear `Use`, `Short`, and `Long` descriptions.
- Provide examples in help text for non-trivial flags.

## Flags

- Prefer explicit flags over positional arguments.
- Use consistent names across commands.

## Errors

- Return actionable errors (what failed, how to fix).
- Use non-zero exit codes on failure.

## TUI

- Keep render loops deterministic.
- Avoid blocking IO in the UI update loop.
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
description: Instructions for building Express REST APIs with TypeScript.
applyTo: "**/*.{ts,tsx}"
---

# Express API (TypeScript) Instructions

## API Design

- Use consistent error shapes (status, code, message, details).
- Validate inputs at the boundary (params, query, body).
- Prefer explicit HTTP status codes.

## Structure

- Keep routing thin; put business logic in services.
- Keep DB access behind repositories/adapters.
- Avoid global mutable state.

## TypeScript

- Avoid `any`.
- Use `zod`/`yup` style schemas if already present; otherwise use minimal runtime checks.

## Observability

- Log request id / correlation id when available.
- Do not log secrets or full request bodies for auth endpoints.

## Testing

- Add request-level tests for new endpoints.
- Cover auth/permission edge cases.
26 changes: 26 additions & 0 deletions instructions/frameworks/react/nextjs.instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
description: Instructions for Next.js (React) applications.
applyTo: "**/*.{ts,tsx,js,jsx}"
---

# Next.js Instructions

## Routing

- Prefer file-based routing conventions.
- Keep server-only code out of client components.

## Data Fetching

- Prefer server components for data loading when possible.
- Use caching intentionally; call out revalidation settings.

## UI

- Keep components small and accessible.
- Avoid layout shift; size images and reserve space.

## Performance

- Avoid shipping large libraries to the client unless necessary.
- Prefer dynamic import for heavy optional UI.
26 changes: 26 additions & 0 deletions instructions/languages/c/c.instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
description: C standards for system utilities and libraries.
applyTo: "**/*.{c,h}"
---

# C Instructions

## Portability

- Prefer standard C (C11+) and POSIX where appropriate.
- Avoid compiler-specific extensions unless required.

## Memory Safety

- Initialize variables.
- Check allocation and IO return codes.
- Avoid unchecked `strcpy`, `sprintf`.

## Style

- Keep functions small.
- Prefer explicit error handling paths.

## Testing

- Add unit tests for parsing and boundary conditions when feasible.
22 changes: 22 additions & 0 deletions instructions/languages/cplusplus/cplusplus.instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
description: Modern C++ standards for performance-sensitive code.
applyTo: "**/*.{cc,cpp,cxx,h,hpp,hxx}"
---

# C++ Instructions

## Modern C++

- Prefer RAII for resource management.
- Prefer `std::unique_ptr` / `std::shared_ptr` over raw owning pointers.
- Prefer `std::string_view` for non-owning string parameters.

## Safety

- Avoid undefined behavior.
- Prefer bounds-checked access for untrusted inputs.

## Performance

- Avoid unnecessary allocations.
- Measure before optimizing.
27 changes: 27 additions & 0 deletions instructions/languages/csharp/csharp.instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
description: C# standards for modern .NET applications.
applyTo: "**/*.{cs,csx}"
---

# C# Instructions

## Language

- Use nullable reference types.
- Prefer records for immutable data.
- Prefer `async`/`await` over blocking calls.

## APIs

- Validate inputs and return meaningful errors.
- Avoid exposing internal types.

## Dependency Injection

- Keep constructors simple.
- Prefer interfaces for external dependencies.

## Testing

- Add tests for business logic.
- Prefer deterministic tests (avoid timing flakiness).
26 changes: 26 additions & 0 deletions instructions/languages/go/go.instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
description: Go standards for services and CLIs.
applyTo: "**/*.go"
---

# Go Instructions

## Style

- Follow `gofmt`.
- Prefer small packages with clear responsibilities.

## Errors

- Wrap errors with context.
- Prefer sentinel errors only when callers need to branch.

## Concurrency

- Avoid goroutine leaks.
- Use contexts for cancellation and timeouts.

## Testing

- Use table-driven tests.
- Avoid reliance on wall clock time.
Loading
Loading