@theholocron/skills 1.0.0 → 1.1.3

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
@@ -41,6 +41,7 @@ Not committed to this repo — fetched from upstream by `holocron skills update`
41
41
  | `frontend-design` | [anthropics/skills](https://github.com/anthropics/skills) | Distinctive, intentional UI design guidance |
42
42
  | `vercel-cli` | [vercel/vercel-plugin](https://github.com/vercel/vercel-plugin) | Vercel CLI: deploy, env vars, logs, domains, project linking |
43
43
  | `turbopack` | [vercel/vercel-plugin](https://github.com/vercel/vercel-plugin) | Turbopack bundler: HMR, CSS, tree shaking, webpack migration |
44
+ | `turborepo` | [vercel/turbo](https://github.com/vercel/turbo) | Turborepo task pipeline configuration and cache optimization |
44
45
 
45
46
  ## Installation via `holocron setup`
46
47
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theholocron/skills",
3
- "version": "1.0.0",
3
+ "version": "1.1.3",
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,16 @@
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",
42
+ "@theholocron/cli": "catalog:holocron",
40
43
  "@theholocron/commitlint-config": "^7.3.1",
41
- "@theholocron/holocron-plugin-github": ">=2.0.0-alpha.0 <2.0.0",
44
+ "@theholocron/holocron-plugin-github": "catalog:holocron",
42
45
  "@theholocron/semantic-release-config": "^7.3.1",
46
+ "@semantic-release/npm": "^13.0.0",
43
47
  "conventional-changelog-conventionalcommits": "^10.2.1",
44
- "semantic-release": "^25.0.7"
48
+ "semantic-release": "^25.0.7",
49
+ "typescript": "^5.9.3"
45
50
  },
51
+ "packageManager": "pnpm@10.34.4",
46
52
  "engines": {
47
53
  "node": ">=22",
48
54
  "pnpm": ">=10"
@@ -51,8 +57,5 @@
51
57
  "access": "public"
52
58
  },
53
59
  "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
- }
60
+ "wiki": "https://github.com/theholocron/skills/wiki"
61
+ }
@@ -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.
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",