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. Publish through the CLI; the website only helps users discover and install packages.

Production publishing is currently approval-only. Public users can browse and install packages while self-service publisher accounts are designed.

Install the CLI

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. Publish the folder

AIPM_TOKEN=<5-minute-token> aipm publish ./skills/review-helper --registry <registry-url>

Planned self-service publishing

  1. Create an AIPM account.
  2. Register an organization and reserve a skill name such as @team/review-helper.
  3. Generate a publish token that is valid for 5 minutes.
  4. Use the CLI to validate, stage, and push the skill files to the registry.

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.