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

# 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:

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

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