siteskills 1.6.0 → 1.6.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/README.md +101 -0
- package/dist/index.js +5 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# siteskills
|
|
2
|
+
|
|
3
|
+
CLI for the [SiteSkills.ai](https://siteskills.ai) marketplace — install, search, and publish AI browser navigation skills.
|
|
4
|
+
|
|
5
|
+
SiteSkills are pre-mapped navigation guides (SKILL.md files) that give AI agents a cheat sheet for specific websites: verified selectors, page structures, common flows, and timing patterns. Install once, works across Claude Code, Cursor, GitHub Copilot, Cline, Continue.dev, Gemini CLI, OpenAI Codex, Windsurf, and more.
|
|
6
|
+
|
|
7
|
+
## Quick Start — No Install Required
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
# Install a skill instantly with npx (no global install needed)
|
|
11
|
+
npx siteskills install github
|
|
12
|
+
npx siteskills install stripe
|
|
13
|
+
npx siteskills install hackernews-top-stories
|
|
14
|
+
|
|
15
|
+
# Search the marketplace
|
|
16
|
+
npx siteskills search "e-commerce checkout"
|
|
17
|
+
|
|
18
|
+
# See details about a skill
|
|
19
|
+
npx siteskills info github
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Install Globally (for repeated use)
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
npm install -g siteskills
|
|
26
|
+
|
|
27
|
+
siteskills install github
|
|
28
|
+
siteskills search "project management"
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Commands
|
|
32
|
+
|
|
33
|
+
### Consumer (no account needed)
|
|
34
|
+
|
|
35
|
+
| Command | Description |
|
|
36
|
+
|---------|-------------|
|
|
37
|
+
| `siteskills install <slug>` | Download and install a skill to all detected AI agents |
|
|
38
|
+
| `siteskills search <query>` | Search the SiteSkills marketplace |
|
|
39
|
+
| `siteskills info <slug>` | Show details about a skill |
|
|
40
|
+
| `siteskills uninstall <slug>` | Remove an installed skill |
|
|
41
|
+
|
|
42
|
+
### Publisher (requires API key)
|
|
43
|
+
|
|
44
|
+
| Command | Description |
|
|
45
|
+
|---------|-------------|
|
|
46
|
+
| `siteskills login` | Authenticate with your API key |
|
|
47
|
+
| `siteskills logout` | Clear stored credentials |
|
|
48
|
+
| `siteskills init` | Create a new SKILL.md in the current directory |
|
|
49
|
+
| `siteskills validate` | Validate the current skill |
|
|
50
|
+
| `siteskills publish` | Upload a SKILL.md to the marketplace |
|
|
51
|
+
| `siteskills update` | Push a new version of an existing skill |
|
|
52
|
+
| `siteskills list` | List your published skills |
|
|
53
|
+
| `siteskills unpublish <slug>` | Remove a skill from the marketplace |
|
|
54
|
+
| `siteskills whoami` | Show the current authenticated user |
|
|
55
|
+
|
|
56
|
+
## Multi-Platform Install
|
|
57
|
+
|
|
58
|
+
When you run `siteskills install <slug>`, the CLI auto-detects every AI agent on your machine and installs to all of them at once:
|
|
59
|
+
|
|
60
|
+
| Agent | Install Path |
|
|
61
|
+
|-------|-------------|
|
|
62
|
+
| Claude Code | `~/.claude/skills/<slug>/SKILL.md` |
|
|
63
|
+
| Gemini CLI | `~/.gemini/skills/<slug>.md` |
|
|
64
|
+
| OpenAI Codex | `~/.codex/AGENTS.md` (appended) |
|
|
65
|
+
| Cursor | `.cursor/rules/siteskill-<slug>.mdc` |
|
|
66
|
+
| Windsurf | `.windsurf/rules/siteskill-<slug>.md` |
|
|
67
|
+
| Cline | `~/Documents/Cline/Rules/siteskill-<slug>.md` |
|
|
68
|
+
| Continue.dev | `~/.continue/rules/siteskill-<slug>.md` |
|
|
69
|
+
| GitHub Copilot | `.github/instructions/siteskill-<slug>.instructions.md` |
|
|
70
|
+
| Aider | `.aider.conf.yml` + `skills/` directory |
|
|
71
|
+
| OpenHands | `.openhands/microagents/siteskill-<slug>.md` |
|
|
72
|
+
| Roo Code | `.roo/rules/siteskill-<slug>.md` |
|
|
73
|
+
|
|
74
|
+
## Publishing a Skill
|
|
75
|
+
|
|
76
|
+
1. Create a SKILL.md:
|
|
77
|
+
```bash
|
|
78
|
+
siteskills init
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
2. Edit the generated SKILL.md to document your site
|
|
82
|
+
|
|
83
|
+
3. Validate it:
|
|
84
|
+
```bash
|
|
85
|
+
siteskills validate
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
4. Get an API key at [siteskills.ai/settings](https://siteskills.ai/settings), then:
|
|
89
|
+
```bash
|
|
90
|
+
siteskills login
|
|
91
|
+
siteskills publish
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Skills go through a 3-stage automated scan (format validation, security analysis, LLM review) before appearing in the marketplace.
|
|
95
|
+
|
|
96
|
+
## Links
|
|
97
|
+
|
|
98
|
+
- [Marketplace](https://siteskills.ai)
|
|
99
|
+
- [Skill format template](https://siteskills.ai/template.md)
|
|
100
|
+
- [siteskill-creator](https://siteskills.ai/skills/siteskill-creator) — AI skill that maps websites and generates SKILL.md files
|
|
101
|
+
- [GitHub](https://github.com/siteskills/siteskills-cli)
|
package/dist/index.js
CHANGED
|
@@ -20,7 +20,11 @@ import { whoamiCommand } from "./commands/whoami.js";
|
|
|
20
20
|
const program = new Command();
|
|
21
21
|
program
|
|
22
22
|
.name("siteskills")
|
|
23
|
-
.description("Install and share AI browser agent navigation skills — works with Claude Code,
|
|
23
|
+
.description("Install and share AI browser agent navigation skills — works with Claude Code, Cursor, Copilot, and more\n\n" +
|
|
24
|
+
" Quick install (no global install needed):\n" +
|
|
25
|
+
" npx siteskills install <slug>\n\n" +
|
|
26
|
+
" Or install globally for repeated use:\n" +
|
|
27
|
+
" npm install -g siteskills")
|
|
24
28
|
.version(version);
|
|
25
29
|
// -------------------------------------------------------------------------
|
|
26
30
|
// Consumer commands (no auth required)
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACV,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|