@heurist-network/skills 0.1.4 → 0.1.5

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.
Files changed (4) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +162 -162
  3. package/dist/cli.js +3 -1
  4. package/package.json +53 -53
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Heurist
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Heurist
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,162 +1,162 @@
1
- # @heurist-network/skills
2
-
3
- A CLI for browsing, installing, and managing verified AI agent skills from the [Heurist Mesh](https://mesh.heurist.ai) skill marketplace.
4
-
5
- Skills are reusable instruction sets (`SKILL.md` files) that extend coding agent capabilities. The Heurist marketplace focuses on verified, secure skills across crypto, finance, market intelligence, social data, and developer workflows: every new skill and every new version is audited before it can be installed, only `verified` skills are available through the CLI, sensitive capabilities trigger explicit warnings, and all marketplace artifacts are stored on [Autonomys](https://autonomys.xyz) decentralized storage with SHA256 integrity tracking.
6
-
7
- ## Quick Start
8
-
9
- ```bash
10
- npx @heurist-network/skills add heurist-mesh
11
- ```
12
-
13
- Or install globally:
14
-
15
- ```bash
16
- npm i -g @heurist-network/skills
17
- heurist-skills add heurist-mesh
18
- ```
19
-
20
- ## Commands
21
-
22
- ### `add <slug>`
23
-
24
- Install a verified skill from the marketplace. Aliases: `install`
25
-
26
- ```bash
27
- # Interactive — prompts for agent, scope, and method
28
- heurist-skills add binance-web3-trading-signal
29
-
30
- # Non-interactive
31
- heurist-skills add binance-web3-trading-signal -a claude-code -g -y
32
-
33
- # Copy instead of symlink
34
- heurist-skills add binance-web3-spot --copy -y
35
-
36
- # Target multiple agents
37
- heurist-skills add binance-web3-meme-rush -a claude-code roo -y
38
-
39
- # Interactive search (no slug)
40
- heurist-skills add
41
- ```
42
-
43
- | Flag | Description |
44
- |------|-------------|
45
- | `-a, --agent <agent...>` | Target specific agents |
46
- | `-g, --global` | Install to global scope (`~/.agents/skills/`) |
47
- | `--copy` | Copy files instead of symlinking |
48
- | `-y, --yes` | Skip all confirmation prompts |
49
-
50
- ### `find [query]`
51
-
52
- Search the skill marketplace.
53
-
54
- ```bash
55
- heurist-skills find heurist
56
- heurist-skills find --category Stocks
57
- heurist-skills find # browse all
58
- ```
59
-
60
- Aliases: `search`, `f`
61
-
62
- ### `list`
63
-
64
- List installed skills or browse the marketplace.
65
-
66
- ```bash
67
- heurist-skills list # project-installed skills
68
- heurist-skills list --global # global-installed skills
69
- heurist-skills list --remote # browse marketplace
70
- heurist-skills list --remote -c Crypto # filter by category
71
- heurist-skills list -a claude-code # filter by agent
72
- ```
73
-
74
- Aliases: `ls`
75
-
76
- ### `info <slug>`
77
-
78
- Show detailed skill information including capabilities, files, and install state.
79
-
80
- ```bash
81
- heurist-skills info heurist-mesh
82
- ```
83
-
84
- Aliases: `show`
85
-
86
- ### `remove [slug]`
87
-
88
- Uninstall a skill. Agent-aware and orphan-safe.
89
-
90
- ```bash
91
- heurist-skills remove binance-web3-spot -y
92
- heurist-skills remove binance-web3-spot --global -y
93
- heurist-skills remove binance-web3-spot -a roo -y # remove from one agent only
94
- heurist-skills remove # interactive selector
95
- ```
96
-
97
- | Flag | Description |
98
- |------|-------------|
99
- | `-a, --agent <agent...>` | Remove from specific agents only |
100
- | `-g, --global` | Target global scope |
101
- | `--all` | Remove all installed skills |
102
- | `-y, --yes` | Skip confirmation |
103
-
104
- Aliases: `rm`, `uninstall`
105
-
106
- ### `check`
107
-
108
- Check installed skills for available updates (report-only).
109
-
110
- ```bash
111
- heurist-skills check
112
- ```
113
-
114
- Aliases: `check-updates`, `update-check`
115
-
116
- ## Installation Scope
117
-
118
- | Scope | Canonical Path | Lock File |
119
- |-------|---------------|-----------|
120
- | **Project** (default) | `.agents/skills/<slug>/` | `./skills-lock.json` |
121
- | **Global** (`-g`) | `~/.agents/skills/<slug>/` | `~/.agents/.skill-lock.json` |
122
-
123
- The project lock file (`skills-lock.json`) is designed to be committed to git for reproducible setups.
124
-
125
- ## Installation Methods
126
-
127
- **Symlink** (default) — Writes skill files to a single canonical directory, then creates symlinks into each agent's native skills path. One source of truth, easy to update.
128
-
129
- **Copy** (`--copy`) — Writes independent copies into each agent's directory. Use when symlinks are not supported.
130
-
131
- ## Supported Agents
132
-
133
- | Agent | Project Path | Global Path |
134
- |-------|-------------|-------------|
135
- | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
136
- | Cursor | `.agents/skills/` | `~/.cursor/skills/` |
137
- | Codex | `.agents/skills/` | `~/.codex/skills/` |
138
- | OpenCode | `.agents/skills/` | `~/.config/opencode/skills/` |
139
- | Cline | `.agents/skills/` | `~/.agents/skills/` |
140
- | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
141
- | Gemini CLI | `.agents/skills/` | `~/.gemini/skills/` |
142
- | GitHub Copilot | `.agents/skills/` | `~/.copilot/skills/` |
143
- | Roo Code | `.roo/skills/` | `~/.roo/skills/` |
144
- | Continue | `.continue/skills/` | `~/.continue/skills/` |
145
-
146
- Agents that share `.agents/skills/` (Cursor, Codex, OpenCode, Cline, Gemini CLI, GitHub Copilot) are "universal" — they read skills from the same canonical directory. Non-universal agents (Claude Code, Windsurf, Roo Code, Continue) have their own paths and receive symlinks or copies.
147
-
148
- The CLI auto-detects which agents are installed on your system. If one agent is found, it installs silently. If multiple are found, it prompts for selection.
149
-
150
- ## Configuration
151
-
152
- | Variable | Description |
153
- |----------|-------------|
154
- | `HEURIST_SKILLS_API` | Override marketplace API URL (default: `https://mesh.heurist.xyz`) |
155
-
156
- ## Lock File Compatibility
157
-
158
- The lock files are compatible with the [vercel/skills](https://github.com/vercel-labs/skills) format. If you have existing vercel skill entries in `~/.agents/.skill-lock.json`, they are preserved — the CLI reads and writes only its own entries without disturbing foreign entries.
159
-
160
- ## License
161
-
162
- MIT
1
+ # @heurist-network/skills
2
+
3
+ A CLI for browsing, installing, and managing verified AI agent skills from the [Heurist Mesh](https://mesh.heurist.ai) skill marketplace.
4
+
5
+ Skills are reusable instruction sets (`SKILL.md` files) that extend coding agent capabilities. The Heurist marketplace focuses on verified, secure skills across crypto, finance, market intelligence, social data, and developer workflows: every new skill and every new version is audited before it can be installed, only `verified` skills are available through the CLI, sensitive capabilities trigger explicit warnings, and all marketplace artifacts are stored on [Autonomys](https://autonomys.xyz) decentralized storage with SHA256 integrity tracking.
6
+
7
+ ## Quick Start
8
+
9
+ ```bash
10
+ npx @heurist-network/skills add heurist-mesh
11
+ ```
12
+
13
+ Or install globally:
14
+
15
+ ```bash
16
+ npm i -g @heurist-network/skills
17
+ heurist-skills add heurist-mesh
18
+ ```
19
+
20
+ ## Commands
21
+
22
+ ### `add <slug>`
23
+
24
+ Install a verified skill from the marketplace. Aliases: `install`
25
+
26
+ ```bash
27
+ # Interactive — prompts for agent, scope, and method
28
+ heurist-skills add binance-web3-trading-signal
29
+
30
+ # Non-interactive
31
+ heurist-skills add binance-web3-trading-signal -a claude-code -g -y
32
+
33
+ # Copy instead of symlink
34
+ heurist-skills add binance-web3-spot --copy -y
35
+
36
+ # Target multiple agents
37
+ heurist-skills add binance-web3-meme-rush -a claude-code roo -y
38
+
39
+ # Interactive search (no slug)
40
+ heurist-skills add
41
+ ```
42
+
43
+ | Flag | Description |
44
+ |------|-------------|
45
+ | `-a, --agent <agent...>` | Target specific agents |
46
+ | `-g, --global` | Install to global scope (`~/.agents/skills/`) |
47
+ | `--copy` | Copy files instead of symlinking |
48
+ | `-y, --yes` | Skip all confirmation prompts |
49
+
50
+ ### `find [query]`
51
+
52
+ Search the skill marketplace.
53
+
54
+ ```bash
55
+ heurist-skills find heurist
56
+ heurist-skills find --category Stocks
57
+ heurist-skills find # browse all
58
+ ```
59
+
60
+ Aliases: `search`, `f`
61
+
62
+ ### `list`
63
+
64
+ List installed skills or browse the marketplace.
65
+
66
+ ```bash
67
+ heurist-skills list # project-installed skills
68
+ heurist-skills list --global # global-installed skills
69
+ heurist-skills list --remote # browse marketplace
70
+ heurist-skills list --remote -c Crypto # filter by category
71
+ heurist-skills list -a claude-code # filter by agent
72
+ ```
73
+
74
+ Aliases: `ls`
75
+
76
+ ### `info <slug>`
77
+
78
+ Show detailed skill information including capabilities, files, and install state.
79
+
80
+ ```bash
81
+ heurist-skills info heurist-mesh
82
+ ```
83
+
84
+ Aliases: `show`
85
+
86
+ ### `remove [slug]`
87
+
88
+ Uninstall a skill. Agent-aware and orphan-safe.
89
+
90
+ ```bash
91
+ heurist-skills remove binance-web3-spot -y
92
+ heurist-skills remove binance-web3-spot --global -y
93
+ heurist-skills remove binance-web3-spot -a roo -y # remove from one agent only
94
+ heurist-skills remove # interactive selector
95
+ ```
96
+
97
+ | Flag | Description |
98
+ |------|-------------|
99
+ | `-a, --agent <agent...>` | Remove from specific agents only |
100
+ | `-g, --global` | Target global scope |
101
+ | `--all` | Remove all installed skills |
102
+ | `-y, --yes` | Skip confirmation |
103
+
104
+ Aliases: `rm`, `uninstall`
105
+
106
+ ### `check`
107
+
108
+ Check installed skills for available updates (report-only).
109
+
110
+ ```bash
111
+ heurist-skills check
112
+ ```
113
+
114
+ Aliases: `check-updates`, `update-check`
115
+
116
+ ## Installation Scope
117
+
118
+ | Scope | Canonical Path | Lock File |
119
+ |-------|---------------|-----------|
120
+ | **Project** (default) | `.agents/skills/<slug>/` | `./skills-lock.json` |
121
+ | **Global** (`-g`) | `~/.agents/skills/<slug>/` | `~/.agents/.skill-lock.json` |
122
+
123
+ The project lock file (`skills-lock.json`) is designed to be committed to git for reproducible setups.
124
+
125
+ ## Installation Methods
126
+
127
+ **Symlink** (default) — Writes skill files to a single canonical directory, then creates symlinks into each agent's native skills path. One source of truth, easy to update.
128
+
129
+ **Copy** (`--copy`) — Writes independent copies into each agent's directory. Use when symlinks are not supported.
130
+
131
+ ## Supported Agents
132
+
133
+ | Agent | Project Path | Global Path |
134
+ |-------|-------------|-------------|
135
+ | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
136
+ | Cursor | `.agents/skills/` | `~/.cursor/skills/` |
137
+ | Codex | `.agents/skills/` | `~/.codex/skills/` |
138
+ | OpenCode | `.agents/skills/` | `~/.config/opencode/skills/` |
139
+ | Cline | `.agents/skills/` | `~/.agents/skills/` |
140
+ | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
141
+ | Gemini CLI | `.agents/skills/` | `~/.gemini/skills/` |
142
+ | GitHub Copilot | `.agents/skills/` | `~/.copilot/skills/` |
143
+ | Roo Code | `.roo/skills/` | `~/.roo/skills/` |
144
+ | Continue | `.continue/skills/` | `~/.continue/skills/` |
145
+
146
+ Agents that share `.agents/skills/` (Cursor, Codex, OpenCode, Cline, Gemini CLI, GitHub Copilot) are "universal" — they read skills from the same canonical directory. Non-universal agents (Claude Code, Windsurf, Roo Code, Continue) have their own paths and receive symlinks or copies.
147
+
148
+ The CLI auto-detects which agents are installed on your system. If one agent is found, it installs silently. If multiple are found, it prompts for selection.
149
+
150
+ ## Configuration
151
+
152
+ | Variable | Description |
153
+ |----------|-------------|
154
+ | `HEURIST_SKILLS_API` | Override marketplace API URL (default: `https://mesh.heurist.xyz`) |
155
+
156
+ ## Lock File Compatibility
157
+
158
+ The lock files are compatible with the [vercel/skills](https://github.com/vercel-labs/skills) format. If you have existing vercel skill entries in `~/.agents/.skill-lock.json`, they are preserved — the CLI reads and writes only its own entries without disturbing foreign entries.
159
+
160
+ ## License
161
+
162
+ MIT
package/dist/cli.js CHANGED
@@ -1573,10 +1573,12 @@ var init_update = __esm({
1573
1573
  });
1574
1574
 
1575
1575
  // src/cli.ts
1576
+ import { createRequire } from "module";
1576
1577
  import "dotenv/config";
1577
1578
  import * as p7 from "@clack/prompts";
1578
1579
  import pc7 from "picocolors";
1579
- var VERSION = "0.1.0";
1580
+ var require2 = createRequire(import.meta.url);
1581
+ var { version: VERSION } = require2("../package.json");
1580
1582
  var LOGO = `
1581
1583
  ${pc7.cyan("\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
1582
1584
  ${pc7.cyan("\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D")}
package/package.json CHANGED
@@ -1,53 +1,53 @@
1
- {
2
- "name": "@heurist-network/skills",
3
- "version": "0.1.4",
4
- "description": "CLI tool for browsing, installing, and managing Heurist Mesh skills from the skill marketplace registry.",
5
- "type": "module",
6
- "bin": {
7
- "heurist-skills": "bin/cli.mjs"
8
- },
9
- "files": [
10
- "dist",
11
- "bin",
12
- "README.md"
13
- ],
14
- "scripts": {
15
- "build": "tsup",
16
- "dev": "tsx src/cli.ts",
17
- "format": "prettier --write 'src/**/*.ts'",
18
- "format:check": "prettier --check 'src/**/*.ts'",
19
- "type-check": "tsc --noEmit"
20
- },
21
- "keywords": [
22
- "cli",
23
- "skills",
24
- "heurist",
25
- "ai-agents",
26
- "skill-marketplace",
27
- "crypto",
28
- "defi"
29
- ],
30
- "repository": {
31
- "type": "git",
32
- "url": "git+https://github.com/heurist-network/heurist-skills-cli.git"
33
- },
34
- "author": "Heurist Network",
35
- "license": "MIT",
36
- "dependencies": {
37
- "@clack/prompts": "^0.11.0",
38
- "dotenv": "^17.3.1",
39
- "gray-matter": "^4.0.3",
40
- "picocolors": "^1.1.1"
41
- },
42
- "devDependencies": {
43
- "@types/node": "^22.10.0",
44
- "prettier": "^3.8.1",
45
- "tsup": "^8.4.0",
46
- "tsx": "^4.19.0",
47
- "typescript": "^5.9.3"
48
- },
49
- "engines": {
50
- "node": ">=18"
51
- },
52
- "packageManager": "pnpm@10.30.3"
53
- }
1
+ {
2
+ "name": "@heurist-network/skills",
3
+ "version": "0.1.5",
4
+ "description": "CLI tool for browsing, installing, and managing Heurist Mesh skills from the skill marketplace registry.",
5
+ "type": "module",
6
+ "bin": {
7
+ "heurist-skills": "bin/cli.mjs"
8
+ },
9
+ "files": [
10
+ "dist",
11
+ "bin",
12
+ "README.md"
13
+ ],
14
+ "scripts": {
15
+ "build": "tsup",
16
+ "dev": "tsx src/cli.ts",
17
+ "format": "prettier --write 'src/**/*.ts'",
18
+ "format:check": "prettier --check 'src/**/*.ts'",
19
+ "type-check": "tsc --noEmit"
20
+ },
21
+ "keywords": [
22
+ "cli",
23
+ "skills",
24
+ "heurist",
25
+ "ai-agents",
26
+ "skill-marketplace",
27
+ "crypto",
28
+ "defi"
29
+ ],
30
+ "repository": {
31
+ "type": "git",
32
+ "url": "git+https://github.com/heurist-network/heurist-skills-cli.git"
33
+ },
34
+ "author": "Heurist Network",
35
+ "license": "MIT",
36
+ "dependencies": {
37
+ "@clack/prompts": "^0.11.0",
38
+ "dotenv": "^17.3.1",
39
+ "gray-matter": "^4.0.3",
40
+ "picocolors": "^1.1.1"
41
+ },
42
+ "devDependencies": {
43
+ "@types/node": "^22.10.0",
44
+ "prettier": "^3.8.1",
45
+ "tsup": "^8.4.0",
46
+ "tsx": "^4.19.0",
47
+ "typescript": "^5.9.3"
48
+ },
49
+ "engines": {
50
+ "node": ">=18"
51
+ },
52
+ "packageManager": "pnpm@10.30.3"
53
+ }