Skip to content
Back to search

skillx-marketplace

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nextlevelbuilder--skillx/badge.svg)](/listings/nextlevelbuilder--skillx)

HTML

<a href="/listings/nextlevelbuilder--skillx"><img src="/api/listings/nextlevelbuilder--skillx/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Web Interface

# Install dependencies
pnpm install

# Start development server
cd apps/web && pnpm dev

# Open http://localhost:5173
# Test with: curl http://localhost:5173/api/admin/seed

CLI Tool

# Install globally
npm install -g skillx-sh

# Search for skills
skillx search "data processing"

# Use a skill
skillx use skillx-search

# Search and use in one command
skillx use "data processing" --search

# Report execution result
skillx report --outcome success --duration 1234

# Configure API key
skillx config set SKILLX_API_KEY sk_prod_...

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 113 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "skillx-marketplace",
  3. "owner": {
  4. "name": "SkillX.sh"
  5. },
  6. "metadata": {
  7. "description": "AI agent skills marketplace — search, install, and use skills for Claude Code",
  8. "version": "1.0.0",
  9. "pluginRoot": "./.claude/skills"
  10. },
  11. "plugins": [
  12. {
  13. "name": "skill-creator",
  14. "source": "./.claude/skills/skill-creator",
  15. "description": "Create or update Claude skills optimized for Skillmark benchmarks. Use for new skills, skill scripts, references, benchmark optimization, extending Claude's capabilities. Adapted from Anthropic's Apache-2.0 skill-creator skill.",
  16. "version": "3.0.0",
  17. "author": {
  18. "name": "SkillX.sh"
  19. },
  20. "homepage": "https://skillx.sh",
  21. "repository": "https://github.com/nextlevelbuilder/skillx",
  22. "license": "Apache-2.0",
  23. "keywords": [
  24. "skills",
  25. "creator",
  26. "benchmark",
  27. "skillmark",
  28. "claude-code"
  29. ],
  30. "category": "developer-tools",
  31. "tags": [
  32. "skill-creation",
  33. "progressive-disclosure",
  34. "benchmark-optimization"
  35. ]
  36. },
  37. {
  38. "name": "skillx",
  39. "source": "./plugins/skillx",
  40. "description": "Find, compare and vet AI agent skills from the SkillX.sh catalog, then load or install one only after you approve it.",
  41. "version": "2.0.0",
  42. "author": {
  43. "name": "SkillX.sh"
  44. },
  45. "homepage": "https://skillx.sh",
  46. "repository": "https://github.com/nextlevelbuilder/skillx",
  47. "license": "MIT",
  48. "keywords": [
  49. "skills",
  50. "skill-discovery",
  51. "agent-skills",
  52. "marketplace",
  53. "skillx"
  54. ],
  55. "category": "developer-tools",
  56. "tags": [
  57. "skill-search",
  58. "skill-vetting",
  59. "marketplace-cli"
  60. ]
  61. },
  62. {
  63. "name": "hol-guard",
  64. "source": "./.claude/skills/hol-guard",
  65. "description": "Protect local AI coding harnesses with HOL Guard runtime safety, approvals, audit receipts, and package scanning.",
  66. "version": "1.0.0",
  67. "author": {
  68. "name": "Hashgraph Online"
  69. },
  70. "homepage": "https://hol.org/guard",
  71. "repository": "https://github.com/hashgraph-online/hol-guard",
  72. "license": "Apache-2.0",
  73. "keywords": [
  74. "security",
  75. "ai-safety",
  76. "runtime-protection",
  77. "agent-security",
  78. "hol-guard"
  79. ],
  80. "category": "developer-tools",
  81. "tags": [
  82. "runtime-safety",
  83. "prompt-injection",
  84. "supply-chain-security"
  85. ]
  86. },
  87. {
  88. "name": "marketing-mindset",
  89. "source": "./.claude/skills/marketing-mindset",
  90. "description": "A marketer's operating mindset for growth and client acquisition: test volume floors, channel kill rules, positioning, offers, and cold outreach for first clients.",
  91. "version": "0.3.0",
  92. "author": {
  93. "name": "Axel Freeman (axelfreeman)"
  94. },
  95. "homepage": "https://github.com/axelfreeman/marketing-mindset",
  96. "repository": "https://github.com/axelfreeman/marketing-mindset",
  97. "license": "MIT",
  98. "keywords": [
  99. "marketing",
  100. "growth",
  101. "positioning",
  102. "cold-outreach",
  103. "client-acquisition"
  104. ],
  105. "category": "marketing",
  106. "tags": [
  107. "marketing-mindset",
  108. "go-to-market",
  109. "offer-design"
  110. ]
  111. }
  112. ]
  113. }
README.md · README · 282 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # SkillX.sh
  2. **The Only Skill That Your AI Agent Needs.**
  3. SkillX is an AI agent skills marketplace — combining a web marketplace, CLI tool, and hybrid search engine to help agents discover and execute the best skills for their tasks.
  4. ## Quick Start
  5. ### Web Interface
  6. ```bash
  7. # Install dependencies
  8. pnpm install
  9. # Start development server
  10. cd apps/web && pnpm dev
  11. # Open http://localhost:5173
  12. # Test with: curl http://localhost:5173/api/admin/seed
  13. ```
  14. ### CLI Tool
  15. The released CLI is `skillx-sh` 0.8.0 (Node >=22). Full reference:
  16. [docs/cli-reference.md](./docs/cli-reference.md).
  17. ```bash
  18. # Install globally
  19. npm install -g skillx-sh
  20. # Search the catalog, or browse results interactively
  21. skillx search "data processing"
  22. skillx find "data processing"
  23. # Show a skill (slug, author/skill, org/repo/skill or "keywords")
  24. skillx use find-skills
  25. skillx use "data processing" --search
  26. # Vet a skill before using it
  27. skillx inspect find-skills
  28. skillx check find-skills --target claude-code # exit 0 only when declared or verified
  29. # Install a verified registry release into a runtime and pin it in skillx.lock.json
  30. skillx install @publisher/package --runtime claude-code
  31. # Report an execution outcome (needs an API key)
  32. skillx report find-skills success --duration 1234
  33. # Configure your API key (prompts; or pipe it on stdin)
  34. skillx config set-key
  35. ```
  36. ## What is SkillX?
  37. SkillX combines three components:
  38. ### 1. Web Marketplace
  39. - Browse 500+ skills with ratings, reviews, usage stats
  40. - Leaderboard sorted by quality metrics
  41. - Add skills to favorites for personalized search
  42. - GitHub OAuth login (no passwords)
  43. ### 2. Hybrid Search Engine
  44. - **Semantic search** via vector embeddings (bge-base-en-v1.5)
  45. - **Keyword search** via SQLite FTS5
  46. - **Ranking** using reciprocal rank fusion + boost scoring
  47. - Search latency: <800ms p95
  48. ### 3. CLI Tool (skillx)
  49. - Discover: `search`, `find`, `use`, `inspect`, `check`
  50. - Install verified releases: `install`, `update`, `uninstall`, `list`, `sync --locked`
  51. - Publish: `validate`, `pack`, `publish <dir>`, `promote`; `import owner/repo` registers a GitHub skill
  52. - Your account: `library list`, `kit` (personal kits), `report`, `config`
  53. - `skillx mcp` serves the local installer (inspect, plan, apply) as an MCP server
  54. - `skillx add <source>` (install straight from GitHub, a git URL or a local directory) is on `main` and ships after 0.8.0
  55. ### 4. Claude Code Plugin Marketplace
  56. Discover and install skills directly in Claude Code:
  57. ```bash
  58. /plugin marketplace add nextlevelbuilder/skillx
  59. /plugin install skill-creator@skillx-marketplace
  60. /plugin install skillx@skillx-marketplace
  61. ```
  62. **Plugins:**
  63. - **skillx** (v2.0.0) — SkillX's own discovery plugin: find, compare and vet catalog skills, then load or install one only after you approve it. Standalone folder `plugins/skillx/` for the Claude directory; see [docs/claude-plugin.md](docs/claude-plugin.md)
  64. - **skill-creator** (v3.0.0, Apache-2.0, adapted from Anthropic's skill-creator) — Create/update skills optimized for Skillmark benchmarks
  65. - **hol-guard** (Hashgraph Online, Apache-2.0) and **marketing-mindset** (Axel Freeman, MIT) — third-party skills listed in this marketplace under their authors' names and licenses; not part of the SkillX plugin
  66. ## Architecture
  67. **Tech Stack:**
  68. - Frontend: React Router v7 + Tailwind v4 (dark theme, mint accent)
  69. - Backend: Cloudflare Workers + D1 (SQLite)
  70. - Search: Vectorize (embeddings) + FTS5 (keywords) + RRF fusion
  71. - Auth: Better Auth + GitHub OAuth
  72. - Storage: KV (cache), R2 (assets)
  73. - AI: Cloudflare Workers AI (bge-base-en-v1.5 embeddings)
  74. **Codebase:**
  75. ```
  76. skillx/
  77. ├── apps/web/ # React Router SSR app (~2,000 LOC)
  78. │ ├── routes/ # Pages (home, search, detail, settings) + APIs
  79. │ ├── components/ # UI components
  80. │ └── lib/ # DB, auth, search, vectorization
  81. ├── packages/cli/ # skillx-sh npm package (bin: skillx)
  82. ├── .claude-plugin/ # Claude Code plugin marketplace
  83. │ └── marketplace.json # Marketplace catalog + plugin manifests
  84. ├── plugins/skillx/ # Standalone SkillX plugin (v2.0.0): skill, MCP, evals
  85. ├── .claude/skills/ # Other marketplace skills
  86. │ ├── skill-creator/ # Skill creation tool (v3.0.0)
  87. │ ├── hol-guard/ # Third-party (Hashgraph Online)
  88. │ └── marketing-mindset/ # Third-party (Axel Freeman)
  89. ├── scripts/ # Seed data (30 real skills)
  90. └── docs/ # Documentation
  91. ```
  92. ## Features
  93. **User-Facing:**
  94. - Semantic + keyword search with instant results
  95. - Rate skills (0-10) and write reviews
  96. - Favorites for personalized recommendations
  97. - Leaderboard with sorting & filtering
  98. - API key management for CLI access
  99. - User profiles with usage stats
  100. **Admin:**
  101. - Seed endpoint for demo data
  102. - Usage analytics & reporting
  103. - Skill indexing & vectorization
  104. - Analytics dashboard
  105. **Developer:**
  106. - REST API with session + API key auth
  107. - CLI for programmatic access
  108. - Flexible search filters (category, price, rating)
  109. - Pagination (limit, offset)
  110. ## Deployment
  111. ### Development
  112. ```bash
  113. cd apps/web
  114. pnpm dev # Local with D1 SQLite
  115. ```
  116. ### Production (Cloudflare)
  117. ```bash
  118. # Setup Cloudflare account, create bindings, set secrets
  119. wrangler d1 create skillx-db
  120. wrangler kv:namespace create skillx-cache
  121. wrangler vectorize create skillx-skills
  122. # Deploy
  123. cd apps/web
  124. pnpm build
  125. wrangler deploy
  126. # Seed production data
  127. curl https://skillx.sh/api/admin/seed
  128. ```
  129. **See [deployment-guide.md](./docs/deployment-guide.md) for detailed instructions.**
  130. ## Documentation
  131. | Doc | Purpose |
  132. |-----|---------|
  133. | [project-overview-pdr.md](./docs/project-overview-pdr.md) | Product requirements, features, business model |
  134. | [codebase-summary.md](./docs/codebase-summary.md) | Directory structure, modules, data flow |
  135. | [code-standards.md](./docs/code-standards.md) | Coding patterns, conventions, best practices |
  136. | [system-architecture.md](./docs/system-architecture.md) | Architecture diagrams, API contracts, security |
  137. | [project-roadmap.md](./docs/project-roadmap.md) | Phases, milestones, timelines |
  138. | [deployment-guide.md](./docs/deployment-guide.md) | Setup, deployment, troubleshooting |
  139. | [design-guidelines.md](./docs/design-guidelines.md) | UI/UX design system (dark theme, mint) |
  140. | [cli-reference.md](./docs/cli-reference.md) | Every `skillx` command, flag, exit code and the installer |
  141. | [api-reference.md](./docs/api-reference.md) | Registry, release, collections and MCP API contracts |
  142. | [personal-kits-api.md](./docs/personal-kits-api.md) | Personal kits API (`SKILLX_PERSONAL_KITS_API`: off unless set; on at skillx.sh) |
  143. ## API Endpoints
  144. **Search (public):**
  145. ```
  146. POST /api/search
  147. { query, category?, is_paid?, limit?, offset? }
  148. Returns: { results: [Skill], count }
  149. ```
  150. **Skill Details (public):**
  151. ```
  152. GET /api/skills/:slug
  153. Returns: { skill, ratings: [], reviews: [] }
  154. ```
  155. **Auth-Protected (session or API key):**
  156. ```
  157. POST /api/skills/:slug/rate { score } # Rate 0-10
  158. POST /api/skills/:slug/review { content } # Write review
  159. POST /api/skills/:slug/favorite # Add favorite
  160. DELETE /api/skills/:slug/favorite # Remove favorite
  161. POST /api/report { outcome, duration_ms } # Report usage
  162. ```
  163. **User APIs (session only):**
  164. ```
  165. GET /api/user/api-keys # List keys
  166. POST /api/user/api-keys { name } # Create key
  167. DELETE /api/user/api-keys/:id # Revoke key
  168. ```
  169. ## Development
  170. ### Prerequisites
  171. - Node.js >=22
  172. - pnpm
  173. - Cloudflare account
  174. ### Commands
  175. ```bash
  176. pnpm install # Install dependencies
  177. pnpm dev # Start dev server (apps/web)
  178. pnpm test # Run tests
  179. pnpm build # Build for production
  180. pnpm lint # Check linting
  181. ```
  182. ### Running Tests
  183. ```bash
  184. # Unit tests
  185. pnpm test
  186. # Type checking
  187. pnpm tsc --noEmit
  188. # Linting
  189. pnpm lint
  190. ```
  191. ## Project Status
  192. **Phase 1 (Complete):** MVP with web marketplace, CLI, hybrid search, auth, ratings/reviews, API keys
  193. **Phase 2 (Next):** Payment integration (Stripe), production hardening, GitHub OAuth setup
  194. **Phase 3 (Future):** MCP server mode, skill execution sandbox, Skillmark integration
  195. See [project-roadmap.md](./docs/project-roadmap.md) for details.
  196. ## Performance Metrics
  197. | Metric | Target |
  198. |--------|--------|
  199. | Search latency (p95) | <800ms |
  200. | Leaderboard load | <500ms |
  201. | Page FCP | <2s |
  202. | Uptime | 99.9% |
  203. ## Security
  204. - API keys hashed (SHA-256)
  205. - Session cookies (httpOnly, secure, sameSite)
  206. - SQL injection prevention (Drizzle ORM)
  207. - CORS enabled for trusted origins
  208. - Rate limiting (100 req/min per IP)
  209. - HTTPS enforced (Cloudflare TLS 1.3)
  210. ## License
  211. MIT
  212. ## Contributing
  213. 1. Read [code-standards.md](./docs/code-standards.md)
  214. 2. Create feature branch
  215. 3. Test locally: `pnpm test && pnpm lint`
  216. 4. Submit PR with description
  217. ---
  218. **Learn more:** [docs/](./docs/) directory

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.