review-migration

Compare migrated GenAI instrumentation packages against upstream implementations and generate MIGRATION_REPORT.md.

27|42|Updated May 12, 2026
One-click install
npx skills add https://github.com/open-telemetry/opentelemetry-python-genai --skill review-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-migration
Source: https://github.com/open-telemetry/opentelemetry-python-genai/tree/main/.github/skills/review-migration
Command: npx skills add https://github.com/open-telemetry/opentelemetry-python-genai --skill review-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the review and reporting process for GenAI instrumentations, comparing migrated packages against known upstream implementations to ensure consistency and completeness.

Core Features & Use Cases

  • Migrating Instrumentation Packages: Review and compare GenAI packages that have been migrated or augmented.
  • Greenfield vs Augment Mode: Detects whether the migration is greenfield or augment mode and adjusts the review accordingly.
  • MIGRATION_REPORT Generation: Generates a MIGRATION_REPORT.md detailing missing or incorrect parts of the migration.

Quick Start

Run the review-migration skill with the target package name, optionally specifying upstream implementations to compare against:

run-review-migration my-instrumentation-package

Frequently Asked Questions about review-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review GenAI instrumentation migrations for consistency?

Review GenAI instrumentation migrations by comparing migrated packages against upstream implementations to ensure consistency, identifying missing functionality, behavioral changes, and test coverage issues automatically.

What is the best way to automate migration reporting for GenAI packages?

Automate migration reporting by comparing target packages against known upstream implementations, detecting greenfield or augment mode, and generating a MIGRATION_REPORT.md detailing missing or incorrect parts.

Do I need Python and Git to run GenAI instrumentation migration reviews?

Yes, you need Python and Git installed, along with access to the upstream packages, to run the migration review and compare target instrumentations against their known upstream implementations.

Can I compare augmented GenAI packages against upstream implementations?

Yes, you can compare augmented GenAI packages against upstream implementations. The review detects augment mode and adjusts the comparison to identify missing functionality, behavioral changes, and test coverage issues.

What does a MIGRATION_REPORT.md contain after reviewing GenAI instrumentation?

The MIGRATION_REPORT.md details missing or incorrect parts of the GenAI instrumentation migration, documenting functionality gaps, behavioral changes, and test coverage issues found during the upstream comparison.