Prompt PieAgent Skills
Prompt Pie skills follow the Agent Skills specification for cross-tool compatibility.
This page describes the format behind every Prompt Pie skill. When you set a piece to skill mode, it follows the Agent Skills specification - an open format for portable AI skills.
To get skills into Prompt Pie, add a skill by importing one onto your canvas. Prompt Pie preserves the standard format described below.
What this means
Skills you create in Prompt Pie work with tools that support the Agent Skills spec. For a shared skill with an installable source, choose Install and follow the generated npx skills@latest command. Otherwise, download or copy its SKILL.md and add it to Claude Code, Codex, Cursor, or another compatible agent yourself.
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
| Field | Required | What it does |
|---|---|---|
name | Yes | Lowercase letters, numbers, hyphens. Max 64 characters. |
description | Yes | Describes what the skill does and when to use it. Max 1024 characters. |
license | No | License name or reference. |
compatibility | No | Environment requirements (e.g. "Requires Python 3.14+"). |
metadata | No | Arbitrary key-value pairs for extra info. |
From Prompt Pie to your tools
- Create a piece and toggle to skill mode.
- Fill in the name and description.
- Write your skill instructions in the body.
- Share the skill or open an existing shared skill.
- Choose Install when its source is installable, then run the provided
npx skills@latestcommand. - Otherwise, download the skill as
.mdor copy to clipboard, then add it to your AI tool's skills directory.
Works with any tool that reads SKILL.md files. Prompt Pie generates global installs, so npx skills keeps the canonical skill in ~/.agents/skills/. Codex and Cursor read that standard directory directly; Claude Code gets a symlink in ~/.claude/skills/. Project-level installs follow the same pattern with .agents/skills/ and .claude/skills/ inside the project.