lpm-dev LPM Guide
Your guide for the entire LPM package lifecycle. Identify what the user needs from the table below, then read the linked section file for detailed instructions before proceeding.
Context
LPM is a registry-agnostic CLI and lpm.dev is the hosted registry for @lpm.dev/* packages. lpm.dev packages use the format @lpm.dev/owner.package-name. Distribution modes:
- Private — Internal use only (default, reversible)
- Pool — Available via $12/month Pool subscription, revenue shared by usage (permanent)
- Marketplace — Listed for sale with per-seat or per-org licensing (permanent)
Read current source or docs before asserting CLI flags, config fields, or publish behavior. Treat lpm.config.json as a source-package config for lpm add, not as a package-type manifest.
Workflows
| User Intent | Guide | When to read |
|---|---|---|
| Create a new package from scratch | Scaffold | "create package", "new package", "scaffold", "init" |
| Bring an existing npm package to LPM | Migrate | "migrate to lpm", "npm to lpm", "dual publish" |
| Check or improve package quality score | Improve | "improve quality", "quality score", "prepare for publish" |
| Make a source package configurable | Source Config | "lpm config", "make configurable", "lpm.config.json" |
| Choose Private, Pool, or Marketplace | Distribution | "distribution mode", "pool vs marketplace", "monetize" |
| Design Marketplace pricing and licensing | Pricing | "pricing strategy", "how much to charge", "license type" |
| Set up CI/CD for installing or publishing | Deploy | "deploy setup", "CI setup", "build fails 401", "LPM_TOKEN" |
| Evaluate a package before installing | Review | "review package", "is this safe", "compare packages" |
| Set up SPM to use LPM packages | Swift Registry | "swift registry", "SE-0292", "lpm swift-registry", "spm setup", "Package.swift registry", "swift package resolve" |
| Create or update Agent Skills for AI assistants | Skills | "agent skills", "create skills", "update skills", "lpm skills", ".lpm/skills" |
References
These are detailed specifications referenced by the section files:
| Reference | Used by |
|---|---|
| Quality Checks | Improve, Review |
| Config Spec | Source Config |
How to Use This Skill
- Match the user's request to a workflow in the table above
- Read the linked section file using the Read tool — it contains the full instructions
- Follow the workflow steps in the section file
- If the user's request spans multiple workflows (e.g., "create a package and set up CI"), read each relevant section in sequence