A AIPM

Publishing

Package AI skills once, then install them anywhere.

A published AIPM skill is a versioned folder with a manifest and the files your AI tool needs. Use the dashboard to reserve names and generate short-lived tokens, then publish through the CLI.

Public publishing uses account-backed orgs, reserved package names, and 5-minute publish tokens. Do not publish private prompts, credentials, customer data, or internal-only files.

Install the CLI

Install the AIPM command before creating or publishing skill packages.

npm install -g @aipm-registry/cli

1. Create a skill folder

Each skill needs an aipm.manifest.json file and an entry file.

{
  "schemaVersion": "0.1",
  "name": "@team/review-helper",
  "version": "1.0.0",
  "type": "skill",
  "description": "Review checklist for project PRs",
  "entry": "SKILL.md",
  "targets": ["cursor"],
  "license": "Apache-2.0"
}

2. Create an account and reserve a name

  1. Sign in with GitHub.
  2. Create an organization namespace.
  3. Reserve a package name such as @team/review-helper.
  4. Generate a publish token that is valid for 5 minutes.

3. Stage and publish from the CLI

Create the package folder, stage files, preview and validate them, then push with a 5-minute token.

aipm publish init --name @team/review-helper --template code-review
cd review-helper
aipm publish add .
aipm publish preview # optional
aipm publish validate # optional
AIPM_TOKEN=<5-minute-token> aipm publish push --yes

Starter templates

Templates only change the starter SKILL.md. Pick the closest workflow, then edit the generated files before staging.

Code review

Create a starter package for pull request review workflows.

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

Issue summary

Create a starter package for bug, incident, and support triage.

aipm publish init --name @team/issue-summary --template issue-summary

Release notes

Create a starter package for release summary workflows.

aipm publish init --name @team/release-notes --template release-notes

Target examples

Cursor-only

"targets": ["cursor"]

Use this when the skill should write Cursor-compatible files only.

Claude-only

"targets": ["claude"]

Use this when the skill is built for Claude project instructions.

Multi-tool

"targets": ["cursor", "claude"]

Use this when the same skill should install into multiple AI tools.

Common publish conditions

Condition What to do
Updating an existing skill Change the manifest version, then publish again.
Duplicate version error AIPM does not overwrite versions. Publish a new version.
Invalid package name Use scoped names like @team/review-helper.
Registry unavailable Check the registry URL and run curl <registry-url>/health.