# Create Package

> Create a new monorepo package using the create-package CLI

- Skill: `majiayu000/create-package` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/create-package`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/create-package/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/create-package

---


# Create Package Skill

Use this skill when the user asks to create a new package in the monorepo.

## Overview

The `yarn create-package` command automates the creation of new monorepo packages by:

- Generating package scaffolding from the template package
- Setting up the package structure, configuration files, and dependencies
- Creating package.json with the provided name and description

## Required Arguments

- `--name` (or `-n`): The package name. Will be prefixed with "@ocap/" if not provided.
- `--description` (or `-d`): A short description of the package for package.json

## Usage Pattern

1. Ask the user for the package name and description if not provided
2. Run `yarn create-package --name <package-name> --description "<description>"`
3. Add any additional dependencies using `yarn workspace @ocap/<package-name> add <dep>`

## Example

```bash
# Create the package
yarn create-package --name my-package --description "A package for handling my feature"

# Add dependencies if needed
yarn workspace @ocap/my-package add some-dependency @ocap/kernel-agents
```

When adding monorepo dependencies like `@ocap/kernel-agents`, update the TypeScript references:

```jsonc
// packages/my-package/tsconfig.json and tsconfig.build.json
{
  "references": [{ "path": "../kernel-agents" }],
}
```

This creates a new package at `packages/my-package` with the name `@ocap/my-package`.

## Notes

- The package name will automatically be prefixed with "@ocap/" if not provided
- The created package is private by default
- The template is located at `packages/template-package/`
- All placeholder values in the template will be replaced with actual values