Skip to content

Commit 6a77a59

Browse files
committed
docs: add npx skills add installation method and skills.sh integration
- Add universal install method supporting 16+ AI tools - Highlight skills.sh listing and discovery - Add supported AI tools comparison table - Clarify when to use advanced installer vs npx - Add seo-geo skill to skills table - Update skill creation instructions
1 parent 4eebe60 commit 6a77a59

1 file changed

Lines changed: 69 additions & 9 deletions

File tree

README.md

Lines changed: 69 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -39,10 +39,34 @@ For more information about the Agent Skills standard, see [agentskills.io](http:
3939
| <img src="./skill-logos/reddit.svg" width="24"> | [reddit](./skills/reddit) | Search and retrieve content from Reddit via the public JSON API |
4040
| <img src="./skill-logos/twitter.svg" width="24"> | [twitter](./skills/twitter) | Search and retrieve content from Twitter/X via twitterapi.io |
4141
| <img src="./skill-logos/producthunt.svg" width="24"> | [producthunt](./skills/producthunt) | Search Product Hunt posts, topics, users, and collections |
42+
| <img src="./skill-logos/seo-geo.svg" width="24"> | [seo-geo](./skills/seo-geo) | SEO & GEO optimization for AI search engines (ChatGPT, Perplexity, Google) |
4243

4344
## Quick Install
4445

45-
### Using the Install Script (Recommended)
46+
### 🚀 Universal Install (Works with 16+ AI Tools)
47+
48+
Install with one command - works with Claude Code, Cursor, Windsurf, Droid, and more:
49+
50+
```bash
51+
# Install all skills
52+
npx skills add ReScienceLab/opc-skills
53+
54+
# Install specific skill
55+
npx skills add ReScienceLab/opc-skills --skill reddit
56+
57+
# Install to specific agent
58+
npx skills add ReScienceLab/opc-skills -a droid -a claude-code
59+
```
60+
61+
Browse and discover skills at **[skills.sh](https://skills.sh/ReScienceLab/opc-skills)** 🎯
62+
63+
> **Note:** For skills with dependencies (e.g., `domain-hunter` needs `twitter` + `reddit`), use the Advanced Install method below for automatic dependency resolution.
64+
65+
---
66+
67+
### ⚙️ Advanced Install (With Dependency Management)
68+
69+
For power users who need dependency resolution, batch operations, and custom directories:
4670

4771
```bash
4872
# Clone the repo
@@ -59,6 +83,13 @@ cd opc-skills
5983
./install.sh -t custom -d ~/.my-agent/skills all
6084
```
6185

86+
**Why use the advanced installer?**
87+
- ✅ Auto-installs dependencies (e.g., `domain-hunter``twitter`, `reddit`)
88+
- ✅ Batch install all skills with one command
89+
- ✅ Custom directory support
90+
- ✅ Project-level vs global install options
91+
- ✅ Beautiful dependency tree visualization
92+
6293
### One-liner Install
6394

6495
```bash
@@ -69,6 +100,32 @@ curl -fsSL opc.dev/install.sh | bash -s -- -t claude all
69100
curl -fsSL opc.dev/install.sh | bash -s -- -t droid reddit
70101
```
71102

103+
---
104+
105+
## Supported AI Tools
106+
107+
OPC Skills work with 16+ AI coding agents:
108+
109+
| Agent | `npx` Support | Advanced Install |
110+
|-------|:-------------:|:----------------:|
111+
| Claude Code |||
112+
| Cursor |||
113+
| Factory Droid |||
114+
| Windsurf |||
115+
| OpenCode |||
116+
| Codex |||
117+
| GitHub Copilot |||
118+
| Gemini CLI |||
119+
| Goose |||
120+
| Kilo Code |||
121+
| Roo Code |||
122+
| Trae |||
123+
| And more... || - |
124+
125+
See the [full compatibility list](https://github.com/vercel-labs/add-skill#available-agents) for installation paths.
126+
127+
---
128+
72129
## Manual Installation
73130

74131
### Skill Directory Locations
@@ -77,7 +134,7 @@ curl -fsSL opc.dev/install.sh | bash -s -- -t droid reddit
77134
|------|------------------|-------------------|
78135
| Claude Code | `~/.claude/skills/` | `.claude/skills/` |
79136
| Factory Droid | `~/.factory/skills/` | `.factory/skills/` |
80-
| Cursor | - | `.cursor/skills/` |
137+
| Cursor | `~/.cursor/skills/` | `.cursor/skills/` |
81138
| OpenCode | `~/.config/opencode/skills/` | - |
82139
| Codex | `~/.codex/skills/` | `.codex/skills/` |
83140

@@ -115,19 +172,22 @@ See the [Skills API Quickstart](https://docs.claude.com/en/api/skills-guide#crea
115172

116173
## Creating New Skills
117174

118-
Use the template in `./template/SKILL.md` as a starting point:
175+
See the template in `./template/` directory for the basic structure:
176+
177+
1. Create a folder in `skills/` with your skill name
178+
2. Add a `SKILL.md` file with YAML frontmatter
179+
3. (Optional) Add scripts, examples, or other resources
119180

120-
```markdown
181+
**Required fields in SKILL.md:**
182+
```yaml
121183
---
122184
name: my-skill-name
123-
description: A clear description of what this skill does
185+
description: A clear description of what this skill does and when to use it
124186
---
125-
126-
# My Skill Name
127-
128-
[Instructions for the AI agent]
129187
```
130188

189+
For detailed guidance, check out existing skills or visit the [Agent Skills specification](https://agentskills.io/).
190+
131191
## Contributing
132192

133193
1. Fork this repository

0 commit comments

Comments
 (0)