porting-claude-skills

Port Claude Code skills to Pi's agentskills.io format with structured transformations.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/jbro/pi-agent --skill porting-claude-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: porting-claude-skills
Source: https://github.com/jbro/pi-agent/tree/main/skills/pi-skills/porting-claude-skills
Command: npx skills add https://github.com/jbro/pi-agent --skill porting-claude-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Port Claude Code skills to Pi doc provides a structured method to port Claude-based skills to Pi's agentskills.io format, addressing the need to adapt frontmatter, cross-references, and local references so they work in Pi's environment.

Core Features & Use Cases

  • Frontmatter normalization: keep the skill name in sync with the directory, trim long descriptions if needed, and drop non-essential metadata.
  • Cross-reference and reference handling: convert Claude-style references to Pi-friendly formats, adjust companion file references, and ensure readability with the Read tool.
  • Portability workflow and companion files: outline a repeatable process for migrating skills, including handling of scripts, references, and assets.

Quick Start

Port Claude Code skills to Pi by applying the documented frontmatter, reference, and tool-compatibility transformations.

Frequently Asked Questions about porting-claude-skills

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

FAQPage Schema
How do I port Claude Code skills to Pi?

Port Claude Code skills to Pi by applying a structured transformation that normalizes frontmatter, adjusts cross-references, and adapts platform-specific tooling to match the Pi agentskills.io format.

What is frontmatter normalization for Pi agentskills?

Frontmatter normalization for Pi agentskills ensures the skill name matches its directory, trims long descriptions to fit constraints, and drops non-essential metadata during the porting process.

How do I handle companion file references when migrating skills to Pi?

Handle companion file references when migrating skills to Pi by converting Claude-style references to Pi-friendly formats and adjusting sibling file paths to ensure readability with the Read tool.

Does porting skills to Pi require specific dependencies?

Porting skills to Pi enforces a safe, reproducible workflow with explicit dependencies, ensuring scripts, references, and assets are handled correctly without requiring external setup.

What is the best way to convert Claude skills to the agentskills.io format?

The best way to convert Claude skills to the agentskills.io format is following a repeatable portability workflow that covers frontmatter, reference handling, and tool-compatibility transformations across the directory.

Why do Claude skill cross-references break in Pi?

Claude skill cross-references break in Pi because they use platform-specific formats that require adjustment to become Pi-friendly and ensure proper readability with the Read tool.