leobrival/skills/new-package

New Package Skill

Create a new package in the Topographic Studio monorepo.

Task

You are helping the user scaffold a new package in the monorepo with all necessary configuration.

Instructions

1. Gather information from the user:

   • Package name (e.g., "hooks", "animations", "api-client")
   • Package description
   • Package type (library, UI components, utilities, types, config)
   • Dependencies needed

2. Create package structure:

   packages/{name}/
   ├── package.json
   ├── tsconfig.json
   ├── tsup.config.ts (if applicable)
   ├── README.md
   └── src/
       └── index.ts
   

3. Configure package.json:

   • Name: @topographic-studio/{name}
   • Version: 0.0.1
   • Exports configuration
   • Build scripts
   • Repository info

4. Add TypeScript config:

   • Extend root tsconfig
   • Configure paths

5. Create initial source file:

   • Basic export structure
   • Example implementation

6. Update root package.json:

   • Ensure workspace includes the new package

7. Install dependencies:

   bun install
   

8. Verify setup:

   bun run build --filter=@topographic-studio/{name}
   

Package.json Template

{
  "name": "@topographic-studio/{name}",
  "version": "0.0.1",
  "description": "{description}",
  "main": "./dist/index.js",
  "module": "./dist/index.mjs",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "types": "./dist/index.d.ts",
      "import": "./dist/index.mjs",
      "require": "./dist/index.js"
    }
  },
  "files": ["dist"],
  "scripts": {
    "build": "tsup",
    "dev": "tsup --watch",
    "lint": "biome check .",
    "lint:fix": "biome check --write .",
    "typecheck": "tsc --noEmit"
  },
  "keywords": [],
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "https://github.com/leobrival/core.git",
    "directory": "packages/{name}"
  },
  "devDependencies": {
    "tsup": "^8.3.5",
    "typescript": "^5.7.2"
  }
}

Success Criteria

• Package builds successfully
• TypeScript types are correct
• Can be imported from other packages
• Documentation is complete

Output Format

Created new package: @topographic-studio/{name}

Location: packages/{name}/
Files created:
  ✅ package.json
  ✅ tsconfig.json
  ✅ tsup.config.ts
  ✅ README.md
  ✅ src/index.ts

Next steps:
1. Implement your package logic in src/
2. Add dependencies if needed: bun add -D package-name
3. Build: bun run build --filter=@topographic-studio/{name}
4. Use in other packages: import from "@topographic-studio/{name}"