mirror of
https://github.com/github/awesome-copilot.git
synced 2026-02-20 10:25:13 +00:00
Merge pull request #588 from shibicr93/feat/openapi-to-application-collections
Add OpenAPI-to-Application collections for 5 common frameworks
This commit is contained in:
Aaron Powell
GitHub
38
agents/openapi-to-application.agent.md
Normal file
38
agents/openapi-to-application.agent.md
Normal file
@@ -0,0 +1,38 @@
|
||||
---
|
||||
description: 'Expert assistant for generating working applications from OpenAPI specifications'
|
||||
name: 'OpenAPI to Application Generator'
|
||||
model: 'GPT-4.1'
|
||||
tools: ['codebase', 'edit/editFiles', 'search/codebase']
|
||||
---
|
||||
|
||||
# OpenAPI to Application Generator
|
||||
|
||||
You are an expert software architect specializing in translating API specifications into complete, production-ready applications. Your expertise spans multiple frameworks, languages, and technologies.
|
||||
|
||||
## Your Expertise
|
||||
|
||||
- **OpenAPI/Swagger Analysis**: Parsing and validating OpenAPI 3.0+ specifications for accuracy and completeness
|
||||
- **Application Architecture**: Designing scalable, maintainable application structures aligned with REST best practices
|
||||
- **Code Generation**: Scaffolding complete application projects with controllers, services, models, and configurations
|
||||
- **Framework Patterns**: Applying framework-specific conventions, dependency injection, error handling, and testing patterns
|
||||
- **Documentation**: Generating comprehensive inline documentation and API documentation from OpenAPI specs
|
||||
|
||||
## Your Approach
|
||||
|
||||
- **Specification-First**: Start by analyzing the OpenAPI spec to understand endpoints, request/response schemas, authentication, and requirements
|
||||
- **Framework-Optimized**: Generate code following the active framework's conventions, patterns, and best practices
|
||||
- **Complete & Functional**: Produce code that is immediately testable and deployable, not just scaffolding
|
||||
- **Best Practices**: Apply industry-standard patterns for error handling, logging, validation, and security
|
||||
- **Clear Communication**: Explain architectural decisions, file structure, and generated code sections
|
||||
|
||||
## Guidelines
|
||||
|
||||
- Always validate the OpenAPI specification before generating code
|
||||
- Request clarification on ambiguous schemas, authentication methods, or requirements
|
||||
- Structure the generated application with separation of concerns (controllers, services, models, repositories)
|
||||
- Include proper error handling, input validation, and logging throughout
|
||||
- Generate configuration files and build scripts appropriate for the framework
|
||||
- Provide clear instructions for running and testing the generated application
|
||||
- Document the generated code with comments and docstrings
|
||||
- Suggest testing strategies and example test cases
|
||||
- Consider scalability, performance, and maintainability in architectural decisions
|
||||
@@ -0,0 +1,14 @@
|
||||
id: openapi-to-application-csharp-dotnet
|
||||
name: OpenAPI to Application - C# .NET
|
||||
description: 'Generate production-ready .NET applications from OpenAPI specifications. Includes ASP.NET Core project scaffolding, controller generation, entity framework integration, and C# best practices.'
|
||||
tags: [openapi, code-generation, api, csharp, dotnet, aspnet]
|
||||
items:
|
||||
- path: agents/openapi-to-application.agent.md
|
||||
kind: agent
|
||||
- path: instructions/csharp.instructions.md
|
||||
kind: instruction
|
||||
- path: prompts/openapi-to-application-code.prompt.md
|
||||
kind: prompt
|
||||
display:
|
||||
ordering: manual
|
||||
show_badge: false
|
||||
13
collections/openapi-to-application-csharp-dotnet.md
Normal file
13
collections/openapi-to-application-csharp-dotnet.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# OpenAPI to Application - C# .NET
|
||||
|
||||
Generate production-ready .NET applications from OpenAPI specifications. Includes ASP.NET Core project scaffolding, controller generation, entity framework integration, and C# best practices.
|
||||
|
||||
**Tags:** openapi, code-generation, api, csharp, dotnet, aspnet
|
||||
|
||||
## Items in this Collection
|
||||
|
||||
| Title | Type | Description | MCP Servers |
|
||||
| ----- | ---- | ----------- | ----------- |
|
||||
| [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Agent | Expert assistant for generating working applications from OpenAPI specifications | |
|
||||
| [C# Development](../instructions/csharp.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fcsharp.instructions.md) | Instruction | Guidelines for building C# applications | |
|
||||
| [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Prompt | Generate a complete, production-ready application from an OpenAPI specification | |
|
||||
14
collections/openapi-to-application-go.collection.yml
Normal file
14
collections/openapi-to-application-go.collection.yml
Normal file
@@ -0,0 +1,14 @@
|
||||
id: openapi-to-application-go
|
||||
name: OpenAPI to Application - Go
|
||||
description: 'Generate production-ready Go applications from OpenAPI specifications. Includes project scaffolding, handler generation, middleware setup, and Go best practices for REST APIs.'
|
||||
tags: [openapi, code-generation, api, go, golang]
|
||||
items:
|
||||
- path: agents/openapi-to-application.agent.md
|
||||
kind: agent
|
||||
- path: instructions/go.instructions.md
|
||||
kind: instruction
|
||||
- path: prompts/openapi-to-application-code.prompt.md
|
||||
kind: prompt
|
||||
display:
|
||||
ordering: manual
|
||||
show_badge: false
|
||||
13
collections/openapi-to-application-go.md
Normal file
13
collections/openapi-to-application-go.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# OpenAPI to Application - Go
|
||||
|
||||
Generate production-ready Go applications from OpenAPI specifications. Includes project scaffolding, handler generation, middleware setup, and Go best practices for REST APIs.
|
||||
|
||||
**Tags:** openapi, code-generation, api, go, golang
|
||||
|
||||
## Items in this Collection
|
||||
|
||||
| Title | Type | Description | MCP Servers |
|
||||
| ----- | ---- | ----------- | ----------- |
|
||||
| [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Agent | Expert assistant for generating working applications from OpenAPI specifications | |
|
||||
| [Go Development Instructions](../instructions/go.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fgo.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fgo.instructions.md) | Instruction | Instructions for writing Go code following idiomatic Go practices and community standards | |
|
||||
| [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Prompt | Generate a complete, production-ready application from an OpenAPI specification | |
|
||||
@@ -0,0 +1,14 @@
|
||||
id: openapi-to-application-java-spring-boot
|
||||
name: OpenAPI to Application - Java Spring Boot
|
||||
description: 'Generate production-ready Spring Boot applications from OpenAPI specifications. Includes project scaffolding, REST controller generation, service layer organization, and Spring Boot best practices.'
|
||||
tags: [openapi, code-generation, api, java, spring-boot]
|
||||
items:
|
||||
- path: agents/openapi-to-application.agent.md
|
||||
kind: agent
|
||||
- path: instructions/springboot.instructions.md
|
||||
kind: instruction
|
||||
- path: prompts/openapi-to-application-code.prompt.md
|
||||
kind: prompt
|
||||
display:
|
||||
ordering: manual
|
||||
show_badge: false
|
||||
13
collections/openapi-to-application-java-spring-boot.md
Normal file
13
collections/openapi-to-application-java-spring-boot.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# OpenAPI to Application - Java Spring Boot
|
||||
|
||||
Generate production-ready Spring Boot applications from OpenAPI specifications. Includes project scaffolding, REST controller generation, service layer organization, and Spring Boot best practices.
|
||||
|
||||
**Tags:** openapi, code-generation, api, java, spring-boot
|
||||
|
||||
## Items in this Collection
|
||||
|
||||
| Title | Type | Description | MCP Servers |
|
||||
| ----- | ---- | ----------- | ----------- |
|
||||
| [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Agent | Expert assistant for generating working applications from OpenAPI specifications | |
|
||||
| [Spring Boot Development](../instructions/springboot.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fspringboot.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fspringboot.instructions.md) | Instruction | Guidelines for building Spring Boot base applications | |
|
||||
| [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Prompt | Generate a complete, production-ready application from an OpenAPI specification | |
|
||||
@@ -0,0 +1,14 @@
|
||||
id: openapi-to-application-nodejs-nestjs
|
||||
name: OpenAPI to Application - Node.js NestJS
|
||||
description: 'Generate production-ready NestJS applications from OpenAPI specifications. Includes project scaffolding, controller and service generation, TypeScript best practices, and enterprise patterns.'
|
||||
tags: [openapi, code-generation, api, nodejs, typescript, nestjs]
|
||||
items:
|
||||
- path: agents/openapi-to-application.agent.md
|
||||
kind: agent
|
||||
- path: instructions/nestjs.instructions.md
|
||||
kind: instruction
|
||||
- path: prompts/openapi-to-application-code.prompt.md
|
||||
kind: prompt
|
||||
display:
|
||||
ordering: manual
|
||||
show_badge: false
|
||||
13
collections/openapi-to-application-nodejs-nestjs.md
Normal file
13
collections/openapi-to-application-nodejs-nestjs.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# OpenAPI to Application - Node.js NestJS
|
||||
|
||||
Generate production-ready NestJS applications from OpenAPI specifications. Includes project scaffolding, controller and service generation, TypeScript best practices, and enterprise patterns.
|
||||
|
||||
**Tags:** openapi, code-generation, api, nodejs, typescript, nestjs
|
||||
|
||||
## Items in this Collection
|
||||
|
||||
| Title | Type | Description | MCP Servers |
|
||||
| ----- | ---- | ----------- | ----------- |
|
||||
| [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Agent | Expert assistant for generating working applications from OpenAPI specifications | |
|
||||
| [NestJS Development Best Practices](../instructions/nestjs.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fnestjs.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fnestjs.instructions.md) | Instruction | NestJS development standards and best practices for building scalable Node.js server-side applications | |
|
||||
| [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Prompt | Generate a complete, production-ready application from an OpenAPI specification | |
|
||||
@@ -0,0 +1,14 @@
|
||||
id: openapi-to-application-python-fastapi
|
||||
name: OpenAPI to Application - Python FastAPI
|
||||
description: 'Generate production-ready FastAPI applications from OpenAPI specifications. Includes project scaffolding, route generation, dependency injection, and Python best practices for async APIs.'
|
||||
tags: [openapi, code-generation, api, python, fastapi]
|
||||
items:
|
||||
- path: agents/openapi-to-application.agent.md
|
||||
kind: agent
|
||||
- path: instructions/python.instructions.md
|
||||
kind: instruction
|
||||
- path: prompts/openapi-to-application-code.prompt.md
|
||||
kind: prompt
|
||||
display:
|
||||
ordering: manual
|
||||
show_badge: false
|
||||
13
collections/openapi-to-application-python-fastapi.md
Normal file
13
collections/openapi-to-application-python-fastapi.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# OpenAPI to Application - Python FastAPI
|
||||
|
||||
Generate production-ready FastAPI applications from OpenAPI specifications. Includes project scaffolding, route generation, dependency injection, and Python best practices for async APIs.
|
||||
|
||||
**Tags:** openapi, code-generation, api, python, fastapi
|
||||
|
||||
## Items in this Collection
|
||||
|
||||
| Title | Type | Description | MCP Servers |
|
||||
| ----- | ---- | ----------- | ----------- |
|
||||
| [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Agent | Expert assistant for generating working applications from OpenAPI specifications | |
|
||||
| [Python Coding Conventions](../instructions/python.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpython.instructions.md)<br />[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpython.instructions.md) | Instruction | Python coding conventions and guidelines | |
|
||||
| [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Prompt | Generate a complete, production-ready application from an OpenAPI specification | |
|
||||
@@ -95,6 +95,7 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
|
||||
| [Neon Migration Specialist](../agents/neon-migration-specialist.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-migration-specialist.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-migration-specialist.agent.md) | Safe Postgres migrations with zero-downtime using Neon's branching workflow. Test schema changes in isolated database branches, validate thoroughly, then apply to production—all automated with support for Prisma, Drizzle, or your favorite ORM. | |
|
||||
| [Neon Performance Analyzer](../agents/neon-optimization-analyzer.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-optimization-analyzer.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fneon-optimization-analyzer.agent.md) | Identify and fix slow Postgres queries automatically using Neon's branching workflow. Analyzes execution plans, tests optimizations in isolated database branches, and provides clear before/after performance metrics with actionable code fixes. | |
|
||||
| [Octopus Release Notes With Mcp](../agents/octopus-deploy-release-notes-mcp.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md) | Generate release notes for a release in Octopus Deploy. The tools for this MCP server provide access to the Octopus Deploy APIs. | octopus<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D) |
|
||||
| [OpenAPI to Application Generator](../agents/openapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fopenapi-to-application.agent.md) | Expert assistant for generating working applications from OpenAPI specifications | |
|
||||
| [PagerDuty Incident Responder](../agents/pagerduty-incident-responder.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md) | Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs. | [pagerduty](https://github.com/mcp/io.github.PagerDuty/pagerduty-mcp)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D) |
|
||||
| [PHP MCP Expert](../agents/php-mcp-expert.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fphp-mcp-expert.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fphp-mcp-expert.agent.md) | Expert assistant for PHP MCP server development using the official PHP SDK with attribute-based discovery | |
|
||||
| [Pimcore Expert](../agents/pimcore-expert.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpimcore-expert.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpimcore-expert.agent.md) | Expert Pimcore development assistant specializing in CMS, DAM, PIM, and E-Commerce solutions with Symfony integration | |
|
||||
|
||||
@@ -31,6 +31,11 @@ Curated collections of related prompts, instructions, and agents organized aroun
|
||||
| [Java MCP Server Development](../collections/java-mcp-development.md) | Complete toolkit for building Model Context Protocol servers in Java using the official MCP Java SDK with reactive streams and Spring Boot integration. | 3 items | java, mcp, model-context-protocol, server-development, sdk, reactive-streams, spring-boot, reactor |
|
||||
| [Kotlin MCP Server Development](../collections/kotlin-mcp-development.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 3 items | kotlin, mcp, model-context-protocol, kotlin-multiplatform, server-development, ktor |
|
||||
| [MCP-based M365 Agents](../collections/mcp-m365-copilot.md) | Comprehensive collection for building declarative agents with Model Context Protocol integration for Microsoft 365 Copilot | 5 items | mcp, m365-copilot, declarative-agents, api-plugins, model-context-protocol, adaptive-cards |
|
||||
| [OpenAPI to Application - C# .NET](../collections/openapi-to-application-csharp-dotnet.md) | Generate production-ready .NET applications from OpenAPI specifications. Includes ASP.NET Core project scaffolding, controller generation, entity framework integration, and C# best practices. | 3 items | openapi, code-generation, api, csharp, dotnet, aspnet |
|
||||
| [OpenAPI to Application - Go](../collections/openapi-to-application-go.md) | Generate production-ready Go applications from OpenAPI specifications. Includes project scaffolding, handler generation, middleware setup, and Go best practices for REST APIs. | 3 items | openapi, code-generation, api, go, golang |
|
||||
| [OpenAPI to Application - Java Spring Boot](../collections/openapi-to-application-java-spring-boot.md) | Generate production-ready Spring Boot applications from OpenAPI specifications. Includes project scaffolding, REST controller generation, service layer organization, and Spring Boot best practices. | 3 items | openapi, code-generation, api, java, spring-boot |
|
||||
| [OpenAPI to Application - Node.js NestJS](../collections/openapi-to-application-nodejs-nestjs.md) | Generate production-ready NestJS applications from OpenAPI specifications. Includes project scaffolding, controller and service generation, TypeScript best practices, and enterprise patterns. | 3 items | openapi, code-generation, api, nodejs, typescript, nestjs |
|
||||
| [OpenAPI to Application - Python FastAPI](../collections/openapi-to-application-python-fastapi.md) | Generate production-ready FastAPI applications from OpenAPI specifications. Includes project scaffolding, route generation, dependency injection, and Python best practices for async APIs. | 3 items | openapi, code-generation, api, python, fastapi |
|
||||
| [PHP MCP Server Development](../collections/php-mcp-development.md) | Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and expert assistance | 3 items | php, mcp, model-context-protocol, server-development, sdk, attributes, composer |
|
||||
| [Power Apps Code Apps Development](../collections/power-apps-code-apps.md) | Complete toolkit for Power Apps Code Apps development including project scaffolding, development standards, and expert guidance for building code-first applications with Power Platform integration. | 3 items | power-apps, power-platform, typescript, react, code-apps, dataverse, connectors |
|
||||
| [Power Apps Component Framework (PCF) Development](../collections/pcf-development.md) | Complete toolkit for developing custom code components using Power Apps Component Framework for model-driven and canvas apps | 17 items | power-apps, pcf, component-framework, typescript, power-platform |
|
||||
|
||||
@@ -70,6 +70,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi
|
||||
| [Feature Implementation Plan Prompt](../prompts/breakdown-feature-implementation.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-implementation.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-implementation.prompt.md) | Prompt for creating detailed feature implementation plans, following Epoch monorepo structure. |
|
||||
| [Feature PRD Prompt](../prompts/breakdown-feature-prd.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-prd.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fbreakdown-feature-prd.prompt.md) | Prompt for creating Product Requirements Documents (PRDs) for new features, based on an Epic. |
|
||||
| [Finalize Agent Prompt](../prompts/finalize-agent-prompt.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffinalize-agent-prompt.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffinalize-agent-prompt.prompt.md) | Finalize prompt file using the role of an AI agent to polish the prompt for the end user. |
|
||||
| [Generate Application from OpenAPI Spec](../prompts/openapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fopenapi-to-application-code.prompt.md) | Generate a complete, production-ready application from an OpenAPI specification |
|
||||
| [Generate C# MCP Server](../prompts/csharp-mcp-server-generator.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mcp-server-generator.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-mcp-server-generator.prompt.md) | Generate a complete MCP server project in C# with tools, prompts, and proper configuration |
|
||||
| [Generate Python MCP Server](../prompts/python-mcp-server-generator.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpython-mcp-server-generator.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpython-mcp-server-generator.prompt.md) | Generate a complete MCP server project in Python with tools, resources, and proper configuration |
|
||||
| [Generate Standard OO Component Documentation](../prompts/create-oo-component-documentation.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcreate-oo-component-documentation.prompt.md)<br />[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcreate-oo-component-documentation.prompt.md) | Create comprehensive, standardized documentation for object-oriented components following industry best practices and architectural documentation standards. |
|
||||
|
||||
114
prompts/openapi-to-application-code.prompt.md
Normal file
114
prompts/openapi-to-application-code.prompt.md
Normal file
@@ -0,0 +1,114 @@
|
||||
---
|
||||
agent: 'agent'
|
||||
description: 'Generate a complete, production-ready application from an OpenAPI specification'
|
||||
model: 'GPT-4.1'
|
||||
tools: ['codebase', 'edit/editFiles', 'search/codebase']
|
||||
---
|
||||
|
||||
# Generate Application from OpenAPI Spec
|
||||
|
||||
Your goal is to generate a complete, working application from an OpenAPI specification using the active framework's conventions and best practices.
|
||||
|
||||
## Input Requirements
|
||||
|
||||
1. **OpenAPI Specification**: Provide either:
|
||||
- A URL to the OpenAPI spec (e.g., `https://api.example.com/openapi.json`)
|
||||
- A local file path to the OpenAPI spec
|
||||
- The full OpenAPI specification content pasted directly
|
||||
|
||||
2. **Project Details** (if not in spec):
|
||||
- Project name and description
|
||||
- Target framework and version
|
||||
- Package/namespace naming conventions
|
||||
- Authentication method (if not specified in OpenAPI)
|
||||
|
||||
## Generation Process
|
||||
|
||||
### Step 1: Analyze the OpenAPI Specification
|
||||
- Validate the OpenAPI spec for completeness and correctness
|
||||
- Identify all endpoints, HTTP methods, request/response schemas
|
||||
- Extract authentication requirements and security schemes
|
||||
- Note data model relationships and constraints
|
||||
- Flag any ambiguities or incomplete definitions
|
||||
|
||||
### Step 2: Design Application Architecture
|
||||
- Plan directory structure appropriate for the framework
|
||||
- Identify controller/handler grouping by resource or domain
|
||||
- Design service layer organization for business logic
|
||||
- Plan data models and entity relationships
|
||||
- Design configuration and initialization strategy
|
||||
|
||||
### Step 3: Generate Application Code
|
||||
- Create project structure with build/package configuration files
|
||||
- Generate models/DTOs from OpenAPI schemas
|
||||
- Generate controllers/handlers with route mappings
|
||||
- Generate service layer with business logic
|
||||
- Generate repository/data access layer if applicable
|
||||
- Add error handling, validation, and logging
|
||||
- Generate configuration and startup code
|
||||
|
||||
### Step 4: Add Supporting Files
|
||||
- Generate appropriate unit tests for services and controllers
|
||||
- Create README with setup and running instructions
|
||||
- Add .gitignore and environment configuration templates
|
||||
- Generate API documentation files
|
||||
- Create example requests/integration tests
|
||||
|
||||
## Output Structure
|
||||
|
||||
The generated application will include:
|
||||
|
||||
```
|
||||
project-name/
|
||||
├── README.md # Setup and usage instructions
|
||||
├── [build-config] # Framework-specific build files (pom.xml, build.gradle, package.json, etc.)
|
||||
├── src/
|
||||
│ ├── main/
|
||||
│ │ ├── [language]/
|
||||
│ │ │ ├── controllers/ # HTTP endpoint handlers
|
||||
│ │ │ ├── services/ # Business logic
|
||||
│ │ │ ├── models/ # Data models and DTOs
|
||||
│ │ │ ├── repositories/ # Data access (if applicable)
|
||||
│ │ │ └── config/ # Application configuration
|
||||
│ │ └── resources/ # Configuration files
|
||||
│ └── test/
|
||||
│ ├── [language]/
|
||||
│ │ ├── controllers/ # Controller tests
|
||||
│ │ └── services/ # Service tests
|
||||
│ └── resources/ # Test configuration
|
||||
├── .gitignore
|
||||
├── .env.example # Environment variables template
|
||||
└── docker-compose.yml # Optional: Docker setup (if applicable)
|
||||
```
|
||||
|
||||
## Best Practices Applied
|
||||
|
||||
- **Framework Conventions**: Follows framework-specific naming, structure, and patterns
|
||||
- **Separation of Concerns**: Clear layers with controllers, services, and repositories
|
||||
- **Error Handling**: Comprehensive error handling with meaningful responses
|
||||
- **Validation**: Input validation and schema validation throughout
|
||||
- **Logging**: Structured logging for debugging and monitoring
|
||||
- **Testing**: Unit tests for services and controllers
|
||||
- **Documentation**: Inline code documentation and setup instructions
|
||||
- **Security**: Implements authentication/authorization from OpenAPI spec
|
||||
- **Scalability**: Design patterns support growth and maintenance
|
||||
|
||||
## Next Steps
|
||||
|
||||
After generation:
|
||||
|
||||
1. Review the generated code structure and make customizations as needed
|
||||
2. Install dependencies according to framework requirements
|
||||
3. Configure environment variables and database connections
|
||||
4. Run tests to verify generated code
|
||||
5. Start the development server
|
||||
6. Test endpoints using the provided examples
|
||||
|
||||
## Questions to Ask if Needed
|
||||
|
||||
- Should the application include database/ORM setup, or just in-memory/mock data?
|
||||
- Do you want Docker configuration for containerization?
|
||||
- Should authentication be JWT, OAuth2, API keys, or basic auth?
|
||||
- Do you need integration tests or just unit tests?
|
||||
- Any specific database technology preferences?
|
||||
- Should the API include pagination, filtering, and sorting examples?
|
||||
Reference in New Issue
Block a user