@theholocron/skills 1.2.1 → 1.3.1

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theholocron/skills",
3
- "version": "1.2.1",
3
+ "version": "1.3.1",
4
4
  "description": "Shared agent skill registry.",
5
5
  "keywords": [
6
6
  "agent",
@@ -10,44 +10,33 @@
10
10
  "skills",
11
11
  "theholocron"
12
12
  ],
13
- "homepage": "https://github.com/theholocron/skills#readme",
13
+ "homepage": "https://github.com/theholocron/skills/tree/main/packages/skills#readme",
14
14
  "bugs": "https://github.com/theholocron/skills/issues",
15
15
  "repository": {
16
16
  "type": "git",
17
- "url": "git+https://github.com/theholocron/skills.git"
17
+ "url": "git+https://github.com/theholocron/skills.git",
18
+ "directory": "packages/skills"
18
19
  },
19
20
  "license": "MIT",
20
21
  "author": "Newton Koumantzelis",
21
22
  "type": "module",
22
23
  "exports": {
23
24
  "./package.json": "./package.json",
24
- "./skills/*": "./skills/*"
25
+ "./skills/*": "./*"
25
26
  },
26
27
  "files": [
27
- "skills/",
28
+ "commit-standards/",
29
+ "git-safety/",
30
+ "holocron-skill-client/",
31
+ "holocron-skill-config/",
32
+ "holocron-skill-plugin/",
33
+ "holocron-skill-skill/",
34
+ "holocron-skill-util/",
35
+ "pr-workflow/",
36
+ "security-review/",
28
37
  "skills-lock.json",
29
38
  "README.md"
30
39
  ],
31
- "scripts": {
32
- "test": "node --test test/index.mjs"
33
- },
34
- "devDependencies": {
35
- "@commitlint/cli": "^21.2.1",
36
- "@commitlint/config-conventional": "^21.2.0",
37
- "@commitlint/types": "^21.2.0",
38
- "@semantic-release/changelog": "^6.0.3",
39
- "@semantic-release/exec": "^7.1.0",
40
- "@semantic-release/git": "^10.0.1",
41
- "@semantic-release/github": "^12.0.9",
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",
46
- "conventional-changelog-conventionalcommits": "^10.2.1",
47
- "semantic-release": "^25.0.7",
48
- "typescript": "^5.9.3"
49
- },
50
- "packageManager": "pnpm@10.34.4",
51
40
  "engines": {
52
41
  "node": ">=22",
53
42
  "pnpm": ">=10"
@@ -56,5 +45,8 @@
56
45
  "access": "public"
57
46
  },
58
47
  "releases": "https://github.com/theholocron/skills/releases",
59
- "wiki": "https://github.com/theholocron/skills/wiki"
60
- }
48
+ "wiki": "https://github.com/theholocron/skills/wiki",
49
+ "scripts": {
50
+ "test": "node --test test/index.mjs"
51
+ }
52
+ }
package/README.md DELETED
@@ -1,111 +0,0 @@
1
- # `@theholocron/skills`
2
-
3
- <!-- holocron:description -->
4
-
5
- Shared agent skill registry.
6
-
7
- <!-- /holocron:description -->
8
-
9
- Each skill is a directory under `skills/` containing a `SKILL.md` file that Claude Code (and compatible
10
- agents) can load as a slash command.
11
-
12
- ## Owned skills
13
-
14
- Skills authored and maintained in this repo. Published inside the npm package.
15
-
16
- ### Workflow & safety
17
-
18
- | Skill | Description |
19
- |-------|-------------|
20
- | [`git-safety`](./skills/git-safety/SKILL.md) | Never force-push or run destructive git ops without permission |
21
- | [`pr-workflow`](./skills/pr-workflow/SKILL.md) | Always open a PR; one-change-per-PR; delete branch on close |
22
- | [`commit-standards`](./skills/commit-standards/SKILL.md) | Conventional Commits format + DCO signing |
23
- | [`security-review`](./skills/security-review/SKILL.md) | OWASP-oriented checklist for code review |
24
-
25
- ### Project-specific (theholocron)
26
-
27
- | Skill | Description |
28
- |-------|-------------|
29
- | [`holocron-skill-config`](./skills/holocron-skill-config/SKILL.md) | Scaffold a new `@theholocron/*-config` package in `theholocron/configs` |
30
- | [`holocron-skill-client`](./skills/holocron-skill-client/SKILL.md) | Scaffold a new `@theholocron/*-client` package in `theholocron/clients` |
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` |
34
-
35
- ## External skills
36
-
37
- Tracked in [`skills-lock.json`](./skills-lock.json) with source provenance and content hash.
38
- Not committed to this repo — fetched from upstream by `holocron skills update` (planned).
39
-
40
- | Skill | Source | Description |
41
- |-------|--------|-------------|
42
- | `find-skills` | [vercel-labs/skills](https://github.com/vercel-labs/skills) | Discover and install agent skills from the skills.sh ecosystem |
43
- | `frontend-design` | [anthropics/skills](https://github.com/anthropics/skills) | Distinctive, intentional UI design guidance |
44
- | `vercel-cli` | [vercel/vercel-plugin](https://github.com/vercel/vercel-plugin) | Vercel CLI: deploy, env vars, logs, domains, project linking |
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 |
47
-
48
- ## Installation via `holocron setup`
49
-
50
- Skills are installed by `holocron setup` based on the `skills` field in
51
- `holocron.config.ts`. They are written to `.agents/skills/<name>/` with a
52
- symlink at the agent-specific path, and **gitignored** — treated as dependencies,
53
- not source.
54
-
55
- ```typescript
56
- // holocron.config.ts
57
- import { defineConfig } from "@theholocron/cli";
58
-
59
- export default defineConfig({
60
- agent: "claude",
61
- skills: ["git-safety", "pr-workflow", "commit-standards", "security-review"],
62
- // ...
63
- });
64
- ```
65
-
66
- Then run:
67
-
68
- ```sh
69
- pnpm add -D @theholocron/skills
70
- GITHUB_TOKEN=$(gh auth token) pnpm exec holocron setup
71
- ```
72
-
73
- ## Manual installation
74
-
75
- Copy a skill directory into your project's `.agents/skills/` and symlink it:
76
-
77
- ```sh
78
- cp -r node_modules/@theholocron/skills/skills/git-safety .agents/skills/
79
- ln -s ../../.agents/skills/git-safety .claude/skills/git-safety
80
- ```
81
-
82
- Add both to `.gitignore`:
83
-
84
- ```gitignore
85
- # managed by holocron setup — skills
86
- /.agents/skills/
87
- /.claude/skills/git-safety
88
- ```
89
-
90
- ## Contributing
91
-
92
- ### Adding an owned skill
93
-
94
- 1. Create `skills/<name>/SKILL.md` with the frontmatter format:
95
- ```markdown
96
- ---
97
- name: <name>
98
- description: One-line description. INVOKE WHEN: <trigger conditions>.
99
- ---
100
- # skill title
101
- …
102
- ```
103
- 2. Run `pnpm test` — the smoke test checks that every skill dir has a `SKILL.md`.
104
- 3. Update this README with a row in the owned skills table.
105
- 4. Open a PR with a `feat:` commit — semantic-release handles versioning.
106
-
107
- ### Registering an external skill
108
-
109
- Run `npx skills add <repo> --skill <name>` from this repo root. This records the
110
- skill in `skills-lock.json` with its source and content hash but does **not** copy
111
- it into `skills/` — external skill content is fetched at install time.
File without changes
File without changes