findskill 0.1.5 → 0.1.7

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 (2) hide show
  1. package/README.md +53 -22
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
1
  # findskill.md
2
2
 
3
- findskill.md is a CLI for discovering and installing SKILL.md format skills for Claude.
3
+ [![npm version](https://img.shields.io/npm/v/findskill.svg)](https://www.npmjs.com/package/findskill)
4
+
5
+ A CLI for discovering and installing [SKILL.md](https://skill.md) format skills for Claude.
4
6
 
5
7
  ## Why it exists
6
8
 
@@ -8,10 +10,10 @@ Until Anthropic or another major platform ships an official skills registry, thi
8
10
 
9
11
  ### How it works
10
12
 
11
- - Skills are discovered by searching for SKILL.md files on GitHub.
12
- - Results are ranked with a bias toward star count to surface trusted repos.
13
- - Approved skills are added to the registry.
14
- - Install counts are tracked to provide additional social proof.
13
+ - Skills are discovered by searching for SKILL.md files on GitHub
14
+ - Results are ranked with a bias toward star count to surface trusted repos
15
+ - Approved skills are added to the registry
16
+ - Install counts are tracked to provide additional social proof
15
17
 
16
18
  ### How to use it
17
19
 
@@ -19,50 +21,79 @@ A simple workflow is to instruct your agent to use findskill when it believes a
19
21
 
20
22
  ### Other CLIs
21
23
 
22
- Just symlink Claude's skill directory to your other CLI config directory.
24
+ Just symlink Claude's skill directory to your other CLI config directory:
23
25
 
24
- ```
26
+ ```bash
25
27
  # replace with .gemini .codex ...
26
28
  ln -s ~/.claude/skills ~/.your-other-cli/skills
27
29
  ```
28
30
 
31
+ ## Installation
32
+
33
+ ```bash
34
+ npm install -g findskill
35
+ ```
36
+
29
37
  ## Usage
30
38
 
39
+ ```
31
40
  findskill [command] [options]
41
+ ```
32
42
 
33
43
  ## Commands
34
44
 
35
- search <query> Search by name, description, or tags
36
- info <name> Show details for a skill
37
- install <name> Install a skill to your skills directory
38
- list List installed skills
39
- update [name] Update all skills or a single skill
40
- submit <github-url> Submit a SKILL.md URL for review
41
- help Show command help
45
+ | Command | Description |
46
+ |---------|-------------|
47
+ | `search <query>` | Search by name, description, or tags |
48
+ | `info <name>` | Show details for a skill |
49
+ | `install <name>` | Install a skill to your skills directory |
50
+ | `list` | List installed skills |
51
+ | `update [name]` | Update all skills or a single skill |
52
+ | `submit <github-url>` | Submit a SKILL.md URL for review |
53
+ | `help` | Show command help |
42
54
 
43
55
  ## Options
44
56
 
45
- search: --page <number>
46
- info: --path <path>
47
- install: --path <path>, --force
48
- list: --path <path>
49
- update: --path <path>
57
+ | Command | Options |
58
+ |---------|---------|
59
+ | `search` | `--page <number>` |
60
+ | `info` | `--path <path>` |
61
+ | `install` | `--path <path>`, `--force` |
62
+ | `list` | `--path <path>` |
63
+ | `update` | `--path <path>` |
50
64
 
51
65
  ## Examples
52
66
 
67
+ ```bash
68
+ # Search for skills
53
69
  findskill search git
70
+
71
+ # Get info about a skill
54
72
  findskill info commit
73
+
74
+ # Install a skill
55
75
  findskill install commit
76
+
77
+ # List installed skills
56
78
  findskill list
79
+
80
+ # Update all skills
57
81
  findskill update
58
- findskill submit https://github.com/you/your-skill/blob/main/my-skill
82
+
83
+ # Submit your own skill
84
+ findskill submit https://github.com/you/your-skill
85
+ ```
59
86
 
60
87
  ## Submit a skill
61
88
 
62
- Use the submit command to add your skill repo to the registry.
89
+ Use the submit command to add your skill repo to the registry:
63
90
 
64
- ```
91
+ ```bash
65
92
  findskill submit https://github.com/you/your-skill
66
93
  ```
67
94
 
68
95
  The registry will review the repo and publish it if it matches the SKILL.md format.
96
+
97
+ ## License
98
+
99
+ MIT
package/package.json CHANGED
@@ -1,13 +1,14 @@
1
1
  {
2
2
  "name": "findskill",
3
- "version": "0.1.5",
3
+ "version": "0.1.7",
4
4
  "description": "CLI for discovering and installing SKILL.md format skills",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "findskill": "./dist/index.js"
8
8
  },
9
9
  "files": [
10
- "dist"
10
+ "dist",
11
+ "README.md"
11
12
  ],
12
13
  "scripts": {
13
14
  "dev": "bun run src/index.ts",