refresh readme

Author: aaronpowell

plugins/awesome-copilot/README.md

@@ -6,7 +6,7 @@ Meta prompts that help you discover and generate curated GitHub Copilot agents,
 
 ```bash
 # Using Copilot CLI
-copilot plugin install github/awesome-copilot/plugins/awesome-copilot
+copilot plugin install awesome-copilot@awesome-copilot
 ```
 
 ## What's Included
@@ -15,16 +15,16 @@ copilot plugin install github/awesome-copilot/plugins/awesome-copilot
 
 | Command | Description |
 |---------|-------------|
-| `/awesome-copilot:suggest-awesome-github-copilot-collections` | Suggest Awesome Github Copilot Collections |
-| `/awesome-copilot:suggest-awesome-github-copilot-instructions` | Suggest Awesome Github Copilot Instructions |
-| `/awesome-copilot:suggest-awesome-github-copilot-prompts` | Suggest Awesome Github Copilot Prompts |
-| `/awesome-copilot:suggest-awesome-github-copilot-agents` | Suggest Awesome Github Copilot Agents |
+| `/awesome-copilot:suggest-awesome-github-copilot-collections` | Suggest relevant GitHub Copilot collections from the awesome-copilot repository based on current repository context and chat history, providing automatic download and installation of collection assets, and identifying outdated collection assets that need updates. |
+| `/awesome-copilot:suggest-awesome-github-copilot-instructions` | Suggest relevant GitHub Copilot instruction files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing instructions in this repository, and identifying outdated instructions that need updates. |
+| `/awesome-copilot:suggest-awesome-github-copilot-prompts` | Suggest relevant GitHub Copilot prompt files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing prompts in this repository, and identifying outdated prompts that need updates. |
+| `/awesome-copilot:suggest-awesome-github-copilot-agents` | Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository, and identifying outdated agents that need updates. |
 
 ### Agents
 
 | Agent | Description |
 |-------|-------------|
-| `meta-agentic-project-scaffold` | Meta Agentic Project Scaffold |
+| `meta-agentic-project-scaffold` | Meta agentic project creation assistant to help users create and manage project workflows effectively. |
 
 ## Source
 

plugins/azure-cloud-development/README.md

@@ -5,50 +5,34 @@ Comprehensive Azure cloud development tools including Infrastructure as Code, se
 ## Installation
 
 ```bash
-copilot plugin install github/awesome-copilot/plugins/azure-cloud-development
+# Using Copilot CLI
+copilot plugin install azure-cloud-development@awesome-copilot
 ```
 
-## Agents
+## What's Included
 
-| Agent | Description |
-|-------|-------------|
-| `azure-principal-architect` | Principal-level Azure architecture guidance |
-| `azure-saas-architect` | SaaS architecture patterns on Azure |
-| `azure-logic-apps-expert` | Azure Logic Apps and workflow automation |
-| `azure-verified-modules-bicep` | Azure Verified Modules with Bicep |
-| `azure-verified-modules-terraform` | Azure Verified Modules with Terraform |
-| `terraform-azure-planning` | Plan Terraform deployments for Azure |
-| `terraform-azure-implement` | Implement Terraform configurations for Azure |
-
-## Commands
+### Commands (Slash Commands)
 
 | Command | Description |
 |---------|-------------|
-| `/azure-cloud-development:azure-resource-health-diagnose` | Diagnose Azure resource health issues |
-| `/azure-cloud-development:az-cost-optimize` | Optimize Azure costs |
-
-## Usage Examples
-
-### Architecture Review
-```
-@azure-principal-architect Review this architecture for a multi-region deployment
-```
+| `/azure-cloud-development:azure-resource-health-diagnose` | Analyze Azure resource health, diagnose issues from logs and telemetry, and create a remediation plan for identified problems. |
+| `/azure-cloud-development:az-cost-optimize` | Analyze Azure resources used in the app (IaC files and/or resources in a target rg) and optimize costs - creating GitHub issues for identified optimizations. |
 
-### Infrastructure as Code
-```
-@terraform-azure-planning Help me plan a Terraform module for an AKS cluster
-```
-
-### Cost Optimization
-```
-/azure-cloud-development:az-cost-optimize
+### Agents
 
-Analyze my Azure subscription for cost savings
-```
+| Agent | Description |
+|-------|-------------|
+| `azure-principal-architect` | Provide expert Azure Principal Architect guidance using Azure Well-Architected Framework principles and Microsoft best practices. |
+| `azure-saas-architect` | Provide expert Azure SaaS Architect guidance focusing on multitenant applications using Azure Well-Architected SaaS principles and Microsoft best practices. |
+| `azure-logic-apps-expert` | Expert guidance for Azure Logic Apps development focusing on workflow design, integration patterns, and JSON-based Workflow Definition Language. |
+| `azure-verified-modules-bicep` | Create, update, or review Azure IaC in Bicep using Azure Verified Modules (AVM). |
+| `azure-verified-modules-terraform` | Create, update, or review Azure IaC in Terraform using Azure Verified Modules (AVM). |
+| `terraform-azure-planning` | Act as implementation planner for your Azure Terraform Infrastructure as Code task. |
+| `terraform-azure-implement` | Act as an Azure Terraform Infrastructure as Code coding specialist that creates and reviews Terraform for Azure resources. |
 
 ## Source
 
-Part of [Awesome Copilot](https://github.com/github/awesome-copilot).
+This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot), a community-driven collection of GitHub Copilot extensions.
 
 ## License
 

plugins/cast-imaging/README.md

@@ -6,7 +6,7 @@ A comprehensive collection of specialized agents for software analysis, impact a
 
 ```bash
 # Using Copilot CLI
-copilot plugin install github/awesome-copilot/plugins/cast-imaging
+copilot plugin install cast-imaging@awesome-copilot
 ```
 
 ## What's Included
@@ -15,9 +15,9 @@ copilot plugin install github/awesome-copilot/plugins/cast-imaging
 
 | Agent | Description |
 |-------|-------------|
-| `cast-imaging-software-discovery` | Cast Imaging Software Discovery |
-| `cast-imaging-impact-analysis` | Cast Imaging Impact Analysis |
-| `cast-imaging-structural-quality-advisor` | Cast Imaging Structural Quality Advisor |
+| `cast-imaging-software-discovery` | Specialized agent for comprehensive software application discovery and architectural mapping through static code analysis using CAST Imaging |
+| `cast-imaging-impact-analysis` | Specialized agent for comprehensive change impact assessment and risk analysis in software systems using CAST Imaging |
+| `cast-imaging-structural-quality-advisor` | Specialized agent for identifying, analyzing, and providing remediation guidance for code quality issues using CAST Imaging |
 
 ## Source
 

plugins/clojure-interactive-programming/README.md

@@ -6,7 +6,7 @@ Tools for REPL-first Clojure workflows featuring Clojure instructions, the inter
 
 ```bash
 # Using Copilot CLI
-copilot plugin install github/awesome-copilot/plugins/clojure-interactive-programming
+copilot plugin install clojure-interactive-programming@awesome-copilot
 ```
 
 ## What's Included
@@ -15,19 +15,13 @@ copilot plugin install github/awesome-copilot/plugins/clojure-interactive-progra
 
 | Command | Description |
 |---------|-------------|
-| `/clojure-interactive-programming:remember-interactive-programming` | Remember Interactive Programming |
+| `/clojure-interactive-programming:remember-interactive-programming` | A micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Driver). Will work with any system that has a live REPL that the agent can use. Adapt the prompt with any specific reminders in your workflow and/or workspace. |
 
 ### Agents
 
 | Agent | Description |
 |-------|-------------|
-| `clojure-interactive-programming` | Clojure Interactive Programming |
-
-### Instructions
-
-| Instruction | Description |
-|-------------|-------------|
-| `clojure` | Clojure |
+| `clojure-interactive-programming` | Expert Clojure pair programmer with REPL-first methodology, architectural oversight, and interactive problem-solving. Enforces quality standards, prevents workarounds, and develops solutions incrementally through live REPL evaluation before file modifications. |
 
 ## Source
 

plugins/copilot-sdk/README.md

@@ -6,7 +6,7 @@ Build applications with the GitHub Copilot SDK across multiple programming langu
 
 ```bash
 # Using Copilot CLI
-copilot plugin install github/awesome-copilot/plugins/copilot-sdk
+copilot plugin install copilot-sdk@awesome-copilot
 ```
 
 ## What's Included
@@ -15,7 +15,7 @@ copilot plugin install github/awesome-copilot/plugins/copilot-sdk
 
 | Skill | Description |
 |-------|-------------|
-| `copilot-sdk` | Build agentic applications with GitHub Copilot SDK |
+| `SKILL.md` | Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent. |
 
 ## Source
 

plugins/copilot-sdk/skills/copilot-sdk

@@ -0,0 +1 @@
+../../../skills/copilot-sdk

plugins/copilot-sdk/skills/copilot-sdk/SKILL.md

@@ -6,7 +6,7 @@ Essential prompts, instructions, and chat modes for C# and .NET development incl
 
 ```bash
 # Using Copilot CLI
-copilot plugin install github/awesome-copilot/plugins/csharp-dotnet-development
+copilot plugin install csharp-dotnet-development@awesome-copilot
 ```
 
 ## What's Included
@@ -15,24 +15,17 @@ copilot plugin install github/awesome-copilot/plugins/csharp-dotnet-development
 
 | Command | Description |
 |---------|-------------|
-| `/csharp-dotnet-development:csharp-async` | Csharp Async |
-| `/csharp-dotnet-development:aspnet-minimal-api-openapi` | Aspnet Minimal Api Openapi |
-| `/csharp-dotnet-development:csharp-xunit` | Csharp Xunit |
-| `/csharp-dotnet-development:dotnet-best-practices` | Dotnet Best Practices |
-| `/csharp-dotnet-development:dotnet-upgrade` | Dotnet Upgrade |
+| `/csharp-dotnet-development:csharp-async` | Get best practices for C# async programming |
+| `/csharp-dotnet-development:aspnet-minimal-api-openapi` | Create ASP.NET Minimal API endpoints with proper OpenAPI documentation |
+| `/csharp-dotnet-development:csharp-xunit` | Get best practices for XUnit unit testing, including data-driven tests |
+| `/csharp-dotnet-development:dotnet-best-practices` | Ensure .NET/C# code meets best practices for the solution/project. |
+| `/csharp-dotnet-development:dotnet-upgrade` | Ready-to-use prompts for comprehensive .NET framework upgrade analysis and execution |
 
 ### Agents
 
 | Agent | Description |
 |-------|-------------|
-| `expert-dotnet-software-engineer` | Expert Dotnet Software Engineer |
-
-### Instructions
-
-| Instruction | Description |
-|-------------|-------------|
-| `csharp` | Csharp |
-| `dotnet-architecture-good-practices` | Dotnet Architecture Good Practices |
+| `expert-dotnet-software-engineer` | Provide expert .NET software engineering guidance using modern software design patterns. |
 
 ## Source
 

plugins/csharp-dotnet-development/README.md

@@ -6,7 +6,7 @@ Complete toolkit for building Model Context Protocol (MCP) servers in C# using t
 
 ```bash
 # Using Copilot CLI
-copilot plugin install github/awesome-copilot/plugins/csharp-mcp-development
+copilot plugin install csharp-mcp-development@awesome-copilot
 ```
 
 ## What's Included
@@ -15,19 +15,13 @@ copilot plugin install github/awesome-copilot/plugins/csharp-mcp-development
 
 | Command | Description |
 |---------|-------------|
-| `/csharp-mcp-development:csharp-mcp-server-generator` | Csharp Mcp Server Generator |
+| `/csharp-mcp-development:csharp-mcp-server-generator` | Generate a complete MCP server project in C# with tools, prompts, and proper configuration |
 
 ### Agents
 
 | Agent | Description |
 |-------|-------------|
-| `csharp-mcp-expert` | Csharp Mcp Expert |
-
-### Instructions
-
-| Instruction | Description |
-|-------------|-------------|
-| `csharp-mcp-server` | Csharp Mcp Server |
+| `csharp-mcp-expert` | Expert assistant for developing Model Context Protocol (MCP) servers in C# |
 
 ## Source
 

plugins/csharp-mcp-development/README.md

@@ -6,7 +6,7 @@ Database administration, SQL optimization, and data management tools for Postgre
 
 ```bash
 # Using Copilot CLI
-copilot plugin install github/awesome-copilot/plugins/database-data-management
+copilot plugin install database-data-management@awesome-copilot
 ```
 
 ## What's Included
@@ -15,24 +15,17 @@ copilot plugin install github/awesome-copilot/plugins/database-data-management
 
 | Command | Description |
 |---------|-------------|
-| `/database-data-management:sql-optimization` | Sql Optimization |
-| `/database-data-management:sql-code-review` | Sql Code Review |
-| `/database-data-management:postgresql-optimization` | Postgresql Optimization |
-| `/database-data-management:postgresql-code-review` | Postgresql Code Review |
+| `/database-data-management:sql-optimization` | Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance. |
+| `/database-data-management:sql-code-review` | Universal SQL code review assistant that performs comprehensive security, maintainability, and code quality analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Focuses on SQL injection prevention, access control, code standards, and anti-pattern detection. Complements SQL optimization prompt for complete development coverage. |
+| `/database-data-management:postgresql-optimization` | PostgreSQL-specific development assistant focusing on unique PostgreSQL features, advanced data types, and PostgreSQL-exclusive capabilities. Covers JSONB operations, array types, custom types, range/geometric types, full-text search, window functions, and PostgreSQL extensions ecosystem. |
+| `/database-data-management:postgresql-code-review` | PostgreSQL-specific code review assistant focusing on PostgreSQL best practices, anti-patterns, and unique quality standards. Covers JSONB operations, array usage, custom types, schema design, function optimization, and PostgreSQL-exclusive security features like Row Level Security (RLS). |
 
 ### Agents
 
 | Agent | Description |
 |-------|-------------|
-| `postgresql-dba` | Postgresql Dba |
-| `ms-sql-dba` | Ms Sql Dba |
-
-### Instructions
-
-| Instruction | Description |
-|-------------|-------------|
-| `ms-sql-dba` | Ms Sql Dba |
-| `sql-sp-generation` | Sql Sp Generation |
+| `postgresql-dba` | Work with PostgreSQL databases using the PostgreSQL extension. |
+| `ms-sql-dba` | Work with Microsoft SQL Server databases using the MS SQL extension. |
 
 ## Source