Create your first skill

Author a project skill in the Instructions Manager console, then sync it with pm-skills.

TIP

Run pm-skills init and pm-skills pull from inside your git repository. See Quickstart.

Prerequisites

• Access to a project in the console (SaaS or your on-prem URL)
• Permission to create skills in that project

Steps

Open the project Skills tab

In the console, open your project and select the Skills tab (or navigate from the Skill Library to the project scope).

Create a skill

Choose Create skill. Set a kebab-case name (for example api-error-handling) and a clear description of what and when the skill applies.

Edit the draft version

Fill in the Markdown body. Optionally add files under scripts / references / assets. Keep the body focused; put long references in files.

Submit for review

Submit the draft. If security scanning is enabled, fix or acknowledge findings before approvers can proceed.

Approve

A project approver marks the version active. Only then does the skill appear in pm-skills list for that project.

Pull locally

In your repo: pm-skills init (once) → pm-skills pull. Confirm .claude/skills/api-error-handling/SKILL.md (or your agent path) exists.

Next

• Approve / publish a version
• Pull skills into agents