Skip to content

Commit 826c67c

Browse files
francescobiancofrancescobianco
committed
docs(distribution): add DISTRIBUTION.md tracking skill registries, marketplaces, awesome lists and announcement channels
1 parent 84764e7 commit 826c67c

1 file changed

Lines changed: 107 additions & 0 deletions

File tree

‎DISTRIBUTION.md‎

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
# Distribution
2+
3+
Tracking document for the distribution of this skills repository across the web: skill registries, marketplaces, awesome lists, directories and announcement channels.
4+
5+
**Install command to promote everywhere:**
6+
7+
```bash
8+
npx skills add openapi/openapi-skills
9+
```
10+
11+
**Status legend:** `todo` (not yet submitted) · `submitted` (PR/form sent, awaiting review) · `listed` (live) · `rejected` (refused, see notes) · `n/a` (decided to skip)
12+
13+
---
14+
15+
## 1. Skill registries & install ecosystems
16+
17+
The highest-value targets: users install directly from here.
18+
19+
| Channel | URL | How to get listed | Status | Date | Notes |
20+
|---|---|---|---|---|---|
21+
| Skills.sh (Vercel) | https://www.skills.sh/ | Indexed from public GitHub repos with `skills/*/SKILL.md`; installs counted via `npx skills add openapi/openapi-skills`. Verify the repo appears in search | todo | | Leaderboard ranks by real installs — drive installs from our own docs/blog |
22+
| SkillX | https://github.com/nextlevelbuilder/skillx | Marketplace with semantic search/ratings; submit per their CLI/registry flow | todo | | |
23+
| Skills Directory | https://www.skillsdirectory.com/ | Submission with security scan (malware/prompt injection review) | todo | | Security-vetted listing is good trust signal for a B2B brand |
24+
| MCP Market — Skills section | https://mcpmarket.com/tools/skills | Submit skill/tool via their form | todo | | Same site can also list the Openapi MCP server |
25+
| Claude Skills Hub | https://claudeskills.info/ | Submission/indexing of SKILL.md repos | todo | | 658+ skills indexed, 13 categories |
26+
| AwesomeSkills.dev | https://www.awesomeskills.dev/en | Directory for cross-tool skills (14+ agents) | todo | | |
27+
| LLMBase skills directory | https://llmbase.ai/skills/ | Submission form | todo | | |
28+
29+
## 2. Official Anthropic channels
30+
31+
| Channel | URL | How to get listed | Status | Date | Notes |
32+
|---|---|---|---|---|---|
33+
| Claude Code official plugin marketplace | https://github.com/anthropics/claude-plugins-official | Package the repo as a plugin (`.claude-plugin/plugin.json` + `skills/`) and use the plugin directory submission form (see https://code.claude.com/docs/en/plugins) | todo | | Requires plugin packaging — quality/security review by Anthropic |
34+
| anthropics/skills (official examples repo) | https://github.com/anthropics/skills | PR if/where third-party skills are accepted | todo | | Check current contribution policy first |
35+
36+
## 3. Awesome lists (GitHub PRs)
37+
38+
Fork → add entry in the right section → PR. One PR per list, link `https://github.com/openapi/openapi-skills`.
39+
40+
| List | URL | Status | Date | Notes |
41+
|---|---|---|---|---|
42+
| VoltAgent/awesome-agent-skills | https://github.com/VoltAgent/awesome-agent-skills | todo | | Largest community list (1000+ skills) |
43+
| heilcheng/awesome-agent-skills | https://github.com/heilcheng/awesome-agent-skills | todo | | Focus on skills used by real engineering teams |
44+
| ComposioHQ/awesome-claude-skills | https://github.com/ComposioHQ/awesome-claude-skills | todo | | |
45+
| travisvn/awesome-claude-skills | https://github.com/travisvn/awesome-claude-skills | todo | | |
46+
| hesreallyhim/awesome-claude-code | https://github.com/hesreallyhim/awesome-claude-code | todo | | General Claude Code list — skills section |
47+
| ComposioHQ/awesome-claude-plugins | https://github.com/ComposioHQ/awesome-claude-plugins | todo | | If/when packaged as plugin |
48+
| Chat2AnyLLM/awesome-claude-plugins | https://github.com/Chat2AnyLLM/awesome-claude-plugins | todo | | If/when packaged as plugin |
49+
50+
## 4. Plugin marketplaces & directories
51+
52+
| Channel | URL | How to get listed | Status | Date | Notes |
53+
|---|---|---|---|---|---|
54+
| claudemarketplaces.com | https://claudemarketplaces.com/ | Auto-indexes GitHub marketplaces/plugins; verify presence, submit if missing | todo | | |
55+
| aitmpl.com (Claude Code Templates) | https://www.aitmpl.com/plugins/ | Contribution via their GitHub repo | todo | | |
56+
57+
## 5. GitHub discoverability
58+
59+
Free, do first — improves indexing by every crawler-based directory above.
60+
61+
| Action | Status | Date | Notes |
62+
|---|---|---|---|
63+
| Add repo topics: `agent-skills`, `claude-skills`, `claude-code`, `skill-md`, `openapi`, `api` | todo | | Settings → Topics |
64+
| Set repo description + website (https://openapi.com) | todo | | |
65+
| Tag a release (`v0.1.0`) | todo | | Registries often index releases |
66+
| Pin the repo on the `openapi` org profile | todo | | |
67+
68+
## 6. Adjacent: MCP registries (for openapi/mcp-server)
69+
70+
Not this repo, but the same audience: each MCP listing should cross-link the skills repo and vice versa.
71+
72+
| Channel | URL | Status | Date | Notes |
73+
|---|---|---|---|---|
74+
| Smithery | https://smithery.ai/ | todo | | |
75+
| mcp.so | https://mcp.so/ | todo | | |
76+
| Glama | https://glama.ai/mcp/servers | todo | | |
77+
| PulseMCP | https://www.pulsemcp.com/ | todo | | |
78+
| MCP Market | https://mcpmarket.com/ | todo | | Same site as the skills section above |
79+
80+
## 7. Openapi's own channels
81+
82+
| Channel | Action | Status | Date | Notes |
83+
|---|---|---|---|---|
84+
| openapi.com/blog | Announcement post with install instructions | todo | | Blog already covers MCP/AI topics |
85+
| docs.openapi.com | "Agent skills" page linking the repo | todo | | |
86+
| Console news sidebar (Flash news) | Announce skills availability | todo | | |
87+
| Postman public workspace | Link the repo from the workspace overview | todo | | https://www.postman.com/openapi-com |
88+
| YouTube (@openapi-com) | Short demo video (the A/B test in `test/` is a ready-made script) | todo | | |
89+
| LinkedIn / Instagram / Facebook | Launch posts | todo | | |
90+
91+
## 8. Community announcements (one-shot)
92+
93+
| Channel | URL | Status | Date | Notes |
94+
|---|---|---|---|---|
95+
| Reddit r/ClaudeAI | https://www.reddit.com/r/ClaudeAI/ | todo | | |
96+
| Reddit r/ClaudeCode | https://www.reddit.com/r/ClaudeCode/ | todo | | |
97+
| Hacker News (Show HN) | https://news.ycombinator.com/ | todo | | Best paired with the blog post |
98+
| dev.to / Hashnode | https://dev.to/ | todo | | Tutorial-style article |
99+
| Product Hunt | https://www.producthunt.com/ | todo | | Optional, needs preparation |
100+
101+
---
102+
103+
## Maintenance
104+
105+
- When a submission is made, update its row: status, date, and the PR/listing URL in Notes.
106+
- Re-check `listed` channels quarterly — directories prune dead or stale entries.
107+
- New registries appear frequently in this ecosystem: when one is found, add a row here before submitting.

0 commit comments

Comments
 (0)