package-development

Package registration. Use when adding a workspace package, making a private package publishable, renaming a package, or moving its workspace path.

Install
npx skills add 'https://github.com/Effect-TS/effect/tree/main/.agents/skills/package-development'
Download bundle ↓
main · 90695b0Scanned 2026-09-15

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

registration.md

registration.mdBrowse 4 files
View on GitHub
← Back to SKILL.md

Package Registration

Use current configuration and the closest package in the same family as the sources of truth. A package-local build does not prove repository registration. Classify every row as applicable or not applicable.

Workspace And TypeScript

SurfaceCheck
pnpm-workspace.yamlIts globs cover the package path and exact-name pnpm selection discovers it.
pnpm-lock.yamlThe current importer, name, and dependencies exist; renamed or moved importers are gone.
tsconfig.packages.jsonPackages intended to participate in the root TypeScript project-reference graph are referenced. Follow neighboring package policy; buildable private tools are not automatically included.
tsconfig.tests.jsonBroad test globs cover the path. Add source aliases only when tests require workspace source routing or would otherwise create a dependency cycle. Preserve intentional platform exclusions.

Tests And Documentation

SurfaceCheck
vitest.config.tsA package with runtime tests has the intended project, environment, setup, and inclusion rules.
tstyche.jsonType-test discovery covers the package depth; current globs cover one- and two-level package layouts.
vitest.docs.tsDoctest source discovery covers packages with runnable JSDoc examples; current globs cover one- and two-level package layouts.
jsdocs.config.jsonPublic source is included in JSDoc checks and exclusions by package family remain intentional.
deno.jsonDeno checks cover the package family, or its exclusion is intentional.

Release And Discovery

SurfaceCheck
.changeset/config.jsonPublished fixed-group membership uses the current name; private tooling is not added solely because it builds.
README.mdPublic catalog entries have the current name, path, description, and documentation link.
AI documentation copy tooling and package filesPublished payloads include required generated documentation. Continue with publishing.md for the full packed-surface audit.
Snapshot publishing workflowsSnapshot publishing selects the package path. Existing globs may already cover it; apply root workflow requirements before editing.
Runtime-specific CI workflowsRuntime-specific packages participate in applicable runtime jobs; apply root workflow requirements before editing.

Paths And Consumers

Audit explicit workspace package names in root tooling manifests. Search scripts for the package family, old name, and old path to find path-sensitive clean, codemod, circularity, copy, and related behavior. Explain every remaining old reference after a rename or move.

Referenced from SKILL.md