create-adsk

 █████╗ ██████╗ ███████╗██╗  ██╗
██╔══██╗██╔══██╗██╔════╝██║ ██╔╝
███████║██║  ██║███████╗█████╔╝
██╔══██║██║  ██║╚════██║██╔═██╗
██║  ██║██████╔╝███████║██║  ██╗
╚═╝  ╚═╝╚═════╝ ╚══════╝╚═╝  ╚═╝

create-adsk

Adopt the Agentic Development Starter Kit (ADSK) as a versioned profile — skills via the skills CLI plus optional Cursor commands/rules. Not a skills marketplace.

Quick Start

Interactive

npx create-adsk

Follow the prompts. You pick a profile, optionally add product packs, then the CLI installs skills, syncs Cursor commands when the profile includes them, and writes .adsk/config.json.

Profile	You get
core	Spec-driven workflow + Cursor commands
delivery	Core + DevOps strategy + release automation
maintainer	Delivery + skill/README authoring + supply-chain gate + stock rules
skills-only	All first-party skills; no .cursor/ writes

Source: profiles.json. Contract: docs/product/create-adsk.md.

Non-interactive

npx create-adsk --profile delivery --yes

Flag	Meaning
--profile <id>	Choose a profile without prompting
--yes / -y	Skip prompts (core if --profile is omitted; optional packs off unless --with-optional-packs)

See npx create-adsk --help for the full option list.

Commands

npx create-adsk          # init (interactive; default)
npx create-adsk update   # refresh from .adsk/config.json
npx create-adsk status   # profile + drift (exit 1 if drift)

Other useful flags: --dry-run, --scope project|global, --force-rules, --with-optional-packs, --target <dir>.

Two tools

Tool	Owns
npx skills	Skill folders in .agents/skills/
npx create-adsk	ADSK profile (skills + Cursor + .adsk/config.json)

Local kit path (optional)

Developing against a checkout instead of the published package:

npx --yes /path/to/agentic-development-starter-kit/packages/create-adsk

(npx --yes skips the npx install prompt for that path — not the same as create-adsk --yes.)

Develop in this monorepo

# from kit root
./scripts/prepare-create-adsk-snapshot.sh
cd packages/create-adsk && npm install && npm test && npm run build
node dist/cli.js --help

Releases (kit vs npm)

Kit GitHub releases (v*) and this npm package are independent.

You want…	Do this
Land code on GitHub	PR → green tier1 → merge to main
Kit changelog / GitHub Release	Merge the release-please PR when ready
New npx create-adsk on npm	Bump package.json version on main, then tag create-adsk-vX.Y.Z

Full workflow: docs/RELEASE.md. Publishing uses Trusted Publishing via .github/workflows/publish-create-adsk.yml.