Skip to main content
The pflow skill command group publishes saved workflows as Agent Skills that AI coding tools can discover and use. pflow creates symlinks from tool skill directories to your saved workflows, keeping ~/.pflow/workflows/ as the single source of truth.

​
Supported tools

​
Commands

​
pflow skill save

Publish a saved workflow as a skill for AI coding tools.
Arguments:
  • WORKFLOW_NAME - Name of a saved workflow (required)
Options: By default, saves to Claude Code. Use multiple flags to save to multiple tools at once. Examples:
Output:
Running save again on an existing skill updates the enrichment (idempotent):
When you run pflow skill save, two things happen:
  1. Workflow enrichment - pflow adds a ## Usage section to your workflow file with instructions for AI agents, and adds name and description fields to the frontmatter.
  2. Symlink creation - pflow creates a SKILL.md symlink in the tool’s skill directory pointing to your workflow file.
The enrichment is idempotent - running save multiple times just updates the ## Usage section.

​
pflow skill list

List all pflow-managed skills across all tools.
Output:
If a skill’s source workflow was deleted, the list shows it as a broken link with fix instructions:

​
pflow skill remove

Remove a workflow’s skill from tool directories.
Arguments:
  • WORKFLOW_NAME - Name of the skill to remove (required)
Options: By default, removes from Claude Code. Use multiple flags to remove from multiple tools. Examples:
Output:
Removing a skill only deletes the symlink. The saved workflow in ~/.pflow/workflows/ is unchanged, including any enrichment added during skill save.

​
Workflow requirements

Before publishing a workflow as a skill, you must save it to the global library:

​
Project vs personal skills

Project skills (default) are stored in the current project directory and are typically version-controlled with your project. Use these for project-specific workflows. Personal skills (--personal) are stored in your home directory and are available across all projects. Use these for general-purpose workflows you want everywhere.