About

Imported from shipshitdev/skills (skills/package-architect/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill package-architect. Copyright stays with the author.

Package Architect

Name: package-architect
Author: shipshitdev

Design reusable TypeScript packages in monorepos (Bun, pnpm, or npm workspaces).

When to Use

Creating new packages or restructuring monorepo packages
Defining package.json exports
Setting up tsconfig references

Core Principles

Single responsibility per package.
Stable public APIs with clear exports.
Avoid inline interfaces; centralize types.
Keep build outputs separated from sources.

Package Structure (Example)

packages/
  utils/
    src/
    package.json
    tsconfig.json
  api-client/
    src/
    package.json
    tsconfig.json

Exports Pattern (Example)

{
  "name": "@scope/utils",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "exports": {
    ".": {
      "import": "./dist/index.js",
      "types": "./dist/index.d.ts"
    }
  }
}

TypeScript References

Use project references for inter-package dependencies.
Prefer path aliases for local dev imports.
Keep tsconfig base shared across packages.

Checklist

Exports map matches intended public API
Types build alongside JS output
No circular dependencies
Consistent lint and tsconfig settings

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-package-architect/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-package-architect.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-package-architect",
  "kind": "skill",
  "name": "package-architect",
  "description": "Design and maintain TypeScript packages in a monorepo, including exports and build configuration. Use when creating or restructuring monorepo packages, defining package.json exports, or setting up tsconfig references.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "packages",
      "monorepo",
      "typescript",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Design and maintain TypeScript packages in a monorepo, including exports and build configuration. Use when creating or restructuring monorepo packages, defining package.json exports, or setting up tsconfig references."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/package-architect/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/package-architect/SKILL.md",
      "key": "shipshitdev/skills/skills/package-architect/SKILL.md"
    }
  },
  "instructions": "# Package Architect\n\nDesign reusable TypeScript packages in monorepos (Bun, pnpm, or npm workspaces).\n\n## When to Use\n\n- Creating new packages or restructuring monorepo packages\n- Defining package.json exports\n- Setting up tsconfig references\n\n## Core Principles\n\n- Single responsibility per package.\n- Stable public APIs with clear exports.\n- Avoid inline interfaces; centralize types.\n- Keep build outputs separated from sources.\n\n## Package Structure (Example)\n\n```\npackages/\n  utils/\n    src/\n    package.json\n    tsconfig.json\n  api-client/\n    src/\n    package.json\n    tsconfig.json\n```\n\n## Ex",
  "cost": {
    "context_tokens": 290
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-package-architect/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.