skills.rest
AlexKapadia
AlexKapadiaCOMMUNITY
Explore all skills by this author →
GitHub

migrate-tool-format

Migrate Pixie tool.json files to the current v1 schema.

6|1|Updated May 17, 2026
Search Tags:#validation#migration#tooling#deprecation#migrate#schema-version#tool-json
One-click install
npx skills add https://github.com/AlexKapadia/Pixie --skill migrate-tool-format
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migrate-tool-format
Source: https://github.com/AlexKapadia/Pixie/tree/main/.claude/skills/migrate-tool-format
Command: npx skills add https://github.com/AlexKapadia/Pixie --skill migrate-tool-format

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrades a Pixie tool's tool.json from older schema versions to the current v1 schema, preserving behavior and ensuring future compatibility.

Core Features & Use Cases

  • Detects missing or outdated schema_version, deprecation warnings, and compatibility issues across tools.
  • Scans tool.json for deprecated patterns, invalid inputs/outputs, and risky fields, then applies a safe, record-preserving upgrade ladder.
  • Validates the updated tool.json with the Pixie validator to guarantee conformance and prevent regressions.

Quick Start

Review all tools in the repository, identify those with an older schema_version, and run the migration workflow to upgrade them to the current format.

Frequently Asked Questions about migrate-tool-format

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

FAQPage Schema
How do I migrate a Pixie tool.json file to the latest schema version?▼

To migrate a Pixie tool.json file, scan it for outdated schema versions or deprecated patterns and apply a safe upgrade ladder to the v1 schema. This preserves existing behavior while ensuring future compatibility.

What does it mean when a Pixie tool has a missing or outdated schema_version?▼

A missing or outdated schema_version indicates the tool.json relies on deprecated patterns or lacks current format validation. Auditing the file detects these compatibility issues so you can apply a record-preserving upgrade.

How do I validate a tool.json file after migrating to the v1 schema?▼

You validate a migrated tool.json by running it through the Pixie validator. This checks the updated file for conformance to the v1 schema, preventing regressions and ensuring all inputs and outputs are valid.

Can I upgrade multiple Pixie tools with deprecated patterns at once?▼

Yes, you can review all tools in a repository to identify those with older schema versions. The migration workflow detects risky fields and applies upgrades across multiple tool.json files to bring them to the current format.

Does migrating a tool.json schema version change the tool's behavior?▼

No, migrating the schema version preserves the tool's behavior. The migration applies a safe, record-preserving upgrade ladder that updates the format while preventing functional regressions through validator checks.

Related Skills

Explore More Software Engineering Skills→
getsentrygetsentry
6.2k

xcodebuildmcp-docs-command-review

Validate CLI command references in XcodeBuildMCP changelogs and manifests.

Official
Intermediate
AlexKapadiaAlexKapadia
6

inspect-tool

Generate a read-only markdown inspection report for a single Pixie tool.

Community
Intermediate
proffesor-for-testingproffesor-for-testing
436

contract-testing

Verify microservice API providers against consumer-driven Pact contracts in CI/CD pipelines.

Community
Advanced
caffeinelabscaffeinelabs
588

migrating-motoko

Migrate Motoko actor state across canister upgrades with migration functions.

Official
Intermediate