skillx-marketplace
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/nextlevelbuilder--skillx)HTML
<a href="/listings/nextlevelbuilder--skillx"><img src="/api/listings/nextlevelbuilder--skillx/badge.svg" alt="findsafeskills safety rating" /></a>Install
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.
- {
- "name": "skillx-marketplace",
- "owner": {
- "name": "SkillX.sh"
- },
- "metadata": {
- "description": "AI agent skills marketplace — search, install, and use skills for Claude Code",
- "version": "1.0.0",
- "pluginRoot": "./.claude/skills"
- },
- "plugins": [
- {
- "name": "skill-creator",
- "source": "./.claude/skills/skill-creator",
- "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.",
- "version": "3.0.0",
- "author": {
- "name": "SkillX.sh"
- },
- "homepage": "https://skillx.sh",
- "repository": "https://github.com/nextlevelbuilder/skillx",
- "license": "Apache-2.0",
- "keywords": [
- "skills",
- "creator",
- "benchmark",
- "skillmark",
- "claude-code"
- ],
- "category": "developer-tools",
- "tags": [
- "skill-creation",
- "progressive-disclosure",
- "benchmark-optimization"
- ]
- },
- {
- "name": "skillx",
- "source": "./plugins/skillx",
- "description": "Find, compare and vet AI agent skills from the SkillX.sh catalog, then load or install one only after you approve it.",
- "version": "2.0.0",
- "author": {
- "name": "SkillX.sh"
- },
- "homepage": "https://skillx.sh",
- "repository": "https://github.com/nextlevelbuilder/skillx",
- "license": "MIT",
- "keywords": [
- "skills",
- "skill-discovery",
- "agent-skills",
- "marketplace",
- "skillx"
- ],
- "category": "developer-tools",
- "tags": [
- "skill-search",
- "skill-vetting",
- "marketplace-cli"
- ]
- },
- {
- "name": "hol-guard",
- "source": "./.claude/skills/hol-guard",
- "description": "Protect local AI coding harnesses with HOL Guard runtime safety, approvals, audit receipts, and package scanning.",
- "version": "1.0.0",
- "author": {
- "name": "Hashgraph Online"
- },
- "homepage": "https://hol.org/guard",
- "repository": "https://github.com/hashgraph-online/hol-guard",
- "license": "Apache-2.0",
- "keywords": [
- "security",
- "ai-safety",
- "runtime-protection",
- "agent-security",
- "hol-guard"
- ],
- "category": "developer-tools",
- "tags": [
- "runtime-safety",
- "prompt-injection",
- "supply-chain-security"
- ]
- },
- {
- "name": "marketing-mindset",
- "source": "./.claude/skills/marketing-mindset",
- "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.",
- "version": "0.3.0",
- "author": {
- "name": "Axel Freeman (axelfreeman)"
- },
- "homepage": "https://github.com/axelfreeman/marketing-mindset",
- "repository": "https://github.com/axelfreeman/marketing-mindset",
- "license": "MIT",
- "keywords": [
- "marketing",
- "growth",
- "positioning",
- "cold-outreach",
- "client-acquisition"
- ],
- "category": "marketing",
- "tags": [
- "marketing-mindset",
- "go-to-market",
- "offer-design"
- ]
- }
- ]
- }
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.
- # SkillX.sh
- **The Only Skill That Your AI Agent Needs.**
- 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.
- ## Quick Start
- ### Web Interface
- ```bash
- # 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
- The released CLI is `skillx-sh` 0.8.0 (Node >=22). Full reference:
- [docs/cli-reference.md](./docs/cli-reference.md).
- ```bash
- # Install globally
- npm install -g skillx-sh
- # Search the catalog, or browse results interactively
- skillx search "data processing"
- skillx find "data processing"
- # Show a skill (slug, author/skill, org/repo/skill or "keywords")
- skillx use find-skills
- skillx use "data processing" --search
- # Vet a skill before using it
- skillx inspect find-skills
- skillx check find-skills --target claude-code # exit 0 only when declared or verified
- # Install a verified registry release into a runtime and pin it in skillx.lock.json
- skillx install @publisher/package --runtime claude-code
- # Report an execution outcome (needs an API key)
- skillx report find-skills success --duration 1234
- # Configure your API key (prompts; or pipe it on stdin)
- skillx config set-key
- ```
- ## What is SkillX?
- SkillX combines three components:
- ### 1. Web Marketplace
- - Browse 500+ skills with ratings, reviews, usage stats
- - Leaderboard sorted by quality metrics
- - Add skills to favorites for personalized search
- - GitHub OAuth login (no passwords)
- ### 2. Hybrid Search Engine
- - **Semantic search** via vector embeddings (bge-base-en-v1.5)
- - **Keyword search** via SQLite FTS5
- - **Ranking** using reciprocal rank fusion + boost scoring
- - Search latency: <800ms p95
- ### 3. CLI Tool (skillx)
- - Discover: `search`, `find`, `use`, `inspect`, `check`
- - Install verified releases: `install`, `update`, `uninstall`, `list`, `sync --locked`
- - Publish: `validate`, `pack`, `publish <dir>`, `promote`; `import owner/repo` registers a GitHub skill
- - Your account: `library list`, `kit` (personal kits), `report`, `config`
- - `skillx mcp` serves the local installer (inspect, plan, apply) as an MCP server
- - `skillx add <source>` (install straight from GitHub, a git URL or a local directory) is on `main` and ships after 0.8.0
- ### 4. Claude Code Plugin Marketplace
- Discover and install skills directly in Claude Code:
- ```bash
- /plugin marketplace add nextlevelbuilder/skillx
- /plugin install skill-creator@skillx-marketplace
- /plugin install skillx@skillx-marketplace
- ```
- **Plugins:**
- - **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)
- - **skill-creator** (v3.0.0, Apache-2.0, adapted from Anthropic's skill-creator) — Create/update skills optimized for Skillmark benchmarks
- - **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
- ## Architecture
- **Tech Stack:**
- - Frontend: React Router v7 + Tailwind v4 (dark theme, mint accent)
- - Backend: Cloudflare Workers + D1 (SQLite)
- - Search: Vectorize (embeddings) + FTS5 (keywords) + RRF fusion
- - Auth: Better Auth + GitHub OAuth
- - Storage: KV (cache), R2 (assets)
- - AI: Cloudflare Workers AI (bge-base-en-v1.5 embeddings)
- **Codebase:**
- ```
- skillx/
- ├── apps/web/ # React Router SSR app (~2,000 LOC)
- │ ├── routes/ # Pages (home, search, detail, settings) + APIs
- │ ├── components/ # UI components
- │ └── lib/ # DB, auth, search, vectorization
- ├── packages/cli/ # skillx-sh npm package (bin: skillx)
- ├── .claude-plugin/ # Claude Code plugin marketplace
- │ └── marketplace.json # Marketplace catalog + plugin manifests
- ├── plugins/skillx/ # Standalone SkillX plugin (v2.0.0): skill, MCP, evals
- ├── .claude/skills/ # Other marketplace skills
- │ ├── skill-creator/ # Skill creation tool (v3.0.0)
- │ ├── hol-guard/ # Third-party (Hashgraph Online)
- │ └── marketing-mindset/ # Third-party (Axel Freeman)
- ├── scripts/ # Seed data (30 real skills)
- └── docs/ # Documentation
- ```
- ## Features
- **User-Facing:**
- - Semantic + keyword search with instant results
- - Rate skills (0-10) and write reviews
- - Favorites for personalized recommendations
- - Leaderboard with sorting & filtering
- - API key management for CLI access
- - User profiles with usage stats
- **Admin:**
- - Seed endpoint for demo data
- - Usage analytics & reporting
- - Skill indexing & vectorization
- - Analytics dashboard
- **Developer:**
- - REST API with session + API key auth
- - CLI for programmatic access
- - Flexible search filters (category, price, rating)
- - Pagination (limit, offset)
- ## Deployment
- ### Development
- ```bash
- cd apps/web
- pnpm dev # Local with D1 SQLite
- ```
- ### Production (Cloudflare)
- ```bash
- # Setup Cloudflare account, create bindings, set secrets
- wrangler d1 create skillx-db
- wrangler kv:namespace create skillx-cache
- wrangler vectorize create skillx-skills
- # Deploy
- cd apps/web
- pnpm build
- wrangler deploy
- # Seed production data
- curl https://skillx.sh/api/admin/seed
- ```
- **See [deployment-guide.md](./docs/deployment-guide.md) for detailed instructions.**
- ## Documentation
- | Doc | Purpose |
- |-----|---------|
- | [project-overview-pdr.md](./docs/project-overview-pdr.md) | Product requirements, features, business model |
- | [codebase-summary.md](./docs/codebase-summary.md) | Directory structure, modules, data flow |
- | [code-standards.md](./docs/code-standards.md) | Coding patterns, conventions, best practices |
- | [system-architecture.md](./docs/system-architecture.md) | Architecture diagrams, API contracts, security |
- | [project-roadmap.md](./docs/project-roadmap.md) | Phases, milestones, timelines |
- | [deployment-guide.md](./docs/deployment-guide.md) | Setup, deployment, troubleshooting |
- | [design-guidelines.md](./docs/design-guidelines.md) | UI/UX design system (dark theme, mint) |
- | [cli-reference.md](./docs/cli-reference.md) | Every `skillx` command, flag, exit code and the installer |
- | [api-reference.md](./docs/api-reference.md) | Registry, release, collections and MCP API contracts |
- | [personal-kits-api.md](./docs/personal-kits-api.md) | Personal kits API (`SKILLX_PERSONAL_KITS_API`: off unless set; on at skillx.sh) |
- ## API Endpoints
- **Search (public):**
- ```
- POST /api/search
- { query, category?, is_paid?, limit?, offset? }
- Returns: { results: [Skill], count }
- ```
- **Skill Details (public):**
- ```
- GET /api/skills/:slug
- Returns: { skill, ratings: [], reviews: [] }
- ```
- **Auth-Protected (session or API key):**
- ```
- POST /api/skills/:slug/rate { score } # Rate 0-10
- POST /api/skills/:slug/review { content } # Write review
- POST /api/skills/:slug/favorite # Add favorite
- DELETE /api/skills/:slug/favorite # Remove favorite
- POST /api/report { outcome, duration_ms } # Report usage
- ```
- **User APIs (session only):**
- ```
- GET /api/user/api-keys # List keys
- POST /api/user/api-keys { name } # Create key
- DELETE /api/user/api-keys/:id # Revoke key
- ```
- ## Development
- ### Prerequisites
- - Node.js >=22
- - pnpm
- - Cloudflare account
- ### Commands
- ```bash
- pnpm install # Install dependencies
- pnpm dev # Start dev server (apps/web)
- pnpm test # Run tests
- pnpm build # Build for production
- pnpm lint # Check linting
- ```
- ### Running Tests
- ```bash
- # Unit tests
- pnpm test
- # Type checking
- pnpm tsc --noEmit
- # Linting
- pnpm lint
- ```
- ## Project Status
- **Phase 1 (Complete):** MVP with web marketplace, CLI, hybrid search, auth, ratings/reviews, API keys
- **Phase 2 (Next):** Payment integration (Stripe), production hardening, GitHub OAuth setup
- **Phase 3 (Future):** MCP server mode, skill execution sandbox, Skillmark integration
- See [project-roadmap.md](./docs/project-roadmap.md) for details.
- ## Performance Metrics
- | Metric | Target |
- |--------|--------|
- | Search latency (p95) | <800ms |
- | Leaderboard load | <500ms |
- | Page FCP | <2s |
- | Uptime | 99.9% |
- ## Security
- - API keys hashed (SHA-256)
- - Session cookies (httpOnly, secure, sameSite)
- - SQL injection prevention (Drizzle ORM)
- - CORS enabled for trusted origins
- - Rate limiting (100 req/min per IP)
- - HTTPS enforced (Cloudflare TLS 1.3)
- ## License
- MIT
- ## Contributing
- 1. Read [code-standards.md](./docs/code-standards.md)
- 2. Create feature branch
- 3. Test locally: `pnpm test && pnpm lint`
- 4. Submit PR with description
- ---
- **Learn more:** [docs/](./docs/) directory
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.