CtrlK
BlogDocsLog inGet started
Tessl Logo

link-workspace-packages

Link workspace packages in monorepos (npm, yarn, bun). USE WHEN: (1) you just created or generated new packages and need to wire up their dependencies, (2) user imports from a sibling package and needs to add it as a dependency, (3) you get resolution errors for workspace packages (@org/*) like "cannot find module", "failed to resolve import", "TS2307", or "cannot resolve". DO NOT patch around with tsconfig paths or manual package.json edits - use the package manager's workspace commands to fix actual linking.

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, command-first skill body: each package manager gets an executable command and its exact package.json result, with a short workflow and debug example. The only soft spot is that the workflow's verification step is named but not shown how to perform, which keeps workflow clarity just below full marks.

DimensionReasoningScore

Conciseness

The body is lean and command-first: 'Check whether there's a `packageManager` field', 'npm auto-symlinks workspace packages', and per-manager command blocks with resulting `package.json` snippets. It assumes Claude's competence — no padding explaining what workspaces or monorepos are — and every section earns its tokens; the only near-redundancy ('npm resolves to local workspace automatically during install') is a useful clarification.

5 / 5

Actionability

Every manager gets a copy-paste-ready command ('yarn workspace @org/app add @org/ui', 'npm install @org/ui --workspace @org/app', 'cd packages/app && bun add @org/ui') plus the exact resulting dependency entry ('workspace:^', '*', 'workspace:*'), and Example 2 gives an executable debug path. The yarn section explicitly scopes to v2+/berry rather than hiding the boundary, so there are no misleading gaps.

5 / 5

Workflow Clarity

The Workflow section sequences identify-consumer → identify-provider → add dependency → 'Verify symlinks created in consumer's `node_modules/`', and Example 2 provides a recovery loop for resolution errors. It falls short of a 5 because the verify step never says how to check (e.g. `ls node_modules/@org/`) and there is no checkpoint for install failure or lockfile effects; it is above 3 because a validation step and an error-recovery example are both explicitly present.

4 / 5

Progressive Disclosure

There is no references/, scripts/, or assets/ bundle, and at ~95 lines of short, well-delimited sections (Detect Package Manager, per-manager sections, Examples, Notes) nothing here warrants splitting into separate files. Navigation is trivial via clear headers, matching the simple-skill organization anchor.

5 / 5

Total

19

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that states a concrete capability and enumerates three explicit trigger scenarios with the literal error messages a user would encounter, plus a negative boundary against tsconfig-path workarounds. Its only limitation is that the action side is a single core operation restated across scenarios rather than a breadth of distinct capabilities, which caps specificity just below full marks.

DimensionReasoningScore

Specificity

Concrete actions are named: 'Link workspace packages in monorepos (npm, yarn, bun)', 'add it as a dependency', 'fix actual linking'. It sits at 4 rather than 5 because the actions reduce to one core operation (linking/wiring dependencies) described from three angles, rather than a comprehensive list of several distinct operations; it is clearly above 3, which requires at most 1-2 concrete actions. The primary voice is third-person imperative ('Link workspace packages'), with 'you' appearing only inside trigger conditions — capability framing like 'You can use this' is absent, so no voice penalty applies.

4 / 5

Completeness

What and when are both explicit: 'Link workspace packages in monorepos (npm, yarn, bun)' states the function, and 'USE WHEN: (1)... (2)... (3)...' enumerates three concrete triggering scenarios with the exact error strings that precede them. It even adds a DO-NOT boundary ('DO NOT patch around with tsconfig paths or manual package.json edits'), exceeding the what+when anchor.

5 / 5

Trigger Term Quality

Exceptionally natural trigger coverage: users hitting this problem literally say 'cannot find module', 'failed to resolve import', 'TS2307', or 'cannot resolve', and the description also includes 'monorepo', '@org/*', 'sibling package', 'wire up their dependencies', and the three manager names. Coverage extends to synonym error strings and the scoped-package glob pattern, matching the comprehensive anchor.

5 / 5

Distinctiveness Conflict Risk

A clear niche — inter-package linking inside workspaces for npm/yarn/bun monorepos — with distinct triggers (scoped '@org/*' resolution failures, TS2307). The DO-NOT clause actively separates it from adjacent tsconfig/package.json-editing skills; only the generic 'cannot find module' phrase has any overlap with non-workspace resolution problems, which is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
leboncoin/spark-web
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.