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
2026-03-16 23:29:50 +03:00
parent 2b725aa8f7
commit 5e4932e8b1
14 changed files with 718 additions and 47 deletions
--- a/distribution/claude-plugin/.claude-plugin/plugin.json
+++ b/distribution/claude-plugin/.claude-plugin/plugin.json
@@ -0,0 +1,11 @@
+{
+  "name": "skill-seekers",
+  "description": "Transform 17 source types (docs, GitHub, PDFs, videos, Jupyter, Confluence, Notion, Slack, and more) into AI-ready skills and RAG knowledge for 16+ LLM platforms.",
+  "version": "3.3.0",
+  "author": {
+    "name": "Yusuf Karaaslan"
+  },
+  "homepage": "https://github.com/yusufkaraaslan/Skill_Seekers",
+  "repository": "https://github.com/yusufkaraaslan/Skill_Seekers",
+  "license": "MIT"
+}
--- a/distribution/claude-plugin/.mcp.json
+++ b/distribution/claude-plugin/.mcp.json
@@ -0,0 +1,6 @@
+{
+  "skill-seekers": {
+    "command": "python",
+    "args": ["-m", "skill_seekers.mcp.server_fastmcp"]
+  }
+}
--- a/distribution/claude-plugin/README.md
+++ b/distribution/claude-plugin/README.md
@@ -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
--- a/distribution/claude-plugin/commands/create-skill.md
+++ b/distribution/claude-plugin/commands/create-skill.md
@@ -0,0 +1,52 @@
+---
+description: Create an AI skill from any source (URL, repo, PDF, video, notebook, etc.)
+---
+
+# Create Skill
+
+Create an AI-ready skill from a source. The source type is auto-detected.
+
+## Usage
+
+```
+/skill-seekers:create-skill <source> [--target <platform>] [--output <dir>]
+```
+
+## Instructions
+
+When the user provides a source via `$ARGUMENTS`, run the `skill-seekers create` command to generate a skill.
+
+1. Parse the arguments: extract the source (first argument) and any flags.
+2. If no `--target` is specified, default to `claude`.
+3. If no `--output` is specified, default to `./output`.
+4. Run the command:
+   ```bash
+   skill-seekers create "$SOURCE" --target "$TARGET" --output "$OUTPUT"
+   ```
+5. After completion, read the generated `SKILL.md` and summarize what was created.
+
+## Source Types (auto-detected)
+
+- **URL** (https://...) → Documentation scraping
+- **owner/repo** or github.com URL → GitHub repo analysis
+- **file.pdf** → PDF extraction
+- **file.ipynb** → Jupyter notebook
+- **file.docx** → Word document
+- **file.epub** → EPUB book
+- **YouTube/Vimeo URL** → Video transcript
+- **./directory** → Local codebase analysis
+- **file.yaml** with OpenAPI → API spec
+- **file.pptx** → PowerPoint
+- **file.adoc** → AsciiDoc
+- **file.html** → HTML page
+- **file.rss** → RSS/Atom feed
+- **cmd.1** → Man page
+
+## Examples
+
+```
+/skill-seekers:create-skill https://react.dev
+/skill-seekers:create-skill pallets/flask --target langchain
+/skill-seekers:create-skill ./docs/api.pdf --target openai
+/skill-seekers:create-skill https://youtube.com/watch?v=abc123
+```
--- a/distribution/claude-plugin/commands/install-skill.md
+++ b/distribution/claude-plugin/commands/install-skill.md
@@ -0,0 +1,44 @@
+---
+description: One-command skill installation — fetch config, scrape, enhance, package, and install
+---
+
+# Install Skill
+
+Complete end-to-end workflow: fetch a config (from preset or URL), scrape the source, optionally enhance with AI, package for the target platform, and install.
+
+## Usage
+
+```
+/skill-seekers:install-skill <config-or-source> [--target <platform>] [--enhance]
+```
+
+## Instructions
+
+When the user provides a source or config via `$ARGUMENTS`:
+
+1. Determine if the argument is a config preset name, config file path, or a direct source.
+2. Use the `install_skill` MCP tool if available, or run the equivalent CLI commands:
+   ```bash
+   # For preset configs
+   skill-seekers install --config "$CONFIG" --target "$TARGET"
+
+   # For direct sources
+   skill-seekers create "$SOURCE" --target "$TARGET"
+   ```
+3. If `--enhance` is specified, run enhancement after initial scraping:
+   ```bash
+   skill-seekers enhance "$SKILL_DIR" --target "$TARGET"
+   ```
+4. Report the final skill location and how to use it.
+
+## Target Platforms
+
+`claude`, `openai`, `gemini`, `langchain`, `llamaindex`, `haystack`, `cursor`, `windsurf`, `continue`, `cline`, `markdown`
+
+## Examples
+
+```
+/skill-seekers:install-skill react --target claude
+/skill-seekers:install-skill https://fastapi.tiangolo.com --target langchain --enhance
+/skill-seekers:install-skill pallets/flask
+```
--- a/distribution/claude-plugin/commands/sync-config.md
+++ b/distribution/claude-plugin/commands/sync-config.md
@@ -0,0 +1,32 @@
+---
+description: Sync a scraping config's URLs against the live documentation site
+---
+
+# Sync Config
+
+Synchronize a Skill Seekers config file with the current state of a documentation site. Detects new pages, removed pages, and URL changes.
+
+## Usage
+
+```
+/skill-seekers:sync-config <config-path-or-name>
+```
+
+## Instructions
+
+When the user provides a config path or preset name via `$ARGUMENTS`:
+
+1. If it's a preset name (e.g., `react`, `godot`), look for it in the `configs/` directory or fetch from the API.
+2. Run the sync command:
+   ```bash
+   skill-seekers sync-config "$CONFIG"
+   ```
+3. Report what changed: new URLs found, removed URLs, and any conflicts.
+4. Ask the user if they want to update the config and re-scrape.
+
+## Examples
+
+```
+/skill-seekers:sync-config configs/react.json
+/skill-seekers:sync-config react
+```
--- a/distribution/claude-plugin/skills/skill-builder/SKILL.md
+++ b/distribution/claude-plugin/skills/skill-builder/SKILL.md
@@ -0,0 +1,69 @@
+---
+name: skill-builder
+description: Automatically detect source types and build AI skills using Skill Seekers. Use when the user wants to create skills from documentation, repos, PDFs, videos, or other knowledge sources.
+---
+
+# Skill Builder
+
+You have access to the Skill Seekers MCP server which provides 35 tools for converting knowledge sources into AI-ready skills.
+
+## When to Use This Skill
+
+Use this skill when the user:
+- Wants to create an AI skill from a documentation site, GitHub repo, PDF, video, or other source
+- Needs to convert documentation into a format suitable for LLM consumption
+- Wants to update or sync existing skills with their source documentation
+- Needs to export skills to vector databases (Weaviate, Chroma, FAISS, Qdrant)
+- Asks about scraping, converting, or packaging documentation for AI
+
+## Source Type Detection
+
+Automatically detect the source type from user input:
+
+| Input Pattern | Source Type | Tool to Use |
+|---------------|-------------|-------------|
+| `https://...` (not GitHub/YouTube) | Documentation | `scrape_docs` |
+| `owner/repo` or `github.com/...` | GitHub | `scrape_github` |
+| `*.pdf` | PDF | `scrape_pdf` |
+| YouTube/Vimeo URL or video file | Video | `scrape_video` |
+| Local directory path | Codebase | `scrape_codebase` |
+| `*.ipynb`, `*.html`, `*.yaml` (OpenAPI), `*.adoc`, `*.pptx`, `*.rss`, `*.1`-`.8` | Various | `scrape_generic` |
+| JSON config file | Unified | Use config with `scrape_docs` |
+
+## Recommended Workflow
+
+1. **Detect source type** from the user's input
+2. **Generate or fetch config** using `generate_config` or `fetch_config` if needed
+3. **Estimate scope** with `estimate_pages` for documentation sites
+4. **Scrape the source** using the appropriate scraping tool
+5. **Enhance** with `enhance_skill` if the user wants AI-powered improvements
+6. **Package** with `package_skill` for the target platform
+7. **Export to vector DB** if requested using `export_to_*` tools
+
+## Available MCP Tools
+
+### Config Management
+- `generate_config` — Generate a scraping config from a URL
+- `list_configs` — List available preset configs
+- `validate_config` — Validate a config file
+
+### Scraping (use based on source type)
+- `scrape_docs` — Documentation sites
+- `scrape_github` — GitHub repositories
+- `scrape_pdf` — PDF files
+- `scrape_video` — Video transcripts
+- `scrape_codebase` — Local code analysis
+- `scrape_generic` — Jupyter, HTML, OpenAPI, AsciiDoc, PPTX, RSS, manpage, Confluence, Notion, chat
+
+### Post-processing
+- `enhance_skill` — AI-powered skill enhancement
+- `package_skill` — Package for target platform
+- `upload_skill` — Upload to platform API
+- `install_skill` — End-to-end install workflow
+
+### Advanced
+- `detect_patterns` — Design pattern detection in code
+- `extract_test_examples` — Extract usage examples from tests
+- `build_how_to_guides` — Generate how-to guides from tests
+- `split_config` — Split large configs into focused skills
+- `export_to_weaviate`, `export_to_chroma`, `export_to_faiss`, `export_to_qdrant` — Vector DB export