Why does it flag lockfiles in sub-workspaces?

Bun monorepos should maintain a single bun.lockb at the root to ensure dependency consistency; local lockfiles can cause version mismatches and install issues.

What specifically does the Bun Validator audit?

It checks Bun version compatibility (1.3+), root package.json structure, workspace isolation, redundant lockfiles, and the correct usage of dependency catalogs.

How do I fix 'workspace protocol' issues flagged by the tool?

Ensure your internal package dependencies use 'workspace:*' or 'workspace:^version' instead of hardcoded version numbers in package.json.

Does it support the new Bun 1.3 dependency catalogs?

Yes, it is specifically designed to validate and encourage the use of central dependency catalogs for easier version management across workspaces.

Can I integrate this into my GitHub Actions?

Yes, the skill includes a dedicated --ci flag intended for CI/CD pipelines to fail builds if workspace validation rules are violated.

Bun Workspace Validator

Name: Bun Workspace Validator
Author: shipshitdev

byshipshitdev

•

Deployment & DevOps

Validates Bun monorepo configurations to ensure compatibility with Bun 1.3+ best practices and workspace isolation.

Bun Workspace Validator is a specialized utility designed to audit and optimize Bun-based monorepos. It enforces modern standards introduced in Bun 1.3+, such as dependency catalogs and isolated installs, while detecting common pitfalls like redundant lockfiles, root-level dependencies, and improper workspace protocols. By integrating this skill, developers can maintain a clean, high-performance monorepo structure that aligns with the latest Bun ecosystem recommendations, preventing runtime errors and dependency hell.

Key Features

0110 GitHub stars

02Ensures strict workspace isolation and prevents improper dependency hoisting

03Validates Bun 1.3+ dependency catalogs and centralized version management

04Detects and flags redundant lockfiles within individual workspace folders

05Enforces the 'workspace:*' protocol for internal package cross-linking

06Audits root package.json for invalid dependency declarations and private status

Use Cases

01Migrating an existing monorepo to modern Bun 1.3+ architecture

02Automating CI/CD pipeline checks to prevent workspace configuration drift

03Auditing AI-generated package.json files for best-practice compliance

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shipshitdev/library bun-validator

For use in Claude.ai and ChatGPT

Download Skill