create-package

Scaffold new npm packages in the dx-toolkit monorepo with standardized configuration.

25|6|Updated Sep 23, 2025
One-click install
npx skills add https://github.com/youdotcom-oss/dx-toolkit --skill create-package-youdotcom-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-package
Source: https://github.com/youdotcom-oss/dx-toolkit/tree/main/.agents/skills/create-package
Command: npx skills add https://github.com/youdotcom-oss/dx-toolkit --skill create-package-youdotcom-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of a new npm package within the dx-toolkit monorepo, providing a standardized structure, configuration files, and a publish workflow.

Core Features & Use Cases

  • Scaffold a new package directory with a consistent layout (src, tests, tsconfig, biome, and package.json).
  • Provide templates for two build models: source-published and bundled, with strict field ordering and exact versioning.
  • Enforce best practices for workspace dependencies, publishing, and post-create steps, including a guided interactive flow and rollback on failure.

Quick Start

Run the interactive Create Package workflow to scaffold a new package in packages/{name}.

Frequently Asked Questions about create-package

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a publish-ready npm package in a monorepo?

Scaffolding a publish-ready npm package in a monorepo involves an interactive workflow that generates a standardized directory structure with src, tests, tsconfig.json, biome.json, and package.json. It enforces exact versions and provides rollback on failure.

What is the difference between source-published and bundled package build templates?

Source-published and bundled package build templates dictate how code is compiled and distributed. The scaffolding process provides both templates, applying strict field ordering and exact versioning to package.json based on your chosen distribution model.

How do I add a new MCP server or API client to a dx-toolkit monorepo?

Adding a new MCP server or API client to a dx-toolkit monorepo uses an automated scaffolding workflow. It creates the package directory under packages/{name} with the correct workspace dependencies, tsconfig, and biome configurations automatically applied.

Does the npm package scaffolding process support rollback on failure?

Yes, the npm package scaffolding process supports rollback on failure. The interactive question flow ensures that if any step in creating the standardized structure or configuration files fails, the operation cleanly rolls back to avoid incomplete package generation.

Can I enforce strict field ordering and exact dependency versions when creating an npm package?

Yes, you can enforce strict field ordering and exact dependency versions when creating an npm package. The scaffolding process automatically generates package.json, tsconfig.json, and biome.json with exact versions and correct field order applied.

What's the best way to standardize package.json and tsconfig files across multiple monorepo packages?

The best way to standardize package.json and tsconfig files across multiple monorepo packages is using an automated scaffolding tool. It enforces exact versions, strict field ordering, and consistent layouts including biome.json configurations during package generation.