skill-seekers-reference/.github/ISSUES_TO_CREATE.md

GitHub Issues to Create

Copy these to GitHub Issues manually or use gh issue create

---

Issue 1: Fix 3 Remaining Test Failures

Title: Fix 3 test failures (warnings vs errors handling)

Labels: bug, tests, good first issue

Body:

## Problem
3 tests are failing because they check for errors but the validation function returns warnings for these cases:

1. `test_missing_recommended_selectors` - Missing selectors are warnings, not errors
2. `test_invalid_rate_limit_too_high` - Rate limit warnings
3. `test_invalid_max_pages_too_high` - Max pages warnings

**Current:** 68/71 tests passing (95.8%)
**Target:** 71/71 tests passing (100%)

## Location
- `tests/test_config_validation.py`

## Solution
Update tests to check warnings tuple instead of errors:
```python
# Before
errors, _ = validate_config(config)
self.assertTrue(any('title' in error.lower() for error in errors))

# After
_, warnings = validate_config(config)
self.assertTrue(any('title' in warning.lower() for warning in warnings))

Acceptance Criteria

• All 71 tests passing
• Tests properly differentiate errors vs warnings
• No false positives

Files to Modify

• tests/test_config_validation.py (3 test methods)

---

## Issue 2: Create MCP Setup Guide

**Title:** Create comprehensive MCP setup guide for Claude Code

**Labels:** documentation, mcp, enhancement

**Body:**
```markdown
## Goal
Create step-by-step guide for users to set up the MCP server with Claude Code.

## Content Needed

### 1. Prerequisites
- Python 3.7+
- Claude Code installed
- Repository cloned

### 2. Installation Steps
- Install dependencies
- Configure MCP in Claude Code
- Verify installation

### 3. Configuration Example
- Complete `~/.config/claude-code/mcp.json` example
- Path configuration
- Troubleshooting common issues

### 4. Usage Examples
- Generate config for new site
- Estimate pages
- Scrape and build skill
- End-to-end workflow

### 5. Screenshots/Video
- Visual guide through setup
- Example interactions

## Deliverables
- [ ] `docs/MCP_SETUP.md` - Main setup guide
- [ ] `.claude/mcp_config.example.json` - Example config
- [ ] Screenshots in `docs/images/`
- [ ] Optional: Quick start video

## Target Audience
Users who have Claude Code but never used MCP before.

---

Issue 3: Test MCP Server Functionality

Title: Test MCP server with actual Claude Code instance

Labels: testing, mcp, priority-high

Body:

## Goal
Verify MCP server works correctly with actual Claude Code.

## Test Plan

### Setup
1. Install MCP server locally
2. Configure Claude Code MCP settings
3. Restart Claude Code

### Tests

#### Test 1: List Configs

User: "List all available configs" Expected: Shows 7 configs (godot, react, vue, django, fastapi, kubernetes, steam-economy)

#### Test 2: Generate Config

User: "Generate config for Tailwind CSS at https://tailwindcss.com/docs" Expected: Creates configs/tailwind.json

#### Test 3: Estimate Pages

User: "Estimate pages for configs/tailwind.json" Expected: Returns estimation results

#### Test 4: Validate Config

User: "Validate configs/react.json" Expected: Shows config is valid

#### Test 5: Scrape Docs

User: "Scrape docs using configs/kubernetes.json with max 10 pages" Expected: Creates output/kubernetes/ directory with SKILL.md

#### Test 6: Package Skill

User: "Package skill at output/kubernetes/" Expected: Creates kubernetes.zip

## Success Criteria
- [ ] All 6 tools respond correctly
- [ ] No errors in Claude Code logs
- [ ] Generated files are correct
- [ ] Performance is acceptable (<5s for simple operations)

## Documentation
Document any issues found and solutions in test results.

## Files
- [ ] Create `tests/mcp_integration_test.md` with results

---

Issue 4: Update Documentation for Monorepo

Title: Update all documentation for new monorepo structure

Labels: documentation, breaking-change

Body:

## Goal
Update all documentation to reflect cli/ and mcp/ structure.

## Files to Update

### 1. README.md
- [ ] Update file structure diagram
- [ ] Add MCP section
- [ ] Update installation commands
- [ ] Add quick start for both CLI and MCP

### 2. CLAUDE.md
- [ ] Update paths (cli/doc_scraper.py)
- [ ] Add MCP usage section
- [ ] Update examples

### 3. docs/USAGE.md
- [ ] Update all command paths
- [ ] Add MCP usage section
- [ ] Update examples

### 4. docs/TESTING.md
- [ ] Update test run commands
- [ ] Note new import structure

### 5. QUICKSTART.md
- [ ] Update for both CLI and MCP
- [ ] Add decision tree: "Use CLI or MCP?"

## New Documentation Needed
- [ ] `mcp/QUICKSTART.md` - MCP-specific quick start
- [ ] Update diagrams/architecture docs

## Breaking Changes to Document
- CLI tools moved from root to `cli/`
- Import path changes: `from doc_scraper` → `from cli.doc_scraper`
- New MCP-based workflow available

## Validation
- [ ] All code examples work
- [ ] All paths are correct
- [ ] Links are not broken

---

How to Create Issues

Option 1: GitHub Web UI

1. Go to https://github.com/yusufkaraaslan/Skill_Seekers/issues/new
2. Copy title and body
3. Add labels
4. Create issue

Option 2: GitHub CLI

# Issue 1
gh issue create --title "Fix 3 test failures (warnings vs errors handling)" \
  --body-file issue1.md \
  --label "bug,tests,good first issue"

# Issue 2
gh issue create --title "Create comprehensive MCP setup guide for Claude Code" \
  --body-file issue2.md \
  --label "documentation,mcp,enhancement"

# Issue 3
gh issue create --title "Test MCP server with actual Claude Code instance" \
  --body-file issue3.md \
  --label "testing,mcp,priority-high"

# Issue 4
gh issue create --title "Update all documentation for new monorepo structure" \
  --body-file issue4.md \
  --label "documentation,breaking-change"

Option 3: Manual Script

Save each issue body to issue1.md, issue2.md, etc., then use gh CLI as shown above.