HomeDeveloper Docs
Beta launching Q3 2026

Semantic Package Manager

spm — install, manage, and publish AI prompt frameworks like software packages. One command to deploy any framework into any AI tool.

terminal
$npm install -g @prompt.doctor/spm
+ @prompt.doctor/spm@1.0.0 installed globally
$spm install content-velocity-engine --tool gpt4
Resolving content-velocity-engine@2.1.0...
Downloading 47 prompts across 4 modules...
✓ content-velocity-engine installed. Run `spm activate content-velocity-engine` to deploy.

Installation

Install the Semantic Package Manager globally via npm or yarn.

npm
npm install -g @prompt.doctor/spm
yarn
yarn global add @prompt.doctor/spm
pnpm
pnpm add -g @prompt.doctor/spm

Requires Node.js 18+. After installation, run spm --version to verify.

Quick Start

Get a framework running in under 60 seconds.

1

Authenticate

spm login

Opens browser for OAuth. Requires a Prompt.Doctor account.

2

Search for a framework

spm search "content marketing"

Returns matching frameworks from the registry.

3

Install it

spm install content-velocity-engine --tool gpt4

Downloads all modules and generates activation prompts.

4

Activate in your AI tool

spm activate content-velocity-engine --copy

Copies the system prompt to clipboard. Paste into ChatGPT, Claude, etc.

CLI Reference

All available spm commands.

spm install <framework-slug>

Install a framework from the registry into your current project

$ spm install content-velocity-engine

Flags

--tool <name>Target AI tool (gpt4, claude, gemini, dalle, flux)
--version <v>Install a specific version (default: latest)
--globalInstall to global config, available in all sessions
--dry-runPreview what would be installed without writing files

Manifest Format (spm.json)

Every framework is defined by an spm.json manifest at the project root. This file is the single source of truth for metadata, modules, pricing, and compatibility.

Example manifest

spm.json
{
  "name": "content-velocity-engine",
  "version": "2.1.0",
  "displayName": "Content Velocity Engine",
  "description": "A 47-prompt system for producing SEO-optimized content at scale.",
  "category": "Content & Copywriting",
  "author": {
    "name": "Alex Rivera",
    "username": "alexrivera",
    "email": "alex@example.com"
  },
  "license": "commercial",
  "price": 79,
  "tools": ["GPT-4", "Claude", "Gemini"],
  "tags": ["content", "seo", "copywriting", "marketing"],
  "modules": [
    {
      "id": "foundation",
      "title": "Foundation Layer",
      "description": "Core semantic scaffolding and context initialization.",
      "promptFile": "./modules/01-foundation.txt",
      "promptCount": 8,
      "order": 1
    },
    {
      "id": "research",
      "title": "Research & Ideation",
      "description": "Topic research, keyword clustering, and content angle generation.",
      "promptFile": "./modules/02-research.txt",
      "promptCount": 12,
      "order": 2
    },
    {
      "id": "production",
      "title": "Content Production",
      "description": "Full-length article, headline, and meta generation prompts.",
      "promptFile": "./modules/03-production.txt",
      "promptCount": 18,
      "order": 3
    },
    {
      "id": "optimization",
      "title": "SEO Optimization",
      "description": "On-page SEO, internal linking, and schema markup prompts.",
      "promptFile": "./modules/04-optimization.txt",
      "promptCount": 9,
      "order": 4
    }
  ],
  "samplePrompts": [
    {
      "title": "Topic Cluster Generator",
      "file": "./samples/topic-cluster.txt",
      "tool": "GPT-4",
      "free": true
    }
  ],
  "changelog": [
    {
      "version": "2.1.0",
      "date": "2026-04-15",
      "notes": "Added 6 new SEO optimization prompts. Improved foundation layer for Claude compatibility."
    }
  ],
  "requirements": {
    "minSpmVersion": "1.0.0"
  }
}

Field reference

namestringrequired

Unique slug identifier. Lowercase, hyphens only. Must be unique in the registry.

versionstringrequired

Semantic version (semver). Increment on every published update.

displayNamestringrequired

Human-readable name shown in the marketplace.

descriptionstringrequired

One-sentence description (max 160 chars). Used in search results.

categorystringrequired

Must match one of the supported category values (see Categories reference).

authorobjectrequired

Author metadata. username must match your Prompt.Doctor seller account.

licensestringrequired

"commercial" (paid) or "free". Determines marketplace listing type.

pricenumber

Price in USD. Required when license is "commercial". Range: $9–$999.

toolsstring[]required

Compatible AI tools. Supported: GPT-4, Claude, Gemini, DALL·E, Flux.

modulesModule[]required

Array of module definitions. Minimum 3 modules required for marketplace listing.

samplePromptsSamplePrompt[]

Free preview prompts shown to non-buyers. At least 1 required for marketplace listing.

changelogChangelogEntry[]

Version history. Shown on the framework detail page.

Generate a manifest automatically

Run spm init in your framework directory to scaffold a valid spm.json interactively.

spm init my-framework --template advanced

REST API

Base URL: https://api.prompt.doctor/v1

Authenticated endpoints require a Bearer token. Get your API key from Dashboard → API Keys.

MethodEndpointDescriptionAuth
GET/v1/frameworksList all published frameworks
GET/v1/frameworks/:slugGet framework metadata by slug
POST/v1/frameworks/installInstall a framework and get activation prompts
GET/v1/frameworks/:slug/modulesList all modules for a framework
GET/v1/frameworks/:slug/modules/:idGet a single module's activation prompt
GET/v1/frameworks/:slug/activateGet the full system activation prompt
POST/v1/frameworks/publishPublish a framework from a manifest
GET/v1/seller/frameworksList your published frameworks
GET/v1/seller/earningsGet earnings and payout history

Example: Install via API

install-framework.ts
const res = await fetch('https://api.prompt.doctor/v1/frameworks/install', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    frameworkSlug: 'content-velocity-engine',
    targetTool: 'gpt4',
  }),
});

const { systemPrompt, modules } = await res.json();
// Paste systemPrompt into your AI tool's system instructions

Publishing Frameworks

Publish your framework to the Prompt.Doctor marketplace and earn 70% of every sale.

1

Create a seller account

Sign up at prompt.doctor/sell and complete identity verification.

Learn more →
2

Initialize your framework

Run spm init to scaffold the project structure and manifest.

$ spm init my-framework
3

Build your modules

Create .txt prompt files for each module. Minimum 3 modules, 20 prompts total.

4

Validate locally

Run spm validate to check your manifest against the schema.

$ spm validate
5

Submit for review

Publish as a draft for our 48-hour review process.

$ spm publish --draft
6

Go live

After approval, publish to the marketplace.

$ spm publish

Read the full Seller Marketplace Agreement before publishing. It covers quality standards, revenue share, and payout schedules.

Beta launching Q3 2026

Join the Beta Waitlist

Be first to access the Semantic Package Manager. Beta members get early API access, a free framework credit, and direct input on the CLI roadmap.

Early API access
Free framework credit
Private beta community
Roadmap input