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

add-tool-from-repo

Clone a Git repository and generate tool.json and FastAPI main.py.

6|1|Updated May 17, 2026
Search Tags:#automation#git#fastapi#tooling#repository#wrap#pixie-tool
One-click install
npx skills add https://github.com/AlexKapadia/Pixie --skill add-tool-from-repo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-tool-from-repo
Source: https://github.com/AlexKapadia/Pixie/tree/main/.claude/skills/add-tool-from-repo
Command: npx skills add https://github.com/AlexKapadia/Pixie --skill add-tool-from-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clones a Git repository and wraps its entrypoint as a Pixie tool - generates tool.json and FastAPI main.py then validates. Use when the user gives a Git URL and asks to add, clone, or wrap a repo. Do NOT use for .zip (import-tool), .py (wrap-local-script), .ipynb (add-tool-from-notebook), or prose (add-tool-from-description).

Core Features & Use Cases

  • Repository wrapping: clones the given Git URL and scaffolds a Pixie tool wrapper with tool.json and a minimal FastAPI app.
  • Validation & safety: runs end-to-end validation to ensure the wrapper conforms to Pixie's interface and does not modify upstream sources.
  • Use Case: when a developer wants to quickly convert a Git-hosted project into a Pixie tool without manually wiring endpoints.

Quick Start

Provide a Git URL and let it generate a Pixie wrapper with tool.json and a FastAPI main.py.

Frequently Asked Questions about add-tool-from-repo

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

FAQPage Schema
How do I convert a Git repository into a Pixie tool?▼

To wrap a Git repository into a Pixie tool, provide the Git URL and the system clones it, then generates tool.json and a FastAPI main.py wrapper. It runs validation to ensure the wrapper conforms to the expected interface.

Can I use a .zip file or local Python script to create a Pixie tool?▼

You cannot use a .zip file or .py script with this wrapper. Use import-tool for .zip archives, wrap-local-script for .py files, and add-tool-from-notebook for .ipynb files instead.

What does the FastAPI wrapper expose when wrapping a repository?▼

The FastAPI wrapper exposes expected endpoints on 127.0.0.1. It reads the repository README for compatibility hints and generates a minimal FastAPI app alongside tool.json without modifying upstream sources.

What's the best way to automate scaffolding a FastAPI wrapper for a Git repo?▼

The best way to automate scaffolding a FastAPI wrapper is to provide the Git URL. It performs pre-flight checks, clones the repository, and generates the necessary tool.json and main.py files for Pixie integration.

Does wrapping a Git repository modify the upstream source code?▼

Wrapping a Git repository does not modify upstream sources. The system clones the repository and generates a separate wrapper with tool.json and a FastAPI main.py, running validation to ensure safety and interface conformity.

Related Skills

Explore More Software Engineering Skills→
AlexKapadiaAlexKapadia
6

wrap-local-script

Wrap a local Python script into a Pixie tool with tool.json and FastAPI main.py.

Community
Intermediate
AlexKapadiaAlexKapadia
6

import-tool

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

Community
Intermediate
AlexKapadiaAlexKapadia
6

share-tool

Package a Pixie tool's source code folder into a zip, excluding sensitive files.

Community
Intermediate
AlexKapadiaAlexKapadia
6

add-tool-from-description

Generate and validate Pixie tool artifacts from natural-language descriptions.

Community
Advanced