@heurist-network/skills 0.1.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.
Files changed (4) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +171 -0
  3. package/bin/cli.mjs +2 -0
  4. package/package.json +53 -0
package/LICENSE ADDED
@@ -0,0 +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.
package/README.md ADDED
@@ -0,0 +1,171 @@
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 provides curated, verified skills for Web3, DeFi, and blockchain development — stored on [Autonomys](https://autonomys.xyz) decentralized storage.
6
+
7
+ ## Quick Start
8
+
9
+ ```bash
10
+ npx @heurist-network/skills add binance-web3-crypto-market-rank
11
+ ```
12
+
13
+ Or install globally:
14
+
15
+ ```bash
16
+ npm i -g @heurist-network/skills
17
+ heurist-skills add binance-web3-crypto-market-rank
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 binance
56
+ heurist-skills find --category defi
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 defi # 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 binance-web3-crypto-market-rank
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
+ ## Heurist-Specific Features
151
+
152
+ These features are unique to the Heurist marketplace and not present in other skills CLIs:
153
+
154
+ - **Verification gate** — Only `verified` skills can be installed. Draft and archived skills are blocked.
155
+ - **Capability warnings** — Before installing, the CLI warns about sensitive capabilities: private key access, transaction signing, leverage usage, and exchange API key requirements.
156
+ - **Decentralized storage** — Skills are stored on Autonomys Auto Drive. Each file gets its own content-addressed CID for integrity.
157
+ - **SHA256 integrity** — Download responses include `X-Skill-SHA256` for content verification and update tracking.
158
+
159
+ ## Configuration
160
+
161
+ | Variable | Description |
162
+ |----------|-------------|
163
+ | `HEURIST_SKILLS_API` | Override marketplace API URL (default: `https://mesh.heurist.ai`) |
164
+
165
+ ## Lock File Compatibility
166
+
167
+ 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.
168
+
169
+ ## License
170
+
171
+ MIT
package/bin/cli.mjs ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ import "../dist/cli.js";
package/package.json ADDED
@@ -0,0 +1,53 @@
1
+ {
2
+ "name": "@heurist-network/skills",
3
+ "version": "0.1.0",
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
+ }