Prompt PiePrompt Pie

Agent Skills

Prompt Pie skills follow the Agent Skills specification for cross-tool compatibility.

When you set a piece to skill mode, it follows the Agent Skills specification - an open format for portable AI skills.

What this means

Skills you create in Prompt Pie work with any tool that supports the Agent Skills spec. Download a skill as a .md file and drop it into Claude Code, Codex, Cursor, or any compatible agent.

If you want Prompt Pie to manage those local skill files for you, use the ppie CLI. It creates the right directories and links one source-of-truth skill into Claude Code, Codex, and Cursor for you.

Skill format

A skill in Prompt Pie maps to a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: What this skill does and when to use it.
---

Your skill instructions here.

Key fields

FieldRequiredWhat it does
nameYesLowercase letters, numbers, hyphens. Max 64 characters.
descriptionYesDescribes what the skill does and when to use it. Max 1024 characters.
licenseNoLicense name or reference.
compatibilityNoEnvironment requirements (e.g. "Requires Python 3.14+").
metadataNoArbitrary key-value pairs for extra info.

From Prompt Pie to your tools

  1. Create a piece and toggle to skill mode
  2. Fill in the name and description
  3. Write your skill instructions in the body
  4. Download as .md or copy to clipboard
  5. Drop the file into your AI tool's skills directory

Works with any tool that reads SKILL.md files - Claude Code (.claude/skills/), Codex (.agents/skills/), Cursor (.cursor/skills/), and others.

Pieces

The two piece types and how to work with them on the canvas.

CLI

Centralize your AI skills across tools and manage them from the terminal with ppie.

On this page

What this meansSkill formatKey fieldsFrom Prompt Pie to your tools