Examples

Copy a working flow for a common skill.

These examples show the whole path: create a skill, stage it, publish it, and install it into an AI tool. Each step has its own command and a short explanation.

Templates Targets

Before any example

Install the CLI once, then sign in on the website to create an org and reserve the package name.

npm install -g @aipm-registry/cli
aipm --version

Code review helper for Cursor

A team wants the same pull request review checklist in every Cursor project.

Publish

1. Create the skill folder

Creates a new package folder with a manifest, starter SKILL.md, and .aipmignore. The --targets cursor flag means this skill is for Cursor only.

aipm publish init --name @team/review-helper --template code-review --targets cursor

2. Open the folder

Move into the folder AIPM just created so the next commands run in the right place.

cd review-helper

3. Stage your files

Adds the skill files in this folder to the publish bundle. Run this after you edit SKILL.md or add other files.

aipm publish add .

4. Preview what will be published (optional)

Shows the file list and package size before you push. Use this to catch secrets or extra files early.

aipm publish preview

5. Publish to the registry

AIPM_TOKEN=<5-minute-token> aipm publish push --yes

Install

Install into a project

Adds the published skill to your project and writes the Cursor skill file. --ci skips prompts in scripts or CI.

aipm add @team/review-helper@1.0.0 --target cursor --ci

Good for pull request reviews
Installs into .cursor/aipm/skills/<skill>.md

Sentry issue summariser for Claude

A product engineer wants Claude to turn error reports into clear triage notes.

Publish

1. Create the skill folder

Creates a package for Claude with starter content for issue summaries.

aipm publish init --name @team/sentry-issue-summary --template issue-summary --targets claude

2. Open the folder

Go into the new package folder before staging or publishing.

cd sentry-issue-summary

3. Stage your files

Adds your edited skill files to the publish bundle.

aipm publish add .

4. Validate the package (optional)

Checks the manifest, entry file, and staged files before you publish.

aipm publish validate

5. Publish to the registry

Use a fresh dashboard token. It expires after 5 minutes.

AIPM_TOKEN=<5-minute-token> aipm publish push --yes

Install

Install into a project

Installs the skill as a Claude project skill folder.

aipm add @team/sentry-issue-summary@1.0.0 --target claude --ci

Good for incidents, support, and bug triage
Installs into .claude/aipm/skills/<skill>/SKILL.md

Release notes skill for Cursor and Claude

A maintainer wants one skill that helps Cursor and Claude draft release notes.

Publish

1. Create the skill folder

Creates one package that supports both Cursor and Claude.

aipm publish init --name @team/release-notes --template release-notes --targets cursor,claude

2. Open the folder

Move into the package folder you just created.

cd release-notes

3. Stage your files

Adds the skill files to the publish bundle.

aipm publish add .

4. Preview what will be published (optional)

Review included files before pushing a new version.

aipm publish preview

5. Publish to the registry

Push the version to the public registry with a dashboard token.

AIPM_TOKEN=<5-minute-token> aipm publish push --yes

Install

Install for Cursor

Installs the Cursor version of the skill into your project.

aipm add @team/release-notes@1.0.0 --target cursor --ci

Install for Claude

Installs the Claude version into the same or another project.

aipm add @team/release-notes@1.0.0 --target claude --ci

Good for teams using more than one AI tool
The manifest should include both cursor and claude targets

Import an existing Codex skill folder

A user already has a local skill folder and wants to publish it.

Publish

1. Import into an AIPM package

Copies an existing skill folder into a new AIPM package layout with a manifest.

aipm publish import ~/.codex/skills/review-helper --name @team/review-helper

2. Open the folder

Go into the imported package folder.

cd review-helper

3. Stage your files

Stages the imported files. Check .aipmignore first so private files stay out.

aipm publish add .

4. Preview what will be published (optional)

Confirms which files will go public before you push.

aipm publish preview

5. Publish to the registry

Publish with a short-lived token from the package dashboard.

AIPM_TOKEN=<5-minute-token> aipm publish push --yes

Install

Install into a project

Installs the published skill for Cursor in this example.

aipm add @team/review-helper@1.0.0 --target cursor --ci

Good when an AI tool created the first draft
Review .aipmignore before staging imported files