Skip to content

Oracle-to-PostgreSQL Bug Reports

Writes structured bug reports for Oracle vs. PostgreSQL behavior differences found during migrations.

Stars
40,703
Licence
MIT
Files
2 files

What it does

When installed, the agent follows a fixed template for documenting defects that appear when an Oracle database application is moved to PostgreSQL. Each report covers status, affected component, related tests, severity, the expected Oracle behavior versus the observed PostgreSQL behavior, step-by-step reproduction, the root cause (the specific database difference), the proposed fix with file paths, and how to validate it on both databases. It also saves reports to a standard folder and filename pattern.

Great for

  • Engineers working on an Oracle-to-PostgreSQL migration who need consistent defect write-ups
  • Migration leads reviewing bug reports from several developers
  • Teams that want Oracle treated as the baseline for expected behavior

Skip it if

  • General PostgreSQL or Oracle administration tasks, since the skill only covers writing bug reports (it does not tune queries or migrate schemas)
  • Projects not involved in an Oracle-to-PostgreSQL migration, where the template and conventions would not apply

Try asking

  • “Document the bug where empty strings are treated differently from NULL in our PostgreSQL port and save it as a bug report”
  • “Write a bug report for a REF CURSOR unwrapping failure in the migrated DataAccess layer, with reproduction steps and a validation plan”
  • “Review this draft bug report for missing severity, root cause, or validation steps”
Step-by-step guide: how to use Oracle-to-PostgreSQL Bug ReportsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    creating-oracle-to-postgres-migration-bug-report.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip creating-oracle-to-postgres-migration-bug-report.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip creating-oracle-to-postgres-migration-bug-report.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Provide the Oracle expected output and the observed PostgreSQL output so the agent can frame the Problem section accurately.
  • Give the project name and defect description so the agent can pick the correct save path and PascalCase slug.
  • Include seed data and the failing test name so the reproduction steps are complete and reproducible.

What's inside

  • references/BUG-REPORT-TEMPLATE.md
  • SKILL.md

Redistributed unmodified from github/awesome-copilot under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.