import-tool

Install a Pixie tool from a ZIP by unpacking under tools/ and validating with uv sync.

6|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/AlexKapadia/Pixie --skill import-tool
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: import-tool
Source: https://github.com/AlexKapadia/Pixie/tree/main/.claude/skills/import-tool
Command: npx skills add https://github.com/AlexKapadia/Pixie --skill import-tool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to quickly import and set up Pixie tools that have been packaged as ZIP archives, ensuring consistent deployment in the local Pixie environment.

Core Features & Use Cases

  • Unpacks a ZIP-archived Pixie tool into the tools/ directory, preserving the tool_id as the root folder.
  • Runs uv sync and the Pixie validator to verify tool integrity and readiness for use in the dashboard.
  • Supports common packaging formats used by the community when sharing tools; ideal for restoring or replicating tool configurations across machines.

Quick Start

Install a shared Pixie tool from a ZIP by unpacking it under tools/ and then running uv sync to validate.

Frequently Asked Questions about import-tool

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

FAQPage Schema
How do I install a shared Pixie tool from a ZIP archive?

To install a shared Pixie tool, unpack the ZIP archive into the tools/ directory and run uv sync to validate its structure, dependencies, and readiness for dashboard use.

What validation checks are performed when importing a Pixie tool?

Validation enforces security checks, mandates exactly one top-level folder named after the tool_id, and confirms essential files like tool.json, pyproject.toml, and main.py are present.

Does importing a Pixie tool from a ZIP require a specific folder structure?

Yes, the ZIP must contain exactly one top-level folder named after the tool_id. This folder must include essential files like tool.json, pyproject.toml, and main.py to pass validation.

Why does my imported Pixie tool fail validation after unpacking?

Validation fails if the ZIP structure lacks exactly one top-level folder named after the tool_id, misses essential files like tool.json, pyproject.toml, or main.py, or triggers security checks.

Can I use this to restore a packaged Pixie tool configuration on a new machine?

Yes, importing a packaged Pixie tool from a ZIP restores tool configurations across machines by unpacking under tools/ and running uv sync with the Pixie validator to ensure readiness.