@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 +1 -0
- package/package.json +12 -9
- package/skills/holocron-skill-config/SKILL.md +121 -30
- package/skills-lock.json +6 -0
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.
|
|
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": "
|
|
42
|
+
"@theholocron/cli": "catalog:holocron",
|
|
40
43
|
"@theholocron/commitlint-config": "^7.3.1",
|
|
41
|
-
"@theholocron/holocron-plugin-github": "
|
|
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
|
-
|
|
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.
|
|
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.
|
|
36
|
+
├── index.ts (re-exports all named presets)
|
|
33
37
|
├── presets/
|
|
34
|
-
│ ├── node.
|
|
35
|
-
│ └── react.
|
|
36
|
-
├── bundles/
|
|
37
|
-
│ └── library.
|
|
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/
|
|
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": "
|
|
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
|
-
".": {
|
|
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": ["
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
163
|
+
### `index.ts` (named presets / multi-export)
|
|
96
164
|
|
|
97
|
-
```
|
|
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
|
-
- **
|
|
129
|
-
|
|
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
|
|
141
|
-
2.
|
|
142
|
-
|
|
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
|
-
|
|
145
|
-
|
|
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",
|