feat: add distribution files for Smithery, GitHub Action, and Claude Code Plugin
- Add Claude Code Plugin: plugin.json, .mcp.json, 3 slash commands, skill-builder agent skill - Add GitHub Action: composite action.yml with 6 inputs/2 outputs, comprehensive README - Add Smithery: publishing guide with namespace yusufkaraaslan/skill-seekers created - Add render-mcp.yaml for MCP server deployment on Render - Fix Dockerfile.mcp: --transport flag (nonexistent) → --http, add dynamic PORT support - Update AGENTS.md to v3.3.0 with corrected test count and expanded CI section - Allow distribution/claude-plugin/.mcp.json in .gitignore
This commit is contained in:
93
distribution/claude-plugin/README.md
Normal file
93
distribution/claude-plugin/README.md
Normal file
@@ -0,0 +1,93 @@
|
||||
# Skill Seekers — Claude Code Plugin
|
||||
|
||||
Transform 17 source types into AI-ready skills and RAG knowledge, directly from Claude Code.
|
||||
|
||||
## Installation
|
||||
|
||||
### From the Official Plugin Directory
|
||||
|
||||
```
|
||||
/plugin install skill-seekers@claude-plugin-directory
|
||||
```
|
||||
|
||||
Or browse for it in `/plugin > Discover`.
|
||||
|
||||
### Local Installation (for development)
|
||||
|
||||
```bash
|
||||
claude --plugin-dir ./path/to/skill-seekers-plugin
|
||||
```
|
||||
|
||||
### Prerequisites
|
||||
|
||||
The plugin requires `skill-seekers` to be installed:
|
||||
|
||||
```bash
|
||||
pip install skill-seekers[mcp]
|
||||
```
|
||||
|
||||
## What's Included
|
||||
|
||||
### MCP Server (35 tools)
|
||||
|
||||
The plugin bundles the Skill Seekers MCP server providing tools for:
|
||||
- Scraping documentation, GitHub repos, PDFs, videos, and 13 other source types
|
||||
- Packaging skills for 16+ LLM platforms
|
||||
- Exporting to vector databases (Weaviate, Chroma, FAISS, Qdrant)
|
||||
- Managing configs, workflows, and sources
|
||||
|
||||
### Slash Commands
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/skill-seekers:create-skill <source>` | Create a skill from any source (auto-detects type) |
|
||||
| `/skill-seekers:sync-config <config>` | Sync config URLs against live docs |
|
||||
| `/skill-seekers:install-skill <source>` | End-to-end: fetch, scrape, enhance, package, install |
|
||||
|
||||
### Agent Skill
|
||||
|
||||
The **skill-builder** skill is automatically available to Claude. It detects source types and uses the appropriate MCP tools to build skills autonomously.
|
||||
|
||||
## Usage Examples
|
||||
|
||||
```
|
||||
# Create a skill from a documentation site
|
||||
/skill-seekers:create-skill https://react.dev
|
||||
|
||||
# Create from a GitHub repo, targeting LangChain
|
||||
/skill-seekers:create-skill pallets/flask --target langchain
|
||||
|
||||
# Full install workflow with AI enhancement
|
||||
/skill-seekers:install-skill https://fastapi.tiangolo.com --enhance
|
||||
|
||||
# Sync an existing config
|
||||
/skill-seekers:sync-config react
|
||||
```
|
||||
|
||||
Or just ask Claude naturally:
|
||||
> "Create an AI skill from the React documentation"
|
||||
> "Scrape the Flask GitHub repo and package it for OpenAI"
|
||||
> "Export my skill to a Chroma vector database"
|
||||
|
||||
The skill-builder agent skill will automatically detect the intent and use the right tools.
|
||||
|
||||
## Remote MCP Alternative
|
||||
|
||||
By default, the plugin runs the MCP server locally via `python -m skill_seekers.mcp.server_fastmcp`. To use a remote server instead, edit `.mcp.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"skill-seekers": {
|
||||
"type": "http",
|
||||
"url": "https://your-hosted-server.com/mcp"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Supported Source Types
|
||||
|
||||
Documentation (web), GitHub repos, PDFs, Word docs, EPUBs, videos, local codebases, Jupyter notebooks, HTML files, OpenAPI specs, AsciiDoc, PowerPoint, RSS/Atom feeds, man pages, Confluence, Notion, Slack/Discord exports.
|
||||
|
||||
## License
|
||||
|
||||
MIT — https://github.com/yusufkaraaslan/Skill_Seekers
|
||||
Reference in New Issue
Block a user