Prompt PieAgent Skills
Manage AI skills in one visual library — Prompt Pie skills follow the open 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 any tool that supports the Agent Skills spec. Download or copy a skill's SKILL.md and add it to Claude Code, Codex, Cursor, or another compatible agent — no proprietary format, no lock-in.
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.
- Download the skill as
.mdor copy to clipboard. - Add it to your AI tool's skills directory (below).
Where tools look for skills
Any tool that reads SKILL.md files works. The Agent Skills standard directory is ~/.agents/skills/ — Codex and Cursor read it directly. Claude Code reads ~/.claude/skills/. Inside a project, the same pattern applies with .agents/skills/ and .claude/skills/ at the project root.
| Tool | User-level skills directory |
|---|---|
| Codex | ~/.agents/skills/ |
| Cursor | ~/.agents/skills/ |
| Claude Code | ~/.claude/skills/ |