creating-oracle-to-postgres-migration-bug-report — skill
Creates structured bug reports for Oracle-to-PostgreSQL migration defects. Use it when a database behaviour difference needs a reproducible report with a cause and validation plan.
npx skills add github/awesome-copilot --skill creating-oracle-to-postgres-migration-bug-reportWhat creating-oracle-to-postgres-migration-bug-report does
This skill writes migration defect reports from references/BUG-REPORT-TEMPLATE.md. A report covers status, affected component, related test, severity, expected Oracle behaviour, observed PostgreSQL behaviour, reproduction scenario, root cause, solution and validation on both databases.
It calls out data-layer differences such as empty strings versus NULL, type coercion, collation, sequence values, time zones, padding and constraints. Oracle is treated as the expected-behaviour baseline, so a PostgreSQL difference needs a clear explanation. Client code changes should be documented and justified when required.
Reports follow .github/oracle-to-postgres-migration/Reports/{ProjectName}/BUG_REPORT_<DescriptiveSlug>.md. Keep SQL excerpts and logs reproducible, and remove sensitive data.
What it helps with
- document an Oracle and PostgreSQL behaviour difference
- write reproduction steps with seed data
- identify the database-level cause of a defect
- record file paths for the required fix
- validate a fix against both databases
Example prompts for the agent
- Write a bug report for an Oracle empty-string and PostgreSQL `NULL` difference.
- Review this migration defect report and add the root cause, reproduction scenario and validation steps.
- Create a report for a type-coercion defect at `.github/oracle-to-postgres-migration/Reports/{ProjectName}/BUG_REPORT_<DescriptiveSlug>.md`.
How to install creating-oracle-to-postgres-migration-bug-report
1Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill creating-oracle-to-postgres-migration-bug-report2GitHub CLI
gh skill install github/awesome-copilot creating-oracle-to-postgres-migration-bug-report3Manually: put the files in place
.github/skills/creating-oracle-to-postgres-migration-bug-report/SKILL.md1Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill creating-oracle-to-postgres-migration-bug-report -a claude-code2Manually: put the files in place
~/.claude/skills/creating-oracle-to-postgres-migration-bug-report/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/creating-oracle-to-postgres-migration-bug-report/
Manually: put the files in place
.agents/skills/creating-oracle-to-postgres-migration-bug-report/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/creating-oracle-to-postgres-migration-bug-report/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
Platform CLI
gemini skills install https://github.com/github/awesome-copilot --path skills/creating-oracle-to-postgres-migration-bug-reportManually: put the files in place
.devin/skills/creating-oracle-to-postgres-migration-bug-report/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set554
The whole set →Similar
Questions about creating-oracle-to-postgres-migration-bug-report
How do I install creating-oracle-to-postgres-migration-bug-report in GitHub Copilot?
Run npx skills add github/awesome-copilot --skill creating-oracle-to-postgres-migration-bug-report. Then use .github/skills/creating-oracle-to-postgres-migration-bug-report/SKILL.md.
What does creating-oracle-to-postgres-migration-bug-report do?
It creates structured bug reports for defects caused by Oracle and PostgreSQL behaviour differences during migration. Reports include severity, root cause, remediation and validation steps.
Which database is the expected-behaviour baseline?
The skill uses Oracle as the source of truth for expected behaviour. PostgreSQL behaviour is recorded as the observed result and compared against that baseline.
Source text
SKILL.md · MIT
---
name: creating-oracle-to-postgres-migration-bug-report
description: 'Creates structured bug reports for defects found during Oracle-to-PostgreSQL migration. Use when documenting behavioral differences between Oracle and PostgreSQL as actionable bug reports with severity, root cause, and remediation steps.'
---
# Creating Bug Reports for Oracle-to-PostgreSQL Migration
## When to Use
- Documenting a defect caused by behavioral differences between Oracle and PostgreSQL
- Writing or reviewing a bug report for an Oracle-to-PostgreSQL migration project
## Bug Report Format
Use the template in [references/BUG-REPORT-TEMPLATE.md](references/BUG-REPORT-TEMPLATE.md). Each report must include:
- **Status**: ✅ RESOLVED, ⛔ UNRESOLVED, or ⏳ IN PROGRESS
- **Component**: Affected endpoint, repository, or stored procedure
- **Test**: Related automated test names
- **Severity**: Low / Medium / High / Critical — based on impact scope
- **Problem**: Expected Oracle behavior vs. observed PostgreSQL behavior
- **Scenario**: Ordered reproduction steps with seed data, operation, expected result, and actual result
- **Root Cause**: The specific Oracle/PostgreSQL behavioral difference causing the defect
- **Solution**: Changes made or required, with explicit file paths
- **Validation**: Steps to confirm the fix on both databases
## Oracle-to-PostgreSQL Guidance
- **Oracle is the source of truth** — frame expected behavior from the Oracle baseline
- Call out data layer nuances explicitly: empty string vs. NULL, type coercion strictness, collation, sequence values, time zones, padding, constraints
- Client code changes should be avoided unless required for correct behavior; when proposed, document and justify them clearly
## Writing Style
- Plain language, short sentences, clear next actions
- Present or past tense consistently
- Bullets and numbered lists for steps and validations
- Minimal SQL excerpts and logs as evidence; omit sensitive data and keep snippets reproducible
- Stick to existing runtime/language versions; avoid speculative fixes
## Filename Convention
Save bug reports to `.github/oracle-to-postgres-migration/Reports/{ProjectName}/BUG_REPORT_<DescriptiveSlug>.md` where:
- `{ProjectName}` is the project's assembly/folder name with spaces normalized to `-` (e.g. `MyApp.DataAccess`)
- `<DescriptiveSlug>` is a short PascalCase identifier describing the defect (e.g., `EmptyStringNullHandling`, `RefCursorUnwrapFailure`)
© github · MIT · github/awesome-copilot