pipeline-migration
Installation
SKILL.md
Update Check — ONCE PER SESSION (mandatory for live migration runs) The first time this skill is used in a session, run the check-updates skill before proceeding.
- GitHub Copilot CLI / VS Code: invoke the
check-updatesskill.- Claude Code / Cowork / Cursor / Windsurf / Codex: compare local vs remote package.json version.
- Skip if the check was already performed earlier in this session.
- Skip in eval / guidance-only mode: if the user's prompt explicitly forbids tool/API calls (e.g. "Do not call any APIs or create any resources") or the skill is being invoked for offline JSON translation / eval, do not run the update check — answer the prompt directly. The check is only required for live-migration runs that will call Fabric or Synapse APIs.
CRITICAL NOTES
- To find workspace details (including its ID) from a workspace name: list all workspaces, then use JMESPath filtering
- To find item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace, then use JMESPath filtering
- Fabric does NOT have a "Dataset" item type — all dataset properties are inlined into activity
typeProperties- Linked Services map to Fabric Connections — in pipeline activity JSON,
referenceNameon the activity'slinkedServiceblock uses the Fabric connection display name (not the connection GUID); the connection GUID is used only on Fabric REST API calls- Notebook activities change from
SynapseNotebooktoTridentNotebookand reference notebooks by GUID, not by name- Synapse global parameters become a Variable Library item in Fabric, referenced as
@pipeline().libraryVariables.<name>. Variable LibraryNumbertypes are not consumable in pipelines — SynapseFloat/Doubleare mapped toStringfor runtime compatibility- The
Validationactivity type does not exist in Fabric — it must be rewritten asGetMetadata+IfCondition- Triggers are intentionally excluded from this skill — recreate schedules manually in Fabric after migration
- SSIS package execution, SHIR-exclusive connectors, and Databricks activities are parked — see pipeline-gotchas.md