From rockets-sdk-config
This skill should be used when starting a new Rockets SDK project, setting up a fresh API, or initializing from the rockets-starter template. Automates clone, env setup, dependency install, and build/test verification.
How this skill is triggered — by the user, by Claude, or both
Slash command
/rockets-sdk-config:rockets-project-bootstrapThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this skill to start a new Rockets project with deterministic setup commands.
Use this skill to start a new Rockets project with deterministic setup commands.
Default template repository:
[email protected]:btwld/rockets-starter.git
# Full bootstrap (clone + env + install + build/test)
node skills/rockets-project-bootstrap/scripts/bootstrap.js \
--repo [email protected]:btwld/rockets-starter.git \
--dest ../rockets-starter-app \
--install --run-build --run-test
# Bootstrap existing local folder (skip clone)
node skills/rockets-project-bootstrap/scripts/bootstrap.js \
--skip-clone \
--dest /path/to/existing/project \
--install --run-build --run-test
# Dry run
node skills/rockets-project-bootstrap/scripts/bootstrap.js --dest ../rockets-starter-app --dry-run
--skip-clone)..env exists (copies from .env.example when available).yarn/pnpm/npm) from lockfile.--install is provided.build and test scripts when requested and available.The starter template must be correct out of the box. The generators add to it — they never fix it.
Run validate.js --project <path> after bootstrap to verify compliance.
apps/api/src/
├── main.ts # Swagger with project-specific title
├── app.module.ts # RocketsAuthModule + CrudModule.forRoot({})
├── app.acl.ts # AppRole + AppResource enums, base grants
├── access-control.service.ts # Implements AccessControlServiceInterface
├── config/
│ ├── typeorm.settings.ts # Postgres config, entities array
│ ├── rockets-auth.settings.ts # Auth config, project-specific email
│ └── rockets.settings.ts # App config
├── entities/
│ ├── index.ts # Barrel export for all entities
│ ├── user.entity.ts # extends UserPostgresEntity
│ ├── role.entity.ts # extends RolePostgresEntity
│ ├── user-otp.entity.ts # extends OtpPostgresEntity or CommonPostgresEntity
│ ├── user-metadata.entity.ts # extends CommonPostgresEntity
│ ├── user-role.entity.ts # extends CommonPostgresEntity
│ ├── federated.entity.ts # extends FederatedPostgresEntity or CommonPostgresEntity
│ └── invitation.entity.ts # extends InvitationPostgresEntity or CommonPostgresEntity
├── adapters/
│ ├── user.adapter.ts # @InjectRepository(UserEntity)
│ └── user-metadata.adapter.ts # @InjectRepository(UserMetadataEntity)
├── modules/
│ ├── user/dto/ # User DTOs (used by RocketsAuthModule)
│ └── role/ # Role CRUD (adapter, DTO)
└── migrations/ # Initial migration for all auth tables
*PostgresEntity or CommonPostgresEntity. NO *SqliteEntity base classes anywhere.src/entities/. NO duplicate entity files in modules/*/entities/.main.ts Swagger title, typeorm.settings.ts DB name, rockets-auth.settings.ts email MUST match the project name. NO placeholder names from other projects.app.module.ts imports (required before any CrudModule.forFeature()).uuid, timestamp, NOT datetime)..env.example — MUST exist with all required environment variables documented.The generators (generate.js + integrate.js) assume:
src/entities/index.ts exists (adds exports)src/config/typeorm.settings.ts or src/typeorm.settings.ts has an entities: [...] arraysrc/app.module.ts has @Module({ imports: [...] }) with bracket structuresrc/app.acl.ts has AppResource enum and acRules variable (if using ACL)If any of these are missing or malformed, integrate.js will warn but not fail.
node skills/rockets-project-bootstrap/scripts/smoke-test.js
The smoke test validates setup logic on a local temporary fixture (no network).
npx claudepluginhub btwld/skills --plugin rockets-sdk-configScaffolds projects with directory structures, configs, dependencies, linting, testing, CI/CD basics, and docs for frontend, backend, mobile, CLI, libraries, and monorepos.
Scaffolds boilerplate for APIs (FastAPI, Express), web apps (Next.js, Nuxt, SvelteKit), CLI tools, libraries, monorepos with best-practice stacks and directory structures.
Scaffolds a full-stack project skeleton with Rust backend (Axum, SeaORM, Redis) and React frontend (TypeScript, TanStack, Tailwind).