# Claude Code Plugin Specification
## Overview
The YouTube KB plugin is a lightweight Claude Code plugin that connects users to the hosted MCP server. It provides easy installation, automatic MCP registration, and optional skills for domain-specific searches.
---
## Plugin Structure
```
youtube-kb-plugin/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── .mcp.json # MCP server connection
├── skills/
│ ├── search-kb/
│ │ └── SKILL.md # General search skill
│ ├── growth-kb/
│ │ └── SKILL.md # Growth domain skill
│ ├── engineering-kb/
│ │ └── SKILL.md # Engineering domain skill
│ └── strategy-kb/
│ └── SKILL.md # Strategy domain skill
├── commands/
│ └── kb-search.md # Optional /kb-search command
└── README.md # User documentation
```
---
## Plugin Manifest
### .claude-plugin/plugin.json
```json
{
"name": "youtube-kb",
"version": "1.0.0",
"description": "Search educational YouTube content across marketing, engineering, growth, and more. Access insights from top creators directly in Claude Code.",
"author": {
"name": "Alex Zaytsev",
"email": "alexvzay@gmail.com",
"url": "https://github.com/unisone"
},
"homepage": "https://youtubkb.dev",
"repository": "https://github.com/unisone/youtube-kb",
"license": "MIT",
"keywords": [
"knowledge-base",
"youtube",
"education",
"marketing",
"engineering",
"growth",
"strategy",
"research"
],
"engines": {
"claude-code": ">=1.0.0"
}
}
```
---
## MCP Configuration
### .mcp.json
```json
{
"mcpServers": {
"youtube-kb": {
"type": "http",
"url": "https://api.youtubkb.dev/mcp",
"description": "YouTube Knowledge Base - educational content search"
}
}
}
```
---
## Skills
### General Search Skill (skills/search-kb/SKILL.md)
```markdown
---
name: Search YouTube KB
description: Use this skill when the user wants to search YouTube educational content, find insights from YouTube creators, or look up expert advice on marketing, engineering, growth, or strategy topics. Triggers on phrases like "search YouTube KB", "find YouTube content about", "what do experts say about", "YouTube insights on".
version: 1.0.0
---
# Search YouTube Knowledge Base
You have access to a semantic search tool that searches across thousands of YouTube educational videos.
## When to Use
Use `mcp__plugin_youtube-kb_youtube-kb__search` when:
- User asks for expert opinions or advice
- User wants to learn best practices
- User asks "what do experts say about X"
- User needs frameworks or methodologies
## Available Domains
| Domain | Topics |
|--------|--------|
| growth | Marketing, acquisition, retention |
| strategy | Business models, pricing, positioning |
| engineering | Architecture, patterns, best practices |
| product | PM skills, roadmaps, prioritization |
| startup | Fundraising, founder advice |
| sales | Selling, closing, pipelines |
| design | UI/UX, visual design |
| ai-tools | AI products, prompting |
## Usage Pattern
1. Identify what the user wants to learn
2. Call `search` with a clear query
3. Optionally filter by domain if topic is specific
4. Present results with citations
## Example
User: "How should I price my SaaS?"
```
mcp__plugin_youtube-kb_youtube-kb__search({
query: "SaaS pricing strategy value-based",
domain: "strategy",
max_results: 5
})
```
## Citation Format
Always cite sources as:
> "{quote}" — [Video Title](URL) by Channel Name
```
### Growth Domain Skill (skills/growth-kb/SKILL.md)
```markdown
---
name: Growth & Marketing KB
description: Search YouTube knowledge base specifically for growth, marketing, customer acquisition, and retention topics. Use when user asks about marketing strategy, growth hacking, content marketing, SEO, paid ads, or customer acquisition.
version: 1.0.0
---
# Growth & Marketing Knowledge Base
Specialized search for growth and marketing insights from top YouTube educators.
## When to Use
- Marketing strategy questions
- Customer acquisition advice
- Content marketing guidance
- SEO and paid advertising
- Growth hacking techniques
- Retention and engagement
## Search Pattern
```
mcp__plugin_youtube-kb_youtube-kb__search({
query: "[user's marketing question]",
domain: "growth",
max_results: 5
})
```
## Example Queries
- "content marketing for B2B startups"
- "customer acquisition channels comparison"
- "email marketing best practices"
- "landing page conversion optimization"
```
### Engineering Domain Skill (skills/engineering-kb/SKILL.md)
```markdown
---
name: Engineering KB
description: Search YouTube knowledge base for software engineering, architecture, and technical best practices. Use when user asks about system design, coding patterns, database optimization, or technical decisions.
version: 1.0.0
---
# Engineering Knowledge Base
Specialized search for software engineering insights from top tech educators.
## When to Use
- System design questions
- Architecture decisions
- Coding best practices
- Database optimization
- Technical trade-offs
- DevOps and deployment
## Search Pattern
```
mcp__plugin_youtube-kb_youtube-kb__search({
query: "[user's engineering question]",
domain: "engineering",
max_results: 5
})
```
## Example Queries
- "microservices vs monolith trade-offs"
- "PostgreSQL performance optimization"
- "API design best practices"
- "technical debt management"
```
### Strategy Domain Skill (skills/strategy-kb/SKILL.md)
```markdown
---
name: Strategy KB
description: Search YouTube knowledge base for business strategy, pricing, positioning, and go-to-market topics. Use when user asks about business models, pricing strategies, competitive positioning, or market entry.
version: 1.0.0
---
# Business Strategy Knowledge Base
Specialized search for business strategy insights from top business educators.
## When to Use
- Business model questions
- Pricing strategy
- Market positioning
- Competitive analysis
- Go-to-market planning
- Strategic decisions
## Search Pattern
```
mcp__plugin_youtube-kb_youtube-kb__search({
query: "[user's strategy question]",
domain: "strategy",
max_results: 5
})
```
## Example Queries
- "SaaS pricing models comparison"
- "positioning against competitors"
- "go-to-market strategy B2B"
- "business model canvas startup"
```
---
## Optional Command
### commands/kb-search.md
```markdown
---
name: kb-search
description: Search the YouTube Knowledge Base
arguments:
- name: query
description: What to search for
required: true
- name: domain
description: Domain to search (growth, strategy, engineering, product, startup, sales, design, ai-tools)
required: false
allowed-tools:
- mcp__plugin_youtube-kb_youtube-kb__search
- mcp__plugin_youtube-kb_youtube-kb__list_domains
---
# YouTube KB Search
Search the YouTube Knowledge Base for educational content.
## Instructions
1. If no domain specified, search across all domains
2. Use the search tool with the user's query
3. Present results with proper citations
## Execution
```
mcp__plugin_youtube-kb_youtube-kb__search({
query: "$ARGUMENTS.query",
domain: "$ARGUMENTS.domain" || undefined,
max_results: 5
})
```
```
---
## README.md
```markdown
# YouTube Knowledge Base Plugin
Search educational YouTube content directly from Claude Code. Access insights from top creators on marketing, engineering, growth, strategy, and more.
## Installation
```bash
claude plugin install youtube-kb
```
Or install from GitHub:
```bash
claude plugin install github:unisone/youtube-kb
```
## Usage
Once installed, Claude Code can automatically search the YouTube KB when you ask questions like:
- "What do experts say about pricing SaaS products?"
- "How should I approach content marketing for a B2B startup?"
- "What are best practices for microservices architecture?"
### Available Domains
| Domain | Topics |
|--------|--------|
| `growth` | Marketing, acquisition, retention, content, SEO |
| `strategy` | Business models, pricing, positioning, GTM |
| `engineering` | Architecture, patterns, databases, DevOps |
| `product` | Product management, roadmaps, prioritization |
| `startup` | Fundraising, founder advice, scaling |
| `sales` | Sales techniques, closing, pipelines |
| `design` | UI/UX, visual design, branding |
| `ai-tools` | AI products, prompting, workflows |
| `ai-builder` | Building with AI, LLMs, automation |
### Manual Search
You can also search directly:
```
/kb-search "your question here" --domain=growth
```
## What's Included
This plugin provides:
- **MCP Connection**: Automatic connection to the hosted YouTube KB server
- **Smart Skills**: Domain-specific search helpers that Claude uses automatically
- **Fast Search**: Sub-500ms semantic search across 50,000+ indexed chunks
## Data Sources
The knowledge base includes transcripts from educational YouTube channels across:
- Marketing and growth experts
- Business strategy educators
- Software engineering channels
- Product management teachers
- Startup advisors
All results include full citations with video links.
## Self-Hosting
Want to run your own instance? The YouTube KB is fully open source:
```bash
git clone https://github.com/unisone/youtube-kb
cd youtube-kb
pnpm install
# See docs/SELF_HOSTING.md for setup
```
## Contributing
We welcome contributions! See [CONTRIBUTING.md](https://github.com/unisone/youtube-kb/blob/main/CONTRIBUTING.md).
## License
MIT License - see [LICENSE](https://github.com/unisone/youtube-kb/blob/main/LICENSE)
```
---
## Installation Flow
### For End Users
```bash
# Install from marketplace (preferred)
claude plugin install youtube-kb
# Or from GitHub
claude plugin install github:unisone/youtube-kb
# Verify installation
claude plugin list
# Should show: youtube-kb@1.0.0
# Test MCP connection
/mcp
# Should show: youtube-kb server connected
```
### For Self-Hosting
```bash
# Clone and modify .mcp.json to point to your server
git clone https://github.com/unisone/youtube-kb-plugin
cd youtube-kb-plugin
# Edit .mcp.json
{
"mcpServers": {
"youtube-kb": {
"type": "http",
"url": "https://YOUR-SERVER.vercel.app/mcp"
}
}
}
# Install locally
claude plugin install .
```
---
## Distribution Channels
### Primary: Claude Plugin Marketplace
1. Submit to Anthropic's official marketplace
2. Users install with `claude plugin install youtube-kb`
3. Automatic updates when we release new versions
### Secondary: GitHub
1. Public repository at `github.com/unisone/youtube-kb`
2. Users install with `claude plugin install github:unisone/youtube-kb`
3. Manual updates required
### Tertiary: npm (Future)
```bash
npm install -g @youtube-kb/plugin
claude plugin install @youtube-kb/plugin
```
---
## Version Strategy
| Version | Changes |
|---------|---------|
| 1.0.0 | Initial release - search, list_domains, stats |
| 1.1.0 | Add more domain skills |
| 1.2.0 | Add caching, performance improvements |
| 2.0.0 | Breaking: API changes (if needed) |
### Changelog Format
```markdown
# Changelog
## [1.0.0] - 2026-01-XX
### Added
- Initial release
- Search tool with hybrid search
- Domain listing
- Statistics tool
- Skills for growth, engineering, strategy domains
### Changed
- N/A
### Fixed
- N/A
```
