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, but publishing requires an admin token.

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=<admin-token> node apps/cli/dist/bin.js publish ./skills/review-helper --registry <registry-url>

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.