Initial release v1.0.0
Open-source marketplace for AI Agent skills. Features: - Next.js 15 web app with i18n (en/fa) - CLI tool for skill installation (npx skillhub) - GitHub crawler/indexer with multi-strategy discovery - Security scanning for all indexed skills - Self-hostable with Docker Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
airano
219
README.md
Normal file
219
README.md
Normal file
@@ -0,0 +1,219 @@
|
||||
# SkillHub
|
||||
|
||||
<div align="center">
|
||||
|
||||
|
||||
|
||||
**The open-source marketplace for AI Agent skills**
|
||||
|
||||
[Documentation](./docs) | [CLI](./apps/cli) | [Self-Host](./docs/self-hosting.md)
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.typescriptlang.org/)
|
||||
[](https://skills.palebluedot.live/api/stats)
|
||||
[](./CONTRIBUTING.md)
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## What is SkillHub?
|
||||
|
||||
SkillHub indexes **hundreds of thousands of AI agent skills** from GitHub and makes them discoverable and installable. Skills are SKILL.md files that teach AI agents (Claude, Codex, Copilot) specialized capabilities - from PDF manipulation to database queries.
|
||||
|
||||
```bash
|
||||
# Install a skill in seconds
|
||||
npx skillhub install anthropics/skills/pdf
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Features
|
||||
|
||||
- **Massive Skill Catalog** - Search by category, platform, or keyword
|
||||
- **One-Line Install** - `npx skillhub install <skill-id>`
|
||||
- **Multi-Platform** - Works with Claude, OpenAI Codex, GitHub Copilot
|
||||
- **Security Scanning** - Every skill scanned for malicious patterns
|
||||
- **Self-Hostable** - Run your own instance with Docker
|
||||
- **Fully Open Source** - MIT licensed, free forever
|
||||
|
||||
---
|
||||
|
||||
## Quick Start
|
||||
|
||||
### Install the CLI
|
||||
|
||||
```bash
|
||||
npm install -g skillhub
|
||||
```
|
||||
|
||||
### Search for Skills
|
||||
|
||||
```bash
|
||||
skillhub search "pdf processing"
|
||||
skillhub search "database" --category data-database
|
||||
```
|
||||
|
||||
### Install a Skill
|
||||
|
||||
```bash
|
||||
# For Claude Code (global)
|
||||
skillhub install anthropics/skills/pdf
|
||||
|
||||
# For a specific project
|
||||
skillhub install anthropics/skills/pdf --project
|
||||
|
||||
# For OpenAI Codex
|
||||
skillhub install anthropics/skills/pdf --platform codex
|
||||
```
|
||||
|
||||
### List Installed Skills
|
||||
|
||||
```bash
|
||||
skillhub list
|
||||
skillhub list --all # Show both global and project skills
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Self-Hosting
|
||||
|
||||
```bash
|
||||
# Clone the repository
|
||||
git clone https://github.com/airano-ir/skillhub.git
|
||||
cd skillhub
|
||||
|
||||
# Copy environment file
|
||||
cp .env.example .env
|
||||
|
||||
# Start with Docker Compose
|
||||
docker compose up -d
|
||||
|
||||
# Open http://localhost:3000
|
||||
```
|
||||
|
||||
For production deployment, see [Self-Hosting Guide](./docs/self-hosting.md).
|
||||
|
||||
---
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
skillhub/
|
||||
├── apps/
|
||||
│ ├── web/ # Next.js 15 web application
|
||||
│ └── cli/ # CLI tool (npm: skillhub)
|
||||
├── packages/
|
||||
│ ├── core/ # SKILL.md parser & validator
|
||||
│ ├── db/ # PostgreSQL + Drizzle ORM
|
||||
│ └── ui/ # Shared shadcn/ui components
|
||||
├── services/
|
||||
│ └── indexer/ # GitHub skill crawler
|
||||
└── docs/ # Documentation
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Technology Stack
|
||||
|
||||
| Layer | Technology |
|
||||
|-------|------------|
|
||||
| Frontend | Next.js 15, React 18, Tailwind CSS, shadcn/ui |
|
||||
| Backend | Next.js API Routes, PostgreSQL |
|
||||
| Search | Meilisearch |
|
||||
| CLI | Commander.js |
|
||||
| DevOps | Docker, GitHub Actions |
|
||||
|
||||
---
|
||||
|
||||
## API
|
||||
|
||||
SkillHub provides a public REST API:
|
||||
|
||||
```bash
|
||||
# Get skill info
|
||||
curl https://skills.palebluedot.live/api/skills/anthropics/skills/pdf
|
||||
|
||||
# Search skills
|
||||
curl "https://skills.palebluedot.live/api/skills?q=pdf&limit=10"
|
||||
|
||||
# Get stats
|
||||
curl https://skills.palebluedot.live/api/stats
|
||||
```
|
||||
|
||||
See [API Documentation](./docs/API.md) for full reference.
|
||||
|
||||
---
|
||||
|
||||
## Contributing
|
||||
|
||||
We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
|
||||
|
||||
### Development Setup
|
||||
|
||||
```bash
|
||||
# Install dependencies
|
||||
pnpm install
|
||||
|
||||
# Start development servers
|
||||
pnpm dev
|
||||
|
||||
# Run tests
|
||||
pnpm test
|
||||
|
||||
# Build all packages
|
||||
pnpm build
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Security
|
||||
|
||||
SkillHub scans all indexed skills for:
|
||||
|
||||
- Dangerous shell commands (rm -rf, curl | sh)
|
||||
- Prompt injection patterns
|
||||
- Data exfiltration attempts
|
||||
|
||||
**Security Status:**
|
||||
- **PASS** - No issues detected
|
||||
- **WARNING** - Potential issues flagged
|
||||
- **FAIL** - Dangerous patterns detected
|
||||
|
||||
Always review skill source code before installing.
|
||||
|
||||
---
|
||||
|
||||
## Roadmap
|
||||
|
||||
- [x] Web marketplace with growing skill catalog
|
||||
- [x] CLI tool
|
||||
- [x] Multi-platform support
|
||||
- [x] Security scanning
|
||||
- [ ] Claude Code MCP plugin
|
||||
- [ ] AI-powered recommendations
|
||||
- [ ] Enterprise features
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
||||
MIT - See [LICENSE](./LICENSE) for details.
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- **Live Site:** https://skills.palebluedot.live
|
||||
- **GitHub:** https://github.com/airano-ir/skillhub
|
||||
- **npm:** https://www.npmjs.com/package/skillhub
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
**[Browse Skills](https://skills.palebluedot.live/browse)** | **[Star on GitHub](https://github.com/airano-ir/skillhub)**
|
||||
|
||||
*Built with love for the AI agent community*
|
||||
|
||||
</div>
|
||||
Reference in New Issue
Block a user