Skip to content

Adds the 'Oracle-to-PostgreSQL Migration Expert' Custom Agent, Asociated Skills, and Plugin Manifest#950

Open
PrimedPaul wants to merge 4 commits intogithub:stagedfrom
PrimedPaul:add-new-custom-agent/oracle-to-postgres-migration
Open

Adds the 'Oracle-to-PostgreSQL Migration Expert' Custom Agent, Asociated Skills, and Plugin Manifest#950
PrimedPaul wants to merge 4 commits intogithub:stagedfrom
PrimedPaul:add-new-custom-agent/oracle-to-postgres-migration

Conversation

@PrimedPaul
Copy link

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.

Description

Adds the 'Oracle-to-PostgreSQL Migration Expert' Custom Agent, its associated skills, plugin manifest.
This custom agent is for helping users migrate application codebases from Oracle to Postgres.
This custom agent uses a 'gated' approach, never moving onto the next step without user approval.

The skills' syntax follow the 'Claude API Docs' best practices.

I constantly refine the custom agent by enhancing it's skillset with real-world occurrences of common migration errors and differences to look out for.

READMEs updated using 'npm run build'.


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.
  • Other (please specify):

Additional Notes

I am currently working on an enterprise Oracle to Postgres migration exercise, converting legacy and modern application codebases. I created this custom agent to help the multiple developers on the team with instruction, guidance and achieving more consistent results.


By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

@PrimedPaul PrimedPaul marked this pull request as ready for review March 9, 2026 18:48
@PrimedPaul PrimedPaul requested a review from aaronpowell as a code owner March 9, 2026 18:48
Copilot AI review requested due to automatic review settings March 9, 2026 18:48
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new “Oracle-to-PostgreSQL Migration Expert” plugin to the Awesome Copilot collection, providing an agent plus a set of migration-focused skills and reference material for Oracle→PostgreSQL work in .NET codebases.

Changes:

  • Added a new custom agent definition for Oracle→PostgreSQL migrations.
  • Added multiple new migration skills (planning, scaffolding tests, creating tests, stored procedure migration, bug reporting, and review guidance) plus supporting reference docs.
  • Registered the new plugin/agent/skills in the docs tables and plugin marketplace metadata.

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
skills/scaffolding-oracle-to-postgres-migration-test-project/SKILL.md New skill to scaffold an xUnit integration test project for migration validation.
skills/reviewing-oracle-to-postgres-migration/references/postgres-refcursor-handling.md Reference doc on refcursor client handling differences.
skills/reviewing-oracle-to-postgres-migration/references/postgres-concurrent-transactions.md Reference doc on Npgsql single-active-command constraints.
skills/reviewing-oracle-to-postgres-migration/references/oracle-to-postgres-type-coercion.md Reference doc on PostgreSQL strict type coercion vs Oracle implicit conversions.
skills/reviewing-oracle-to-postgres-migration/references/oracle-to-postgres-to-char-numeric.md Reference doc on TO_CHAR(numeric) migration patterns.
skills/reviewing-oracle-to-postgres-migration/references/oracle-to-postgres-timestamp-timezone.md Reference doc on timestamp/timezone handling and Npgsql configuration guidance.
skills/reviewing-oracle-to-postgres-migration/references/oracle-to-postgres-sorting.md Reference doc on ordering differences and PostgreSQL DISTINCT ordering constraints.
skills/reviewing-oracle-to-postgres-migration/references/oracle-parentheses-from-clause.md Reference doc on Oracle-only FROM-clause parentheses patterns.
skills/reviewing-oracle-to-postgres-migration/references/no-data-found-exceptions.md Reference doc on SELECT INTO “no data found” behavior differences.
skills/reviewing-oracle-to-postgres-migration/references/empty-strings-handling.md Reference doc on empty string vs NULL behavior differences.
skills/reviewing-oracle-to-postgres-migration/references/REFERENCE.md Index file tying the review skill’s reference docs together.
skills/reviewing-oracle-to-postgres-migration/SKILL.md New skill to review/validate migrations using the bundled reference insights.
skills/planning-oracle-to-postgres-migration-integration-testing/SKILL.md New skill to produce an integration testing plan for a target project.
skills/migrating-oracle-to-postgres-stored-procedures/SKILL.md New skill to translate Oracle PL/SQL procedures to PostgreSQL PL/pgSQL.
skills/creating-oracle-to-postgres-migration-integration-tests/SKILL.md New skill to generate DB-agnostic integration tests for migrated data access code.
skills/creating-oracle-to-postgres-migration-bug-report/references/BUG-REPORT-TEMPLATE.md Bug report template reference for migration defects.
skills/creating-oracle-to-postgres-migration-bug-report/SKILL.md New skill to create structured bug reports for migration issues.
skills/creating-oracle-to-postgres-master-migration-plan/SKILL.md New skill to inventory/classify projects in a .NET solution for migration.
plugins/oracle-to-postgres-migration-expert/README.md Plugin documentation describing included agent/skills and usage.
plugins/oracle-to-postgres-migration-expert/.github/plugin/plugin.json Plugin manifest registering the agent and skills.
docs/README.skills.md Adds the new skills to the skills documentation index.
docs/README.plugins.md Adds the new plugin to the plugins documentation index.
docs/README.agents.md Adds the new agent to the agents documentation index.
agents/oracle-to-postgres-migration-expert.agent.md New agent definition for migration guidance and tool-assisted execution.
.github/plugin/marketplace.json Registers the new plugin in the generated marketplace list.

- Fix BOM characters
- Rerun 'npm run build'
- Clarify timestampz date kind
- Remove consufing text for SELECT INTO exception
- Remove dangerous VB.NET example
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 5 comments.

Copy link
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is looking great - thanks for taking the time to incorporate the feedback (I know we've been through a few iterations) as I think this will be really usable as a set of skills.

I added one really tiny nitpick change just to ensure that nothing gets missed when working with it, but otherwise it'll be good to merge in.


**Step 1: Discover projects**

Find the `.sln` file in the workspace root (ask the user if multiple exist). Parse it to extract all `.csproj` project references. For each project, note the name, path, and type (class library, web API, console, test, etc.).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Find the `.sln` file in the workspace root (ask the user if multiple exist). Parse it to extract all `.csproj` project references. For each project, note the name, path, and type (class library, web API, console, test, etc.).
Find the Solution File (it has a `.sln` or `.slnx` extension) in the workspace root (ask the user if multiple exist). Parse it to extract all `.csproj` project references. For each project, note the name, path, and type (class library, web API, console, test, etc.).

Just improving so that the new slnx doesn't get missed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants