@theholocron/skills 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -29,6 +29,8 @@ Skills authored and maintained in this repo. Published inside the npm package.
29
29
  | [`holocron-skill-config`](./skills/holocron-skill-config/SKILL.md) | Scaffold a new `@theholocron/*-config` package in `theholocron/configs` |
30
30
  | [`holocron-skill-client`](./skills/holocron-skill-client/SKILL.md) | Scaffold a new `@theholocron/*-client` package in `theholocron/clients` |
31
31
  | [`holocron-skill-plugin`](./skills/holocron-skill-plugin/SKILL.md) | Scaffold or migrate a new `holocron-plugin-*` package |
32
+ | [`holocron-skill-util`](./skills/holocron-skill-util/SKILL.md) | Scaffold a new `@theholocron/*-utils` package in `theholocron/utils` |
33
+ | [`holocron-skill-skill`](./skills/holocron-skill-skill/SKILL.md) | Add a new owned skill to `theholocron/skills` |
32
34
 
33
35
  ## External skills
34
36
 
@@ -41,6 +43,7 @@ Not committed to this repo — fetched from upstream by `holocron skills update`
41
43
  | `frontend-design` | [anthropics/skills](https://github.com/anthropics/skills) | Distinctive, intentional UI design guidance |
42
44
  | `vercel-cli` | [vercel/vercel-plugin](https://github.com/vercel/vercel-plugin) | Vercel CLI: deploy, env vars, logs, domains, project linking |
43
45
  | `turbopack` | [vercel/vercel-plugin](https://github.com/vercel/vercel-plugin) | Turbopack bundler: HMR, CSS, tree shaking, webpack migration |
46
+ | `turborepo` | [vercel/turbo](https://github.com/vercel/turbo) | Turborepo task pipeline configuration and cache optimization |
44
47
 
45
48
  ## Installation via `holocron setup`
46
49
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theholocron/skills",
3
- "version": "1.0.0",
3
+ "version": "1.2.0",
4
4
  "description": "Shared agent skill registry.",
5
5
  "keywords": [
6
6
  "agent",
@@ -28,6 +28,9 @@
28
28
  "skills-lock.json",
29
29
  "README.md"
30
30
  ],
31
+ "scripts": {
32
+ "test": "node --test test/index.mjs"
33
+ },
31
34
  "devDependencies": {
32
35
  "@commitlint/cli": "^21.2.1",
33
36
  "@commitlint/config-conventional": "^21.2.0",
@@ -36,13 +39,15 @@
36
39
  "@semantic-release/exec": "^7.1.0",
37
40
  "@semantic-release/git": "^10.0.1",
38
41
  "@semantic-release/github": "^12.0.9",
39
- "@theholocron/cli": ">=2.0.0-alpha.0 <2.0.0",
40
- "@theholocron/commitlint-config": "^7.3.1",
41
- "@theholocron/holocron-plugin-github": ">=2.0.0-alpha.0 <2.0.0",
42
- "@theholocron/semantic-release-config": "^7.3.1",
42
+ "@theholocron/cli": "catalog:holocron",
43
+ "@theholocron/commitlint-config": "catalog:configs",
44
+ "@theholocron/holocron-plugin-github": "catalog:holocron",
45
+ "@theholocron/semantic-release-config": "catalog:configs",
43
46
  "conventional-changelog-conventionalcommits": "^10.2.1",
44
- "semantic-release": "^25.0.7"
47
+ "semantic-release": "^25.0.7",
48
+ "typescript": "^5.9.3"
45
49
  },
50
+ "packageManager": "pnpm@10.34.4",
46
51
  "engines": {
47
52
  "node": ">=22",
48
53
  "pnpm": ">=10"
@@ -51,8 +56,5 @@
51
56
  "access": "public"
52
57
  },
53
58
  "releases": "https://github.com/theholocron/skills/releases",
54
- "wiki": "https://github.com/theholocron/skills/wiki",
55
- "scripts": {
56
- "test": "node --test test/index.mjs"
57
- }
58
- }
59
+ "wiki": "https://github.com/theholocron/skills/wiki"
60
+ }
@@ -20,7 +20,11 @@ Seven files in `packages/<tool>-config/`:
20
20
  ```
21
21
  packages/<tool>-config/
22
22
  ├── package.json
23
- ├── index.js (or named-export entry; use bundles/ for multi-preset)
23
+ ├── index.ts (or named-export entry; use presets/ for multi-preset)
24
+ ├── tsdown.config.ts
25
+ ├── tsconfig.json
26
+ ├── vitest.config.ts
27
+ ├── index.test.ts
24
28
  └── README.md
25
29
  ```
26
30
 
@@ -29,12 +33,16 @@ Optionally, if the config needs multiple presets:
29
33
  ```
30
34
  packages/<tool>-config/
31
35
  ├── package.json
32
- ├── index.js (re-exports all named presets)
36
+ ├── index.ts (re-exports all named presets)
33
37
  ├── presets/
34
- │ ├── node.js
35
- │ └── react.js
36
- ├── bundles/ (preset + opinionated settings combined)
37
- │ └── library.js
38
+ │ ├── node.ts
39
+ │ └── react.ts
40
+ ├── bundles/ (preset + opinionated settings combined)
41
+ │ └── library.ts
42
+ ├── tsdown.config.ts
43
+ ├── tsconfig.json
44
+ ├── vitest.config.ts
45
+ ├── index.test.ts
38
46
  └── README.md
39
47
  ```
40
48
 
@@ -42,13 +50,13 @@ packages/<tool>-config/
42
50
 
43
51
  ### `package.json`
44
52
 
45
- Copy the shape from an existing package (e.g. `packages/vitest-config/package.json`).
53
+ Copy the shape from an existing package (e.g. `packages/prettier-config/package.json`).
46
54
  Key fields:
47
55
 
48
56
  ```json
49
57
  {
50
58
  "name": "@theholocron/<tool>-config",
51
- "version": "4.1.0",
59
+ "version": "<current monorepo version>",
52
60
  "description": "A <Tool> configuration for <purpose>.",
53
61
  "homepage": "https://github.com/theholocron/configs/tree/main/packages/<tool>-config#readme",
54
62
  "bugs": "https://github.com/theholocron/configs/issues",
@@ -58,47 +66,124 @@ Key fields:
58
66
  },
59
67
  "license": "GPL-3.0",
60
68
  "author": "Newton Koumantzelis",
69
+ "keywords": ["<tool>", "config", "theholocron"],
61
70
  "type": "module",
71
+ "main": "dist/index.js",
72
+ "scripts": {
73
+ "build": "tsdown",
74
+ "typecheck": "tsc --noEmit",
75
+ "test": "vitest run"
76
+ },
77
+ "devDependencies": {
78
+ "@theholocron/tsconfig": "workspace:*",
79
+ "@theholocron/vitest-config": "workspace:*",
80
+ "@vitest/coverage-v8": "catalog:",
81
+ "tsdown": "catalog:",
82
+ "typescript": "catalog:",
83
+ "vitest": "catalog:"
84
+ },
62
85
  "exports": {
63
- ".": { "import": "./index.js", "default": "./index.js" }
86
+ ".": {
87
+ "types": "./dist/index.d.ts",
88
+ "import": "./dist/index.js",
89
+ "default": "./dist/index.js"
90
+ },
91
+ "./package.json": "./package.json"
64
92
  },
65
- "files": ["index.js"],
93
+ "files": ["dist/"],
66
94
  "peerDependencies": {
67
95
  "<tool>": "^<major>"
68
96
  },
97
+ "engines": {
98
+ "node": ">=22.0.0"
99
+ },
69
100
  "publishConfig": { "access": "public" }
70
101
  }
71
102
  ```
72
103
 
73
- - Match `version` to the current monorepo version (check the root `package.json`).
104
+ - **Match `version` to the current monorepo version** — check the root `package.json`.
74
105
  - All peer deps that are optional per-preset go under `peerDependenciesMeta`:
75
106
  ```json
76
107
  "peerDependenciesMeta": { "<tool>": { "optional": true } }
77
108
  ```
78
- - Export each preset/bundle as a subpath (`"./presets/node"`, `"./bundles/library"`, …)
79
- and add those to `"files"`.
109
+ - Export each preset/bundle as a subpath (`"./presets/node"`, `"./bundles/library"`, …),
110
+ add the corresponding `"types"` / `"import"` / `"default"` keys pointing to `dist/`,
111
+ and ensure they are listed under `"files": ["dist/"]`.
112
+
113
+ ### `tsdown.config.ts`
114
+
115
+ ```ts
116
+ import { defineConfig } from "tsdown";
117
+ export default defineConfig({
118
+ entry: ["index.ts"],
119
+ format: "esm",
120
+ fixedExtension: false,
121
+ dts: true,
122
+ clean: true,
123
+ });
124
+ ```
125
+
126
+ For multi-preset packages list every entry point:
127
+
128
+ ```ts
129
+ entry: ["index.ts", "presets/node.ts", "presets/react.ts", "bundles/library.ts"],
130
+ ```
131
+
132
+ ### `tsconfig.json`
133
+
134
+ ```json
135
+ {
136
+ "extends": "@theholocron/tsconfig/node-lts",
137
+ "compilerOptions": { "rootDir": ".", "outDir": "dist" },
138
+ "include": ["**/*.ts"],
139
+ "exclude": ["dist", "node_modules", "tsdown.config.ts"]
140
+ }
141
+ ```
142
+
143
+ ### `vitest.config.ts`
144
+
145
+ ```ts
146
+ import { node } from "@theholocron/vitest-config";
147
+ import { defineConfig } from "vitest/config";
148
+ export default defineConfig(node());
149
+ ```
150
+
151
+ ### `index.ts` (single default export)
80
152
 
81
- ### `index.js` (single-export example)
153
+ ```ts
154
+ import type { Config } from "<tool>";
82
155
 
83
- ```js
84
- /**
85
- * @see https://example.com/docs/config
86
- * @type {import("<tool>").Config}
87
- */
88
156
  const config = {
89
- // ...
90
- };
157
+ // ...
158
+ } satisfies Config;
91
159
 
92
160
  export default config;
93
161
  ```
94
162
 
95
- ### `index.js` (multi-export / named presets)
163
+ ### `index.ts` (named presets / multi-export)
96
164
 
97
- ```js
165
+ ```ts
98
166
  export { node } from "./presets/node.js";
99
167
  export { react } from "./presets/react.js";
100
168
  ```
101
169
 
170
+ Note: source files use `.js` extensions on relative imports — TypeScript's ESM
171
+ convention; the TS resolver finds the `.ts` file at build time.
172
+
173
+ ### `index.test.ts`
174
+
175
+ ```ts
176
+ import { describe, it, expect } from "vitest";
177
+ import config from "./index.js";
178
+
179
+ describe("<tool>-config", () => {
180
+ it("exports a non-empty config object", () => {
181
+ expect(typeof config).toBe("object");
182
+ expect(Object.keys(config).length).toBeGreaterThan(0);
183
+ });
184
+ });
185
+ ```
186
+
102
187
  ### `README.md`
103
188
 
104
189
  Follow this structure (see existing READMEs for tone):
@@ -125,21 +210,27 @@ Keep it short. Link to official docs rather than duplicating them.
125
210
 
126
211
  ## Non-negotiables
127
212
 
128
- - **No build step.** Source JS is the published artifact. Do not add TypeScript
129
- compilation.
213
+ - **TypeScript source, compiled to `dist/` via tsdown.** Never publish raw `.ts`
214
+ files or add plain `.js` source. The `"files"` field must be `["dist/"]`.
130
215
  - **Match version to current monorepo version** — check root `package.json`.
131
216
  - **Peer deps, not regular deps.** The tool being configured belongs in
132
217
  `peerDependencies`.
133
218
  - **Deprecation notice** if replacing an existing package — add a banner at the
134
219
  top of the old package's `README.md` pointing to the replacement.
135
220
  - Run `pnpm install` after adding the package to pick up workspace resolution.
221
+ - Run `pnpm build` to verify tsdown compiles successfully.
136
222
  - Run `pnpm lint` to verify the new files pass ESLint.
137
223
 
138
224
  ## Checklist
139
225
 
140
- 1. Create `packages/<tool>-config/` with `package.json`, `index.js`, `README.md`
141
- 2. Add `vitest` and `@theholocron/vitest-config: "workspace:*"` to `devDependencies`
142
- 3. Add `"build": "tsdown"`, `"test": "vitest run"`, `"typecheck": "tsc --noEmit"` to scripts
226
+ 1. Create `packages/<tool>-config/` with all seven files listed above.
227
+ 2. Set `devDependencies` to include `@theholocron/tsconfig`, `@theholocron/vitest-config`,
228
+ `@vitest/coverage-v8`, `tsdown`, `typescript`, and `vitest` (use `catalog:` /
229
+ `workspace:*` specifiers — never pin exact versions).
230
+ 3. Confirm `scripts` has `"build": "tsdown"`, `"test": "vitest run"`, and
231
+ `"typecheck": "tsc --noEmit"`.
143
232
  4. Add entry to `codecov.yml` under `component_management.individual_components`
144
- 5. Verify `pnpm install` resolves, `pnpm build` succeeds, `pnpm test` passes
145
- 6. Open a PR with a `feat:` commit
233
+ with `component_id: <slug>`, `name: "<slug>"`, and `paths: [packages/<slug>/**]`.
234
+ 5. Run `pnpm install`, `pnpm build`, `pnpm test`, `pnpm typecheck` — all must pass.
235
+ 6. Open a PR with a `feat:` commit — semantic-release will compute a minor bump
236
+ and publish all packages in lockstep.
@@ -0,0 +1,134 @@
1
+ ---
2
+ name: holocron-skill-skill
3
+ description: Add a new owned skill to theholocron/skills. INVOKE WHEN: user asks to create or add a new skill to the skills repo. Invoked as /holocron-skill-skill.
4
+ ---
5
+
6
+ <!-- editorconfig-checker-disable-file -->
7
+
8
+ # Add a new skill
9
+
10
+ Add a new owned skill to `theholocron/skills`.
11
+
12
+ Replace `<name>` with the skill's kebab-case identifier (e.g. `git-safety`, `holocron-skill-config`).
13
+
14
+ ---
15
+
16
+ ## 1. Decide the skill category
17
+
18
+ **Workflow & safety** — generic skills applicable to any repo (e.g. `git-safety`, `commit-standards`).
19
+ **Project-specific** — skills scoped to a particular theholocron repo or task (e.g. `holocron-skill-config`).
20
+
21
+ The category determines which section of `README.md` the skill is listed in.
22
+
23
+ ---
24
+
25
+ ## 2. Create the skill file
26
+
27
+ ```
28
+ skills/<name>/
29
+ └── SKILL.md
30
+ ```
31
+
32
+ ### `SKILL.md` frontmatter
33
+
34
+ ```markdown
35
+ ---
36
+ name: <name>
37
+ description: <One-line description>. INVOKE WHEN: <trigger conditions>. Invoked as /<name>.
38
+ ---
39
+ ```
40
+
41
+ - `name` must match the directory name exactly.
42
+ - `description` is what Claude reads to decide whether to invoke the skill — make the "INVOKE WHEN" clause specific and unambiguous.
43
+ - "Invoked as `/<name>`" is the slash-command the user types.
44
+
45
+ ### Body structure
46
+
47
+ Follow the pattern used by existing skills:
48
+
49
+ ```markdown
50
+ # <Skill title>
51
+
52
+ <One-paragraph summary of what this skill does and when to use it.>
53
+
54
+ ## When to use
55
+
56
+ <Bullet list of specific trigger scenarios.>
57
+
58
+ ## <Main content section(s)>
59
+
60
+ <Rules, checklists, file templates, etc.>
61
+
62
+ ## Non-negotiables (if applicable)
63
+
64
+ <Hard rules the agent must never violate.>
65
+
66
+ ## Checklist
67
+
68
+ <Numbered steps — the agent works through these in order.>
69
+ ```
70
+
71
+ Keep it concise. The agent reads this at invocation time; every sentence should earn its place.
72
+
73
+ ---
74
+
75
+ ## 3. Validate
76
+
77
+ ```bash
78
+ pnpm test
79
+ ```
80
+
81
+ The smoke test checks that every `skills/*/SKILL.md` exists. It will fail if the frontmatter is missing or the file is empty.
82
+
83
+ ---
84
+
85
+ ## 4. Update `README.md`
86
+
87
+ Add a row to the **Owned skills** table in the appropriate section:
88
+
89
+ ```markdown
90
+ | [`<name>`](./skills/<name>/SKILL.md) | <Short description — match the "description" frontmatter field> |
91
+ ```
92
+
93
+ - Workflow & safety skills → "Workflow & safety" table
94
+ - Repo-specific skills → "Project-specific (theholocron)" table
95
+
96
+ ---
97
+
98
+ ## 5. Update `AGENTS.md`
99
+
100
+ Add a row to the **Available skills** table in the matching section:
101
+
102
+ ```markdown
103
+ | `<name>` | <trigger phrase — a few words> |
104
+ ```
105
+
106
+ ---
107
+
108
+ ## 6. Open a PR
109
+
110
+ ```bash
111
+ git add skills/<name>/SKILL.md README.md AGENTS.md
112
+ git commit -s -m "feat: add <name> skill"
113
+ ```
114
+
115
+ Semantic-release handles versioning. The `pnpm test` smoke test runs in CI.
116
+
117
+ ---
118
+
119
+ ## Non-negotiables
120
+
121
+ - **`name` in frontmatter must match the directory name** — the smoke test and install tooling rely on this.
122
+ - **`INVOKE WHEN:` clause is required in `description`** — without it, the agent won't know when to invoke the skill automatically.
123
+ - **Both `README.md` and `AGENTS.md` must be updated** — `README.md` is the public-facing table; `AGENTS.md` is what agents read in consuming repos.
124
+ - **`pnpm test` must pass** before opening a PR.
125
+
126
+ ---
127
+
128
+ ## Checklist
129
+
130
+ 1. Create `skills/<name>/SKILL.md` with correct frontmatter and body.
131
+ 2. Run `pnpm test` — smoke test must pass.
132
+ 3. Add row to `README.md` owned skills table (correct section).
133
+ 4. Add row to `AGENTS.md` Available skills table (correct section).
134
+ 5. Open a PR with a `feat:` commit signed with `-s`.
@@ -0,0 +1,274 @@
1
+ ---
2
+ name: holocron-skill-util
3
+ description: Scaffold a new @theholocron/<slug>-utils package in theholocron/utils. INVOKE WHEN: user asks to add a new utility package to the utils monorepo. Invoked as /holocron-skill-util.
4
+ ---
5
+
6
+ <!-- editorconfig-checker-disable-file -->
7
+
8
+ # Scaffold a new utility package
9
+
10
+ Scaffold a new `@theholocron/<name>-utils` package in `theholocron/utils`.
11
+
12
+ Replace `<name>` with the utility domain in kebab-case (e.g. `color`, `math`, `format`).
13
+
14
+ Reference implementations:
15
+ - Node-only package: `packages/string-utils` (canonical, no browser APIs)
16
+ - Browser-API package: `packages/location-utils` (adds DOM lib + eslint override)
17
+
18
+ ---
19
+
20
+ ## 1. Create the package directory
21
+
22
+ ```
23
+ packages/<name>-utils/
24
+ ├── src/
25
+ │ └── index.ts
26
+ ├── package.json
27
+ ├── tsdown.config.ts
28
+ ├── tsconfig.json
29
+ ├── vitest.config.ts
30
+ └── README.md
31
+ ```
32
+
33
+ Tests live colocated in `src/` as `*.test.ts` files alongside the source they cover.
34
+
35
+ ---
36
+
37
+ ## 2. File templates
38
+
39
+ ### `package.json`
40
+
41
+ ```json
42
+ {
43
+ "name": "@theholocron/<name>-utils",
44
+ "version": "<current monorepo version>",
45
+ "description": "<One-line description.>",
46
+ "homepage": "https://github.com/theholocron/utils/tree/main/packages/<name>-utils#readme",
47
+ "bugs": "https://github.com/theholocron/utils/issues",
48
+ "releases": "https://github.com/theholocron/utils/releases",
49
+ "wiki": "https://github.com/theholocron/utils/wiki",
50
+ "repository": {
51
+ "type": "git",
52
+ "url": "git+https://github.com/theholocron/utils.git"
53
+ },
54
+ "license": "GPL-3.0",
55
+ "author": "Newton Koumantzelis",
56
+ "type": "module",
57
+ "exports": {
58
+ ".": {
59
+ "import": "./dist/index.js",
60
+ "types": "./dist/index.d.ts"
61
+ }
62
+ },
63
+ "files": ["dist", "README.md"],
64
+ "scripts": {
65
+ "build": "tsdown",
66
+ "lint": "eslint .",
67
+ "test": "vitest run",
68
+ "typecheck": "npx tsc --noEmit"
69
+ },
70
+ "devDependencies": {
71
+ "@theholocron/tsdown-config": "catalog:configs",
72
+ "@theholocron/vitest-config": "catalog:configs",
73
+ "@tsconfig/node-lts": "catalog:",
74
+ "@vitest/coverage-v8": "catalog:",
75
+ "tsdown": "catalog:",
76
+ "vitest": "catalog:"
77
+ },
78
+ "packageManager": "pnpm@10.34.4",
79
+ "engines": {
80
+ "node": ">=22",
81
+ "pnpm": ">=10"
82
+ },
83
+ "publishConfig": {
84
+ "access": "public"
85
+ }
86
+ }
87
+ ```
88
+
89
+ - **Match `version` to the current monorepo version** — check any existing package's `package.json`.
90
+ - Runtime dependencies (if any) go in `"dependencies"`, not `devDependencies`.
91
+ - Browser-API packages should add `"happy-dom": "catalog:"` to `devDependencies` for tests.
92
+
93
+ ### `tsdown.config.ts`
94
+
95
+ ```ts
96
+ import { library } from "@theholocron/tsdown-config/presets/library";
97
+ import type { UserConfig } from "tsdown";
98
+
99
+ const config: UserConfig = library({
100
+ deps: { neverBundle: [/^@theholocron\//] },
101
+ });
102
+
103
+ export default config;
104
+ ```
105
+
106
+ If the package has runtime dependencies that should also be externalized, add their patterns to `neverBundle` (e.g. `packages/string-utils` externalizes `change-case` and `title-case`).
107
+
108
+ ### `tsconfig.json` (Node-only)
109
+
110
+ ```json
111
+ {
112
+ "display": "<Name> Utilities",
113
+ "extends": "@tsconfig/node-lts/tsconfig.json",
114
+ "compilerOptions": {
115
+ "allowImportingTsExtensions": true
116
+ },
117
+ "include": ["./src/**/*.ts"],
118
+ "exclude": ["./node_modules", "**/*.test.ts"]
119
+ }
120
+ ```
121
+
122
+ ### `tsconfig.json` (Browser-API package)
123
+
124
+ Add `"lib"` to `compilerOptions`:
125
+
126
+ ```json
127
+ {
128
+ "display": "<Name> Utilities",
129
+ "extends": "@tsconfig/node-lts/tsconfig.json",
130
+ "compilerOptions": {
131
+ "allowImportingTsExtensions": true,
132
+ "lib": ["dom", "dom.iterable", "es2022"]
133
+ },
134
+ "include": ["./src/**/*.ts"],
135
+ "exclude": ["./node_modules", "**/*.test.ts"]
136
+ }
137
+ ```
138
+
139
+ ### `vitest.config.ts`
140
+
141
+ ```ts
142
+ import { library } from "@theholocron/vitest-config/bundles/library";
143
+ import { defineConfig } from "vitest/config";
144
+
145
+ export default defineConfig(library({ globals: true }) as never);
146
+ ```
147
+
148
+ `globals: true` is required — tests use `describe`/`test`/`expect` without explicit imports.
149
+
150
+ ### `src/index.ts`
151
+
152
+ ```ts
153
+ // Named exports — no default export
154
+ export function myUtil(value: string): string {
155
+ return value;
156
+ }
157
+ ```
158
+
159
+ Use named exports throughout. Group related utilities into sibling files (`src/casing.ts`, `src/casting.ts`, …) and re-export from `src/index.ts`:
160
+
161
+ ```ts
162
+ export * from "./casing.ts";
163
+ export * from "./casting.ts";
164
+ ```
165
+
166
+ Note: source imports use `.ts` extensions — TypeScript's ESM convention.
167
+
168
+ ### Test files (`src/<module>.test.ts`)
169
+
170
+ ```ts
171
+ import { describe, expect, test } from "vitest";
172
+
173
+ import { myUtil } from "./index.ts";
174
+
175
+ describe("<Name>", () => {
176
+ test("does X", () => {
177
+ expect(myUtil("input")).toBe("expected");
178
+ });
179
+ });
180
+ ```
181
+
182
+ ### `README.md`
183
+
184
+ ```markdown
185
+ # `@theholocron/<name>-utils`
186
+
187
+ <One-line description of what the utilities do.>
188
+
189
+ ## Installation
190
+
191
+ \`\`\`bash
192
+ pnpm add @theholocron/<name>-utils
193
+ \`\`\`
194
+
195
+ ## Usage
196
+
197
+ \`\`\`typescript
198
+ import * as <name> from "@theholocron/<name>-utils";
199
+
200
+ <minimal working example>
201
+ \`\`\`
202
+
203
+ ## Documentation
204
+
205
+ Check out [The Holocron Archive](https://docs.theholocron.dev/projects/utils/) for more information.
206
+ ```
207
+
208
+ ---
209
+
210
+ ## 3. Register in `release.config.ts`
211
+
212
+ Add the new package path to `prepareCmd` **in alphabetical order**:
213
+
214
+ ```ts
215
+ // release.config.ts
216
+ "node -e \"...['packages/array-utils','packages/<name>-utils',...].forEach(...)\"",
217
+ ```
218
+
219
+ ---
220
+
221
+ ## 4. Add to `codecov.yml`
222
+
223
+ Append to `component_management.individual_components` (keep alphabetical):
224
+
225
+ ```yaml
226
+ - component_id: <name>-utils
227
+ name: "<name>-utils"
228
+ paths:
229
+ - packages/<name>-utils/**
230
+ ```
231
+
232
+ ---
233
+
234
+ ## 5. Browser-API packages only: update root `eslint.config.ts`
235
+
236
+ Add the new package's source path to the browser override block:
237
+
238
+ ```ts
239
+ // eslint.config.ts — existing override
240
+ files: [
241
+ "packages/location-utils/src/**",
242
+ "packages/misc-utils/src/**",
243
+ "packages/storage-utils/src/**",
244
+ "packages/<name>-utils/src/**", // ← add here
245
+ ],
246
+ rules: {
247
+ "n/no-unsupported-features/node-builtins": "off",
248
+ },
249
+ ```
250
+
251
+ ---
252
+
253
+ ## Non-negotiables
254
+
255
+ - **`catalog:configs`** for `@theholocron/tsdown-config` and `@theholocron/vitest-config`; `catalog:` for everything else — never pin exact versions.
256
+ - **`tsdown` and `vitest` must be direct `devDependencies`** — pnpm does not expose transitive binaries.
257
+ - **`globals: true`** in every `vitest.config.ts` — required by existing test style.
258
+ - **Match version to current monorepo version** before opening a PR.
259
+ - **Run `pnpm install`** after adding `package.json` to pick up workspace resolution.
260
+
261
+ ---
262
+
263
+ ## Checklist
264
+
265
+ 1. Create `packages/<name>-utils/` with all files listed above.
266
+ 2. Add package path to `prepareCmd` in `release.config.ts` (alphabetical order).
267
+ 3. Add `component_id` entry to `codecov.yml` (alphabetical order).
268
+ 4. If browser-API package: add `"lib"` to tsconfig + add path to root `eslint.config.ts` override.
269
+ 5. Run `pnpm install` — must resolve without errors.
270
+ 6. Run `pnpm build` — tsdown must compile successfully.
271
+ 7. Run `pnpm test` — all tests must pass.
272
+ 8. Run `pnpm typecheck` — no type errors.
273
+ 9. Run `pnpm lint` — no lint errors.
274
+ 10. Open a PR with a `feat:` commit — semantic-release computes a minor bump and publishes all packages in lockstep.
package/skills-lock.json CHANGED
@@ -19,6 +19,12 @@
19
19
  "skillPath": "skills/turbopack/SKILL.md",
20
20
  "computedHash": "cd8c2f189adacb88854c20088ab37dfe077cdc0bc1ded3ec3aa4e40be22bcf3c"
21
21
  },
22
+ "turborepo": {
23
+ "source": "vercel/turbo",
24
+ "sourceType": "github",
25
+ "skillPath": "skills/turborepo/SKILL.md",
26
+ "computedHash": "4f3937d6463890e607ad015d8256e4c27766f0eacaaf87eed1c6454239746694"
27
+ },
22
28
  "vercel-cli": {
23
29
  "source": "vercel/vercel-plugin",
24
30
  "sourceType": "github",