Adds the 'Oracle-to-PostgreSQL Migration Expert' Custom Agent, Asociated Skills, and Plugin Manifest#950
Conversation
…ociated skills, plugin manifest
There was a problem hiding this comment.
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. |
...s/reviewing-oracle-to-postgres-migration/references/oracle-to-postgres-timestamp-timezone.md
Show resolved
Hide resolved
skills/reviewing-oracle-to-postgres-migration/references/no-data-found-exceptions.md
Show resolved
Hide resolved
skills/reviewing-oracle-to-postgres-migration/references/oracle-to-postgres-to-char-numeric.md
Outdated
Show resolved
Hide resolved
- Fix BOM characters - Rerun 'npm run build' - Clarify timestampz date kind - Remove consufing text for SELECT INTO exception - Remove dangerous VB.NET example
skills/reviewing-oracle-to-postgres-migration/references/postgres-refcursor-handling.md
Outdated
Show resolved
Hide resolved
skills/reviewing-oracle-to-postgres-migration/references/postgres-refcursor-handling.md
Outdated
Show resolved
Hide resolved
skills/reviewing-oracle-to-postgres-migration/references/postgres-refcursor-handling.md
Outdated
Show resolved
Hide resolved
aaronpowell
left a comment
There was a problem hiding this comment.
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.). |
There was a problem hiding this comment.
| 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.
Pull Request Checklist
npm startand verified thatREADME.mdis 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
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.