diff --git a/api/config_analyzer.py b/api/config_analyzer.py
index 644ade7..61c1931 100644
--- a/api/config_analyzer.py
+++ b/api/config_analyzer.py
@@ -4,11 +4,10 @@ Config Analyzer - Extract metadata from Skill Seekers config files
 """
 
 import json
-import os
 import subprocess
-from pathlib import Path
-from typing import List, Dict, Any, Optional
 from datetime import datetime
+from pathlib import Path
+from typing import Any
 
 
 class ConfigAnalyzer:
@@ -16,27 +15,13 @@ class ConfigAnalyzer:
 
     # Category mapping based on config content
     CATEGORY_MAPPING = {
-        "web-frameworks": [
-            "react", "vue", "django", "fastapi", "laravel", "astro", "hono"
-        ],
-        "game-engines": [
-            "godot", "unity", "unreal"
-        ],
-        "devops": [
-            "kubernetes", "ansible", "docker", "terraform"
-        ],
-        "css-frameworks": [
-            "tailwind", "bootstrap", "bulma"
-        ],
-        "development-tools": [
-            "claude-code", "vscode", "git"
-        ],
-        "gaming": [
-            "steam"
-        ],
-        "testing": [
-            "pytest", "jest", "test"
-        ]
+        "web-frameworks": ["react", "vue", "django", "fastapi", "laravel", "astro", "hono"],
+        "game-engines": ["godot", "unity", "unreal"],
+        "devops": ["kubernetes", "ansible", "docker", "terraform"],
+        "css-frameworks": ["tailwind", "bootstrap", "bulma"],
+        "development-tools": ["claude-code", "vscode", "git"],
+        "gaming": ["steam"],
+        "testing": ["pytest", "jest", "test"],
     }
 
     # Tag extraction keywords
@@ -50,7 +35,7 @@ class ConfigAnalyzer:
         "game-development": ["godot", "unity", "unreal", "game"],
         "devops": ["kubernetes", "ansible", "docker", "k8s", "devops"],
         "documentation": ["docs", "documentation"],
-        "testing": ["test", "testing", "pytest", "jest"]
+        "testing": ["test", "testing", "pytest", "jest"],
     }
 
     def __init__(self, config_dir: Path, base_url: str = "https://api.skillseekersweb.com"):
@@ -67,7 +52,7 @@ class ConfigAnalyzer:
         if not self.config_dir.exists():
             raise ValueError(f"Config directory not found: {self.config_dir}")
 
-    def analyze_all_configs(self) -> List[Dict[str, Any]]:
+    def analyze_all_configs(self) -> list[dict[str, Any]]:
         """
         Analyze all config files and extract metadata
 
@@ -92,7 +77,7 @@ class ConfigAnalyzer:
 
         return configs
 
-    def analyze_config(self, config_path: Path) -> Optional[Dict[str, Any]]:
+    def analyze_config(self, config_path: Path) -> dict[str, Any] | None:
         """
         Analyze a single config file and extract metadata
 
@@ -104,7 +89,7 @@ class ConfigAnalyzer:
         """
         try:
             # Read config file
-            with open(config_path, 'r') as f:
+            with open(config_path) as f:
                 config_data = json.load(f)
 
             # Skip if no name field
@@ -147,7 +132,7 @@ class ConfigAnalyzer:
                 "file_size": file_size,
                 "last_updated": last_updated,
                 "download_url": download_url,
-                "config_file": config_path.name
+                "config_file": config_path.name,
             }
 
         except json.JSONDecodeError as e:
@@ -157,7 +142,7 @@ class ConfigAnalyzer:
             print(f"Error analyzing {config_path.name}: {e}")
             return None
 
-    def get_config_by_name(self, name: str) -> Optional[Dict[str, Any]]:
+    def get_config_by_name(self, name: str) -> dict[str, Any] | None:
         """
         Get config metadata by name
 
@@ -173,7 +158,7 @@ class ConfigAnalyzer:
                 return config
         return None
 
-    def _determine_type(self, config_data: Dict[str, Any]) -> str:
+    def _determine_type(self, config_data: dict[str, Any]) -> str:
         """
         Determine if config is single-source or unified
 
@@ -193,7 +178,7 @@ class ConfigAnalyzer:
 
         return "single-source"
 
-    def _get_primary_source(self, config_data: Dict[str, Any], config_type: str) -> str:
+    def _get_primary_source(self, config_data: dict[str, Any], config_type: str) -> str:
         """
         Get primary source URL/repo
 
@@ -227,7 +212,7 @@ class ConfigAnalyzer:
 
         return "Unknown"
 
-    def _categorize_config(self, name: str, description: str, config_data: Dict[str, Any]) -> str:
+    def _categorize_config(self, name: str, description: str, config_data: dict[str, Any]) -> str:
         """
         Auto-categorize config based on name and content
 
@@ -261,7 +246,7 @@ class ConfigAnalyzer:
         # Default to uncategorized
         return "uncategorized"
 
-    def _extract_tags(self, name: str, description: str, config_data: Dict[str, Any]) -> List[str]:
+    def _extract_tags(self, name: str, description: str, config_data: dict[str, Any]) -> list[str]:
         """
         Extract relevant tags from config
 
@@ -288,18 +273,26 @@ class ConfigAnalyzer:
             tags.add("multi-source")
 
         # Add source type tags
-        if "base_url" in config_data or (config_type == "unified" and any(s.get("type") == "documentation" for s in config_data.get("sources", []))):
+        if "base_url" in config_data or (
+            config_type == "unified" and any(s.get("type") == "documentation" for s in config_data.get("sources", []))
+        ):
             tags.add("documentation")
 
-        if "repo" in config_data or (config_type == "unified" and any(s.get("type") == "github" for s in config_data.get("sources", []))):
+        if "repo" in config_data or (
+            config_type == "unified" and any(s.get("type") == "github" for s in config_data.get("sources", []))
+        ):
             tags.add("github")
 
-        if "pdf" in config_data or "pdf_url" in config_data or (config_type == "unified" and any(s.get("type") == "pdf" for s in config_data.get("sources", []))):
+        if (
+            "pdf" in config_data
+            or "pdf_url" in config_data
+            or (config_type == "unified" and any(s.get("type") == "pdf" for s in config_data.get("sources", [])))
+        ):
             tags.add("pdf")
 
         return sorted(list(tags))
 
-    def _get_max_pages(self, config_data: Dict[str, Any]) -> Optional[int]:
+    def _get_max_pages(self, config_data: dict[str, Any]) -> int | None:
         """
         Get max_pages value from config
 
@@ -338,7 +331,7 @@ class ConfigAnalyzer:
                 cwd=config_path.parent.parent,
                 capture_output=True,
                 text=True,
-                timeout=5
+                timeout=5,
             )
 
             if result.returncode == 0 and result.stdout.strip():
diff --git a/api/main.py b/api/main.py
index 27b8383..3274cd4 100644
--- a/api/main.py
+++ b/api/main.py
@@ -4,21 +4,20 @@ Skill Seekers Config API
 FastAPI backend for listing available skill configs
 """
 
-from fastapi import FastAPI, HTTPException
-from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import JSONResponse, FileResponse
-from typing import List, Dict, Any, Optional
-import os
 from pathlib import Path
+from typing import Any
 
 from config_analyzer import ConfigAnalyzer
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import FileResponse
 
 app = FastAPI(
     title="Skill Seekers Config API",
     description="API for discovering and downloading Skill Seekers configuration files",
     version="1.0.0",
     docs_url="/docs",
-    redoc_url="/redoc"
+    redoc_url="/redoc",
 )
 
 # CORS middleware - allow all origins for public API
@@ -54,16 +53,12 @@ async def root():
         },
         "repository": "https://github.com/yusufkaraaslan/Skill_Seekers",
         "configs_repository": "https://github.com/yusufkaraaslan/skill-seekers-configs",
-        "website": "https://api.skillseekersweb.com"
+        "website": "https://api.skillseekersweb.com",
     }
 
 
 @app.get("/api/configs")
-async def list_configs(
-    category: Optional[str] = None,
-    tag: Optional[str] = None,
-    type: Optional[str] = None
-) -> Dict[str, Any]:
+async def list_configs(category: str | None = None, tag: str | None = None, type: str | None = None) -> dict[str, Any]:
     """
     List all available configs with metadata
 
@@ -102,7 +97,7 @@ async def list_configs(
             "version": "1.0.0",
             "total": len(configs),
             "filters": filters_applied if filters_applied else None,
-            "configs": configs
+            "configs": configs,
         }
 
     except Exception as e:
@@ -110,7 +105,7 @@ async def list_configs(
 
 
 @app.get("/api/configs/{name}")
-async def get_config(name: str) -> Dict[str, Any]:
+async def get_config(name: str) -> dict[str, Any]:
     """
     Get detailed information about a specific config
 
@@ -124,10 +119,7 @@ async def get_config(name: str) -> Dict[str, Any]:
         config = analyzer.get_config_by_name(name)
 
         if not config:
-            raise HTTPException(
-                status_code=404,
-                detail=f"Config '{name}' not found"
-            )
+            raise HTTPException(status_code=404, detail=f"Config '{name}' not found")
 
         return config
 
@@ -138,7 +130,7 @@ async def get_config(name: str) -> Dict[str, Any]:
 
 
 @app.get("/api/categories")
-async def list_categories() -> Dict[str, Any]:
+async def list_categories() -> dict[str, Any]:
     """
     List all available categories with config counts
 
@@ -155,10 +147,7 @@ async def list_categories() -> Dict[str, Any]:
             cat = config.get("category", "uncategorized")
             category_counts[cat] = category_counts.get(cat, 0) + 1
 
-        return {
-            "total_categories": len(category_counts),
-            "categories": category_counts
-        }
+        return {"total_categories": len(category_counts), "categories": category_counts}
 
     except Exception as e:
         raise HTTPException(status_code=500, detail=f"Error analyzing categories: {str(e)}")
@@ -191,16 +180,9 @@ async def download_config(config_name: str):
             break
 
         if not config_path or not config_path.exists():
-            raise HTTPException(
-                status_code=404,
-                detail=f"Config file '{config_name}' not found"
-            )
+            raise HTTPException(status_code=404, detail=f"Config file '{config_name}' not found")
 
-        return FileResponse(
-            path=config_path,
-            media_type="application/json",
-            filename=config_name
-        )
+        return FileResponse(path=config_path, media_type="application/json", filename=config_name)
 
     except HTTPException:
         raise
@@ -216,4 +198,5 @@ async def health_check():
 
 if __name__ == "__main__":
     import uvicorn
+
     uvicorn.run(app, host="0.0.0.0", port=8000)
diff --git a/demo_conflicts.py b/demo_conflicts.py
index 776ad50..f83be4d 100644
--- a/demo_conflicts.py
+++ b/demo_conflicts.py
@@ -6,14 +6,13 @@ This demonstrates the unified scraper's ability to detect and report
 conflicts between documentation and code implementation.
 """
 
-import sys
 import json
+import sys
 from pathlib import Path
 
 # Add CLI to path
-sys.path.insert(0, str(Path(__file__).parent / 'cli'))
+sys.path.insert(0, str(Path(__file__).parent / "cli"))
 
-from conflict_detector import ConflictDetector
 
 print("=" * 70)
 print("UNIFIED SCRAPER - CONFLICT DETECTION DEMO")
@@ -26,11 +25,11 @@ print("   - Documentation APIs from example docs")
 print("   - Code APIs from example repository")
 print()
 
-with open('cli/conflicts.json', 'r') as f:
+with open("cli/conflicts.json") as f:
     conflicts_data = json.load(f)
 
-conflicts = conflicts_data['conflicts']
-summary = conflicts_data['summary']
+conflicts = conflicts_data["conflicts"]
+summary = conflicts_data["summary"]
 
 print(f"✅ Loaded {summary['total']} conflicts")
 print()
@@ -45,14 +44,14 @@ print(f"📊 **Total Conflicts**: {summary['total']}")
 print()
 
 print("**By Type:**")
-for conflict_type, count in summary['by_type'].items():
+for conflict_type, count in summary["by_type"].items():
     if count > 0:
         emoji = "📖" if conflict_type == "missing_in_docs" else "💻" if conflict_type == "missing_in_code" else "⚠️"
         print(f"   {emoji} {conflict_type}: {count}")
 print()
 
 print("**By Severity:**")
-for severity, count in summary['by_severity'].items():
+for severity, count in summary["by_severity"].items():
     if count > 0:
         emoji = "🔴" if severity == "high" else "🟡" if severity == "medium" else "🟢"
         print(f"   {emoji} {severity.upper()}: {count}")
@@ -65,9 +64,9 @@ print("=" * 70)
 print()
 
 # Group by severity
-high = [c for c in conflicts if c['severity'] == 'high']
-medium = [c for c in conflicts if c['severity'] == 'medium']
-low = [c for c in conflicts if c['severity'] == 'low']
+high = [c for c in conflicts if c["severity"] == "high"]
+medium = [c for c in conflicts if c["severity"] == "medium"]
+low = [c for c in conflicts if c["severity"] == "low"]
 
 # Show high severity first
 if high:
@@ -80,14 +79,14 @@ if high:
         print(f"**Issue**: {conflict['difference']}")
         print(f"**Suggestion**: {conflict['suggestion']}")
 
-        if conflict['docs_info']:
-            print(f"\n**Documented as**:")
+        if conflict["docs_info"]:
+            print("\n**Documented as**:")
             print(f"  Signature: {conflict['docs_info'].get('raw_signature', 'N/A')}")
 
-        if conflict['code_info']:
-            print(f"\n**Implemented as**:")
-            params = conflict['code_info'].get('parameters', [])
-            param_str = ', '.join(f"{p['name']}: {p.get('type_hint', 'Any')}" for p in params if p['name'] != 'self')
+        if conflict["code_info"]:
+            print("\n**Implemented as**:")
+            params = conflict["code_info"].get("parameters", [])
+            param_str = ", ".join(f"{p['name']}: {p.get('type_hint', 'Any')}" for p in params if p["name"] != "self")
             print(f"  Signature: {conflict['code_info']['name']}({param_str})")
             print(f"  Return type: {conflict['code_info'].get('return_type', 'None')}")
             print(f"  Location: {conflict['code_info'].get('source', 'N/A')}:{conflict['code_info'].get('line', '?')}")
@@ -103,7 +102,7 @@ if medium:
         print(f"**Type**: {conflict['type']}")
         print(f"**Issue**: {conflict['difference']}")
 
-        if conflict['code_info']:
+        if conflict["code_info"]:
             print(f"**Location**: {conflict['code_info'].get('source', 'N/A')}")
 
     if len(medium) > 3:
@@ -128,30 +127,30 @@ print()
 print(f"⚠️ **Conflict**: {example_conflict['difference']}")
 print()
 
-if example_conflict.get('docs_info'):
+if example_conflict.get("docs_info"):
     print("**Documentation says:**")
     print("```")
-    print(example_conflict['docs_info'].get('raw_signature', 'N/A'))
+    print(example_conflict["docs_info"].get("raw_signature", "N/A"))
     print("```")
     print()
 
-if example_conflict.get('code_info'):
+if example_conflict.get("code_info"):
     print("**Code implementation:**")
     print("```python")
-    params = example_conflict['code_info'].get('parameters', [])
+    params = example_conflict["code_info"].get("parameters", [])
     param_strs = []
     for p in params:
-        if p['name'] == 'self':
+        if p["name"] == "self":
             continue
-        param_str = p['name']
-        if p.get('type_hint'):
+        param_str = p["name"]
+        if p.get("type_hint"):
             param_str += f": {p['type_hint']}"
-        if p.get('default'):
+        if p.get("default"):
             param_str += f" = {p['default']}"
         param_strs.append(param_str)
 
     sig = f"def {example_conflict['code_info']['name']}({', '.join(param_strs)})"
-    if example_conflict['code_info'].get('return_type'):
+    if example_conflict["code_info"].get("return_type"):
         sig += f" -> {example_conflict['code_info']['return_type']}"
 
     print(sig)
diff --git a/examples/test_http_server.py b/examples/test_http_server.py
index 350f8a1..73799c3 100644
--- a/examples/test_http_server.py
+++ b/examples/test_http_server.py
@@ -10,8 +10,9 @@ Usage:
 
 import asyncio
 import subprocess
-import time
 import sys
+import time
+
 import requests
 
 
@@ -47,7 +48,7 @@ async def test_http_server():
         print("3. Testing health check endpoint...")
         response = requests.get("http://127.0.0.1:8765/health", timeout=5)
         if response.status_code == 200:
-            print(f"   ✓ Health check passed")
+            print("   ✓ Health check passed")
             print(f"   Response: {response.json()}")
         else:
             print(f"   ✗ Health check failed: {response.status_code}")
@@ -57,13 +58,11 @@ async def test_http_server():
         print("4. Testing SSE endpoint availability...")
         # Just check if the endpoint exists (full SSE testing requires MCP client)
         try:
-            response = requests.get(
-                "http://127.0.0.1:8765/sse", timeout=5, stream=True
-            )
+            response = requests.get("http://127.0.0.1:8765/sse", timeout=5, stream=True)
             print(f"   ✓ SSE endpoint is available (status: {response.status_code})")
         except Exception as e:
             print(f"   ℹ SSE endpoint response: {e}")
-            print(f"   (This is expected - full SSE testing requires MCP client)")
+            print("   (This is expected - full SSE testing requires MCP client)")
 
         print()
         print("=" * 60)
@@ -71,13 +70,13 @@ async def test_http_server():
         print("=" * 60)
         print()
         print("Server Configuration for Claude Desktop:")
-        print('{')
+        print("{")
         print('  "mcpServers": {')
         print('    "skill-seeker": {')
         print('      "url": "http://127.0.0.1:8765/sse"')
-        print('    }')
-        print('  }')
-        print('}')
+        print("    }")
+        print("  }")
+        print("}")
         print()
 
         return True
diff --git a/pyproject.toml b/pyproject.toml
index fbc2a14..af4907f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -167,10 +167,52 @@ exclude_lines = [
     "@abstractmethod",
 ]
 
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # Pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "ARG",    # flake8-unused-arguments
+    "SIM",    # flake8-simplify
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["skill_seekers"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = true
+ignore_missing_imports = true
+show_error_codes = true
+pretty = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+check_untyped_defs = false
+
 [dependency-groups]
 dev = [
     "pytest>=8.4.2",
     "pytest-asyncio>=0.24.0",
     "pytest-cov>=7.0.0",
     "coverage>=7.11.0",
+    "ruff>=0.14.13",
+    "mypy>=1.19.1",
 ]
diff --git a/src/skill_seekers/cli/adaptors/__init__.py b/src/skill_seekers/cli/adaptors/__init__.py
index 92cae46..8207298 100644
--- a/src/skill_seekers/cli/adaptors/__init__.py
+++ b/src/skill_seekers/cli/adaptors/__init__.py
@@ -33,17 +33,17 @@ except ImportError:
 
 
 # Registry of available adaptors
-ADAPTORS: Dict[str, Type[SkillAdaptor]] = {}
+ADAPTORS: dict[str, type[SkillAdaptor]] = {}
 
 # Register adaptors that are implemented
 if ClaudeAdaptor:
-    ADAPTORS['claude'] = ClaudeAdaptor
+    ADAPTORS["claude"] = ClaudeAdaptor
 if GeminiAdaptor:
-    ADAPTORS['gemini'] = GeminiAdaptor
+    ADAPTORS["gemini"] = GeminiAdaptor
 if OpenAIAdaptor:
-    ADAPTORS['openai'] = OpenAIAdaptor
+    ADAPTORS["openai"] = OpenAIAdaptor
 if MarkdownAdaptor:
-    ADAPTORS['markdown'] = MarkdownAdaptor
+    ADAPTORS["markdown"] = MarkdownAdaptor
 
 
 def get_adaptor(platform: str, config: dict = None) -> SkillAdaptor:
@@ -65,15 +65,11 @@ def get_adaptor(platform: str, config: dict = None) -> SkillAdaptor:
         >>> adaptor = get_adaptor('gemini', {'api_version': 'v1beta'})
     """
     if platform not in ADAPTORS:
-        available = ', '.join(ADAPTORS.keys())
+        available = ", ".join(ADAPTORS.keys())
         if not ADAPTORS:
-            raise ValueError(
-                f"No adaptors are currently implemented. "
-                f"Platform '{platform}' is not available."
-            )
+            raise ValueError(f"No adaptors are currently implemented. Platform '{platform}' is not available.")
         raise ValueError(
-            f"Platform '{platform}' is not supported or not yet implemented. "
-            f"Available platforms: {available}"
+            f"Platform '{platform}' is not supported or not yet implemented. Available platforms: {available}"
         )
 
     adaptor_class = ADAPTORS[platform]
@@ -115,10 +111,10 @@ def is_platform_available(platform: str) -> bool:
 
 # Export public interface
 __all__ = [
-    'SkillAdaptor',
-    'SkillMetadata',
-    'get_adaptor',
-    'list_platforms',
-    'is_platform_available',
-    'ADAPTORS',
+    "SkillAdaptor",
+    "SkillMetadata",
+    "get_adaptor",
+    "list_platforms",
+    "is_platform_available",
+    "ADAPTORS",
 ]
diff --git a/src/skill_seekers/cli/adaptors/base.py b/src/skill_seekers/cli/adaptors/base.py
index f390503..fdfabff 100644
--- a/src/skill_seekers/cli/adaptors/base.py
+++ b/src/skill_seekers/cli/adaptors/base.py
@@ -7,18 +7,19 @@ This enables Skill Seekers to generate skills for multiple LLM platforms (Claude
 """
 
 from abc import ABC, abstractmethod
-from pathlib import Path
-from typing import Dict, Any, Optional
 from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
 
 
 @dataclass
 class SkillMetadata:
     """Universal skill metadata used across all platforms"""
+
     name: str
     description: str
     version: str = "1.0.0"
-    author: Optional[str] = None
+    author: str | None = None
     tags: list[str] = field(default_factory=list)
 
 
@@ -34,11 +35,11 @@ class SkillAdaptor(ABC):
     """
 
     # Platform identifiers (override in subclasses)
-    PLATFORM: str = "unknown"              # e.g., "claude", "gemini", "openai"
-    PLATFORM_NAME: str = "Unknown"          # e.g., "Claude AI (Anthropic)"
-    DEFAULT_API_ENDPOINT: Optional[str] = None
+    PLATFORM: str = "unknown"  # e.g., "claude", "gemini", "openai"
+    PLATFORM_NAME: str = "Unknown"  # e.g., "Claude AI (Anthropic)"
+    DEFAULT_API_ENDPOINT: str | None = None
 
-    def __init__(self, config: Optional[Dict[str, Any]] = None):
+    def __init__(self, config: dict[str, Any] | None = None):
         """
         Initialize adaptor with optional configuration.
 
@@ -86,7 +87,7 @@ class SkillAdaptor(ABC):
         pass
 
     @abstractmethod
-    def upload(self, package_path: Path, api_key: str, **kwargs) -> Dict[str, Any]:
+    def upload(self, package_path: Path, api_key: str, **kwargs) -> dict[str, Any]:
         """
         Upload packaged skill to platform.
 
@@ -168,11 +169,11 @@ class SkillAdaptor(ABC):
         if not skill_md_path.exists():
             return ""
 
-        content = skill_md_path.read_text(encoding='utf-8')
+        content = skill_md_path.read_text(encoding="utf-8")
 
         # Strip YAML frontmatter if present
-        if content.startswith('---'):
-            parts = content.split('---', 2)
+        if content.startswith("---"):
+            parts = content.split("---", 2)
             if len(parts) >= 3:
                 return parts[2].strip()
 
@@ -193,7 +194,7 @@ class SkillAdaptor(ABC):
             return "See references/ directory for documentation."
 
         # Read index and extract relevant sections
-        content = index_path.read_text(encoding='utf-8')
+        content = index_path.read_text(encoding="utf-8")
         return content[:500] + "..." if len(content) > 500 else content
 
     def _generate_toc(self, skill_dir: Path) -> str:
@@ -214,7 +215,7 @@ class SkillAdaptor(ABC):
         for ref_file in sorted(refs_dir.glob("*.md")):
             if ref_file.name == "index.md":
                 continue
-            title = ref_file.stem.replace('_', ' ').title()
+            title = ref_file.stem.replace("_", " ").title()
             toc_lines.append(f"- [{title}](references/{ref_file.name})")
 
         return "\n".join(toc_lines)
diff --git a/src/skill_seekers/cli/adaptors/claude.py b/src/skill_seekers/cli/adaptors/claude.py
index 267a69f..4e97a40 100644
--- a/src/skill_seekers/cli/adaptors/claude.py
+++ b/src/skill_seekers/cli/adaptors/claude.py
@@ -6,10 +6,9 @@ Implements platform-specific handling for Claude AI (Anthropic) skills.
 Refactored from upload_skill.py and enhance_skill.py.
 """
 
-import os
 import zipfile
 from pathlib import Path
-from typing import Dict, Any
+from typing import Any
 
 from .base import SkillAdaptor, SkillMetadata
 
@@ -101,16 +100,16 @@ version: {metadata.version}
         skill_dir = Path(skill_dir)
 
         # Determine output filename
-        if output_path.is_dir() or str(output_path).endswith('/'):
+        if output_path.is_dir() or str(output_path).endswith("/"):
             output_path = Path(output_path) / f"{skill_dir.name}.zip"
-        elif not str(output_path).endswith('.zip'):
-            output_path = Path(str(output_path) + '.zip')
+        elif not str(output_path).endswith(".zip"):
+            output_path = Path(str(output_path) + ".zip")
 
         output_path = Path(output_path)
         output_path.parent.mkdir(parents=True, exist_ok=True)
 
         # Create ZIP file
-        with zipfile.ZipFile(output_path, 'w', zipfile.ZIP_DEFLATED) as zf:
+        with zipfile.ZipFile(output_path, "w", zipfile.ZIP_DEFLATED) as zf:
             # Add SKILL.md (required)
             skill_md = skill_dir / "SKILL.md"
             if skill_md.exists():
@@ -120,7 +119,7 @@ version: {metadata.version}
             refs_dir = skill_dir / "references"
             if refs_dir.exists():
                 for ref_file in refs_dir.rglob("*"):
-                    if ref_file.is_file() and not ref_file.name.startswith('.'):
+                    if ref_file.is_file() and not ref_file.name.startswith("."):
                         arcname = ref_file.relative_to(skill_dir)
                         zf.write(ref_file, str(arcname))
 
@@ -128,7 +127,7 @@ version: {metadata.version}
             scripts_dir = skill_dir / "scripts"
             if scripts_dir.exists():
                 for script_file in scripts_dir.rglob("*"):
-                    if script_file.is_file() and not script_file.name.startswith('.'):
+                    if script_file.is_file() and not script_file.name.startswith("."):
                         arcname = script_file.relative_to(skill_dir)
                         zf.write(script_file, str(arcname))
 
@@ -136,13 +135,13 @@ version: {metadata.version}
             assets_dir = skill_dir / "assets"
             if assets_dir.exists():
                 for asset_file in assets_dir.rglob("*"):
-                    if asset_file.is_file() and not asset_file.name.startswith('.'):
+                    if asset_file.is_file() and not asset_file.name.startswith("."):
                         arcname = asset_file.relative_to(skill_dir)
                         zf.write(asset_file, str(arcname))
 
         return output_path
 
-    def upload(self, package_path: Path, api_key: str, **kwargs) -> Dict[str, Any]:
+    def upload(self, package_path: Path, api_key: str, **kwargs) -> dict[str, Any]:
         """
         Upload skill ZIP to Anthropic Skills API.
 
@@ -159,130 +158,99 @@ version: {metadata.version}
             import requests
         except ImportError:
             return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': 'requests library not installed. Run: pip install requests'
+                "success": False,
+                "skill_id": None,
+                "url": None,
+                "message": "requests library not installed. Run: pip install requests",
             }
 
         # Validate ZIP file
         package_path = Path(package_path)
         if not package_path.exists():
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'File not found: {package_path}'
-            }
+            return {"success": False, "skill_id": None, "url": None, "message": f"File not found: {package_path}"}
 
-        if not package_path.suffix == '.zip':
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'Not a ZIP file: {package_path}'
-            }
+        if not package_path.suffix == ".zip":
+            return {"success": False, "skill_id": None, "url": None, "message": f"Not a ZIP file: {package_path}"}
 
         # Prepare API request
         api_url = self.DEFAULT_API_ENDPOINT
-        headers = {
-            "x-api-key": api_key,
-            "anthropic-version": "2023-06-01",
-            "anthropic-beta": "skills-2025-10-02"
-        }
+        headers = {"x-api-key": api_key, "anthropic-version": "2023-06-01", "anthropic-beta": "skills-2025-10-02"}
 
-        timeout = kwargs.get('timeout', 60)
+        timeout = kwargs.get("timeout", 60)
 
         try:
             # Read ZIP file
-            with open(package_path, 'rb') as f:
+            with open(package_path, "rb") as f:
                 zip_data = f.read()
 
             # Upload skill
-            files = {
-                'files[]': (package_path.name, zip_data, 'application/zip')
-            }
+            files = {"files[]": (package_path.name, zip_data, "application/zip")}
 
-            response = requests.post(
-                api_url,
-                headers=headers,
-                files=files,
-                timeout=timeout
-            )
+            response = requests.post(api_url, headers=headers, files=files, timeout=timeout)
 
             # Check response
             if response.status_code == 200:
                 # Extract skill ID if available
                 try:
                     response_data = response.json()
-                    skill_id = response_data.get('id')
+                    skill_id = response_data.get("id")
                 except:
                     skill_id = None
 
                 return {
-                    'success': True,
-                    'skill_id': skill_id,
-                    'url': 'https://claude.ai/skills',
-                    'message': 'Skill uploaded successfully to Claude AI'
+                    "success": True,
+                    "skill_id": skill_id,
+                    "url": "https://claude.ai/skills",
+                    "message": "Skill uploaded successfully to Claude AI",
                 }
 
             elif response.status_code == 401:
                 return {
-                    'success': False,
-                    'skill_id': None,
-                    'url': None,
-                    'message': 'Authentication failed. Check your ANTHROPIC_API_KEY'
+                    "success": False,
+                    "skill_id": None,
+                    "url": None,
+                    "message": "Authentication failed. Check your ANTHROPIC_API_KEY",
                 }
 
             elif response.status_code == 400:
                 try:
-                    error_msg = response.json().get('error', {}).get('message', 'Unknown error')
+                    error_msg = response.json().get("error", {}).get("message", "Unknown error")
                 except:
-                    error_msg = 'Invalid skill format'
+                    error_msg = "Invalid skill format"
 
                 return {
-                    'success': False,
-                    'skill_id': None,
-                    'url': None,
-                    'message': f'Invalid skill format: {error_msg}'
+                    "success": False,
+                    "skill_id": None,
+                    "url": None,
+                    "message": f"Invalid skill format: {error_msg}",
                 }
 
             else:
                 try:
-                    error_msg = response.json().get('error', {}).get('message', 'Unknown error')
+                    error_msg = response.json().get("error", {}).get("message", "Unknown error")
                 except:
-                    error_msg = f'HTTP {response.status_code}'
+                    error_msg = f"HTTP {response.status_code}"
 
-                return {
-                    'success': False,
-                    'skill_id': None,
-                    'url': None,
-                    'message': f'Upload failed: {error_msg}'
-                }
+                return {"success": False, "skill_id": None, "url": None, "message": f"Upload failed: {error_msg}"}
 
         except requests.exceptions.Timeout:
             return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': 'Upload timed out. Try again or use manual upload'
+                "success": False,
+                "skill_id": None,
+                "url": None,
+                "message": "Upload timed out. Try again or use manual upload",
             }
 
         except requests.exceptions.ConnectionError:
             return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': 'Connection error. Check your internet connection'
+                "success": False,
+                "skill_id": None,
+                "url": None,
+                "message": "Connection error. Check your internet connection",
             }
 
         except Exception as e:
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'Unexpected error: {str(e)}'
-            }
+            return {"success": False, "skill_id": None, "url": None, "message": f"Unexpected error: {str(e)}"}
 
     def validate_api_key(self, api_key: str) -> bool:
         """
@@ -294,7 +262,7 @@ version: {metadata.version}
         Returns:
             True if key starts with 'sk-ant-'
         """
-        return api_key.strip().startswith('sk-ant-')
+        return api_key.strip().startswith("sk-ant-")
 
     def get_env_var_name(self) -> str:
         """
@@ -355,17 +323,13 @@ version: {metadata.version}
         # Read current SKILL.md
         current_skill_md = None
         if skill_md_path.exists():
-            current_skill_md = skill_md_path.read_text(encoding='utf-8')
+            current_skill_md = skill_md_path.read_text(encoding="utf-8")
             print(f"  ℹ Found existing SKILL.md ({len(current_skill_md)} chars)")
         else:
-            print(f"  ℹ No existing SKILL.md, will create new one")
+            print("  ℹ No existing SKILL.md, will create new one")
 
         # Build enhancement prompt
-        prompt = self._build_enhancement_prompt(
-            skill_dir.name,
-            references,
-            current_skill_md
-        )
+        prompt = self._build_enhancement_prompt(skill_dir.name, references, current_skill_md)
 
         print("\n🤖 Asking Claude to enhance SKILL.md...")
         print(f"   Input: {len(prompt):,} characters")
@@ -377,10 +341,7 @@ version: {metadata.version}
                 model="claude-sonnet-4-20250514",
                 max_tokens=4096,
                 temperature=0.3,
-                messages=[{
-                    "role": "user",
-                    "content": prompt
-                }]
+                messages=[{"role": "user", "content": prompt}],
             )
 
             enhanced_content = message.content[0].text
@@ -388,13 +349,13 @@ version: {metadata.version}
 
             # Backup original
             if skill_md_path.exists():
-                backup_path = skill_md_path.with_suffix('.md.backup')
+                backup_path = skill_md_path.with_suffix(".md.backup")
                 skill_md_path.rename(backup_path)
                 print(f"  💾 Backed up original to: {backup_path.name}")
 
             # Save enhanced version
-            skill_md_path.write_text(enhanced_content, encoding='utf-8')
-            print(f"  ✅ Saved enhanced SKILL.md")
+            skill_md_path.write_text(enhanced_content, encoding="utf-8")
+            print("  ✅ Saved enhanced SKILL.md")
 
             return True
 
@@ -402,7 +363,7 @@ version: {metadata.version}
             print(f"❌ Error calling Claude API: {e}")
             return False
 
-    def _read_reference_files(self, references_dir: Path, max_chars: int = 200000) -> Dict[str, str]:
+    def _read_reference_files(self, references_dir: Path, max_chars: int = 200000) -> dict[str, str]:
         """
         Read reference markdown files from skill directory.
 
@@ -425,7 +386,7 @@ version: {metadata.version}
                 break
 
             try:
-                content = ref_file.read_text(encoding='utf-8')
+                content = ref_file.read_text(encoding="utf-8")
                 # Limit individual file size
                 if len(content) > 30000:
                     content = content[:30000] + "\n\n...(truncated)"
@@ -439,10 +400,7 @@ version: {metadata.version}
         return references
 
     def _build_enhancement_prompt(
-        self,
-        skill_name: str,
-        references: Dict[str, str],
-        current_skill_md: str = None
+        self, skill_name: str, references: dict[str, str], current_skill_md: str = None
     ) -> str:
         """
         Build Claude API prompt for enhancement.
@@ -460,9 +418,9 @@ version: {metadata.version}
 I've scraped documentation and organized it into reference files. Your job is to create an EXCELLENT SKILL.md that will help Claude use this documentation effectively.
 
 CURRENT SKILL.MD:
-{'```markdown' if current_skill_md else '(none - create from scratch)'}
-{current_skill_md or 'No existing SKILL.md'}
-{'```' if current_skill_md else ''}
+{"```markdown" if current_skill_md else "(none - create from scratch)"}
+{current_skill_md or "No existing SKILL.md"}
+{"```" if current_skill_md else ""}
 
 REFERENCE DOCUMENTATION:
 """
diff --git a/src/skill_seekers/cli/adaptors/gemini.py b/src/skill_seekers/cli/adaptors/gemini.py
index 5d361dd..be5a396 100644
--- a/src/skill_seekers/cli/adaptors/gemini.py
+++ b/src/skill_seekers/cli/adaptors/gemini.py
@@ -6,11 +6,11 @@ Implements platform-specific handling for Google Gemini skills.
 Uses Gemini Files API for grounding and Gemini 2.0 Flash for enhancement.
 """
 
+import json
 import os
 import tarfile
-import json
 from pathlib import Path
-from typing import Dict, Any
+from typing import Any
 
 from .base import SkillAdaptor, SkillMetadata
 
@@ -105,20 +105,20 @@ See the references directory for complete documentation with examples and best p
         skill_dir = Path(skill_dir)
 
         # Determine output filename
-        if output_path.is_dir() or str(output_path).endswith('/'):
+        if output_path.is_dir() or str(output_path).endswith("/"):
             output_path = Path(output_path) / f"{skill_dir.name}-gemini.tar.gz"
-        elif not str(output_path).endswith('.tar.gz'):
+        elif not str(output_path).endswith(".tar.gz"):
             # Replace .zip with .tar.gz if needed
-            output_str = str(output_path).replace('.zip', '.tar.gz')
-            if not output_str.endswith('.tar.gz'):
-                output_str += '.tar.gz'
+            output_str = str(output_path).replace(".zip", ".tar.gz")
+            if not output_str.endswith(".tar.gz"):
+                output_str += ".tar.gz"
             output_path = Path(output_str)
 
         output_path = Path(output_path)
         output_path.parent.mkdir(parents=True, exist_ok=True)
 
         # Create tar.gz file
-        with tarfile.open(output_path, 'w:gz') as tar:
+        with tarfile.open(output_path, "w:gz") as tar:
             # Add SKILL.md as system_instructions.md
             skill_md = skill_dir / "SKILL.md"
             if skill_md.exists():
@@ -128,21 +128,22 @@ See the references directory for complete documentation with examples and best p
             refs_dir = skill_dir / "references"
             if refs_dir.exists():
                 for ref_file in refs_dir.rglob("*"):
-                    if ref_file.is_file() and not ref_file.name.startswith('.'):
+                    if ref_file.is_file() and not ref_file.name.startswith("."):
                         arcname = ref_file.relative_to(skill_dir)
                         tar.add(ref_file, arcname=str(arcname))
 
             # Create and add metadata file
             metadata = {
-                'platform': 'gemini',
-                'name': skill_dir.name,
-                'version': '1.0.0',
-                'created_with': 'skill-seekers'
+                "platform": "gemini",
+                "name": skill_dir.name,
+                "version": "1.0.0",
+                "created_with": "skill-seekers",
             }
 
             # Write metadata to temp file and add to archive
             import tempfile
-            with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as tmp:
+
+            with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as tmp:
                 json.dump(metadata, tmp, indent=2)
                 tmp_path = tmp.name
 
@@ -153,7 +154,7 @@ See the references directory for complete documentation with examples and best p
 
         return output_path
 
-    def upload(self, package_path: Path, api_key: str, **kwargs) -> Dict[str, Any]:
+    def upload(self, package_path: Path, api_key: str, **kwargs) -> dict[str, Any]:
         """
         Upload skill tar.gz to Gemini Files API.
 
@@ -168,30 +169,20 @@ See the references directory for complete documentation with examples and best p
         # Validate package file FIRST
         package_path = Path(package_path)
         if not package_path.exists():
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'File not found: {package_path}'
-            }
+            return {"success": False, "skill_id": None, "url": None, "message": f"File not found: {package_path}"}
 
-        if not package_path.suffix == '.gz':
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'Not a tar.gz file: {package_path}'
-            }
+        if not package_path.suffix == ".gz":
+            return {"success": False, "skill_id": None, "url": None, "message": f"Not a tar.gz file: {package_path}"}
 
         # Check for google-generativeai library
         try:
             import google.generativeai as genai
         except ImportError:
             return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': 'google-generativeai library not installed. Run: pip install google-generativeai'
+                "success": False,
+                "skill_id": None,
+                "url": None,
+                "message": "google-generativeai library not installed. Run: pip install google-generativeai",
             }
 
         # Configure Gemini
@@ -200,11 +191,10 @@ See the references directory for complete documentation with examples and best p
 
             # Extract tar.gz to temp directory
             import tempfile
-            import shutil
 
             with tempfile.TemporaryDirectory() as temp_dir:
                 # Extract archive
-                with tarfile.open(package_path, 'r:gz') as tar:
+                with tarfile.open(package_path, "r:gz") as tar:
                     tar.extractall(temp_dir)
 
                 temp_path = Path(temp_dir)
@@ -213,17 +203,14 @@ See the references directory for complete documentation with examples and best p
                 main_file = temp_path / "system_instructions.md"
                 if not main_file.exists():
                     return {
-                        'success': False,
-                        'skill_id': None,
-                        'url': None,
-                        'message': 'Invalid package: system_instructions.md not found'
+                        "success": False,
+                        "skill_id": None,
+                        "url": None,
+                        "message": "Invalid package: system_instructions.md not found",
                     }
 
                 # Upload to Files API
-                uploaded_file = genai.upload_file(
-                    path=str(main_file),
-                    display_name=f"{package_path.stem}_instructions"
-                )
+                uploaded_file = genai.upload_file(path=str(main_file), display_name=f"{package_path.stem}_instructions")
 
                 # Upload reference files (if any)
                 refs_dir = temp_path / "references"
@@ -231,25 +218,19 @@ See the references directory for complete documentation with examples and best p
                 if refs_dir.exists():
                     for ref_file in refs_dir.glob("*.md"):
                         ref_uploaded = genai.upload_file(
-                            path=str(ref_file),
-                            display_name=f"{package_path.stem}_{ref_file.stem}"
+                            path=str(ref_file), display_name=f"{package_path.stem}_{ref_file.stem}"
                         )
                         uploaded_refs.append(ref_uploaded.name)
 
             return {
-                'success': True,
-                'skill_id': uploaded_file.name,
-                'url': f"https://aistudio.google.com/app/files/{uploaded_file.name}",
-                'message': f'Skill uploaded to Google AI Studio ({len(uploaded_refs) + 1} files)'
+                "success": True,
+                "skill_id": uploaded_file.name,
+                "url": f"https://aistudio.google.com/app/files/{uploaded_file.name}",
+                "message": f"Skill uploaded to Google AI Studio ({len(uploaded_refs) + 1} files)",
             }
 
         except Exception as e:
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'Upload failed: {str(e)}'
-            }
+            return {"success": False, "skill_id": None, "url": None, "message": f"Upload failed: {str(e)}"}
 
     def validate_api_key(self, api_key: str) -> bool:
         """
@@ -261,7 +242,7 @@ See the references directory for complete documentation with examples and best p
         Returns:
             True if key starts with 'AIza'
         """
-        return api_key.strip().startswith('AIza')
+        return api_key.strip().startswith("AIza")
 
     def get_env_var_name(self) -> str:
         """
@@ -319,17 +300,13 @@ See the references directory for complete documentation with examples and best p
         # Read current SKILL.md
         current_skill_md = None
         if skill_md_path.exists():
-            current_skill_md = skill_md_path.read_text(encoding='utf-8')
+            current_skill_md = skill_md_path.read_text(encoding="utf-8")
             print(f"  ℹ Found existing SKILL.md ({len(current_skill_md)} chars)")
         else:
-            print(f"  ℹ No existing SKILL.md, will create new one")
+            print("  ℹ No existing SKILL.md, will create new one")
 
         # Build enhancement prompt
-        prompt = self._build_enhancement_prompt(
-            skill_dir.name,
-            references,
-            current_skill_md
-        )
+        prompt = self._build_enhancement_prompt(skill_dir.name, references, current_skill_md)
 
         print("\n🤖 Asking Gemini to enhance SKILL.md...")
         print(f"   Input: {len(prompt):,} characters")
@@ -337,7 +314,7 @@ See the references directory for complete documentation with examples and best p
         try:
             genai.configure(api_key=api_key)
 
-            model = genai.GenerativeModel('gemini-2.0-flash-exp')
+            model = genai.GenerativeModel("gemini-2.0-flash-exp")
 
             response = model.generate_content(prompt)
 
@@ -346,13 +323,13 @@ See the references directory for complete documentation with examples and best p
 
             # Backup original
             if skill_md_path.exists():
-                backup_path = skill_md_path.with_suffix('.md.backup')
+                backup_path = skill_md_path.with_suffix(".md.backup")
                 skill_md_path.rename(backup_path)
                 print(f"  💾 Backed up original to: {backup_path.name}")
 
             # Save enhanced version
-            skill_md_path.write_text(enhanced_content, encoding='utf-8')
-            print(f"  ✅ Saved enhanced SKILL.md")
+            skill_md_path.write_text(enhanced_content, encoding="utf-8")
+            print("  ✅ Saved enhanced SKILL.md")
 
             return True
 
@@ -360,7 +337,7 @@ See the references directory for complete documentation with examples and best p
             print(f"❌ Error calling Gemini API: {e}")
             return False
 
-    def _read_reference_files(self, references_dir: Path, max_chars: int = 200000) -> Dict[str, str]:
+    def _read_reference_files(self, references_dir: Path, max_chars: int = 200000) -> dict[str, str]:
         """
         Read reference markdown files from skill directory.
 
@@ -383,7 +360,7 @@ See the references directory for complete documentation with examples and best p
                 break
 
             try:
-                content = ref_file.read_text(encoding='utf-8')
+                content = ref_file.read_text(encoding="utf-8")
                 # Limit individual file size
                 if len(content) > 30000:
                     content = content[:30000] + "\n\n...(truncated)"
@@ -397,10 +374,7 @@ See the references directory for complete documentation with examples and best p
         return references
 
     def _build_enhancement_prompt(
-        self,
-        skill_name: str,
-        references: Dict[str, str],
-        current_skill_md: str = None
+        self, skill_name: str, references: dict[str, str], current_skill_md: str = None
     ) -> str:
         """
         Build Gemini API prompt for enhancement.
@@ -418,9 +392,9 @@ See the references directory for complete documentation with examples and best p
 I've scraped documentation and organized it into reference files. Your job is to create an EXCELLENT markdown documentation file that will help Gemini use this documentation effectively.
 
 CURRENT DOCUMENTATION:
-{'```markdown' if current_skill_md else '(none - create from scratch)'}
-{current_skill_md or 'No existing documentation'}
-{'```' if current_skill_md else ''}
+{"```markdown" if current_skill_md else "(none - create from scratch)"}
+{current_skill_md or "No existing documentation"}
+{"```" if current_skill_md else ""}
 
 REFERENCE DOCUMENTATION:
 """
diff --git a/src/skill_seekers/cli/adaptors/markdown.py b/src/skill_seekers/cli/adaptors/markdown.py
index 2d534ba..323d3e9 100644
--- a/src/skill_seekers/cli/adaptors/markdown.py
+++ b/src/skill_seekers/cli/adaptors/markdown.py
@@ -8,7 +8,7 @@ No platform-specific features, just clean markdown documentation.
 
 import zipfile
 from pathlib import Path
-from typing import Dict, Any
+from typing import Any
 
 from .base import SkillAdaptor, SkillMetadata
 
@@ -100,33 +100,33 @@ Browse the reference files for detailed information on each topic. All files are
         skill_dir = Path(skill_dir)
 
         # Determine output filename
-        if output_path.is_dir() or str(output_path).endswith('/'):
+        if output_path.is_dir() or str(output_path).endswith("/"):
             output_path = Path(output_path) / f"{skill_dir.name}-markdown.zip"
-        elif not str(output_path).endswith('.zip'):
+        elif not str(output_path).endswith(".zip"):
             # Replace extension if needed
-            output_str = str(output_path).replace('.tar.gz', '.zip')
-            if not output_str.endswith('-markdown.zip'):
-                output_str = output_str.replace('.zip', '-markdown.zip')
-            if not output_str.endswith('.zip'):
-                output_str += '.zip'
+            output_str = str(output_path).replace(".tar.gz", ".zip")
+            if not output_str.endswith("-markdown.zip"):
+                output_str = output_str.replace(".zip", "-markdown.zip")
+            if not output_str.endswith(".zip"):
+                output_str += ".zip"
             output_path = Path(output_str)
 
         output_path = Path(output_path)
         output_path.parent.mkdir(parents=True, exist_ok=True)
 
         # Create ZIP file
-        with zipfile.ZipFile(output_path, 'w', zipfile.ZIP_DEFLATED) as zf:
+        with zipfile.ZipFile(output_path, "w", zipfile.ZIP_DEFLATED) as zf:
             # Add SKILL.md as README.md
             skill_md = skill_dir / "SKILL.md"
             if skill_md.exists():
-                content = skill_md.read_text(encoding='utf-8')
+                content = skill_md.read_text(encoding="utf-8")
                 zf.writestr("README.md", content)
 
             # Add individual reference files
             refs_dir = skill_dir / "references"
             if refs_dir.exists():
                 for ref_file in refs_dir.rglob("*.md"):
-                    if ref_file.is_file() and not ref_file.name.startswith('.'):
+                    if ref_file.is_file() and not ref_file.name.startswith("."):
                         # Preserve directory structure under references/
                         arcname = ref_file.relative_to(skill_dir)
                         zf.write(ref_file, str(arcname))
@@ -138,20 +138,21 @@ Browse the reference files for detailed information on each topic. All files are
 
             # Add metadata file
             import json
+
             metadata = {
-                'platform': 'markdown',
-                'name': skill_dir.name,
-                'version': '1.0.0',
-                'created_with': 'skill-seekers',
-                'format': 'universal_markdown',
-                'usage': 'Use with any LLM or documentation system'
+                "platform": "markdown",
+                "name": skill_dir.name,
+                "version": "1.0.0",
+                "created_with": "skill-seekers",
+                "format": "universal_markdown",
+                "usage": "Use with any LLM or documentation system",
             }
 
             zf.writestr("metadata.json", json.dumps(metadata, indent=2))
 
         return output_path
 
-    def upload(self, package_path: Path, api_key: str, **kwargs) -> Dict[str, Any]:
+    def upload(self, package_path: Path, api_key: str, **kwargs) -> dict[str, Any]:
         """
         Generic markdown export does not support upload.
 
@@ -166,13 +167,13 @@ Browse the reference files for detailed information on each topic. All files are
             Result indicating no upload capability
         """
         return {
-            'success': False,
-            'skill_id': None,
-            'url': str(package_path.absolute()),
-            'message': (
-                'Generic markdown export does not support automatic upload. '
-                f'Your documentation is packaged at: {package_path.absolute()}'
-            )
+            "success": False,
+            "skill_id": None,
+            "url": str(package_path.absolute()),
+            "message": (
+                "Generic markdown export does not support automatic upload. "
+                f"Your documentation is packaged at: {package_path.absolute()}"
+            ),
         }
 
     def validate_api_key(self, api_key: str) -> bool:
@@ -237,10 +238,10 @@ Browse the reference files for detailed information on each topic. All files are
 
         # Add main content
         if skill_md.exists():
-            content = skill_md.read_text(encoding='utf-8')
+            content = skill_md.read_text(encoding="utf-8")
             # Strip YAML frontmatter if present
-            if content.startswith('---'):
-                parts = content.split('---', 2)
+            if content.startswith("---"):
+                parts = content.split("---", 2)
                 if len(parts) >= 3:
                     content = parts[2].strip()
             combined_parts.append(content)
@@ -258,7 +259,7 @@ Browse the reference files for detailed information on each topic. All files are
                     continue  # Skip index
 
                 try:
-                    ref_content = ref_file.read_text(encoding='utf-8')
+                    ref_content = ref_file.read_text(encoding="utf-8")
                     combined_parts.append(f"# {ref_file.stem.replace('_', ' ').title()}\n\n")
                     combined_parts.append(ref_content)
                     combined_parts.append("\n\n---\n\n")
diff --git a/src/skill_seekers/cli/adaptors/openai.py b/src/skill_seekers/cli/adaptors/openai.py
index 4fbbd1c..c272f51 100644
--- a/src/skill_seekers/cli/adaptors/openai.py
+++ b/src/skill_seekers/cli/adaptors/openai.py
@@ -6,11 +6,10 @@ Implements platform-specific handling for OpenAI ChatGPT Assistants.
 Uses Assistants API with Vector Store for file search.
 """
 
-import os
-import zipfile
 import json
+import zipfile
 from pathlib import Path
-from typing import Dict, Any
+from typing import Any
 
 from .base import SkillAdaptor, SkillMetadata
 
@@ -123,51 +122,51 @@ Always prioritize accuracy by consulting the attached documentation files before
         skill_dir = Path(skill_dir)
 
         # Determine output filename
-        if output_path.is_dir() or str(output_path).endswith('/'):
+        if output_path.is_dir() or str(output_path).endswith("/"):
             output_path = Path(output_path) / f"{skill_dir.name}-openai.zip"
-        elif not str(output_path).endswith('.zip'):
+        elif not str(output_path).endswith(".zip"):
             # Keep .zip extension
-            if not str(output_path).endswith('-openai.zip'):
-                output_str = str(output_path).replace('.zip', '-openai.zip')
-                if not output_str.endswith('.zip'):
-                    output_str += '.zip'
+            if not str(output_path).endswith("-openai.zip"):
+                output_str = str(output_path).replace(".zip", "-openai.zip")
+                if not output_str.endswith(".zip"):
+                    output_str += ".zip"
                 output_path = Path(output_str)
 
         output_path = Path(output_path)
         output_path.parent.mkdir(parents=True, exist_ok=True)
 
         # Create ZIP file
-        with zipfile.ZipFile(output_path, 'w', zipfile.ZIP_DEFLATED) as zf:
+        with zipfile.ZipFile(output_path, "w", zipfile.ZIP_DEFLATED) as zf:
             # Add SKILL.md as assistant_instructions.txt
             skill_md = skill_dir / "SKILL.md"
             if skill_md.exists():
-                instructions = skill_md.read_text(encoding='utf-8')
+                instructions = skill_md.read_text(encoding="utf-8")
                 zf.writestr("assistant_instructions.txt", instructions)
 
             # Add references directory as vector_store_files/
             refs_dir = skill_dir / "references"
             if refs_dir.exists():
                 for ref_file in refs_dir.rglob("*.md"):
-                    if ref_file.is_file() and not ref_file.name.startswith('.'):
+                    if ref_file.is_file() and not ref_file.name.startswith("."):
                         # Place all reference files in vector_store_files/
                         arcname = f"vector_store_files/{ref_file.name}"
                         zf.write(ref_file, arcname)
 
             # Create and add metadata file
             metadata = {
-                'platform': 'openai',
-                'name': skill_dir.name,
-                'version': '1.0.0',
-                'created_with': 'skill-seekers',
-                'model': 'gpt-4o',
-                'tools': ['file_search']
+                "platform": "openai",
+                "name": skill_dir.name,
+                "version": "1.0.0",
+                "created_with": "skill-seekers",
+                "model": "gpt-4o",
+                "tools": ["file_search"],
             }
 
             zf.writestr("openai_metadata.json", json.dumps(metadata, indent=2))
 
         return output_path
 
-    def upload(self, package_path: Path, api_key: str, **kwargs) -> Dict[str, Any]:
+    def upload(self, package_path: Path, api_key: str, **kwargs) -> dict[str, Any]:
         """
         Upload skill ZIP to OpenAI Assistants API.
 
@@ -186,30 +185,20 @@ Always prioritize accuracy by consulting the attached documentation files before
         # Validate package file FIRST
         package_path = Path(package_path)
         if not package_path.exists():
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'File not found: {package_path}'
-            }
+            return {"success": False, "skill_id": None, "url": None, "message": f"File not found: {package_path}"}
 
-        if not package_path.suffix == '.zip':
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'Not a ZIP file: {package_path}'
-            }
+        if not package_path.suffix == ".zip":
+            return {"success": False, "skill_id": None, "url": None, "message": f"Not a ZIP file: {package_path}"}
 
         # Check for openai library
         try:
             from openai import OpenAI
         except ImportError:
             return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': 'openai library not installed. Run: pip install openai'
+                "success": False,
+                "skill_id": None,
+                "url": None,
+                "message": "openai library not installed. Run: pip install openai",
             }
 
         # Configure OpenAI client
@@ -218,11 +207,10 @@ Always prioritize accuracy by consulting the attached documentation files before
 
             # Extract package to temp directory
             import tempfile
-            import shutil
 
             with tempfile.TemporaryDirectory() as temp_dir:
                 # Extract ZIP
-                with zipfile.ZipFile(package_path, 'r') as zf:
+                with zipfile.ZipFile(package_path, "r") as zf:
                     zf.extractall(temp_dir)
 
                 temp_path = Path(temp_dir)
@@ -231,29 +219,27 @@ Always prioritize accuracy by consulting the attached documentation files before
                 instructions_file = temp_path / "assistant_instructions.txt"
                 if not instructions_file.exists():
                     return {
-                        'success': False,
-                        'skill_id': None,
-                        'url': None,
-                        'message': 'Invalid package: assistant_instructions.txt not found'
+                        "success": False,
+                        "skill_id": None,
+                        "url": None,
+                        "message": "Invalid package: assistant_instructions.txt not found",
                     }
 
-                instructions = instructions_file.read_text(encoding='utf-8')
+                instructions = instructions_file.read_text(encoding="utf-8")
 
                 # Read metadata
                 metadata_file = temp_path / "openai_metadata.json"
                 skill_name = package_path.stem
-                model = kwargs.get('model', 'gpt-4o')
+                model = kwargs.get("model", "gpt-4o")
 
                 if metadata_file.exists():
-                    with open(metadata_file, 'r') as f:
+                    with open(metadata_file) as f:
                         metadata = json.load(f)
-                        skill_name = metadata.get('name', skill_name)
-                        model = metadata.get('model', model)
+                        skill_name = metadata.get("name", skill_name)
+                        model = metadata.get("model", model)
 
                 # Create vector store
-                vector_store = client.beta.vector_stores.create(
-                    name=f"{skill_name} Documentation"
-                )
+                vector_store = client.beta.vector_stores.create(name=f"{skill_name} Documentation")
 
                 # Upload reference files to vector store
                 vector_files_dir = temp_path / "vector_store_files"
@@ -262,19 +248,13 @@ Always prioritize accuracy by consulting the attached documentation files before
                 if vector_files_dir.exists():
                     for ref_file in vector_files_dir.glob("*.md"):
                         # Upload file
-                        with open(ref_file, 'rb') as f:
-                            uploaded_file = client.files.create(
-                                file=f,
-                                purpose='assistants'
-                            )
+                        with open(ref_file, "rb") as f:
+                            uploaded_file = client.files.create(file=f, purpose="assistants")
                             file_ids.append(uploaded_file.id)
 
                     # Attach files to vector store
                     if file_ids:
-                        client.beta.vector_stores.files.create_batch(
-                            vector_store_id=vector_store.id,
-                            file_ids=file_ids
-                        )
+                        client.beta.vector_stores.files.create_batch(vector_store_id=vector_store.id, file_ids=file_ids)
 
                 # Create assistant
                 assistant = client.beta.assistants.create(
@@ -282,27 +262,18 @@ Always prioritize accuracy by consulting the attached documentation files before
                     instructions=instructions,
                     model=model,
                     tools=[{"type": "file_search"}],
-                    tool_resources={
-                        "file_search": {
-                            "vector_store_ids": [vector_store.id]
-                        }
-                    }
+                    tool_resources={"file_search": {"vector_store_ids": [vector_store.id]}},
                 )
 
             return {
-                'success': True,
-                'skill_id': assistant.id,
-                'url': f"https://platform.openai.com/assistants/{assistant.id}",
-                'message': f'Assistant created with {len(file_ids)} knowledge files'
+                "success": True,
+                "skill_id": assistant.id,
+                "url": f"https://platform.openai.com/assistants/{assistant.id}",
+                "message": f"Assistant created with {len(file_ids)} knowledge files",
             }
 
         except Exception as e:
-            return {
-                'success': False,
-                'skill_id': None,
-                'url': None,
-                'message': f'Upload failed: {str(e)}'
-            }
+            return {"success": False, "skill_id": None, "url": None, "message": f"Upload failed: {str(e)}"}
 
     def validate_api_key(self, api_key: str) -> bool:
         """
@@ -314,7 +285,7 @@ Always prioritize accuracy by consulting the attached documentation files before
         Returns:
             True if key starts with 'sk-'
         """
-        return api_key.strip().startswith('sk-')
+        return api_key.strip().startswith("sk-")
 
     def get_env_var_name(self) -> str:
         """
@@ -372,17 +343,13 @@ Always prioritize accuracy by consulting the attached documentation files before
         # Read current SKILL.md
         current_skill_md = None
         if skill_md_path.exists():
-            current_skill_md = skill_md_path.read_text(encoding='utf-8')
+            current_skill_md = skill_md_path.read_text(encoding="utf-8")
             print(f"  ℹ Found existing SKILL.md ({len(current_skill_md)} chars)")
         else:
-            print(f"  ℹ No existing SKILL.md, will create new one")
+            print("  ℹ No existing SKILL.md, will create new one")
 
         # Build enhancement prompt
-        prompt = self._build_enhancement_prompt(
-            skill_dir.name,
-            references,
-            current_skill_md
-        )
+        prompt = self._build_enhancement_prompt(skill_dir.name, references, current_skill_md)
 
         print("\n🤖 Asking GPT-4o to enhance SKILL.md...")
         print(f"   Input: {len(prompt):,} characters")
@@ -395,15 +362,12 @@ Always prioritize accuracy by consulting the attached documentation files before
                 messages=[
                     {
                         "role": "system",
-                        "content": "You are an expert technical writer creating Assistant instructions for OpenAI ChatGPT."
+                        "content": "You are an expert technical writer creating Assistant instructions for OpenAI ChatGPT.",
                     },
-                    {
-                        "role": "user",
-                        "content": prompt
-                    }
+                    {"role": "user", "content": prompt},
                 ],
                 temperature=0.3,
-                max_tokens=4096
+                max_tokens=4096,
             )
 
             enhanced_content = response.choices[0].message.content
@@ -411,13 +375,13 @@ Always prioritize accuracy by consulting the attached documentation files before
 
             # Backup original
             if skill_md_path.exists():
-                backup_path = skill_md_path.with_suffix('.md.backup')
+                backup_path = skill_md_path.with_suffix(".md.backup")
                 skill_md_path.rename(backup_path)
                 print(f"  💾 Backed up original to: {backup_path.name}")
 
             # Save enhanced version
-            skill_md_path.write_text(enhanced_content, encoding='utf-8')
-            print(f"  ✅ Saved enhanced SKILL.md")
+            skill_md_path.write_text(enhanced_content, encoding="utf-8")
+            print("  ✅ Saved enhanced SKILL.md")
 
             return True
 
@@ -425,7 +389,7 @@ Always prioritize accuracy by consulting the attached documentation files before
             print(f"❌ Error calling OpenAI API: {e}")
             return False
 
-    def _read_reference_files(self, references_dir: Path, max_chars: int = 200000) -> Dict[str, str]:
+    def _read_reference_files(self, references_dir: Path, max_chars: int = 200000) -> dict[str, str]:
         """
         Read reference markdown files from skill directory.
 
@@ -448,7 +412,7 @@ Always prioritize accuracy by consulting the attached documentation files before
                 break
 
             try:
-                content = ref_file.read_text(encoding='utf-8')
+                content = ref_file.read_text(encoding="utf-8")
                 # Limit individual file size
                 if len(content) > 30000:
                     content = content[:30000] + "\n\n...(truncated)"
@@ -462,10 +426,7 @@ Always prioritize accuracy by consulting the attached documentation files before
         return references
 
     def _build_enhancement_prompt(
-        self,
-        skill_name: str,
-        references: Dict[str, str],
-        current_skill_md: str = None
+        self, skill_name: str, references: dict[str, str], current_skill_md: str = None
     ) -> str:
         """
         Build OpenAI API prompt for enhancement.
@@ -483,9 +444,9 @@ Always prioritize accuracy by consulting the attached documentation files before
 I've scraped documentation and organized it into reference files. Your job is to create EXCELLENT Assistant instructions that will help the Assistant use this documentation effectively.
 
 CURRENT INSTRUCTIONS:
-{'```' if current_skill_md else '(none - create from scratch)'}
-{current_skill_md or 'No existing instructions'}
-{'```' if current_skill_md else ''}
+{"```" if current_skill_md else "(none - create from scratch)"}
+{current_skill_md or "No existing instructions"}
+{"```" if current_skill_md else ""}
 
 REFERENCE DOCUMENTATION:
 """
diff --git a/src/skill_seekers/cli/ai_enhancer.py b/src/skill_seekers/cli/ai_enhancer.py
index 1c42cbe..dbfe971 100644
--- a/src/skill_seekers/cli/ai_enhancer.py
+++ b/src/skill_seekers/cli/ai_enhancer.py
@@ -17,9 +17,8 @@ Credits:
 - Graceful degradation if API unavailable
 """
 
-import os
 import logging
-from typing import List, Dict, Optional, Any
+import os
 from dataclasses import dataclass
 
 logger = logging.getLogger(__name__)
@@ -28,18 +27,19 @@ logger = logging.getLogger(__name__)
 @dataclass
 class AIAnalysis:
     """AI analysis result for patterns or examples"""
+
     explanation: str
-    issues: List[str]
-    recommendations: List[str]
-    related_items: List[str]  # Related patterns or examples
-    best_practices: List[str]
+    issues: list[str]
+    recommendations: list[str]
+    related_items: list[str]  # Related patterns or examples
+    best_practices: list[str]
     confidence_boost: float  # -0.2 to +0.2 adjustment to confidence
 
 
 class AIEnhancer:
     """Base class for AI enhancement"""
 
-    def __init__(self, api_key: Optional[str] = None, enabled: bool = True, mode: str = "auto"):
+    def __init__(self, api_key: str | None = None, enabled: bool = True, mode: str = "auto"):
         """
         Initialize AI enhancer.
 
@@ -53,7 +53,7 @@ class AIEnhancer:
         """
         self.enabled = enabled
         self.mode = mode
-        self.api_key = api_key or os.environ.get('ANTHROPIC_API_KEY')
+        self.api_key = api_key or os.environ.get("ANTHROPIC_API_KEY")
         self.client = None
 
         # Determine actual mode
@@ -72,6 +72,7 @@ class AIEnhancer:
         if self.mode == "api" and self.enabled:
             try:
                 import anthropic
+
                 self.client = anthropic.Anthropic(api_key=self.api_key)
                 logger.info("✅ AI enhancement enabled (using Claude API)")
             except ImportError:
@@ -88,16 +89,14 @@ class AIEnhancer:
             logger.info("   Use API mode (set ANTHROPIC_API_KEY) or 'skill-seekers enhance' for SKILL.md")
             self.enabled = False
 
-    def _call_claude(self, prompt: str, max_tokens: int = 1000) -> Optional[str]:
+    def _call_claude(self, prompt: str, max_tokens: int = 1000) -> str | None:
         """Call Claude API with error handling"""
         if not self.client:
             return None
 
         try:
             response = self.client.messages.create(
-                model="claude-sonnet-4-20250514",
-                max_tokens=max_tokens,
-                messages=[{"role": "user", "content": prompt}]
+                model="claude-sonnet-4-20250514", max_tokens=max_tokens, messages=[{"role": "user", "content": prompt}]
             )
             return response.content[0].text
         except Exception as e:
@@ -108,7 +107,7 @@ class AIEnhancer:
 class PatternEnhancer(AIEnhancer):
     """Enhance design pattern detection with AI analysis"""
 
-    def enhance_patterns(self, patterns: List[Dict]) -> List[Dict]:
+    def enhance_patterns(self, patterns: list[dict]) -> list[dict]:
         """
         Enhance detected patterns with AI analysis.
 
@@ -128,19 +127,19 @@ class PatternEnhancer(AIEnhancer):
         enhanced = []
 
         for i in range(0, len(patterns), batch_size):
-            batch = patterns[i:i+batch_size]
+            batch = patterns[i : i + batch_size]
             batch_results = self._enhance_pattern_batch(batch)
             enhanced.extend(batch_results)
 
         logger.info(f"✅ Enhanced {len(enhanced)} patterns")
         return enhanced
 
-    def _enhance_pattern_batch(self, patterns: List[Dict]) -> List[Dict]:
+    def _enhance_pattern_batch(self, patterns: list[dict]) -> list[dict]:
         """Enhance a batch of patterns"""
         # Prepare prompt
         pattern_descriptions = []
         for idx, p in enumerate(patterns):
-            desc = f"{idx+1}. {p['pattern_type']} in {p.get('class_name', 'unknown')}"
+            desc = f"{idx + 1}. {p['pattern_type']} in {p.get('class_name', 'unknown')}"
             desc += f"\n   Evidence: {', '.join(p.get('evidence', []))}"
             pattern_descriptions.append(desc)
 
@@ -166,24 +165,25 @@ Format as JSON array matching input order. Be concise and actionable.
 
         try:
             import json
+
             analyses = json.loads(response)
 
             # Merge AI analysis into patterns
             for idx, pattern in enumerate(patterns):
                 if idx < len(analyses):
                     analysis = analyses[idx]
-                    pattern['ai_analysis'] = {
-                        'explanation': analysis.get('explanation', ''),
-                        'issues': analysis.get('issues', []),
-                        'recommendations': analysis.get('recommendations', []),
-                        'related_patterns': analysis.get('related_patterns', []),
-                        'confidence_boost': analysis.get('confidence_boost', 0.0)
+                    pattern["ai_analysis"] = {
+                        "explanation": analysis.get("explanation", ""),
+                        "issues": analysis.get("issues", []),
+                        "recommendations": analysis.get("recommendations", []),
+                        "related_patterns": analysis.get("related_patterns", []),
+                        "confidence_boost": analysis.get("confidence_boost", 0.0),
                     }
 
                     # Adjust confidence
-                    boost = analysis.get('confidence_boost', 0.0)
+                    boost = analysis.get("confidence_boost", 0.0)
                     if -0.2 <= boost <= 0.2:
-                        pattern['confidence'] = min(1.0, max(0.0, pattern['confidence'] + boost))
+                        pattern["confidence"] = min(1.0, max(0.0, pattern["confidence"] + boost))
 
             return patterns
 
@@ -198,7 +198,7 @@ Format as JSON array matching input order. Be concise and actionable.
 class TestExampleEnhancer(AIEnhancer):
     """Enhance test examples with AI analysis"""
 
-    def enhance_examples(self, examples: List[Dict]) -> List[Dict]:
+    def enhance_examples(self, examples: list[dict]) -> list[dict]:
         """
         Enhance test examples with AI context and explanations.
 
@@ -218,21 +218,21 @@ class TestExampleEnhancer(AIEnhancer):
         enhanced = []
 
         for i in range(0, len(examples), batch_size):
-            batch = examples[i:i+batch_size]
+            batch = examples[i : i + batch_size]
             batch_results = self._enhance_example_batch(batch)
             enhanced.extend(batch_results)
 
         logger.info(f"✅ Enhanced {len(enhanced)} examples")
         return enhanced
 
-    def _enhance_example_batch(self, examples: List[Dict]) -> List[Dict]:
+    def _enhance_example_batch(self, examples: list[dict]) -> list[dict]:
         """Enhance a batch of examples"""
         # Prepare prompt
         example_descriptions = []
         for idx, ex in enumerate(examples):
-            desc = f"{idx+1}. {ex.get('category', 'unknown')} - {ex.get('test_name', 'unknown')}"
+            desc = f"{idx + 1}. {ex.get('category', 'unknown')} - {ex.get('test_name', 'unknown')}"
             desc += f"\n   Code: {ex.get('code', '')[:100]}..."
-            if ex.get('expected_behavior'):
+            if ex.get("expected_behavior"):
                 desc += f"\n   Expected: {ex['expected_behavior']}"
             example_descriptions.append(desc)
 
@@ -257,18 +257,19 @@ Format as JSON array matching input order. Focus on educational value.
 
         try:
             import json
+
             analyses = json.loads(response)
 
             # Merge AI analysis into examples
             for idx, example in enumerate(examples):
                 if idx < len(analyses):
                     analysis = analyses[idx]
-                    example['ai_analysis'] = {
-                        'explanation': analysis.get('explanation', ''),
-                        'best_practices': analysis.get('best_practices', []),
-                        'common_mistakes': analysis.get('common_mistakes', []),
-                        'related_examples': analysis.get('related_examples', []),
-                        'tutorial_group': analysis.get('tutorial_group', '')
+                    example["ai_analysis"] = {
+                        "explanation": analysis.get("explanation", ""),
+                        "best_practices": analysis.get("best_practices", []),
+                        "common_mistakes": analysis.get("common_mistakes", []),
+                        "related_examples": analysis.get("related_examples", []),
+                        "tutorial_group": analysis.get("tutorial_group", ""),
                     }
 
             return examples
@@ -280,7 +281,7 @@ Format as JSON array matching input order. Focus on educational value.
             logger.warning(f"⚠️  Error processing AI analysis: {e}")
             return examples
 
-    def generate_tutorials(self, examples: List[Dict]) -> Dict[str, List[Dict]]:
+    def generate_tutorials(self, examples: list[dict]) -> dict[str, list[dict]]:
         """
         Group enhanced examples into tutorial sections.
 
@@ -293,8 +294,8 @@ Format as JSON array matching input order. Focus on educational value.
         tutorials = {}
 
         for example in examples:
-            ai_analysis = example.get('ai_analysis', {})
-            group = ai_analysis.get('tutorial_group', 'Miscellaneous')
+            ai_analysis = example.get("ai_analysis", {})
+            group = ai_analysis.get("tutorial_group", "Miscellaneous")
 
             if group not in tutorials:
                 tutorials[group] = []
diff --git a/src/skill_seekers/cli/api_reference_builder.py b/src/skill_seekers/cli/api_reference_builder.py
index 1264a31..670f602 100644
--- a/src/skill_seekers/cli/api_reference_builder.py
+++ b/src/skill_seekers/cli/api_reference_builder.py
@@ -17,10 +17,9 @@ Usage:
     builder.build_reference(output_dir)
 """
 
-import os
 import json
 from pathlib import Path
-from typing import Dict, List, Any, Optional
+from typing import Any
 
 
 class APIReferenceBuilder:
@@ -31,7 +30,7 @@ class APIReferenceBuilder:
     documentation for each analyzed source file.
     """
 
-    def __init__(self, code_analysis: Dict[str, Any]):
+    def __init__(self, code_analysis: dict[str, Any]):
         """
         Initialize builder with code analysis results.
 
@@ -40,9 +39,9 @@ class APIReferenceBuilder:
                           Expected format: {'files': [{'file': 'path', 'classes': [...], 'functions': [...]}]}
         """
         self.code_analysis = code_analysis
-        self.files_data = code_analysis.get('files', [])
+        self.files_data = code_analysis.get("files", [])
 
-    def build_reference(self, output_dir: Path) -> Dict[str, Path]:
+    def build_reference(self, output_dir: Path) -> dict[str, Path]:
         """
         Generate markdown files for each analyzed source file.
 
@@ -58,11 +57,11 @@ class APIReferenceBuilder:
         generated_files = {}
 
         for file_data in self.files_data:
-            source_file = file_data.get('file', 'unknown')
-            language = file_data.get('language', 'Unknown')
+            source_file = file_data.get("file", "unknown")
+            language = file_data.get("language", "Unknown")
 
             # Skip files with no analysis
-            if not file_data.get('classes') and not file_data.get('functions'):
+            if not file_data.get("classes") and not file_data.get("functions"):
                 continue
 
             # Generate markdown content
@@ -73,7 +72,7 @@ class APIReferenceBuilder:
             output_path = output_dir / output_filename
 
             # Write markdown file
-            output_path.write_text(markdown_content, encoding='utf-8')
+            output_path.write_text(markdown_content, encoding="utf-8")
             generated_files[source_file] = output_path
 
         return generated_files
@@ -92,11 +91,10 @@ class APIReferenceBuilder:
         basename = Path(source_file).name
 
         # Replace extension with .md
-        name_without_ext = basename.rsplit('.', 1)[0] if '.' in basename else basename
+        name_without_ext = basename.rsplit(".", 1)[0] if "." in basename else basename
         return f"{name_without_ext}.md"
 
-    def _generate_file_reference(self, file_data: Dict[str, Any],
-                                 source_file: str, language: str) -> str:
+    def _generate_file_reference(self, file_data: dict[str, Any], source_file: str, language: str) -> str:
         """
         Generate complete markdown reference for a single file.
 
@@ -118,7 +116,7 @@ class APIReferenceBuilder:
         lines.append("---\n")
 
         # Classes section
-        classes = file_data.get('classes', [])
+        classes = file_data.get("classes", [])
         if classes:
             lines.append("## Classes\n")
             for cls in classes:
@@ -126,16 +124,16 @@ class APIReferenceBuilder:
                 lines.append("\n")
 
         # Functions section
-        functions = file_data.get('functions', [])
+        functions = file_data.get("functions", [])
         if functions:
             lines.append("## Functions\n")
             for func in functions:
                 lines.append(self._format_function(func))
                 lines.append("\n")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def _format_class(self, class_sig: Dict[str, Any]) -> str:
+    def _format_class(self, class_sig: dict[str, Any]) -> str:
         """
         Format class signature as markdown.
 
@@ -148,33 +146,33 @@ class APIReferenceBuilder:
         lines = []
 
         # Class name
-        class_name = class_sig.get('name', 'Unknown')
+        class_name = class_sig.get("name", "Unknown")
         lines.append(f"### {class_name}\n")
 
         # Docstring
-        docstring = class_sig.get('docstring')
+        docstring = class_sig.get("docstring")
         if docstring:
             lines.append(f"{docstring}\n")
 
         # Inheritance
-        base_classes = class_sig.get('base_classes', [])
+        base_classes = class_sig.get("base_classes", [])
         if base_classes:
-            bases_str = ', '.join(base_classes)
+            bases_str = ", ".join(base_classes)
             lines.append(f"**Inherits from**: {bases_str}\n")
         else:
             lines.append("**Inherits from**: (none)\n")
 
         # Methods
-        methods = class_sig.get('methods', [])
+        methods = class_sig.get("methods", [])
         if methods:
             lines.append("#### Methods\n")
             for method in methods:
                 lines.append(self._format_method(method))
                 lines.append("")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def _format_method(self, method_sig: Dict[str, Any]) -> str:
+    def _format_method(self, method_sig: dict[str, Any]) -> str:
         """
         Format method signature as markdown.
 
@@ -191,30 +189,30 @@ class APIReferenceBuilder:
         lines.append(f"##### {signature}\n")
 
         # Docstring
-        docstring = method_sig.get('docstring')
+        docstring = method_sig.get("docstring")
         if docstring:
             lines.append(f"{docstring}\n")
 
         # Decorators
-        decorators = method_sig.get('decorators', [])
+        decorators = method_sig.get("decorators", [])
         if decorators:
-            dec_str = ', '.join(f"`@{d}`" for d in decorators)
+            dec_str = ", ".join(f"`@{d}`" for d in decorators)
             lines.append(f"**Decorators**: {dec_str}\n")
 
         # Parameters table
-        params = method_sig.get('parameters', [])
+        params = method_sig.get("parameters", [])
         if params:
             lines.append(self._format_parameters(params))
             lines.append("")
 
         # Return type
-        return_type = method_sig.get('return_type')
+        return_type = method_sig.get("return_type")
         if return_type:
             lines.append(f"**Returns**: `{return_type}`\n")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def _format_function(self, func_sig: Dict[str, Any]) -> str:
+    def _format_function(self, func_sig: dict[str, Any]) -> str:
         """
         Format function signature as markdown.
 
@@ -231,30 +229,30 @@ class APIReferenceBuilder:
         lines.append(f"### {signature}\n")
 
         # Async indicator
-        if func_sig.get('is_async'):
+        if func_sig.get("is_async"):
             lines.append("**Async function**\n")
 
         # Docstring
-        docstring = func_sig.get('docstring')
+        docstring = func_sig.get("docstring")
         if docstring:
             lines.append(f"{docstring}\n")
 
         # Parameters table
-        params = func_sig.get('parameters', [])
+        params = func_sig.get("parameters", [])
         if params:
             lines.append(self._format_parameters(params))
             lines.append("")
 
         # Return type
-        return_type = func_sig.get('return_type')
+        return_type = func_sig.get("return_type")
         if return_type:
             lines.append(f"**Returns**: `{return_type}`\n")
         else:
             lines.append("**Returns**: (none)\n")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def _build_signature(self, sig: Dict[str, Any]) -> str:
+    def _build_signature(self, sig: dict[str, Any]) -> str:
         """
         Build function/method signature string.
 
@@ -264,28 +262,28 @@ class APIReferenceBuilder:
         Returns:
             Formatted signature string
         """
-        name = sig.get('name', 'unknown')
-        params = sig.get('parameters', [])
-        return_type = sig.get('return_type')
+        name = sig.get("name", "unknown")
+        params = sig.get("parameters", [])
+        return_type = sig.get("return_type")
 
         # Build parameter list
         param_strs = []
         for param in params:
-            param_str = param.get('name', '')
+            param_str = param.get("name", "")
 
             # Add type hint if available
-            type_hint = param.get('type_hint')
+            type_hint = param.get("type_hint")
             if type_hint:
                 param_str += f": {type_hint}"
 
             # Add default value if available
-            default = param.get('default')
+            default = param.get("default")
             if default:
                 param_str += f" = {default}"
 
             param_strs.append(param_str)
 
-        params_str = ', '.join(param_strs)
+        params_str = ", ".join(param_strs)
 
         # Build full signature
         if return_type:
@@ -293,7 +291,7 @@ class APIReferenceBuilder:
         else:
             return f"{name}({params_str})"
 
-    def _format_parameters(self, params: List[Dict]) -> str:
+    def _format_parameters(self, params: list[dict]) -> str:
         """
         Format parameter list as markdown table.
 
@@ -313,19 +311,19 @@ class APIReferenceBuilder:
         lines.append("|------|------|---------|-------------|")
 
         for param in params:
-            name = param.get('name', '-')
-            type_hint = param.get('type_hint', '-')
-            default = param.get('default')
+            name = param.get("name", "-")
+            type_hint = param.get("type_hint", "-")
+            default = param.get("default")
 
             # Show "-" for parameters without defaults
-            default_str = default if default is not None else '-'
+            default_str = default if default is not None else "-"
 
             # For description, use empty for now (would need JSDoc/docstring parsing)
             description = "-"
 
             lines.append(f"| {name} | {type_hint} | {default_str} | {description} |")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
 
 def main():
@@ -336,12 +334,10 @@ def main():
     """
     import argparse
 
-    parser = argparse.ArgumentParser(
-        description='Generate API reference from code analysis results'
-    )
+    parser = argparse.ArgumentParser(description="Generate API reference from code analysis results")
 
-    parser.add_argument('input_file', help='Code analysis JSON file')
-    parser.add_argument('output_dir', help='Output directory for markdown files')
+    parser.add_argument("input_file", help="Code analysis JSON file")
+    parser.add_argument("output_dir", help="Output directory for markdown files")
 
     args = parser.parse_args()
 
@@ -351,7 +347,7 @@ def main():
         print(f"Error: Input file not found: {input_path}")
         return 1
 
-    with open(input_path, 'r', encoding='utf-8') as f:
+    with open(input_path, encoding="utf-8") as f:
         code_analysis = json.load(f)
 
     # Build API reference
@@ -367,6 +363,7 @@ def main():
     return 0
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     import sys
+
     sys.exit(main())
diff --git a/src/skill_seekers/cli/architectural_pattern_detector.py b/src/skill_seekers/cli/architectural_pattern_detector.py
index bf1d38f..116bec5 100644
--- a/src/skill_seekers/cli/architectural_pattern_detector.py
+++ b/src/skill_seekers/cli/architectural_pattern_detector.py
@@ -21,11 +21,9 @@ Credits:
 """
 
 import logging
-import re
-from dataclasses import dataclass, field
-from pathlib import Path
-from typing import List, Dict, Optional, Set
 from collections import defaultdict
+from dataclasses import dataclass
+from pathlib import Path
 
 logger = logging.getLogger(__name__)
 
@@ -33,41 +31,43 @@ logger = logging.getLogger(__name__)
 @dataclass
 class ArchitecturalPattern:
     """Detected architectural pattern"""
+
     pattern_name: str  # e.g., "MVC", "MVVM", "Repository"
     confidence: float  # 0.0-1.0
-    evidence: List[str]  # List of evidence supporting detection
-    components: Dict[str, List[str]]  # Component type -> file paths
-    framework: Optional[str] = None  # Detected framework (Django, Spring, etc.)
+    evidence: list[str]  # List of evidence supporting detection
+    components: dict[str, list[str]]  # Component type -> file paths
+    framework: str | None = None  # Detected framework (Django, Spring, etc.)
     description: str = ""  # Human-readable description
 
 
 @dataclass
 class ArchitecturalReport:
     """Complete architectural analysis report"""
-    patterns: List[ArchitecturalPattern]
-    directory_structure: Dict[str, int]  # Directory name -> file count
-    total_files_analyzed: int
-    frameworks_detected: List[str]
-    ai_analysis: Optional[Dict] = None  # AI enhancement (C3.6 integration)
 
-    def to_dict(self) -> Dict:
+    patterns: list[ArchitecturalPattern]
+    directory_structure: dict[str, int]  # Directory name -> file count
+    total_files_analyzed: int
+    frameworks_detected: list[str]
+    ai_analysis: dict | None = None  # AI enhancement (C3.6 integration)
+
+    def to_dict(self) -> dict:
         """Export to dictionary"""
         return {
-            'patterns': [
+            "patterns": [
                 {
-                    'pattern_name': p.pattern_name,
-                    'confidence': p.confidence,
-                    'evidence': p.evidence,
-                    'components': p.components,
-                    'framework': p.framework,
-                    'description': p.description
+                    "pattern_name": p.pattern_name,
+                    "confidence": p.confidence,
+                    "evidence": p.evidence,
+                    "components": p.components,
+                    "framework": p.framework,
+                    "description": p.description,
                 }
                 for p in self.patterns
             ],
-            'directory_structure': self.directory_structure,
-            'total_files_analyzed': self.total_files_analyzed,
-            'frameworks_detected': self.frameworks_detected,
-            'ai_analysis': self.ai_analysis
+            "directory_structure": self.directory_structure,
+            "total_files_analyzed": self.total_files_analyzed,
+            "frameworks_detected": self.frameworks_detected,
+            "ai_analysis": self.ai_analysis,
         }
 
 
@@ -79,25 +79,25 @@ class ArchitecturalPatternDetector:
     """
 
     # Common directory patterns for architectures
-    MVC_DIRS = {'models', 'views', 'controllers', 'model', 'view', 'controller'}
-    MVVM_DIRS = {'models', 'views', 'viewmodels', 'viewmodel'}
-    LAYERED_DIRS = {'presentation', 'business', 'data', 'dal', 'bll', 'ui'}
-    CLEAN_ARCH_DIRS = {'domain', 'application', 'infrastructure', 'presentation'}
-    REPO_DIRS = {'repositories', 'repository'}
-    SERVICE_DIRS = {'services', 'service'}
+    MVC_DIRS = {"models", "views", "controllers", "model", "view", "controller"}
+    MVVM_DIRS = {"models", "views", "viewmodels", "viewmodel"}
+    LAYERED_DIRS = {"presentation", "business", "data", "dal", "bll", "ui"}
+    CLEAN_ARCH_DIRS = {"domain", "application", "infrastructure", "presentation"}
+    REPO_DIRS = {"repositories", "repository"}
+    SERVICE_DIRS = {"services", "service"}
 
     # Framework detection patterns
     FRAMEWORK_MARKERS = {
-        'Django': ['django', 'manage.py', 'settings.py', 'urls.py'],
-        'Flask': ['flask', 'app.py', 'wsgi.py'],
-        'Spring': ['springframework', '@Controller', '@Service', '@Repository'],
-        'ASP.NET': ['Controllers', 'Models', 'Views', '.cshtml', 'Startup.cs'],
-        'Rails': ['app/models', 'app/views', 'app/controllers', 'config/routes.rb'],
-        'Angular': ['app.module.ts', '@Component', '@Injectable', 'angular.json'],
-        'React': ['package.json', 'react', 'components'],
-        'Vue.js': ['vue', '.vue', 'components'],
-        'Express': ['express', 'app.js', 'routes'],
-        'Laravel': ['artisan', 'app/Http/Controllers', 'app/Models']
+        "Django": ["django", "manage.py", "settings.py", "urls.py"],
+        "Flask": ["flask", "app.py", "wsgi.py"],
+        "Spring": ["springframework", "@Controller", "@Service", "@Repository"],
+        "ASP.NET": ["Controllers", "Models", "Views", ".cshtml", "Startup.cs"],
+        "Rails": ["app/models", "app/views", "app/controllers", "config/routes.rb"],
+        "Angular": ["app.module.ts", "@Component", "@Injectable", "angular.json"],
+        "React": ["package.json", "react", "components"],
+        "Vue.js": ["vue", ".vue", "components"],
+        "Express": ["express", "app.js", "routes"],
+        "Laravel": ["artisan", "app/Http/Controllers", "app/Models"],
     }
 
     def __init__(self, enhance_with_ai: bool = True):
@@ -113,12 +113,13 @@ class ArchitecturalPatternDetector:
         if self.enhance_with_ai:
             try:
                 from skill_seekers.cli.ai_enhancer import AIEnhancer
+
                 self.ai_enhancer = AIEnhancer()
             except Exception as e:
                 logger.warning(f"⚠️  Failed to initialize AI enhancer: {e}")
                 self.enhance_with_ai = False
 
-    def analyze(self, directory: Path, files_analysis: List[Dict]) -> ArchitecturalReport:
+    def analyze(self, directory: Path, files_analysis: list[dict]) -> ArchitecturalReport:
         """
         Analyze codebase for architectural patterns.
 
@@ -151,7 +152,7 @@ class ArchitecturalPatternDetector:
             patterns=patterns,
             directory_structure=dir_structure,
             total_files_analyzed=len(files_analysis),
-            frameworks_detected=frameworks
+            frameworks_detected=frameworks,
         )
 
         # Enhance with AI if enabled (C3.6)
@@ -161,11 +162,11 @@ class ArchitecturalPatternDetector:
         logger.info(f"✅ Detected {len(patterns)} architectural patterns")
         return report
 
-    def _analyze_directory_structure(self, directory: Path) -> Dict[str, int]:
+    def _analyze_directory_structure(self, directory: Path) -> dict[str, int]:
         """Analyze directory structure and count files"""
         structure = defaultdict(int)
 
-        for path in directory.rglob('*'):
+        for path in directory.rglob("*"):
             if path.is_file():
                 # Get relative directory path
                 rel_dir = path.parent.relative_to(directory)
@@ -180,13 +181,13 @@ class ArchitecturalPatternDetector:
 
         return dict(structure)
 
-    def _detect_frameworks(self, directory: Path, files: List[Dict]) -> List[str]:
+    def _detect_frameworks(self, directory: Path, files: list[dict]) -> list[str]:
         """Detect frameworks being used"""
         detected = []
 
         # Check file paths and content
-        all_paths = [str(f.get('file', '')) for f in files]
-        all_content = ' '.join(all_paths)
+        all_paths = [str(f.get("file", "")) for f in files]
+        all_content = " ".join(all_paths)
 
         for framework, markers in self.FRAMEWORK_MARKERS.items():
             matches = sum(1 for marker in markers if marker.lower() in all_content.lower())
@@ -196,7 +197,7 @@ class ArchitecturalPatternDetector:
 
         return detected
 
-    def _detect_mvc(self, dirs: Dict[str, int], files: List[Dict], frameworks: List[str]) -> List[ArchitecturalPattern]:
+    def _detect_mvc(self, dirs: dict[str, int], files: list[dict], frameworks: list[str]) -> list[ArchitecturalPattern]:
         """Detect MVC pattern"""
         patterns = []
 
@@ -213,58 +214,62 @@ class ArchitecturalPatternDetector:
 
         # Find MVC files
         for file in files:
-            file_path = str(file.get('file', '')).lower()
+            file_path = str(file.get("file", "")).lower()
 
-            if 'model' in file_path and ('models/' in file_path or '/model/' in file_path):
-                components['Models'].append(file.get('file', ''))
-                if len(components['Models']) == 1:
+            if "model" in file_path and ("models/" in file_path or "/model/" in file_path):
+                components["Models"].append(file.get("file", ""))
+                if len(components["Models"]) == 1:
                     evidence.append("Models directory with model classes")
 
-            if 'view' in file_path and ('views/' in file_path or '/view/' in file_path):
-                components['Views'].append(file.get('file', ''))
-                if len(components['Views']) == 1:
+            if "view" in file_path and ("views/" in file_path or "/view/" in file_path):
+                components["Views"].append(file.get("file", ""))
+                if len(components["Views"]) == 1:
                     evidence.append("Views directory with view files")
 
-            if 'controller' in file_path and ('controllers/' in file_path or '/controller/' in file_path):
-                components['Controllers'].append(file.get('file', ''))
-                if len(components['Controllers']) == 1:
+            if "controller" in file_path and ("controllers/" in file_path or "/controller/" in file_path):
+                components["Controllers"].append(file.get("file", ""))
+                if len(components["Controllers"]) == 1:
                     evidence.append("Controllers directory with controller classes")
 
         # Calculate confidence
-        has_models = len(components['Models']) > 0
-        has_views = len(components['Views']) > 0
-        has_controllers = len(components['Controllers']) > 0
+        has_models = len(components["Models"]) > 0
+        has_views = len(components["Views"]) > 0
+        has_controllers = len(components["Controllers"]) > 0
 
         if sum([has_models, has_views, has_controllers]) >= 2:
             confidence = 0.6 + (sum([has_models, has_views, has_controllers]) * 0.15)
 
             # Boost confidence if framework detected
             framework = None
-            for fw in ['Django', 'Flask', 'Spring', 'ASP.NET', 'Rails', 'Laravel']:
+            for fw in ["Django", "Flask", "Spring", "ASP.NET", "Rails", "Laravel"]:
                 if fw in frameworks:
                     confidence = min(0.95, confidence + 0.1)
                     framework = fw
                     evidence.append(f"{fw} framework detected (uses MVC)")
                     break
 
-            patterns.append(ArchitecturalPattern(
-                pattern_name="MVC (Model-View-Controller)",
-                confidence=confidence,
-                evidence=evidence,
-                components=dict(components),
-                framework=framework,
-                description="Separates application into Models (data), Views (UI), and Controllers (logic)"
-            ))
+            patterns.append(
+                ArchitecturalPattern(
+                    pattern_name="MVC (Model-View-Controller)",
+                    confidence=confidence,
+                    evidence=evidence,
+                    components=dict(components),
+                    framework=framework,
+                    description="Separates application into Models (data), Views (UI), and Controllers (logic)",
+                )
+            )
 
         return patterns
 
-    def _detect_mvvm(self, dirs: Dict[str, int], files: List[Dict], frameworks: List[str]) -> List[ArchitecturalPattern]:
+    def _detect_mvvm(
+        self, dirs: dict[str, int], files: list[dict], frameworks: list[str]
+    ) -> list[ArchitecturalPattern]:
         """Detect MVVM pattern"""
         patterns = []
 
         # Look for ViewModels directory or classes ending with ViewModel
-        has_viewmodel_dir = 'viewmodels' in dirs or 'viewmodel' in dirs
-        viewmodel_files = [f for f in files if 'viewmodel' in str(f.get('file', '')).lower()]
+        has_viewmodel_dir = "viewmodels" in dirs or "viewmodel" in dirs
+        viewmodel_files = [f for f in files if "viewmodel" in str(f.get("file", "")).lower()]
 
         if not (has_viewmodel_dir or len(viewmodel_files) >= 2):
             return patterns
@@ -274,63 +279,68 @@ class ArchitecturalPatternDetector:
 
         # Find MVVM files
         for file in files:
-            file_path = str(file.get('file', '')).lower()
-            classes = file.get('classes', [])
+            file_path = str(file.get("file", "")).lower()
+            classes = file.get("classes", [])
 
-            if 'model' in file_path and 'viewmodel' not in file_path:
-                components['Models'].append(file.get('file', ''))
+            if "model" in file_path and "viewmodel" not in file_path:
+                components["Models"].append(file.get("file", ""))
 
-            if 'view' in file_path:
-                components['Views'].append(file.get('file', ''))
+            if "view" in file_path:
+                components["Views"].append(file.get("file", ""))
 
-            if 'viewmodel' in file_path or any('viewmodel' in c.get('name', '').lower() for c in classes):
-                components['ViewModels'].append(file.get('file', ''))
+            if "viewmodel" in file_path or any("viewmodel" in c.get("name", "").lower() for c in classes):
+                components["ViewModels"].append(file.get("file", ""))
 
-        if len(components['ViewModels']) >= 2:
+        if len(components["ViewModels"]) >= 2:
             evidence.append(f"ViewModels directory with {len(components['ViewModels'])} ViewModel classes")
 
-        if len(components['Views']) >= 2:
+        if len(components["Views"]) >= 2:
             evidence.append(f"Views directory with {len(components['Views'])} view files")
 
-        if len(components['Models']) >= 1:
+        if len(components["Models"]) >= 1:
             evidence.append(f"Models directory with {len(components['Models'])} model files")
 
         # Calculate confidence
-        has_models = len(components['Models']) > 0
-        has_views = len(components['Views']) > 0
-        has_viewmodels = len(components['ViewModels']) >= 2
+        has_models = len(components["Models"]) > 0
+        has_views = len(components["Views"]) > 0
+        has_viewmodels = len(components["ViewModels"]) >= 2
 
         if has_viewmodels and (has_models or has_views):
             confidence = 0.7 if (has_models and has_views and has_viewmodels) else 0.6
 
             framework = None
-            for fw in ['ASP.NET', 'Angular', 'Vue.js']:
+            for fw in ["ASP.NET", "Angular", "Vue.js"]:
                 if fw in frameworks:
                     confidence = min(0.95, confidence + 0.1)
                     framework = fw
                     evidence.append(f"{fw} framework detected (supports MVVM)")
                     break
 
-            patterns.append(ArchitecturalPattern(
-                pattern_name="MVVM (Model-View-ViewModel)",
-                confidence=confidence,
-                evidence=evidence,
-                components=dict(components),
-                framework=framework,
-                description="ViewModels provide data-binding between Views and Models"
-            ))
+            patterns.append(
+                ArchitecturalPattern(
+                    pattern_name="MVVM (Model-View-ViewModel)",
+                    confidence=confidence,
+                    evidence=evidence,
+                    components=dict(components),
+                    framework=framework,
+                    description="ViewModels provide data-binding between Views and Models",
+                )
+            )
 
         return patterns
 
-    def _detect_repository(self, dirs: Dict[str, int], files: List[Dict]) -> List[ArchitecturalPattern]:
+    def _detect_repository(self, dirs: dict[str, int], files: list[dict]) -> list[ArchitecturalPattern]:
         """Detect Repository pattern"""
         patterns = []
 
         # Look for repositories directory or classes ending with Repository
         has_repo_dir = any(d in dirs for d in self.REPO_DIRS)
-        repo_files = [f for f in files
-                     if 'repository' in str(f.get('file', '')).lower() or
-                     any('repository' in c.get('name', '').lower() for c in f.get('classes', []))]
+        repo_files = [
+            f
+            for f in files
+            if "repository" in str(f.get("file", "")).lower()
+            or any("repository" in c.get("name", "").lower() for c in f.get("classes", []))
+        ]
 
         if not (has_repo_dir or len(repo_files) >= 2):
             return patterns
@@ -339,30 +349,35 @@ class ArchitecturalPatternDetector:
         components = defaultdict(list)
 
         for file in repo_files:
-            components['Repositories'].append(file.get('file', ''))
+            components["Repositories"].append(file.get("file", ""))
 
-        if len(components['Repositories']) >= 2:
+        if len(components["Repositories"]) >= 2:
             evidence.append(f"Repository pattern: {len(components['Repositories'])} repository classes")
             evidence.append("Repositories abstract data access logic")
 
-            patterns.append(ArchitecturalPattern(
-                pattern_name="Repository Pattern",
-                confidence=0.75,
-                evidence=evidence,
-                components=dict(components),
-                description="Encapsulates data access logic in repository classes"
-            ))
+            patterns.append(
+                ArchitecturalPattern(
+                    pattern_name="Repository Pattern",
+                    confidence=0.75,
+                    evidence=evidence,
+                    components=dict(components),
+                    description="Encapsulates data access logic in repository classes",
+                )
+            )
 
         return patterns
 
-    def _detect_service_layer(self, dirs: Dict[str, int], files: List[Dict]) -> List[ArchitecturalPattern]:
+    def _detect_service_layer(self, dirs: dict[str, int], files: list[dict]) -> list[ArchitecturalPattern]:
         """Detect Service Layer pattern"""
         patterns = []
 
         has_service_dir = any(d in dirs for d in self.SERVICE_DIRS)
-        service_files = [f for f in files
-                        if 'service' in str(f.get('file', '')).lower() or
-                        any('service' in c.get('name', '').lower() for c in f.get('classes', []))]
+        service_files = [
+            f
+            for f in files
+            if "service" in str(f.get("file", "")).lower()
+            or any("service" in c.get("name", "").lower() for c in f.get("classes", []))
+        ]
 
         if not (has_service_dir or len(service_files) >= 3):
             return patterns
@@ -371,23 +386,25 @@ class ArchitecturalPatternDetector:
         components = defaultdict(list)
 
         for file in service_files:
-            components['Services'].append(file.get('file', ''))
+            components["Services"].append(file.get("file", ""))
 
-        if len(components['Services']) >= 3:
+        if len(components["Services"]) >= 3:
             evidence.append(f"Service layer: {len(components['Services'])} service classes")
             evidence.append("Services encapsulate business logic")
 
-            patterns.append(ArchitecturalPattern(
-                pattern_name="Service Layer Pattern",
-                confidence=0.75,
-                evidence=evidence,
-                components=dict(components),
-                description="Encapsulates business logic in service classes"
-            ))
+            patterns.append(
+                ArchitecturalPattern(
+                    pattern_name="Service Layer Pattern",
+                    confidence=0.75,
+                    evidence=evidence,
+                    components=dict(components),
+                    description="Encapsulates business logic in service classes",
+                )
+            )
 
         return patterns
 
-    def _detect_layered_architecture(self, dirs: Dict[str, int], files: List[Dict]) -> List[ArchitecturalPattern]:
+    def _detect_layered_architecture(self, dirs: dict[str, int], files: list[dict]) -> list[ArchitecturalPattern]:
         """Detect Layered Architecture (3-tier, N-tier)"""
         patterns = []
 
@@ -400,32 +417,34 @@ class ArchitecturalPatternDetector:
         components = defaultdict(list)
         layers_found = []
 
-        if 'presentation' in dirs or 'ui' in dirs:
+        if "presentation" in dirs or "ui" in dirs:
             layers_found.append("Presentation Layer")
             evidence.append("Presentation/UI layer detected")
 
-        if 'business' in dirs or 'bll' in dirs:
+        if "business" in dirs or "bll" in dirs:
             layers_found.append("Business Logic Layer")
             evidence.append("Business logic layer detected")
 
-        if 'data' in dirs or 'dal' in dirs:
+        if "data" in dirs or "dal" in dirs:
             layers_found.append("Data Access Layer")
             evidence.append("Data access layer detected")
 
         if len(layers_found) >= 2:
             confidence = 0.65 + (len(layers_found) * 0.1)
 
-            patterns.append(ArchitecturalPattern(
-                pattern_name=f"Layered Architecture ({len(layers_found)}-tier)",
-                confidence=min(confidence, 0.9),
-                evidence=evidence,
-                components={'Layers': layers_found},
-                description=f"Separates concerns into {len(layers_found)} distinct layers"
-            ))
+            patterns.append(
+                ArchitecturalPattern(
+                    pattern_name=f"Layered Architecture ({len(layers_found)}-tier)",
+                    confidence=min(confidence, 0.9),
+                    evidence=evidence,
+                    components={"Layers": layers_found},
+                    description=f"Separates concerns into {len(layers_found)} distinct layers",
+                )
+            )
 
         return patterns
 
-    def _detect_clean_architecture(self, dirs: Dict[str, int], files: List[Dict]) -> List[ArchitecturalPattern]:
+    def _detect_clean_architecture(self, dirs: dict[str, int], files: list[dict]) -> list[ArchitecturalPattern]:
         """Detect Clean Architecture"""
         patterns = []
 
@@ -437,50 +456,52 @@ class ArchitecturalPatternDetector:
         evidence = []
         components = defaultdict(list)
 
-        if 'domain' in dirs:
+        if "domain" in dirs:
             evidence.append("Domain layer (core business logic)")
-            components['Domain'].append('domain/')
+            components["Domain"].append("domain/")
 
-        if 'application' in dirs:
+        if "application" in dirs:
             evidence.append("Application layer (use cases)")
-            components['Application'].append('application/')
+            components["Application"].append("application/")
 
-        if 'infrastructure' in dirs:
+        if "infrastructure" in dirs:
             evidence.append("Infrastructure layer (external dependencies)")
-            components['Infrastructure'].append('infrastructure/')
+            components["Infrastructure"].append("infrastructure/")
 
-        if 'presentation' in dirs:
+        if "presentation" in dirs:
             evidence.append("Presentation layer (UI/API)")
-            components['Presentation'].append('presentation/')
+            components["Presentation"].append("presentation/")
 
         if len(components) >= 3:
-            patterns.append(ArchitecturalPattern(
-                pattern_name="Clean Architecture",
-                confidence=0.85,
-                evidence=evidence,
-                components=dict(components),
-                description="Dependency inversion with domain at center, infrastructure at edges"
-            ))
+            patterns.append(
+                ArchitecturalPattern(
+                    pattern_name="Clean Architecture",
+                    confidence=0.85,
+                    evidence=evidence,
+                    components=dict(components),
+                    description="Dependency inversion with domain at center, infrastructure at edges",
+                )
+            )
 
         return patterns
 
-    def _enhance_with_ai(self, report: ArchitecturalReport) -> Dict:
+    def _enhance_with_ai(self, report: ArchitecturalReport) -> dict:
         """Enhance architectural analysis with AI insights"""
         if not self.ai_enhancer:
             return {}
 
         # Prepare summary for AI
         summary = f"""Detected {len(report.patterns)} architectural patterns:
-{chr(10).join(f'- {p.pattern_name} (confidence: {p.confidence:.2f})' for p in report.patterns)}
+{chr(10).join(f"- {p.pattern_name} (confidence: {p.confidence:.2f})" for p in report.patterns)}
 
-Frameworks: {', '.join(report.frameworks_detected) if report.frameworks_detected else 'None'}
+Frameworks: {", ".join(report.frameworks_detected) if report.frameworks_detected else "None"}
 Total files: {report.total_files_analyzed}
 
 Provide brief architectural insights and recommendations."""
 
         try:
             response = self.ai_enhancer._call_claude(summary, max_tokens=500)
-            return {'insights': response} if response else {}
+            return {"insights": response} if response else {}
         except Exception as e:
             logger.warning(f"⚠️  AI enhancement failed: {e}")
             return {}
diff --git a/src/skill_seekers/cli/code_analyzer.py b/src/skill_seekers/cli/code_analyzer.py
index 1d6ed3b..10c0ca1 100644
--- a/src/skill_seekers/cli/code_analyzer.py
+++ b/src/skill_seekers/cli/code_analyzer.py
@@ -23,10 +23,10 @@ consider using dedicated parsers (tree-sitter, language-specific AST libraries).
 """
 
 import ast
-import re
 import logging
-from typing import Dict, List, Any, Optional
-from dataclasses import dataclass, asdict
+import re
+from dataclasses import asdict, dataclass
+from typing import Any
 
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -35,22 +35,24 @@ logger = logging.getLogger(__name__)
 @dataclass
 class Parameter:
     """Represents a function parameter."""
+
     name: str
-    type_hint: Optional[str] = None
-    default: Optional[str] = None
+    type_hint: str | None = None
+    default: str | None = None
 
 
 @dataclass
 class FunctionSignature:
     """Represents a function/method signature."""
+
     name: str
-    parameters: List[Parameter]
-    return_type: Optional[str] = None
-    docstring: Optional[str] = None
-    line_number: Optional[int] = None
+    parameters: list[Parameter]
+    return_type: str | None = None
+    docstring: str | None = None
+    line_number: int | None = None
     is_async: bool = False
     is_method: bool = False
-    decorators: List[str] = None
+    decorators: list[str] = None
 
     def __post_init__(self):
         if self.decorators is None:
@@ -60,11 +62,12 @@ class FunctionSignature:
 @dataclass
 class ClassSignature:
     """Represents a class signature."""
+
     name: str
-    base_classes: List[str]
-    methods: List[FunctionSignature]
-    docstring: Optional[str] = None
-    line_number: Optional[int] = None
+    base_classes: list[str]
+    methods: list[FunctionSignature]
+    docstring: str | None = None
+    line_number: int | None = None
 
 
 class CodeAnalyzer:
@@ -72,7 +75,7 @@ class CodeAnalyzer:
     Analyzes code at different depth levels.
     """
 
-    def __init__(self, depth: str = 'surface'):
+    def __init__(self, depth: str = "surface"):
         """
         Initialize code analyzer.
 
@@ -81,7 +84,7 @@ class CodeAnalyzer:
         """
         self.depth = depth
 
-    def analyze_file(self, file_path: str, content: str, language: str) -> Dict[str, Any]:
+    def analyze_file(self, file_path: str, content: str, language: str) -> dict[str, Any]:
         """
         Analyze a single file based on depth level.
 
@@ -93,29 +96,29 @@ class CodeAnalyzer:
         Returns:
             Dict containing extracted signatures
         """
-        if self.depth == 'surface':
+        if self.depth == "surface":
             return {}  # Surface level doesn't analyze individual files
 
         logger.debug(f"Analyzing {file_path} (language: {language}, depth: {self.depth})")
 
         try:
-            if language == 'Python':
+            if language == "Python":
                 return self._analyze_python(content, file_path)
-            elif language in ['JavaScript', 'TypeScript']:
+            elif language in ["JavaScript", "TypeScript"]:
                 return self._analyze_javascript(content, file_path)
-            elif language in ['C', 'C++']:
+            elif language in ["C", "C++"]:
                 return self._analyze_cpp(content, file_path)
-            elif language == 'C#':
+            elif language == "C#":
                 return self._analyze_csharp(content, file_path)
-            elif language == 'Go':
+            elif language == "Go":
                 return self._analyze_go(content, file_path)
-            elif language == 'Rust':
+            elif language == "Rust":
                 return self._analyze_rust(content, file_path)
-            elif language == 'Java':
+            elif language == "Java":
                 return self._analyze_java(content, file_path)
-            elif language == 'Ruby':
+            elif language == "Ruby":
                 return self._analyze_ruby(content, file_path)
-            elif language == 'PHP':
+            elif language == "PHP":
                 return self._analyze_php(content, file_path)
             else:
                 logger.debug(f"No analyzer for language: {language}")
@@ -124,7 +127,7 @@ class CodeAnalyzer:
             logger.warning(f"Error analyzing {file_path}: {e}")
             return {}
 
-    def _analyze_python(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_python(self, content: str, file_path: str) -> dict[str, Any]:
         """Analyze Python file using AST."""
         try:
             tree = ast.parse(content)
@@ -144,9 +147,11 @@ class CodeAnalyzer:
                 # Fix AST parser to check isinstance(parent.body, list) before 'in' operator
                 is_method = False
                 try:
-                    is_method = any(isinstance(parent, ast.ClassDef)
-                                  for parent in ast.walk(tree)
-                                  if hasattr(parent, 'body') and isinstance(parent.body, list) and node in parent.body)
+                    is_method = any(
+                        isinstance(parent, ast.ClassDef)
+                        for parent in ast.walk(tree)
+                        if hasattr(parent, "body") and isinstance(parent.body, list) and node in parent.body
+                    )
                 except (TypeError, AttributeError):
                     # If body is not iterable or check fails, assume it's a top-level function
                     is_method = False
@@ -158,11 +163,7 @@ class CodeAnalyzer:
         # Extract comments
         comments = self._extract_python_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
     def _extract_python_class(self, node: ast.ClassDef) -> ClassSignature:
         """Extract class signature from AST node."""
@@ -172,7 +173,7 @@ class CodeAnalyzer:
             if isinstance(base, ast.Name):
                 bases.append(base.id)
             elif isinstance(base, ast.Attribute):
-                bases.append(f"{base.value.id}.{base.attr}" if hasattr(base.value, 'id') else base.attr)
+                bases.append(f"{base.value.id}.{base.attr}" if hasattr(base.value, "id") else base.attr)
 
         # Extract methods
         methods = []
@@ -185,11 +186,7 @@ class CodeAnalyzer:
         docstring = ast.get_docstring(node)
 
         return ClassSignature(
-            name=node.name,
-            base_classes=bases,
-            methods=methods,
-            docstring=docstring,
-            line_number=node.lineno
+            name=node.name, base_classes=bases, methods=methods, docstring=docstring, line_number=node.lineno
         )
 
     def _extract_python_function(self, node, is_method: bool = False) -> FunctionSignature:
@@ -199,12 +196,9 @@ class CodeAnalyzer:
         for arg in node.args.args:
             param_type = None
             if arg.annotation:
-                param_type = ast.unparse(arg.annotation) if hasattr(ast, 'unparse') else None
+                param_type = ast.unparse(arg.annotation) if hasattr(ast, "unparse") else None
 
-            params.append(Parameter(
-                name=arg.arg,
-                type_hint=param_type
-            ))
+            params.append(Parameter(name=arg.arg, type_hint=param_type))
 
         # Extract defaults
         defaults = node.args.defaults
@@ -215,7 +209,7 @@ class CodeAnalyzer:
                 param_idx = num_no_default + i
                 if param_idx < len(params):
                     try:
-                        params[param_idx].default = ast.unparse(default) if hasattr(ast, 'unparse') else str(default)
+                        params[param_idx].default = ast.unparse(default) if hasattr(ast, "unparse") else str(default)
                     except:
                         params[param_idx].default = "..."
 
@@ -223,7 +217,7 @@ class CodeAnalyzer:
         return_type = None
         if node.returns:
             try:
-                return_type = ast.unparse(node.returns) if hasattr(ast, 'unparse') else None
+                return_type = ast.unparse(node.returns) if hasattr(ast, "unparse") else None
             except:
                 pass
 
@@ -231,7 +225,7 @@ class CodeAnalyzer:
         decorators = []
         for decorator in node.decorator_list:
             try:
-                if hasattr(ast, 'unparse'):
+                if hasattr(ast, "unparse"):
                     decorators.append(ast.unparse(decorator))
                 elif isinstance(decorator, ast.Name):
                     decorators.append(decorator.id)
@@ -249,10 +243,10 @@ class CodeAnalyzer:
             line_number=node.lineno,
             is_async=isinstance(node, ast.AsyncFunctionDef),
             is_method=is_method,
-            decorators=decorators
+            decorators=decorators,
         )
 
-    def _analyze_javascript(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_javascript(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze JavaScript/TypeScript file using regex patterns.
 
@@ -263,7 +257,7 @@ class CodeAnalyzer:
         functions = []
 
         # Extract class definitions
-        class_pattern = r'class\s+(\w+)(?:\s+extends\s+(\w+))?\s*\{'
+        class_pattern = r"class\s+(\w+)(?:\s+extends\s+(\w+))?\s*\{"
         for match in re.finditer(class_pattern, content):
             class_name = match.group(1)
             base_class = match.group(2) if match.group(2) else None
@@ -271,101 +265,105 @@ class CodeAnalyzer:
             # Try to extract methods (simplified)
             class_block_start = match.end()
             # This is a simplification - proper parsing would track braces
-            class_block_end = content.find('}', class_block_start)
+            class_block_end = content.find("}", class_block_start)
             if class_block_end != -1:
                 class_body = content[class_block_start:class_block_end]
                 methods = self._extract_js_methods(class_body)
             else:
                 methods = []
 
-            classes.append({
-                'name': class_name,
-                'base_classes': [base_class] if base_class else [],
-                'methods': methods,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": class_name,
+                    "base_classes": [base_class] if base_class else [],
+                    "methods": methods,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract top-level functions
-        func_pattern = r'(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)'
+        func_pattern = r"(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)"
         for match in re.finditer(func_pattern, content):
             func_name = match.group(1)
             params_str = match.group(2)
-            is_async = 'async' in match.group(0)
+            is_async = "async" in match.group(0)
 
             params = self._parse_js_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': None,  # JS doesn't have type annotations (unless TS)
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': is_async,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": None,  # JS doesn't have type annotations (unless TS)
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": is_async,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract arrow functions assigned to const/let
-        arrow_pattern = r'(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\(([^)]*)\)\s*=>'
+        arrow_pattern = r"(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\(([^)]*)\)\s*=>"
         for match in re.finditer(arrow_pattern, content):
             func_name = match.group(1)
             params_str = match.group(2)
-            is_async = 'async' in match.group(0)
+            is_async = "async" in match.group(0)
 
             params = self._parse_js_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': None,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': is_async,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": None,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": is_async,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_js_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _extract_js_methods(self, class_body: str) -> List[Dict]:
+    def _extract_js_methods(self, class_body: str) -> list[dict]:
         """Extract method signatures from class body."""
         methods = []
 
         # Match method definitions
-        method_pattern = r'(?:async\s+)?(\w+)\s*\(([^)]*)\)'
+        method_pattern = r"(?:async\s+)?(\w+)\s*\(([^)]*)\)"
         for match in re.finditer(method_pattern, class_body):
             method_name = match.group(1)
             params_str = match.group(2)
-            is_async = 'async' in match.group(0)
+            is_async = "async" in match.group(0)
 
             # Skip constructor keyword detection
-            if method_name in ['if', 'for', 'while', 'switch']:
+            if method_name in ["if", "for", "while", "switch"]:
                 continue
 
             params = self._parse_js_parameters(params_str)
 
-            methods.append({
-                'name': method_name,
-                'parameters': params,
-                'return_type': None,
-                'docstring': None,
-                'line_number': None,
-                'is_async': is_async,
-                'is_method': True,
-                'decorators': []
-            })
+            methods.append(
+                {
+                    "name": method_name,
+                    "parameters": params,
+                    "return_type": None,
+                    "docstring": None,
+                    "line_number": None,
+                    "is_async": is_async,
+                    "is_method": True,
+                    "decorators": [],
+                }
+            )
 
         return methods
 
-    def _parse_js_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_js_parameters(self, params_str: str) -> list[dict]:
         """Parse JavaScript parameter string."""
         params = []
 
@@ -373,15 +371,15 @@ class CodeAnalyzer:
             return params
 
         # Split by comma (simplified - doesn't handle complex default values)
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
                 continue
 
             # Check for default value
-            if '=' in param:
-                name, default = param.split('=', 1)
+            if "=" in param:
+                name, default = param.split("=", 1)
                 name = name.strip()
                 default = default.strip()
             else:
@@ -390,20 +388,16 @@ class CodeAnalyzer:
 
             # Check for type annotation (TypeScript)
             type_hint = None
-            if ':' in name:
-                name, type_hint = name.split(':', 1)
+            if ":" in name:
+                name, type_hint = name.split(":", 1)
                 name = name.strip()
                 type_hint = type_hint.strip()
 
-            params.append({
-                'name': name,
-                'type_hint': type_hint,
-                'default': default
-            })
+            params.append({"name": name, "type_hint": type_hint, "default": default})
 
         return params
 
-    def _analyze_cpp(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_cpp(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze C/C++ header file using regex patterns.
 
@@ -414,61 +408,61 @@ class CodeAnalyzer:
         functions = []
 
         # Extract class definitions (simplified - doesn't handle nested classes)
-        class_pattern = r'class\s+(\w+)(?:\s*:\s*public\s+(\w+))?\s*\{'
+        class_pattern = r"class\s+(\w+)(?:\s*:\s*public\s+(\w+))?\s*\{"
         for match in re.finditer(class_pattern, content):
             class_name = match.group(1)
             base_class = match.group(2) if match.group(2) else None
 
-            classes.append({
-                'name': class_name,
-                'base_classes': [base_class] if base_class else [],
-                'methods': [],  # Simplified - would need to parse class body
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": class_name,
+                    "base_classes": [base_class] if base_class else [],
+                    "methods": [],  # Simplified - would need to parse class body
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract function declarations
-        func_pattern = r'(\w+(?:\s*\*|\s*&)?)\s+(\w+)\s*\(([^)]*)\)'
+        func_pattern = r"(\w+(?:\s*\*|\s*&)?)\s+(\w+)\s*\(([^)]*)\)"
         for match in re.finditer(func_pattern, content):
             return_type = match.group(1).strip()
             func_name = match.group(2)
             params_str = match.group(3)
 
             # Skip common keywords
-            if func_name in ['if', 'for', 'while', 'switch', 'return']:
+            if func_name in ["if", "for", "while", "switch", "return"]:
                 continue
 
             params = self._parse_cpp_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': False,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": False,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_cpp_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _parse_cpp_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_cpp_parameters(self, params_str: str) -> list[dict]:
         """Parse C++ parameter string."""
         params = []
 
-        if not params_str.strip() or params_str.strip() == 'void':
+        if not params_str.strip() or params_str.strip() == "void":
             return params
 
         # Split by comma (simplified)
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
@@ -476,8 +470,8 @@ class CodeAnalyzer:
 
             # Check for default value
             default = None
-            if '=' in param:
-                param, default = param.rsplit('=', 1)
+            if "=" in param:
+                param, default = param.rsplit("=", 1)
                 param = param.strip()
                 default = default.strip()
 
@@ -485,21 +479,17 @@ class CodeAnalyzer:
             # Format: "type name" or "type* name" or "type& name"
             parts = param.split()
             if len(parts) >= 2:
-                param_type = ' '.join(parts[:-1])
+                param_type = " ".join(parts[:-1])
                 param_name = parts[-1]
             else:
                 param_type = param
                 param_name = "unknown"
 
-            params.append({
-                'name': param_name,
-                'type_hint': param_type,
-                'default': default
-            })
+            params.append({"name": param_name, "type_hint": param_type, "default": default})
 
         return params
 
-    def _extract_python_comments(self, content: str) -> List[Dict]:
+    def _extract_python_comments(self, content: str) -> list[dict]:
         """
         Extract Python comments (# style).
 
@@ -511,21 +501,17 @@ class CodeAnalyzer:
             stripped = line.strip()
 
             # Skip shebang and encoding declarations
-            if stripped.startswith('#!') or stripped.startswith('#') and 'coding' in stripped:
+            if stripped.startswith("#!") or stripped.startswith("#") and "coding" in stripped:
                 continue
 
             # Extract regular comments
-            if stripped.startswith('#'):
+            if stripped.startswith("#"):
                 comment_text = stripped[1:].strip()
-                comments.append({
-                    'line': i,
-                    'text': comment_text,
-                    'type': 'inline'
-                })
+                comments.append({"line": i, "text": comment_text, "type": "inline"})
 
         return comments
 
-    def _extract_js_comments(self, content: str) -> List[Dict]:
+    def _extract_js_comments(self, content: str) -> list[dict]:
         """
         Extract JavaScript/TypeScript comments (// and /* */ styles).
 
@@ -534,30 +520,22 @@ class CodeAnalyzer:
         comments = []
 
         # Extract single-line comments (//)
-        for match in re.finditer(r'//(.+)$', content, re.MULTILINE):
-            line_num = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"//(.+)$", content, re.MULTILINE):
+            line_num = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
-            comments.append({
-                'line': line_num,
-                'text': comment_text,
-                'type': 'inline'
-            })
+            comments.append({"line": line_num, "text": comment_text, "type": "inline"})
 
         # Extract multi-line comments (/* */)
-        for match in re.finditer(r'/\*(.+?)\*/', content, re.DOTALL):
-            start_line = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"/\*(.+?)\*/", content, re.DOTALL):
+            start_line = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
-            comments.append({
-                'line': start_line,
-                'text': comment_text,
-                'type': 'block'
-            })
+            comments.append({"line": start_line, "text": comment_text, "type": "block"})
 
         return comments
 
-    def _extract_cpp_comments(self, content: str) -> List[Dict]:
+    def _extract_cpp_comments(self, content: str) -> list[dict]:
         """
         Extract C++ comments (// and /* */ styles, same as JavaScript).
 
@@ -566,7 +544,7 @@ class CodeAnalyzer:
         # C++ uses the same comment syntax as JavaScript
         return self._extract_js_comments(content)
 
-    def _analyze_csharp(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_csharp(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze C# file using regex patterns.
 
@@ -581,15 +559,15 @@ class CodeAnalyzer:
 
         # Extract class definitions
         # Matches: [modifiers] class ClassName [: BaseClass] [, Interface]
-        class_pattern = r'(?:public|private|internal|protected)?\s*(?:static|abstract|sealed)?\s*class\s+(\w+)(?:\s*:\s*([\w\s,<>]+))?\s*\{'
+        class_pattern = r"(?:public|private|internal|protected)?\s*(?:static|abstract|sealed)?\s*class\s+(\w+)(?:\s*:\s*([\w\s,<>]+))?\s*\{"
         for match in re.finditer(class_pattern, content):
             class_name = match.group(1)
-            bases_str = match.group(2) if match.group(2) else ''
+            bases_str = match.group(2) if match.group(2) else ""
 
             # Parse base classes and interfaces
             base_classes = []
             if bases_str:
-                base_classes = [b.strip() for b in bases_str.split(',')]
+                base_classes = [b.strip() for b in bases_str.split(",")]
 
             # Try to extract methods (simplified)
             class_block_start = match.end()
@@ -597,9 +575,9 @@ class CodeAnalyzer:
             brace_count = 1
             class_block_end = class_block_start
             for i, char in enumerate(content[class_block_start:], class_block_start):
-                if char == '{':
+                if char == "{":
                     brace_count += 1
-                elif char == '}':
+                elif char == "}":
                     brace_count -= 1
                     if brace_count == 0:
                         class_block_end = i
@@ -611,81 +589,83 @@ class CodeAnalyzer:
             else:
                 methods = []
 
-            classes.append({
-                'name': class_name,
-                'base_classes': base_classes,
-                'methods': methods,
-                'docstring': None,  # Would need to extract XML doc comments
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": class_name,
+                    "base_classes": base_classes,
+                    "methods": methods,
+                    "docstring": None,  # Would need to extract XML doc comments
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract top-level functions/methods
         # Matches: [modifiers] [async] ReturnType MethodName(params)
-        func_pattern = r'(?:public|private|internal|protected)?\s*(?:static|virtual|override|abstract)?\s*(?:async\s+)?(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)'
+        func_pattern = r"(?:public|private|internal|protected)?\s*(?:static|virtual|override|abstract)?\s*(?:async\s+)?(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)"
         for match in re.finditer(func_pattern, content):
             return_type = match.group(1).strip()
             func_name = match.group(2)
             params_str = match.group(3)
-            is_async = 'async' in match.group(0)
+            is_async = "async" in match.group(0)
 
             # Skip common keywords
-            if func_name in ['if', 'for', 'while', 'switch', 'return', 'using', 'namespace']:
+            if func_name in ["if", "for", "while", "switch", "return", "using", "namespace"]:
                 continue
 
             params = self._parse_csharp_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': is_async,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": is_async,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_csharp_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _extract_csharp_methods(self, class_body: str) -> List[Dict]:
+    def _extract_csharp_methods(self, class_body: str) -> list[dict]:
         """Extract C# method signatures from class body."""
         methods = []
 
         # Match method definitions
-        method_pattern = r'(?:public|private|internal|protected)?\s*(?:static|virtual|override|abstract)?\s*(?:async\s+)?(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)'
+        method_pattern = r"(?:public|private|internal|protected)?\s*(?:static|virtual|override|abstract)?\s*(?:async\s+)?(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)"
         for match in re.finditer(method_pattern, class_body):
             return_type = match.group(1).strip()
             method_name = match.group(2)
             params_str = match.group(3)
-            is_async = 'async' in match.group(0)
+            is_async = "async" in match.group(0)
 
             # Skip keywords
-            if method_name in ['if', 'for', 'while', 'switch', 'get', 'set']:
+            if method_name in ["if", "for", "while", "switch", "get", "set"]:
                 continue
 
             params = self._parse_csharp_parameters(params_str)
 
-            methods.append({
-                'name': method_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': None,
-                'is_async': is_async,
-                'is_method': True,
-                'decorators': []
-            })
+            methods.append(
+                {
+                    "name": method_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": None,
+                    "is_async": is_async,
+                    "is_method": True,
+                    "decorators": [],
+                }
+            )
 
         return methods
 
-    def _parse_csharp_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_csharp_parameters(self, params_str: str) -> list[dict]:
         """Parse C# parameter string."""
         params = []
 
@@ -693,7 +673,7 @@ class CodeAnalyzer:
             return params
 
         # Split by comma (simplified)
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
@@ -701,8 +681,8 @@ class CodeAnalyzer:
 
             # Check for default value
             default = None
-            if '=' in param:
-                param, default = param.split('=', 1)
+            if "=" in param:
+                param, default = param.split("=", 1)
                 param = param.strip()
                 default = default.strip()
 
@@ -710,7 +690,7 @@ class CodeAnalyzer:
             parts = param.split()
             if len(parts) >= 2:
                 # Remove ref/out modifiers
-                if parts[0] in ['ref', 'out', 'in', 'params']:
+                if parts[0] in ["ref", "out", "in", "params"]:
                     parts = parts[1:]
 
                 if len(parts) >= 2:
@@ -723,46 +703,34 @@ class CodeAnalyzer:
                 param_type = None
                 param_name = param
 
-            params.append({
-                'name': param_name,
-                'type_hint': param_type,
-                'default': default
-            })
+            params.append({"name": param_name, "type_hint": param_type, "default": default})
 
         return params
 
-    def _extract_csharp_comments(self, content: str) -> List[Dict]:
+    def _extract_csharp_comments(self, content: str) -> list[dict]:
         """Extract C# comments (// and /* */ and /// XML docs)."""
         comments = []
 
         # Single-line comments (//)
-        for match in re.finditer(r'//(.+)$', content, re.MULTILINE):
-            line_num = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"//(.+)$", content, re.MULTILINE):
+            line_num = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
             # Distinguish XML doc comments (///)
-            comment_type = 'doc' if match.group(1).startswith('/') else 'inline'
+            comment_type = "doc" if match.group(1).startswith("/") else "inline"
 
-            comments.append({
-                'line': line_num,
-                'text': comment_text.lstrip('/').strip(),
-                'type': comment_type
-            })
+            comments.append({"line": line_num, "text": comment_text.lstrip("/").strip(), "type": comment_type})
 
         # Multi-line comments (/* */)
-        for match in re.finditer(r'/\*(.+?)\*/', content, re.DOTALL):
-            start_line = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"/\*(.+?)\*/", content, re.DOTALL):
+            start_line = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
-            comments.append({
-                'line': start_line,
-                'text': comment_text,
-                'type': 'block'
-            })
+            comments.append({"line": start_line, "text": comment_text, "type": "block"})
 
         return comments
 
-    def _analyze_go(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_go(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze Go file using regex patterns.
 
@@ -776,21 +744,23 @@ class CodeAnalyzer:
         functions = []
 
         # Extract struct definitions (Go's equivalent of classes)
-        struct_pattern = r'type\s+(\w+)\s+struct\s*\{'
+        struct_pattern = r"type\s+(\w+)\s+struct\s*\{"
         for match in re.finditer(struct_pattern, content):
             struct_name = match.group(1)
 
-            classes.append({
-                'name': struct_name,
-                'base_classes': [],  # Go uses embedding, not inheritance
-                'methods': [],  # Methods extracted separately
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": struct_name,
+                    "base_classes": [],  # Go uses embedding, not inheritance
+                    "methods": [],  # Methods extracted separately
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract function definitions
         # Matches: func [receiver] name(params) [returns]
-        func_pattern = r'func\s+(?:\((\w+)\s+\*?(\w+)\)\s+)?(\w+)\s*\(([^)]*)\)(?:\s+\(([^)]+)\)|(?:\s+(\w+(?:\[.*?\])?(?:,\s*\w+)*)))?'
+        func_pattern = r"func\s+(?:\((\w+)\s+\*?(\w+)\)\s+)?(\w+)\s*\(([^)]*)\)(?:\s+\(([^)]+)\)|(?:\s+(\w+(?:\[.*?\])?(?:,\s*\w+)*)))?"
         for match in re.finditer(func_pattern, content):
             receiver_var = match.group(1)
             receiver_type = match.group(2)
@@ -811,27 +781,25 @@ class CodeAnalyzer:
 
             params = self._parse_go_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': False,  # Go uses goroutines differently
-                'is_method': is_method,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": False,  # Go uses goroutines differently
+                    "is_method": is_method,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_go_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _parse_go_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_go_parameters(self, params_str: str) -> list[dict]:
         """Parse Go parameter string."""
         params = []
 
@@ -839,7 +807,7 @@ class CodeAnalyzer:
             return params
 
         # Split by comma
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
@@ -851,25 +819,27 @@ class CodeAnalyzer:
             if len(parts) >= 2:
                 # Last part is type
                 param_type = parts[-1]
-                param_name = ' '.join(parts[:-1])
+                param_name = " ".join(parts[:-1])
             else:
                 param_type = param
                 param_name = "unknown"
 
-            params.append({
-                'name': param_name,
-                'type_hint': param_type,
-                'default': None  # Go doesn't support default parameters
-            })
+            params.append(
+                {
+                    "name": param_name,
+                    "type_hint": param_type,
+                    "default": None,  # Go doesn't support default parameters
+                }
+            )
 
         return params
 
-    def _extract_go_comments(self, content: str) -> List[Dict]:
+    def _extract_go_comments(self, content: str) -> list[dict]:
         """Extract Go comments (// and /* */ styles)."""
         # Go uses C-style comments
         return self._extract_js_comments(content)
 
-    def _analyze_rust(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_rust(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze Rust file using regex patterns.
 
@@ -883,50 +853,50 @@ class CodeAnalyzer:
         functions = []
 
         # Extract struct definitions
-        struct_pattern = r'(?:pub\s+)?struct\s+(\w+)(?:<[^>]+>)?\s*\{'
+        struct_pattern = r"(?:pub\s+)?struct\s+(\w+)(?:<[^>]+>)?\s*\{"
         for match in re.finditer(struct_pattern, content):
             struct_name = match.group(1)
 
-            classes.append({
-                'name': struct_name,
-                'base_classes': [],  # Rust uses traits, not inheritance
-                'methods': [],
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": struct_name,
+                    "base_classes": [],  # Rust uses traits, not inheritance
+                    "methods": [],
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract function definitions
         # Matches: [pub] [async] [unsafe] [const] fn name<generics>(params) -> ReturnType
-        func_pattern = r'(?:pub\s+)?(?:async\s+)?(?:unsafe\s+)?(?:const\s+)?fn\s+(\w+)(?:<[^>]+>)?\s*\(([^)]*)\)(?:\s*->\s*([^{;]+))?'
+        func_pattern = r"(?:pub\s+)?(?:async\s+)?(?:unsafe\s+)?(?:const\s+)?fn\s+(\w+)(?:<[^>]+>)?\s*\(([^)]*)\)(?:\s*->\s*([^{;]+))?"
         for match in re.finditer(func_pattern, content):
             func_name = match.group(1)
             params_str = match.group(2)
             return_type = match.group(3).strip() if match.group(3) else None
-            is_async = 'async' in match.group(0)
+            is_async = "async" in match.group(0)
 
             params = self._parse_rust_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': is_async,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": is_async,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_rust_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _parse_rust_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_rust_parameters(self, params_str: str) -> list[dict]:
         """Parse Rust parameter string."""
         params = []
 
@@ -934,15 +904,15 @@ class CodeAnalyzer:
             return params
 
         # Split by comma
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
                 continue
 
             # Rust format: name: type or &self
-            if ':' in param:
-                name, param_type = param.split(':', 1)
+            if ":" in param:
+                name, param_type = param.split(":", 1)
                 name = name.strip()
                 param_type = param_type.strip()
             else:
@@ -950,50 +920,44 @@ class CodeAnalyzer:
                 name = param
                 param_type = None
 
-            params.append({
-                'name': name,
-                'type_hint': param_type,
-                'default': None  # Rust doesn't support default parameters
-            })
+            params.append(
+                {
+                    "name": name,
+                    "type_hint": param_type,
+                    "default": None,  # Rust doesn't support default parameters
+                }
+            )
 
         return params
 
-    def _extract_rust_comments(self, content: str) -> List[Dict]:
+    def _extract_rust_comments(self, content: str) -> list[dict]:
         """Extract Rust comments (// and /* */ and /// doc comments)."""
         comments = []
 
         # Single-line comments (//)
-        for match in re.finditer(r'//(.+)$', content, re.MULTILINE):
-            line_num = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"//(.+)$", content, re.MULTILINE):
+            line_num = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
             # Distinguish doc comments (/// or //!)
-            if comment_text.startswith('/') or comment_text.startswith('!'):
-                comment_type = 'doc'
-                comment_text = comment_text.lstrip('/!').strip()
+            if comment_text.startswith("/") or comment_text.startswith("!"):
+                comment_type = "doc"
+                comment_text = comment_text.lstrip("/!").strip()
             else:
-                comment_type = 'inline'
+                comment_type = "inline"
 
-            comments.append({
-                'line': line_num,
-                'text': comment_text,
-                'type': comment_type
-            })
+            comments.append({"line": line_num, "text": comment_text, "type": comment_type})
 
         # Multi-line comments (/* */)
-        for match in re.finditer(r'/\*(.+?)\*/', content, re.DOTALL):
-            start_line = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"/\*(.+?)\*/", content, re.DOTALL):
+            start_line = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
-            comments.append({
-                'line': start_line,
-                'text': comment_text,
-                'type': 'block'
-            })
+            comments.append({"line": start_line, "text": comment_text, "type": "block"})
 
         return comments
 
-    def _analyze_java(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_java(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze Java file using regex patterns.
 
@@ -1008,7 +972,7 @@ class CodeAnalyzer:
 
         # Extract class definitions
         # Matches: [modifiers] class ClassName [extends Base] [implements Interfaces]
-        class_pattern = r'(?:public|private|protected)?\s*(?:static|final|abstract)?\s*class\s+(\w+)(?:\s+extends\s+(\w+))?(?:\s+implements\s+([\w\s,]+))?\s*\{'
+        class_pattern = r"(?:public|private|protected)?\s*(?:static|final|abstract)?\s*class\s+(\w+)(?:\s+extends\s+(\w+))?(?:\s+implements\s+([\w\s,]+))?\s*\{"
         for match in re.finditer(class_pattern, content):
             class_name = match.group(1)
             base_class = match.group(2)
@@ -1018,16 +982,16 @@ class CodeAnalyzer:
             if base_class:
                 base_classes.append(base_class)
             if interfaces_str:
-                base_classes.extend([i.strip() for i in interfaces_str.split(',')])
+                base_classes.extend([i.strip() for i in interfaces_str.split(",")])
 
             # Extract methods (simplified)
             class_block_start = match.end()
             brace_count = 1
             class_block_end = class_block_start
             for i, char in enumerate(content[class_block_start:], class_block_start):
-                if char == '{':
+                if char == "{":
                     brace_count += 1
-                elif char == '}':
+                elif char == "}":
                     brace_count -= 1
                     if brace_count == 0:
                         class_block_end = i
@@ -1039,77 +1003,79 @@ class CodeAnalyzer:
             else:
                 methods = []
 
-            classes.append({
-                'name': class_name,
-                'base_classes': base_classes,
-                'methods': methods,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": class_name,
+                    "base_classes": base_classes,
+                    "methods": methods,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract top-level functions (rare in Java, but static methods)
-        func_pattern = r'(?:public|private|protected)?\s*(?:static|final|synchronized)?\s*(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)'
+        func_pattern = r"(?:public|private|protected)?\s*(?:static|final|synchronized)?\s*(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)"
         for match in re.finditer(func_pattern, content):
             return_type = match.group(1).strip()
             func_name = match.group(2)
             params_str = match.group(3)
 
             # Skip keywords
-            if func_name in ['if', 'for', 'while', 'switch', 'return', 'class', 'void']:
+            if func_name in ["if", "for", "while", "switch", "return", "class", "void"]:
                 continue
 
             params = self._parse_java_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': False,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": False,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_java_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _extract_java_methods(self, class_body: str) -> List[Dict]:
+    def _extract_java_methods(self, class_body: str) -> list[dict]:
         """Extract Java method signatures from class body."""
         methods = []
 
-        method_pattern = r'(?:public|private|protected)?\s*(?:static|final|synchronized)?\s*(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)'
+        method_pattern = r"(?:public|private|protected)?\s*(?:static|final|synchronized)?\s*(\w+(?:<[\w\s,]+>)?)\s+(\w+)\s*\(([^)]*)\)"
         for match in re.finditer(method_pattern, class_body):
             return_type = match.group(1).strip()
             method_name = match.group(2)
             params_str = match.group(3)
 
             # Skip keywords
-            if method_name in ['if', 'for', 'while', 'switch']:
+            if method_name in ["if", "for", "while", "switch"]:
                 continue
 
             params = self._parse_java_parameters(params_str)
 
-            methods.append({
-                'name': method_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': None,
-                'is_async': False,
-                'is_method': True,
-                'decorators': []
-            })
+            methods.append(
+                {
+                    "name": method_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": None,
+                    "is_async": False,
+                    "is_method": True,
+                    "decorators": [],
+                }
+            )
 
         return methods
 
-    def _parse_java_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_java_parameters(self, params_str: str) -> list[dict]:
         """Parse Java parameter string."""
         params = []
 
@@ -1117,7 +1083,7 @@ class CodeAnalyzer:
             return params
 
         # Split by comma
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
@@ -1127,7 +1093,7 @@ class CodeAnalyzer:
             parts = param.split()
             if len(parts) >= 2:
                 # Remove 'final' if present
-                if parts[0] == 'final':
+                if parts[0] == "final":
                     parts = parts[1:]
 
                 if len(parts) >= 2:
@@ -1140,46 +1106,40 @@ class CodeAnalyzer:
                 param_type = param
                 param_name = "unknown"
 
-            params.append({
-                'name': param_name,
-                'type_hint': param_type,
-                'default': None  # Java doesn't support default parameters
-            })
+            params.append(
+                {
+                    "name": param_name,
+                    "type_hint": param_type,
+                    "default": None,  # Java doesn't support default parameters
+                }
+            )
 
         return params
 
-    def _extract_java_comments(self, content: str) -> List[Dict]:
+    def _extract_java_comments(self, content: str) -> list[dict]:
         """Extract Java comments (// and /* */ and /** JavaDoc */)."""
         comments = []
 
         # Single-line comments (//)
-        for match in re.finditer(r'//(.+)$', content, re.MULTILINE):
-            line_num = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"//(.+)$", content, re.MULTILINE):
+            line_num = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
-            comments.append({
-                'line': line_num,
-                'text': comment_text,
-                'type': 'inline'
-            })
+            comments.append({"line": line_num, "text": comment_text, "type": "inline"})
 
         # Multi-line and JavaDoc comments (/* */ and /** */)
-        for match in re.finditer(r'/\*\*?(.+?)\*/', content, re.DOTALL):
-            start_line = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"/\*\*?(.+?)\*/", content, re.DOTALL):
+            start_line = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
             # Distinguish JavaDoc (starts with **)
-            comment_type = 'doc' if match.group(0).startswith('/**') else 'block'
+            comment_type = "doc" if match.group(0).startswith("/**") else "block"
 
-            comments.append({
-                'line': start_line,
-                'text': comment_text,
-                'type': comment_type
-            })
+            comments.append({"line": start_line, "text": comment_text, "type": comment_type})
 
         return comments
 
-    def _analyze_ruby(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_ruby(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze Ruby file using regex patterns.
 
@@ -1193,51 +1153,51 @@ class CodeAnalyzer:
         functions = []
 
         # Extract class definitions
-        class_pattern = r'class\s+(\w+)(?:\s*<\s*(\w+))?\s*$'
+        class_pattern = r"class\s+(\w+)(?:\s*<\s*(\w+))?\s*$"
         for match in re.finditer(class_pattern, content, re.MULTILINE):
             class_name = match.group(1)
             base_class = match.group(2)
 
             base_classes = [base_class] if base_class else []
 
-            classes.append({
-                'name': class_name,
-                'base_classes': base_classes,
-                'methods': [],  # Would need to parse class body
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": class_name,
+                    "base_classes": base_classes,
+                    "methods": [],  # Would need to parse class body
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract method/function definitions
         # Matches: def method_name(params)
-        func_pattern = r'def\s+(?:self\.)?(\w+[?!]?)\s*(?:\(([^)]*)\))?'
+        func_pattern = r"def\s+(?:self\.)?(\w+[?!]?)\s*(?:\(([^)]*)\))?"
         for match in re.finditer(func_pattern, content):
             func_name = match.group(1)
-            params_str = match.group(2) if match.group(2) else ''
+            params_str = match.group(2) if match.group(2) else ""
 
             params = self._parse_ruby_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': None,  # Ruby has no type annotations (usually)
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': False,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": None,  # Ruby has no type annotations (usually)
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": False,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_ruby_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _parse_ruby_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_ruby_parameters(self, params_str: str) -> list[dict]:
         """Parse Ruby parameter string."""
         params = []
 
@@ -1245,7 +1205,7 @@ class CodeAnalyzer:
             return params
 
         # Split by comma
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
@@ -1253,23 +1213,19 @@ class CodeAnalyzer:
 
             # Check for default value
             default = None
-            if '=' in param:
-                name, default = param.split('=', 1)
+            if "=" in param:
+                name, default = param.split("=", 1)
                 name = name.strip()
                 default = default.strip()
             else:
                 name = param
 
             # Ruby doesn't have type hints in method signatures
-            params.append({
-                'name': name,
-                'type_hint': None,
-                'default': default
-            })
+            params.append({"name": name, "type_hint": None, "default": default})
 
         return params
 
-    def _extract_ruby_comments(self, content: str) -> List[Dict]:
+    def _extract_ruby_comments(self, content: str) -> list[dict]:
         """Extract Ruby comments (# style)."""
         comments = []
 
@@ -1277,17 +1233,13 @@ class CodeAnalyzer:
             stripped = line.strip()
 
             # Ruby comments start with #
-            if stripped.startswith('#'):
+            if stripped.startswith("#"):
                 comment_text = stripped[1:].strip()
-                comments.append({
-                    'line': i,
-                    'text': comment_text,
-                    'type': 'inline'
-                })
+                comments.append({"line": i, "text": comment_text, "type": "inline"})
 
         return comments
 
-    def _analyze_php(self, content: str, file_path: str) -> Dict[str, Any]:
+    def _analyze_php(self, content: str, file_path: str) -> dict[str, Any]:
         """
         Analyze PHP file using regex patterns.
 
@@ -1301,7 +1253,7 @@ class CodeAnalyzer:
         functions = []
 
         # Extract class definitions
-        class_pattern = r'(?:abstract\s+)?class\s+(\w+)(?:\s+extends\s+(\w+))?(?:\s+implements\s+([\w\s,]+))?\s*\{'
+        class_pattern = r"(?:abstract\s+)?class\s+(\w+)(?:\s+extends\s+(\w+))?(?:\s+implements\s+([\w\s,]+))?\s*\{"
         for match in re.finditer(class_pattern, content):
             class_name = match.group(1)
             base_class = match.group(2)
@@ -1311,16 +1263,16 @@ class CodeAnalyzer:
             if base_class:
                 base_classes.append(base_class)
             if interfaces_str:
-                base_classes.extend([i.strip() for i in interfaces_str.split(',')])
+                base_classes.extend([i.strip() for i in interfaces_str.split(",")])
 
             # Extract methods (simplified)
             class_block_start = match.end()
             brace_count = 1
             class_block_end = class_block_start
             for i, char in enumerate(content[class_block_start:], class_block_start):
-                if char == '{':
+                if char == "{":
                     brace_count += 1
-                elif char == '}':
+                elif char == "}":
                     brace_count -= 1
                     if brace_count == 0:
                         class_block_end = i
@@ -1332,16 +1284,18 @@ class CodeAnalyzer:
             else:
                 methods = []
 
-            classes.append({
-                'name': class_name,
-                'base_classes': base_classes,
-                'methods': methods,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1
-            })
+            classes.append(
+                {
+                    "name": class_name,
+                    "base_classes": base_classes,
+                    "methods": methods,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                }
+            )
 
         # Extract function definitions
-        func_pattern = r'function\s+(\w+)\s*\(([^)]*)\)(?:\s*:\s*(\??\w+))?'
+        func_pattern = r"function\s+(\w+)\s*\(([^)]*)\)(?:\s*:\s*(\??\w+))?"
         for match in re.finditer(func_pattern, content):
             func_name = match.group(1)
             params_str = match.group(2)
@@ -1349,31 +1303,31 @@ class CodeAnalyzer:
 
             params = self._parse_php_parameters(params_str)
 
-            functions.append({
-                'name': func_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': content[:match.start()].count('\n') + 1,
-                'is_async': False,
-                'is_method': False,
-                'decorators': []
-            })
+            functions.append(
+                {
+                    "name": func_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": content[: match.start()].count("\n") + 1,
+                    "is_async": False,
+                    "is_method": False,
+                    "decorators": [],
+                }
+            )
 
         # Extract comments
         comments = self._extract_php_comments(content)
 
-        return {
-            'classes': classes,
-            'functions': functions,
-            'comments': comments
-        }
+        return {"classes": classes, "functions": functions, "comments": comments}
 
-    def _extract_php_methods(self, class_body: str) -> List[Dict]:
+    def _extract_php_methods(self, class_body: str) -> list[dict]:
         """Extract PHP method signatures from class body."""
         methods = []
 
-        method_pattern = r'(?:public|private|protected)?\s*(?:static|final)?\s*function\s+(\w+)\s*\(([^)]*)\)(?:\s*:\s*(\??\w+))?'
+        method_pattern = (
+            r"(?:public|private|protected)?\s*(?:static|final)?\s*function\s+(\w+)\s*\(([^)]*)\)(?:\s*:\s*(\??\w+))?"
+        )
         for match in re.finditer(method_pattern, class_body):
             method_name = match.group(1)
             params_str = match.group(2)
@@ -1381,20 +1335,22 @@ class CodeAnalyzer:
 
             params = self._parse_php_parameters(params_str)
 
-            methods.append({
-                'name': method_name,
-                'parameters': params,
-                'return_type': return_type,
-                'docstring': None,
-                'line_number': None,
-                'is_async': False,
-                'is_method': True,
-                'decorators': []
-            })
+            methods.append(
+                {
+                    "name": method_name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "docstring": None,
+                    "line_number": None,
+                    "is_async": False,
+                    "is_method": True,
+                    "decorators": [],
+                }
+            )
 
         return methods
 
-    def _parse_php_parameters(self, params_str: str) -> List[Dict]:
+    def _parse_php_parameters(self, params_str: str) -> list[dict]:
         """Parse PHP parameter string."""
         params = []
 
@@ -1402,7 +1358,7 @@ class CodeAnalyzer:
             return params
 
         # Split by comma
-        param_list = [p.strip() for p in params_str.split(',')]
+        param_list = [p.strip() for p in params_str.split(",")]
 
         for param in param_list:
             if not param:
@@ -1410,8 +1366,8 @@ class CodeAnalyzer:
 
             # Check for default value
             default = None
-            if '=' in param:
-                param, default = param.split('=', 1)
+            if "=" in param:
+                param, default = param.split("=", 1)
                 param = param.strip()
                 default = default.strip()
 
@@ -1425,50 +1381,38 @@ class CodeAnalyzer:
                 param_name = parts[0] if parts else "unknown"
 
             # Remove $ from variable name
-            if param_name.startswith('$'):
+            if param_name.startswith("$"):
                 param_name = param_name[1:]
 
-            params.append({
-                'name': param_name,
-                'type_hint': param_type,
-                'default': default
-            })
+            params.append({"name": param_name, "type_hint": param_type, "default": default})
 
         return params
 
-    def _extract_php_comments(self, content: str) -> List[Dict]:
+    def _extract_php_comments(self, content: str) -> list[dict]:
         """Extract PHP comments (// and /* */ and # and /** PHPDoc */)."""
         comments = []
 
         # Single-line comments (// and #)
-        for match in re.finditer(r'(?://|#)(.+)$', content, re.MULTILINE):
-            line_num = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"(?://|#)(.+)$", content, re.MULTILINE):
+            line_num = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
-            comments.append({
-                'line': line_num,
-                'text': comment_text,
-                'type': 'inline'
-            })
+            comments.append({"line": line_num, "text": comment_text, "type": "inline"})
 
         # Multi-line and PHPDoc comments (/* */ and /** */)
-        for match in re.finditer(r'/\*\*?(.+?)\*/', content, re.DOTALL):
-            start_line = content[:match.start()].count('\n') + 1
+        for match in re.finditer(r"/\*\*?(.+?)\*/", content, re.DOTALL):
+            start_line = content[: match.start()].count("\n") + 1
             comment_text = match.group(1).strip()
 
             # Distinguish PHPDoc (starts with **)
-            comment_type = 'doc' if match.group(0).startswith('/**') else 'block'
+            comment_type = "doc" if match.group(0).startswith("/**") else "block"
 
-            comments.append({
-                'line': start_line,
-                'text': comment_text,
-                'type': comment_type
-            })
+            comments.append({"line": start_line, "text": comment_text, "type": comment_type})
 
         return comments
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Test the analyzer
     python_code = '''
 class Node2D:
@@ -1487,18 +1431,22 @@ def create_sprite(texture: str) -> Node2D:
     return Node2D()
 '''
 
-    analyzer = CodeAnalyzer(depth='deep')
-    result = analyzer.analyze_file('test.py', python_code, 'Python')
+    analyzer = CodeAnalyzer(depth="deep")
+    result = analyzer.analyze_file("test.py", python_code, "Python")
 
     print("Analysis Result:")
     print(f"Classes: {len(result.get('classes', []))}")
     print(f"Functions: {len(result.get('functions', []))}")
 
-    if result.get('classes'):
-        cls = result['classes'][0]
+    if result.get("classes"):
+        cls = result["classes"][0]
         print(f"\nClass: {cls['name']}")
         print(f"  Methods: {len(cls['methods'])}")
-        for method in cls['methods']:
-            params = ', '.join([f"{p['name']}: {p['type_hint']}" + (f" = {p['default']}" if p.get('default') else "")
-                               for p in method['parameters']])
+        for method in cls["methods"]:
+            params = ", ".join(
+                [
+                    f"{p['name']}: {p['type_hint']}" + (f" = {p['default']}" if p.get("default") else "")
+                    for p in method["parameters"]
+                ]
+            )
             print(f"    {method['name']}({params}) -> {method['return_type']}")
diff --git a/src/skill_seekers/cli/codebase_scraper.py b/src/skill_seekers/cli/codebase_scraper.py
index a4c12a9..03661b8 100644
--- a/src/skill_seekers/cli/codebase_scraper.py
+++ b/src/skill_seekers/cli/codebase_scraper.py
@@ -24,65 +24,80 @@ Credits:
     - pathspec for .gitignore support: https://pypi.org/project/pathspec/
 """
 
+import argparse
+import json
+import logging
 import os
 import sys
-import json
-import argparse
-import logging
 from pathlib import Path
-from typing import Dict, List, Optional, Any
+from typing import Any
 
 # Add parent directory to path for imports
 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
-from skill_seekers.cli.code_analyzer import CodeAnalyzer
 from skill_seekers.cli.api_reference_builder import APIReferenceBuilder
-from skill_seekers.cli.dependency_analyzer import DependencyAnalyzer
+from skill_seekers.cli.code_analyzer import CodeAnalyzer
 from skill_seekers.cli.config_extractor import ConfigExtractor
+from skill_seekers.cli.dependency_analyzer import DependencyAnalyzer
 
 # Try to import pathspec for .gitignore support
 try:
     import pathspec
+
     PATHSPEC_AVAILABLE = True
 except ImportError:
     PATHSPEC_AVAILABLE = False
 
 # Configure logging
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s - %(levelname)s - %(message)s'
-)
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
 logger = logging.getLogger(__name__)
 
 
 # Language extension mapping
 LANGUAGE_EXTENSIONS = {
-    '.py': 'Python',
-    '.js': 'JavaScript',
-    '.jsx': 'JavaScript',
-    '.ts': 'TypeScript',
-    '.tsx': 'TypeScript',
-    '.cpp': 'C++',
-    '.cc': 'C++',
-    '.cxx': 'C++',
-    '.h': 'C++',
-    '.hpp': 'C++',
-    '.hxx': 'C++',
-    '.c': 'C',
-    '.cs': 'C#',
-    '.go': 'Go',
-    '.rs': 'Rust',
-    '.java': 'Java',
-    '.rb': 'Ruby',
-    '.php': 'PHP',
+    ".py": "Python",
+    ".js": "JavaScript",
+    ".jsx": "JavaScript",
+    ".ts": "TypeScript",
+    ".tsx": "TypeScript",
+    ".cpp": "C++",
+    ".cc": "C++",
+    ".cxx": "C++",
+    ".h": "C++",
+    ".hpp": "C++",
+    ".hxx": "C++",
+    ".c": "C",
+    ".cs": "C#",
+    ".go": "Go",
+    ".rs": "Rust",
+    ".java": "Java",
+    ".rb": "Ruby",
+    ".php": "PHP",
 }
 
 # Default directories to exclude
 DEFAULT_EXCLUDED_DIRS = {
-    'node_modules', 'venv', '__pycache__', '.git', '.svn', '.hg',
-    'build', 'dist', 'target', '.pytest_cache', '.tox', '.mypy_cache',
-    'htmlcov', 'coverage', '.coverage', '.eggs', '*.egg-info',
-    '.idea', '.vscode', '.vs', '__pypackages__'
+    "node_modules",
+    "venv",
+    "__pycache__",
+    ".git",
+    ".svn",
+    ".hg",
+    "build",
+    "dist",
+    "target",
+    ".pytest_cache",
+    ".tox",
+    ".mypy_cache",
+    "htmlcov",
+    "coverage",
+    ".coverage",
+    ".eggs",
+    "*.egg-info",
+    ".idea",
+    ".vscode",
+    ".vs",
+    "__pypackages__",
 }
 
 
@@ -97,10 +112,10 @@ def detect_language(file_path: Path) -> str:
         Language name or 'Unknown'
     """
     extension = file_path.suffix.lower()
-    return LANGUAGE_EXTENSIONS.get(extension, 'Unknown')
+    return LANGUAGE_EXTENSIONS.get(extension, "Unknown")
 
 
-def load_gitignore(directory: Path) -> Optional[pathspec.PathSpec]:
+def load_gitignore(directory: Path) -> pathspec.PathSpec | None:
     """
     Load .gitignore file and create pathspec matcher.
 
@@ -115,14 +130,14 @@ def load_gitignore(directory: Path) -> Optional[pathspec.PathSpec]:
         logger.warning("Install with: pip install pathspec")
         return None
 
-    gitignore_path = directory / '.gitignore'
+    gitignore_path = directory / ".gitignore"
     if not gitignore_path.exists():
         logger.debug(f"No .gitignore found in {directory}")
         return None
 
     try:
-        with open(gitignore_path, 'r', encoding='utf-8') as f:
-            spec = pathspec.PathSpec.from_lines('gitwildmatch', f)
+        with open(gitignore_path, encoding="utf-8") as f:
+            spec = pathspec.PathSpec.from_lines("gitwildmatch", f)
         logger.info(f"Loaded .gitignore from {gitignore_path}")
         return spec
     except Exception as e:
@@ -146,10 +161,10 @@ def should_exclude_dir(dir_name: str, excluded_dirs: set) -> bool:
 
 def walk_directory(
     root: Path,
-    patterns: Optional[List[str]] = None,
-    gitignore_spec: Optional[pathspec.PathSpec] = None,
-    excluded_dirs: Optional[set] = None
-) -> List[Path]:
+    patterns: list[str] | None = None,
+    gitignore_spec: pathspec.PathSpec | None = None,
+    excluded_dirs: set | None = None,
+) -> list[Path]:
     """
     Walk directory tree and collect source files.
 
@@ -205,9 +220,9 @@ def walk_directory(
 def analyze_codebase(
     directory: Path,
     output_dir: Path,
-    depth: str = 'deep',
-    languages: Optional[List[str]] = None,
-    file_patterns: Optional[List[str]] = None,
+    depth: str = "deep",
+    languages: list[str] | None = None,
+    file_patterns: list[str] | None = None,
     build_api_reference: bool = True,
     extract_comments: bool = True,
     build_dependency_graph: bool = True,
@@ -216,8 +231,8 @@ def analyze_codebase(
     build_how_to_guides: bool = True,
     extract_config_patterns: bool = True,
     enhance_with_ai: bool = True,
-    ai_mode: str = "auto"
-) -> Dict[str, Any]:
+    ai_mode: str = "auto",
+) -> dict[str, Any]:
     """
     Analyze local codebase and extract code knowledge.
 
@@ -255,11 +270,7 @@ def analyze_codebase(
 
     # Walk directory tree
     logger.info("Scanning directory tree...")
-    files = walk_directory(
-        directory,
-        patterns=file_patterns,
-        gitignore_spec=gitignore_spec
-    )
+    files = walk_directory(directory, patterns=file_patterns, gitignore_spec=gitignore_spec)
 
     logger.info(f"Found {len(files)} source files")
 
@@ -273,27 +284,25 @@ def analyze_codebase(
     analyzer = CodeAnalyzer(depth=depth)
 
     # Analyze each file
-    results = {'files': []}
+    results = {"files": []}
     analyzed_count = 0
 
     for file_path in files:
         try:
-            content = file_path.read_text(encoding='utf-8', errors='ignore')
+            content = file_path.read_text(encoding="utf-8", errors="ignore")
             language = detect_language(file_path)
 
-            if language == 'Unknown':
+            if language == "Unknown":
                 continue
 
             # Analyze file
             analysis = analyzer.analyze_file(str(file_path), content, language)
 
             # Only include files with actual analysis results
-            if analysis and (analysis.get('classes') or analysis.get('functions')):
-                results['files'].append({
-                    'file': str(file_path.relative_to(directory)),
-                    'language': language,
-                    **analysis
-                })
+            if analysis and (analysis.get("classes") or analysis.get("functions")):
+                results["files"].append(
+                    {"file": str(file_path.relative_to(directory)), "language": language, **analysis}
+                )
                 analyzed_count += 1
 
                 if analyzed_count % 10 == 0:
@@ -306,17 +315,17 @@ def analyze_codebase(
     logger.info(f"✅ Successfully analyzed {analyzed_count} files")
 
     # Save results
-    output_json = output_dir / 'code_analysis.json'
-    with open(output_json, 'w', encoding='utf-8') as f:
+    output_json = output_dir / "code_analysis.json"
+    with open(output_json, "w", encoding="utf-8") as f:
         json.dump(results, f, indent=2)
 
     logger.info(f"📁 Saved analysis to: {output_json}")
 
     # Build API reference if requested
-    if build_api_reference and results['files']:
+    if build_api_reference and results["files"]:
         logger.info("Building API reference documentation...")
         builder = APIReferenceBuilder(results)
-        api_output_dir = output_dir / 'api_reference'
+        api_output_dir = output_dir / "api_reference"
         generated_files = builder.build_reference(api_output_dir)
         logger.info(f"✅ Generated {len(generated_files)} API reference files")
         logger.info(f"📁 API reference: {api_output_dir}")
@@ -329,10 +338,10 @@ def analyze_codebase(
         # Analyze dependencies for all files
         for file_path in files:
             try:
-                content = file_path.read_text(encoding='utf-8', errors='ignore')
+                content = file_path.read_text(encoding="utf-8", errors="ignore")
                 language = detect_language(file_path)
 
-                if language != 'Unknown':
+                if language != "Unknown":
                     # Use relative path from directory for better graph readability
                     rel_path = str(file_path.relative_to(directory))
                     dep_analyzer.analyze_file(rel_path, content, language)
@@ -348,7 +357,7 @@ def analyze_codebase(
         if cycles:
             logger.warning(f"⚠️  Found {len(cycles)} circular dependencies:")
             for i, cycle in enumerate(cycles[:5], 1):  # Show first 5
-                cycle_str = ' → '.join(cycle) + f" → {cycle[0]}"
+                cycle_str = " → ".join(cycle) + f" → {cycle[0]}"
                 logger.warning(f"  {i}. {cycle_str}")
             if len(cycles) > 5:
                 logger.warning(f"  ... and {len(cycles) - 5} more")
@@ -356,32 +365,34 @@ def analyze_codebase(
             logger.info("✅ No circular dependencies found")
 
         # Save dependency graph data
-        dep_output_dir = output_dir / 'dependencies'
+        dep_output_dir = output_dir / "dependencies"
         dep_output_dir.mkdir(parents=True, exist_ok=True)
 
         # Export as JSON
-        dep_json = dep_output_dir / 'dependency_graph.json'
-        with open(dep_json, 'w', encoding='utf-8') as f:
+        dep_json = dep_output_dir / "dependency_graph.json"
+        with open(dep_json, "w", encoding="utf-8") as f:
             json.dump(dep_analyzer.export_json(), f, indent=2)
         logger.info(f"📁 Saved dependency graph: {dep_json}")
 
         # Export as Mermaid diagram
-        mermaid_file = dep_output_dir / 'dependency_graph.mmd'
+        mermaid_file = dep_output_dir / "dependency_graph.mmd"
         mermaid_file.write_text(dep_analyzer.export_mermaid())
         logger.info(f"📁 Saved Mermaid diagram: {mermaid_file}")
 
         # Save statistics
         stats = dep_analyzer.get_statistics()
-        stats_file = dep_output_dir / 'statistics.json'
-        with open(stats_file, 'w', encoding='utf-8') as f:
+        stats_file = dep_output_dir / "statistics.json"
+        with open(stats_file, "w", encoding="utf-8") as f:
             json.dump(stats, f, indent=2)
-        logger.info(f"📊 Statistics: {stats['total_files']} files, "
-                   f"{stats['total_dependencies']} dependencies, "
-                   f"{stats['circular_dependencies']} cycles")
+        logger.info(
+            f"📊 Statistics: {stats['total_files']} files, "
+            f"{stats['total_dependencies']} dependencies, "
+            f"{stats['circular_dependencies']} cycles"
+        )
 
         # Try to export as DOT (requires pydot)
         try:
-            dot_file = dep_output_dir / 'dependency_graph.dot'
+            dot_file = dep_output_dir / "dependency_graph.dot"
             dep_analyzer.export_dot(str(dot_file))
         except:
             pass  # pydot not installed, skip DOT export
@@ -396,13 +407,11 @@ def analyze_codebase(
 
         for file_path in files:
             try:
-                content = file_path.read_text(encoding='utf-8', errors='ignore')
+                content = file_path.read_text(encoding="utf-8", errors="ignore")
                 language = detect_language(file_path)
 
-                if language != 'Unknown':
-                    report = pattern_recognizer.analyze_file(
-                        str(file_path), content, language
-                    )
+                if language != "Unknown":
+                    report = pattern_recognizer.analyze_file(str(file_path), content, language)
 
                     if report.patterns:
                         pattern_results.append(report.to_dict())
@@ -412,14 +421,14 @@ def analyze_codebase(
 
         # Save pattern results
         if pattern_results:
-            pattern_output = output_dir / 'patterns'
+            pattern_output = output_dir / "patterns"
             pattern_output.mkdir(parents=True, exist_ok=True)
 
-            pattern_json = pattern_output / 'detected_patterns.json'
-            with open(pattern_json, 'w', encoding='utf-8') as f:
+            pattern_json = pattern_output / "detected_patterns.json"
+            with open(pattern_json, "w", encoding="utf-8") as f:
                 json.dump(pattern_results, f, indent=2)
 
-            total_patterns = sum(len(r['patterns']) for r in pattern_results)
+            total_patterns = sum(len(r["patterns"]) for r in pattern_results)
             logger.info(f"✅ Detected {total_patterns} patterns in {len(pattern_results)} files")
             logger.info(f"📁 Saved to: {pattern_json}")
         else:
@@ -432,35 +441,31 @@ def analyze_codebase(
 
         # Create extractor
         test_extractor = TestExampleExtractor(
-            min_confidence=0.5,
-            max_per_file=10,
-            languages=languages,
-            enhance_with_ai=enhance_with_ai
+            min_confidence=0.5, max_per_file=10, languages=languages, enhance_with_ai=enhance_with_ai
         )
 
         # Extract examples from directory
         try:
-            example_report = test_extractor.extract_from_directory(
-                directory,
-                recursive=True
-            )
+            example_report = test_extractor.extract_from_directory(directory, recursive=True)
 
             if example_report.total_examples > 0:
                 # Save results
-                examples_output = output_dir / 'test_examples'
+                examples_output = output_dir / "test_examples"
                 examples_output.mkdir(parents=True, exist_ok=True)
 
                 # Save as JSON
-                examples_json = examples_output / 'test_examples.json'
-                with open(examples_json, 'w', encoding='utf-8') as f:
+                examples_json = examples_output / "test_examples.json"
+                with open(examples_json, "w", encoding="utf-8") as f:
                     json.dump(example_report.to_dict(), f, indent=2)
 
                 # Save as Markdown
-                examples_md = examples_output / 'test_examples.md'
-                examples_md.write_text(example_report.to_markdown(), encoding='utf-8')
+                examples_md = examples_output / "test_examples.md"
+                examples_md.write_text(example_report.to_markdown(), encoding="utf-8")
 
-                logger.info(f"✅ Extracted {example_report.total_examples} test examples "
-                           f"({example_report.high_value_count} high-value)")
+                logger.info(
+                    f"✅ Extracted {example_report.total_examples} test examples "
+                    f"({example_report.high_value_count} high-value)"
+                )
                 logger.info(f"📁 Saved to: {examples_output}")
             else:
                 logger.info("No test examples extracted")
@@ -479,25 +484,25 @@ def analyze_codebase(
             guide_builder = HowToGuideBuilder(enhance_with_ai=enhance_with_ai)
 
             # Build guides from workflow examples
-            tutorials_dir = output_dir / 'tutorials'
+            tutorials_dir = output_dir / "tutorials"
 
             # Get workflow examples from the example_report if available
-            if 'example_report' in locals() and example_report and example_report.total_examples > 0:
+            if "example_report" in locals() and example_report and example_report.total_examples > 0:
                 # Convert example_report to list of dicts for processing
-                examples_list = example_report.to_dict().get('examples', [])
+                examples_list = example_report.to_dict().get("examples", [])
 
                 guide_collection = guide_builder.build_guides_from_examples(
                     examples_list,
-                    grouping_strategy='ai-tutorial-group',
+                    grouping_strategy="ai-tutorial-group",
                     output_dir=tutorials_dir,
                     enhance_with_ai=enhance_with_ai,
-                    ai_mode=ai_mode
+                    ai_mode=ai_mode,
                 )
 
                 if guide_collection and guide_collection.total_guides > 0:
                     # Save collection summary
-                    collection_json = tutorials_dir / 'guide_collection.json'
-                    with open(collection_json, 'w', encoding='utf-8') as f:
+                    collection_json = tutorials_dir / "guide_collection.json"
+                    with open(collection_json, "w", encoding="utf-8") as f:
                         json.dump(guide_collection.to_dict(), f, indent=2)
 
                     logger.info(f"✅ Built {guide_collection.total_guides} how-to guides")
@@ -524,9 +529,10 @@ def analyze_codebase(
                 result_dict = config_extractor.to_dict(extraction_result)
 
                 # AI Enhancement (if enabled)
-                if enhance_with_ai and ai_mode != 'none':
+                if enhance_with_ai and ai_mode != "none":
                     try:
                         from skill_seekers.cli.config_enhancer import ConfigEnhancer
+
                         logger.info(f"🤖 Enhancing config analysis with AI (mode: {ai_mode})...")
                         enhancer = ConfigEnhancer(mode=ai_mode)
                         result_dict = enhancer.enhance_config_result(result_dict)
@@ -535,28 +541,30 @@ def analyze_codebase(
                         logger.warning(f"⚠️  Config AI enhancement failed: {e}")
 
                 # Save results
-                config_output = output_dir / 'config_patterns'
+                config_output = output_dir / "config_patterns"
                 config_output.mkdir(parents=True, exist_ok=True)
 
                 # Save as JSON
-                config_json = config_output / 'config_patterns.json'
-                with open(config_json, 'w', encoding='utf-8') as f:
+                config_json = config_output / "config_patterns.json"
+                with open(config_json, "w", encoding="utf-8") as f:
                     json.dump(result_dict, f, indent=2)
 
                 # Save as Markdown (basic - AI enhancements in JSON only for now)
-                config_md = config_output / 'config_patterns.md'
-                config_md.write_text(extraction_result.to_markdown(), encoding='utf-8')
+                config_md = config_output / "config_patterns.md"
+                config_md.write_text(extraction_result.to_markdown(), encoding="utf-8")
 
                 # Count total settings across all files
                 total_settings = sum(len(cf.settings) for cf in extraction_result.config_files)
                 total_patterns = sum(len(cf.patterns) for cf in extraction_result.config_files)
 
-                logger.info(f"✅ Extracted {len(extraction_result.config_files)} config files "
-                           f"with {total_settings} settings and {total_patterns} detected patterns")
+                logger.info(
+                    f"✅ Extracted {len(extraction_result.config_files)} config files "
+                    f"with {total_settings} settings and {total_patterns} detected patterns"
+                )
 
-                if 'ai_enhancements' in result_dict:
-                    insights = result_dict['ai_enhancements'].get('overall_insights', {})
-                    if insights.get('security_issues_found'):
+                if "ai_enhancements" in result_dict:
+                    insights = result_dict["ai_enhancements"].get("overall_insights", {})
+                    if insights.get("security_issues_found"):
                         logger.info(f"🔐 Security issues found: {insights['security_issues_found']}")
 
                 logger.info(f"📁 Saved to: {config_output}")
@@ -572,15 +580,15 @@ def analyze_codebase(
     from skill_seekers.cli.architectural_pattern_detector import ArchitecturalPatternDetector
 
     arch_detector = ArchitecturalPatternDetector(enhance_with_ai=enhance_with_ai)
-    arch_report = arch_detector.analyze(directory, results['files'])
+    arch_report = arch_detector.analyze(directory, results["files"])
 
     if arch_report.patterns:
-        arch_output = output_dir / 'architecture'
+        arch_output = output_dir / "architecture"
         arch_output.mkdir(parents=True, exist_ok=True)
 
         # Save as JSON
-        arch_json = arch_output / 'architectural_patterns.json'
-        with open(arch_json, 'w', encoding='utf-8') as f:
+        arch_json = arch_output / "architectural_patterns.json"
+        with open(arch_json, "w", encoding="utf-8") as f:
             json.dump(arch_report.to_dict(), f, indent=2)
 
         logger.info(f"🏗️  Detected {len(arch_report.patterns)} architectural patterns")
@@ -601,7 +609,7 @@ def analyze_codebase(
         build_dependency_graph=build_dependency_graph,
         detect_patterns=detect_patterns,
         extract_test_examples=extract_test_examples,
-        extract_config_patterns=extract_config_patterns
+        extract_config_patterns=extract_config_patterns,
     )
 
     return results
@@ -610,13 +618,13 @@ def analyze_codebase(
 def _generate_skill_md(
     output_dir: Path,
     directory: Path,
-    results: Dict[str, Any],
+    results: dict[str, Any],
     depth: str,
     build_api_reference: bool,
     build_dependency_graph: bool,
     detect_patterns: bool,
     extract_test_examples: bool,
-    extract_config_patterns: bool
+    extract_config_patterns: bool,
 ):
     """
     Generate rich SKILL.md from codebase analysis results.
@@ -635,14 +643,14 @@ def _generate_skill_md(
     repo_name = directory.name
 
     # Generate skill name (lowercase, hyphens only, max 64 chars)
-    skill_name = repo_name.lower().replace('_', '-').replace(' ', '-')[:64]
+    skill_name = repo_name.lower().replace("_", "-").replace(" ", "-")[:64]
 
     # Generate description
     description = f"Local codebase analysis for {repo_name}"
 
     # Count files by language
-    language_stats = _get_language_stats(results.get('files', []))
-    total_files = len(results.get('files', []))
+    language_stats = _get_language_stats(results.get("files", []))
+    total_files = len(results.get("files", []))
 
     # Start building content
     skill_content = f"""---
@@ -658,7 +666,7 @@ Local codebase analysis and documentation generated from code analysis.
 
 **Path:** `{directory}`
 **Files Analyzed:** {total_files}
-**Languages:** {', '.join(language_stats.keys())}
+**Languages:** {", ".join(language_stats.keys())}
 **Analysis Depth:** {depth}
 
 ## When to Use This Skill
@@ -732,22 +740,22 @@ Use this skill when you need to:
     skill_content += "This skill includes detailed reference documentation:\n\n"
 
     refs_added = False
-    if build_api_reference and (output_dir / 'api_reference').exists():
+    if build_api_reference and (output_dir / "api_reference").exists():
         skill_content += "- **API Reference**: `references/api_reference/` - Complete API documentation\n"
         refs_added = True
-    if build_dependency_graph and (output_dir / 'dependencies').exists():
+    if build_dependency_graph and (output_dir / "dependencies").exists():
         skill_content += "- **Dependencies**: `references/dependencies/` - Dependency graph and analysis\n"
         refs_added = True
-    if detect_patterns and (output_dir / 'patterns').exists():
+    if detect_patterns and (output_dir / "patterns").exists():
         skill_content += "- **Patterns**: `references/patterns/` - Detected design patterns\n"
         refs_added = True
-    if extract_test_examples and (output_dir / 'test_examples').exists():
+    if extract_test_examples and (output_dir / "test_examples").exists():
         skill_content += "- **Examples**: `references/test_examples/` - Usage examples from tests\n"
         refs_added = True
-    if extract_config_patterns and (output_dir / 'config_patterns').exists():
+    if extract_config_patterns and (output_dir / "config_patterns").exists():
         skill_content += "- **Configuration**: `references/config_patterns/` - Configuration patterns\n"
         refs_added = True
-    if (output_dir / 'architecture').exists():
+    if (output_dir / "architecture").exists():
         skill_content += "- **Architecture**: `references/architecture/` - Architectural patterns\n"
         refs_added = True
 
@@ -762,34 +770,34 @@ Use this skill when you need to:
 
     # Write SKILL.md
     skill_path = output_dir / "SKILL.md"
-    skill_path.write_text(skill_content, encoding='utf-8')
+    skill_path.write_text(skill_content, encoding="utf-8")
 
-    line_count = len(skill_content.split('\n'))
+    line_count = len(skill_content.split("\n"))
     logger.info(f"✅ Generated SKILL.md: {skill_path} ({line_count} lines)")
 
     # Generate references/ directory structure
     _generate_references(output_dir)
 
 
-def _get_language_stats(files: List[Dict]) -> Dict[str, int]:
+def _get_language_stats(files: list[dict]) -> dict[str, int]:
     """Count files by language from analysis results."""
     stats = {}
     for file_data in files:
         # files is a list of dicts with 'language' key
-        lang = file_data.get('language', 'Unknown')
-        if lang != 'Unknown':
+        lang = file_data.get("language", "Unknown")
+        if lang != "Unknown":
             stats[lang] = stats.get(lang, 0) + 1
     return stats
 
 
 def _format_patterns_section(output_dir: Path) -> str:
     """Format design patterns section from patterns/detected_patterns.json."""
-    patterns_file = output_dir / 'patterns' / 'detected_patterns.json'
+    patterns_file = output_dir / "patterns" / "detected_patterns.json"
     if not patterns_file.exists():
         return ""
 
     try:
-        with open(patterns_file, 'r', encoding='utf-8') as f:
+        with open(patterns_file, encoding="utf-8") as f:
             patterns_data = json.load(f)
     except Exception:
         return ""
@@ -802,10 +810,10 @@ def _format_patterns_section(output_dir: Path) -> str:
     by_class = {}
 
     for pattern_file in patterns_data:
-        for pattern in pattern_file.get('patterns', []):
-            ptype = pattern.get('pattern_type', 'Unknown')
-            cls = pattern.get('class_name', '')
-            confidence = pattern.get('confidence', 0)
+        for pattern in pattern_file.get("patterns", []):
+            ptype = pattern.get("pattern_type", "Unknown")
+            cls = pattern.get("class_name", "")
+            confidence = pattern.get("confidence", 0)
 
             # Skip low confidence
             if confidence < 0.7:
@@ -813,7 +821,7 @@ def _format_patterns_section(output_dir: Path) -> str:
 
             # Deduplicate by class
             key = f"{cls}:{ptype}"
-            if key not in by_class or by_class[key]['confidence'] < confidence:
+            if key not in by_class or by_class[key]["confidence"] < confidence:
                 by_class[key] = pattern
 
             # Count by type
@@ -836,22 +844,22 @@ def _format_patterns_section(output_dir: Path) -> str:
 
 def _format_examples_section(output_dir: Path) -> str:
     """Format code examples section from test_examples/test_examples.json."""
-    examples_file = output_dir / 'test_examples' / 'test_examples.json'
+    examples_file = output_dir / "test_examples" / "test_examples.json"
     if not examples_file.exists():
         return ""
 
     try:
-        with open(examples_file, 'r', encoding='utf-8') as f:
+        with open(examples_file, encoding="utf-8") as f:
             examples_data = json.load(f)
     except Exception:
         return ""
 
-    examples = examples_data.get('examples', [])
+    examples = examples_data.get("examples", [])
     if not examples:
         return ""
 
     # Filter high-value examples (complexity > 0.7)
-    high_value = [ex for ex in examples if ex.get('complexity_score', 0) > 0.7]
+    high_value = [ex for ex in examples if ex.get("complexity_score", 0) > 0.7]
 
     if not high_value:
         # If no high complexity, take any examples
@@ -864,11 +872,11 @@ def _format_examples_section(output_dir: Path) -> str:
     content += "*High-quality examples extracted from test files (C3.2)*\n\n"
 
     # Top 10 examples
-    for ex in sorted(high_value, key=lambda x: x.get('complexity_score', 0), reverse=True)[:10]:
-        desc = ex.get('description', 'Example')
-        lang = ex.get('language', 'python').lower()
-        code = ex.get('code', '')
-        complexity = ex.get('complexity_score', 0)
+    for ex in sorted(high_value, key=lambda x: x.get("complexity_score", 0), reverse=True)[:10]:
+        desc = ex.get("description", "Example")
+        lang = ex.get("language", "python").lower()
+        code = ex.get("code", "")
+        complexity = ex.get("complexity_score", 0)
 
         content += f"**{desc}** (complexity: {complexity:.2f})\n\n"
         content += f"```{lang}\n{code}\n```\n\n"
@@ -879,16 +887,16 @@ def _format_examples_section(output_dir: Path) -> str:
 
 def _format_api_section(output_dir: Path) -> str:
     """Format API reference section."""
-    api_dir = output_dir / 'api_reference'
+    api_dir = output_dir / "api_reference"
     if not api_dir.exists():
         return ""
 
-    api_md = api_dir / 'api_reference.md'
+    api_md = api_dir / "api_reference.md"
     if not api_md.exists():
         return ""
 
     try:
-        api_content = api_md.read_text(encoding='utf-8')
+        api_content = api_md.read_text(encoding="utf-8")
     except Exception:
         return ""
 
@@ -906,17 +914,17 @@ def _format_api_section(output_dir: Path) -> str:
 
 def _format_architecture_section(output_dir: Path) -> str:
     """Format architecture section from architecture/architectural_patterns.json."""
-    arch_file = output_dir / 'architecture' / 'architectural_patterns.json'
+    arch_file = output_dir / "architecture" / "architectural_patterns.json"
     if not arch_file.exists():
         return ""
 
     try:
-        with open(arch_file, 'r', encoding='utf-8') as f:
+        with open(arch_file, encoding="utf-8") as f:
             arch_data = json.load(f)
     except Exception:
         return ""
 
-    patterns = arch_data.get('patterns', [])
+    patterns = arch_data.get("patterns", [])
     if not patterns:
         return ""
 
@@ -925,9 +933,9 @@ def _format_architecture_section(output_dir: Path) -> str:
 
     content += "**Detected Architectural Patterns:**\n\n"
     for pattern in patterns[:5]:
-        name = pattern.get('pattern_name', 'Unknown')
-        confidence = pattern.get('confidence', 0)
-        indicators = pattern.get('indicators', [])
+        name = pattern.get("pattern_name", "Unknown")
+        confidence = pattern.get("confidence", 0)
+        indicators = pattern.get("indicators", [])
 
         content += f"- **{name}** (confidence: {confidence:.2f})\n"
         if indicators:
@@ -940,22 +948,22 @@ def _format_architecture_section(output_dir: Path) -> str:
 
 def _format_config_section(output_dir: Path) -> str:
     """Format configuration patterns section."""
-    config_file = output_dir / 'config_patterns' / 'config_patterns.json'
+    config_file = output_dir / "config_patterns" / "config_patterns.json"
     if not config_file.exists():
         return ""
 
     try:
-        with open(config_file, 'r', encoding='utf-8') as f:
+        with open(config_file, encoding="utf-8") as f:
             config_data = json.load(f)
     except Exception:
         return ""
 
-    config_files = config_data.get('config_files', [])
+    config_files = config_data.get("config_files", [])
     if not config_files:
         return ""
 
-    total_settings = sum(len(cf.get('settings', [])) for cf in config_files)
-    total_patterns = sum(len(cf.get('patterns', [])) for cf in config_files)
+    total_settings = sum(len(cf.get("settings", [])) for cf in config_files)
+    total_patterns = sum(len(cf.get("patterns", [])) for cf in config_files)
 
     content = "## ⚙️ Configuration Patterns\n\n"
     content += "*From C3.4 configuration analysis*\n\n"
@@ -966,7 +974,7 @@ def _format_config_section(output_dir: Path) -> str:
     # List config file types found
     file_types = {}
     for cf in config_files:
-        ctype = cf.get('config_type', 'unknown')
+        ctype = cf.get("config_type", "unknown")
         file_types[ctype] = file_types.get(ctype, 0) + 1
 
     if file_types:
@@ -985,18 +993,18 @@ def _generate_references(output_dir: Path):
 
     Creates a clean references/ directory that links to all analysis outputs.
     """
-    references_dir = output_dir / 'references'
+    references_dir = output_dir / "references"
     references_dir.mkdir(exist_ok=True)
 
     # Map analysis directories to reference names
     mappings = {
-        'api_reference': 'api_reference',
-        'dependencies': 'dependencies',
-        'patterns': 'patterns',
-        'test_examples': 'test_examples',
-        'tutorials': 'tutorials',
-        'config_patterns': 'config_patterns',
-        'architecture': 'architecture'
+        "api_reference": "api_reference",
+        "dependencies": "dependencies",
+        "patterns": "patterns",
+        "test_examples": "test_examples",
+        "tutorials": "tutorials",
+        "config_patterns": "config_patterns",
+        "architecture": "architecture",
     }
 
     for source, target in mappings.items():
@@ -1007,9 +1015,11 @@ def _generate_references(output_dir: Path):
             # Copy directory to references/ (not symlink, for portability)
             if target_dir.exists():
                 import shutil
+
                 shutil.rmtree(target_dir)
 
             import shutil
+
             shutil.copytree(source_dir, target_dir)
             logger.debug(f"Copied {source} → references/{target}")
 
@@ -1019,7 +1029,7 @@ def _generate_references(output_dir: Path):
 def main():
     """Command-line interface for codebase analysis."""
     parser = argparse.ArgumentParser(
-        description='Analyze local codebases and extract code knowledge',
+        description="Analyze local codebases and extract code knowledge",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -1043,101 +1053,78 @@ Examples:
 
   # Skip specific features
   codebase-scraper --directory . --skip-patterns --skip-test-examples
-"""
+""",
     )
 
+    parser.add_argument("--directory", required=True, help="Directory to analyze")
+    parser.add_argument("--output", default="output/codebase/", help="Output directory (default: output/codebase/)")
     parser.add_argument(
-        '--directory',
-        required=True,
-        help='Directory to analyze'
+        "--depth", choices=["surface", "deep", "full"], default="deep", help="Analysis depth (default: deep)"
     )
+    parser.add_argument("--languages", help="Comma-separated languages to analyze (e.g., Python,JavaScript,C++)")
+    parser.add_argument("--file-patterns", help="Comma-separated file patterns (e.g., *.py,src/**/*.js)")
     parser.add_argument(
-        '--output',
-        default='output/codebase/',
-        help='Output directory (default: output/codebase/)'
-    )
-    parser.add_argument(
-        '--depth',
-        choices=['surface', 'deep', 'full'],
-        default='deep',
-        help='Analysis depth (default: deep)'
-    )
-    parser.add_argument(
-        '--languages',
-        help='Comma-separated languages to analyze (e.g., Python,JavaScript,C++)'
-    )
-    parser.add_argument(
-        '--file-patterns',
-        help='Comma-separated file patterns (e.g., *.py,src/**/*.js)'
-    )
-    parser.add_argument(
-        '--skip-api-reference',
-        action='store_true',
+        "--skip-api-reference",
+        action="store_true",
         default=False,
-        help='Skip API reference markdown documentation generation (default: enabled)'
+        help="Skip API reference markdown documentation generation (default: enabled)",
     )
     parser.add_argument(
-        '--skip-dependency-graph',
-        action='store_true',
+        "--skip-dependency-graph",
+        action="store_true",
         default=False,
-        help='Skip dependency graph and circular dependency detection (default: enabled)'
+        help="Skip dependency graph and circular dependency detection (default: enabled)",
     )
     parser.add_argument(
-        '--skip-patterns',
-        action='store_true',
+        "--skip-patterns",
+        action="store_true",
         default=False,
-        help='Skip design pattern detection (Singleton, Factory, Observer, etc.) (default: enabled)'
+        help="Skip design pattern detection (Singleton, Factory, Observer, etc.) (default: enabled)",
     )
     parser.add_argument(
-        '--skip-test-examples',
-        action='store_true',
+        "--skip-test-examples",
+        action="store_true",
         default=False,
-        help='Skip test example extraction (instantiation, method calls, configs, etc.) (default: enabled)'
+        help="Skip test example extraction (instantiation, method calls, configs, etc.) (default: enabled)",
     )
     parser.add_argument(
-        '--skip-how-to-guides',
-        action='store_true',
+        "--skip-how-to-guides",
+        action="store_true",
         default=False,
-        help='Skip how-to guide generation from workflow examples (default: enabled)'
+        help="Skip how-to guide generation from workflow examples (default: enabled)",
     )
     parser.add_argument(
-        '--skip-config-patterns',
-        action='store_true',
+        "--skip-config-patterns",
+        action="store_true",
         default=False,
-        help='Skip configuration pattern extraction from config files (JSON, YAML, TOML, ENV, etc.) (default: enabled)'
+        help="Skip configuration pattern extraction from config files (JSON, YAML, TOML, ENV, etc.) (default: enabled)",
     )
     parser.add_argument(
-        '--ai-mode',
-        choices=['auto', 'api', 'local', 'none'],
-        default='auto',
-        help='AI enhancement mode for how-to guides: auto (detect best), api (Claude API), local (Claude Code CLI), none (disable) (default: auto)'
-    )
-    parser.add_argument(
-        '--no-comments',
-        action='store_true',
-        help='Skip comment extraction'
-    )
-    parser.add_argument(
-        '--verbose',
-        action='store_true',
-        help='Enable verbose logging'
+        "--ai-mode",
+        choices=["auto", "api", "local", "none"],
+        default="auto",
+        help="AI enhancement mode for how-to guides: auto (detect best), api (Claude API), local (Claude Code CLI), none (disable) (default: auto)",
     )
+    parser.add_argument("--no-comments", action="store_true", help="Skip comment extraction")
+    parser.add_argument("--verbose", action="store_true", help="Enable verbose logging")
 
     # Check for deprecated flags
     deprecated_flags = {
-        '--build-api-reference': '--skip-api-reference',
-        '--build-dependency-graph': '--skip-dependency-graph',
-        '--detect-patterns': '--skip-patterns',
-        '--extract-test-examples': '--skip-test-examples',
-        '--build-how-to-guides': '--skip-how-to-guides',
-        '--extract-config-patterns': '--skip-config-patterns'
+        "--build-api-reference": "--skip-api-reference",
+        "--build-dependency-graph": "--skip-dependency-graph",
+        "--detect-patterns": "--skip-patterns",
+        "--extract-test-examples": "--skip-test-examples",
+        "--build-how-to-guides": "--skip-how-to-guides",
+        "--extract-config-patterns": "--skip-config-patterns",
     }
 
     for old_flag, new_flag in deprecated_flags.items():
         if old_flag in sys.argv:
-            logger.warning(f"⚠️  DEPRECATED: {old_flag} is deprecated. "
-                          f"All features are now enabled by default. "
-                          f"Use {new_flag} to disable this feature.")
+            logger.warning(
+                f"⚠️  DEPRECATED: {old_flag} is deprecated. "
+                f"All features are now enabled by default. "
+                f"Use {new_flag} to disable this feature."
+            )
 
     args = parser.parse_args()
 
@@ -1158,12 +1145,12 @@ Examples:
     # Parse languages
     languages = None
     if args.languages:
-        languages = [lang.strip() for lang in args.languages.split(',')]
+        languages = [lang.strip() for lang in args.languages.split(",")]
 
     # Parse file patterns
     file_patterns = None
     if args.file_patterns:
-        file_patterns = [p.strip() for p in args.file_patterns.split(',')]
+        file_patterns = [p.strip() for p in args.file_patterns.split(",")]
 
     # Analyze codebase
     try:
@@ -1181,18 +1168,18 @@ Examples:
             build_how_to_guides=not args.skip_how_to_guides,
             extract_config_patterns=not args.skip_config_patterns,
             enhance_with_ai=True,  # Auto-disables if no API key present
-            ai_mode=args.ai_mode  # NEW: AI enhancement mode for how-to guides
+            ai_mode=args.ai_mode,  # NEW: AI enhancement mode for how-to guides
         )
 
         # Print summary
-        print(f"\n{'='*60}")
-        print(f"CODEBASE ANALYSIS COMPLETE")
-        print(f"{'='*60}")
+        print(f"\n{'=' * 60}")
+        print("CODEBASE ANALYSIS COMPLETE")
+        print(f"{'=' * 60}")
         print(f"Files analyzed: {len(results['files'])}")
         print(f"Output directory: {args.output}")
         if args.build_api_reference:
             print(f"API reference: {Path(args.output) / 'api_reference'}")
-        print(f"{'='*60}\n")
+        print(f"{'=' * 60}\n")
 
         return 0
 
@@ -1202,9 +1189,10 @@ Examples:
     except Exception as e:
         logger.error(f"Analysis failed: {e}")
         import traceback
+
         traceback.print_exc()
         return 1
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(main())
diff --git a/src/skill_seekers/cli/config_command.py b/src/skill_seekers/cli/config_command.py
index eeaf5a7..9bd89e8 100644
--- a/src/skill_seekers/cli/config_command.py
+++ b/src/skill_seekers/cli/config_command.py
@@ -4,9 +4,8 @@ Interactive Configuration Wizard for Skill Seekers
 Provides user-friendly setup for GitHub tokens, API keys, and settings.
 """
 
-import sys
 import webbrowser
-from typing import Optional
+
 from .config_manager import get_config_manager
 
 
@@ -46,7 +45,7 @@ Documentation: https://github.com/SkillSeekers/skill-seekers
     # Ask if user wants to run setup now
     response = input("Would you like to run the configuration wizard now? [y/N]: ").strip().lower()
 
-    if response in ['y', 'yes']:
+    if response in ["y", "yes"]:
         main_menu()
     else:
         print("\nYou can run the configuration wizard anytime with:")
@@ -158,7 +157,7 @@ def add_github_profile():
         if name in config.config["github"]["profiles"]:
             print(f"❌ Profile '{name}' already exists.")
             overwrite = input("Overwrite? [y/N]: ").strip().lower()
-            if overwrite not in ['y', 'yes']:
+            if overwrite not in ["y", "yes"]:
                 continue
         break
 
@@ -175,7 +174,7 @@ def add_github_profile():
     print("  4. Copy the token (ghp_...)\n")
 
     open_now = input("Open GitHub token page in browser? [Y/n]: ").strip().lower()
-    if open_now not in ['n', 'no']:
+    if open_now not in ["n", "no"]:
         open_github_token_page()
 
     while True:
@@ -186,7 +185,7 @@ def add_github_profile():
         if not (token.startswith("ghp_") or token.startswith("github_pat_")):
             print("⚠️  Warning: Token doesn't match GitHub format")
             proceed = input("Continue anyway? [y/N]: ").strip().lower()
-            if proceed not in ['y', 'yes']:
+            if proceed not in ["y", "yes"]:
                 continue
         break
 
@@ -198,12 +197,7 @@ def add_github_profile():
     print("  4. fail - Fail immediately")
 
     strategy_choice = input("\nSelect strategy [1-4] (default: 1): ").strip() or "1"
-    strategy_map = {
-        "1": "prompt",
-        "2": "wait",
-        "3": "switch",
-        "4": "fail"
-    }
+    strategy_map = {"1": "prompt", "2": "wait", "3": "switch", "4": "fail"}
     strategy = strategy_map.get(strategy_choice, "prompt")
 
     # Timeout
@@ -217,7 +211,7 @@ def add_github_profile():
     # Set as default
     has_profiles = bool(config.config["github"]["profiles"])
     if has_profiles:
-        set_default = input("\nSet as default profile? [y/N]: ").strip().lower() in ['y', 'yes']
+        set_default = input("\nSet as default profile? [y/N]: ").strip().lower() in ["y", "yes"]
     else:
         set_default = True  # First profile is always default
 
@@ -228,7 +222,7 @@ def add_github_profile():
         description=description,
         rate_limit_strategy=strategy,
         timeout_minutes=timeout,
-        set_as_default=set_default
+        set_as_default=set_default,
     )
 
     print(f"\n✅ GitHub profile '{name}' added successfully!")
@@ -258,7 +252,7 @@ def remove_github_profile():
         if 1 <= choice_idx <= len(profiles):
             profile_name = profiles[choice_idx - 1]["name"]
             confirm = input(f"Really remove profile '{profile_name}'? [y/N]: ").strip().lower()
-            if confirm in ['y', 'yes']:
+            if confirm in ["y", "yes"]:
                 config.remove_github_profile(profile_name)
         else:
             print("❌ Invalid choice.")
@@ -325,11 +319,10 @@ def api_keys_menu():
         source = ""
         if key:
             import os
-            env_var = {
-                "anthropic": "ANTHROPIC_API_KEY",
-                "google": "GOOGLE_API_KEY",
-                "openai": "OPENAI_API_KEY"
-            }[provider]
+
+            env_var = {"anthropic": "ANTHROPIC_API_KEY", "google": "GOOGLE_API_KEY", "openai": "OPENAI_API_KEY"}[
+                provider
+            ]
             if os.getenv(env_var):
                 source = " (from environment)"
             else:
@@ -347,7 +340,7 @@ def api_keys_menu():
     provider_map = {
         "1": ("anthropic", "https://console.anthropic.com/settings/keys"),
         "2": ("google", "https://makersuite.google.com/app/apikey"),
-        "3": ("openai", "https://platform.openai.com/api-keys")
+        "3": ("openai", "https://platform.openai.com/api-keys"),
     }
 
     if choice in provider_map:
@@ -365,7 +358,7 @@ def set_api_key(provider: str, url: str):
     print(f"Get your API key at: {url}\n")
 
     open_now = input("Open in browser? [Y/n]: ").strip().lower()
-    if open_now not in ['n', 'no']:
+    if open_now not in ["n", "no"]:
         try:
             webbrowser.open(url)
             print("✅ Opened in browser\n")
@@ -390,7 +383,7 @@ def rate_limit_settings():
 
     current = config.config["rate_limit"]
 
-    print(f"Current settings:")
+    print("Current settings:")
     print(f"  • Default timeout: {current['default_timeout_minutes']} minutes")
     print(f"  • Auto-switch profiles: {current['auto_switch_profiles']}")
     print(f"  • Show countdown: {current['show_countdown']}\n")
@@ -404,14 +397,16 @@ def rate_limit_settings():
             print("⚠️  Invalid input, keeping current value")
 
     # Auto-switch
-    auto_switch_input = input(f"Auto-switch to other profiles? [y/n] ({current['auto_switch_profiles']}): ").strip().lower()
+    auto_switch_input = (
+        input(f"Auto-switch to other profiles? [y/n] ({current['auto_switch_profiles']}): ").strip().lower()
+    )
     if auto_switch_input:
-        config.config["rate_limit"]["auto_switch_profiles"] = auto_switch_input in ['y', 'yes']
+        config.config["rate_limit"]["auto_switch_profiles"] = auto_switch_input in ["y", "yes"]
 
     # Show countdown
     countdown_input = input(f"Show countdown timer? [y/n] ({current['show_countdown']}): ").strip().lower()
     if countdown_input:
-        config.config["rate_limit"]["show_countdown"] = countdown_input in ['y', 'yes']
+        config.config["rate_limit"]["show_countdown"] = countdown_input in ["y", "yes"]
 
     config.save_config()
     print("\n✅ Rate limit settings updated")
@@ -427,7 +422,7 @@ def resume_settings():
 
     current = config.config["resume"]
 
-    print(f"Current settings:")
+    print("Current settings:")
     print(f"  • Auto-save interval: {current['auto_save_interval_seconds']} seconds")
     print(f"  • Keep progress for: {current['keep_progress_days']} days\n")
 
@@ -467,13 +462,12 @@ def test_connections():
         print("  ⚠️  No GitHub profiles configured")
     else:
         import requests
+
         for p in profiles:
             token = config.config["github"]["profiles"][p["name"]]["token"]
             try:
                 response = requests.get(
-                    "https://api.github.com/rate_limit",
-                    headers={"Authorization": f"token {token}"},
-                    timeout=5
+                    "https://api.github.com/rate_limit", headers={"Authorization": f"token {token}"}, timeout=5
                 )
                 if response.status_code == 200:
                     data = response.json()
@@ -518,34 +512,12 @@ def main():
     """Main entry point for config command."""
     import argparse
 
-    parser = argparse.ArgumentParser(
-        description="Configure Skill Seekers settings"
-    )
-    parser.add_argument(
-        "--github",
-        action="store_true",
-        help="Go directly to GitHub token setup"
-    )
-    parser.add_argument(
-        "--api-keys",
-        action="store_true",
-        help="Go directly to API keys setup"
-    )
-    parser.add_argument(
-        "--show",
-        action="store_true",
-        help="Show current configuration and exit"
-    )
-    parser.add_argument(
-        "--test",
-        action="store_true",
-        help="Test connections and exit"
-    )
-    parser.add_argument(
-        "--welcome",
-        action="store_true",
-        help="Show welcome message"
-    )
+    parser = argparse.ArgumentParser(description="Configure Skill Seekers settings")
+    parser.add_argument("--github", action="store_true", help="Go directly to GitHub token setup")
+    parser.add_argument("--api-keys", action="store_true", help="Go directly to API keys setup")
+    parser.add_argument("--show", action="store_true", help="Show current configuration and exit")
+    parser.add_argument("--test", action="store_true", help="Test connections and exit")
+    parser.add_argument("--welcome", action="store_true", help="Show welcome message")
 
     args = parser.parse_args()
 
diff --git a/src/skill_seekers/cli/config_enhancer.py b/src/skill_seekers/cli/config_enhancer.py
index 0ed5cf8..b89eb7a 100644
--- a/src/skill_seekers/cli/config_enhancer.py
+++ b/src/skill_seekers/cli/config_enhancer.py
@@ -12,24 +12,24 @@ Provides dual-mode AI enhancement (API + LOCAL) for configuration analysis:
 Similar to GuideEnhancer (C3.3) but for configuration files.
 """
 
-import os
-import sys
 import json
 import logging
+import os
 import subprocess
+import sys
 import tempfile
-from pathlib import Path
-from typing import Dict, List, Optional, Any
 from dataclasses import dataclass, field
+from pathlib import Path
 
 # Configure logging
-logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
+logging.basicConfig(level=logging.INFO, format="%(levelname)s - %(message)s")
 logger = logging.getLogger(__name__)
 
 # Optional anthropic import
 ANTHROPIC_AVAILABLE = False
 try:
     import anthropic
+
     ANTHROPIC_AVAILABLE = True
 except ImportError:
     pass
@@ -38,6 +38,7 @@ except ImportError:
 @dataclass
 class ConfigEnhancement:
     """AI-generated enhancement for a configuration"""
+
     explanation: str = ""  # What this setting does
     best_practice: str = ""  # Suggested improvement
     security_concern: str = ""  # Security issue (if any)
@@ -48,11 +49,12 @@ class ConfigEnhancement:
 @dataclass
 class EnhancedConfigFile:
     """Configuration file with AI enhancements"""
+
     file_path: str
     config_type: str
     purpose: str
     enhancement: ConfigEnhancement
-    setting_enhancements: Dict[str, ConfigEnhancement] = field(default_factory=dict)
+    setting_enhancements: dict[str, ConfigEnhancement] = field(default_factory=dict)
 
 
 class ConfigEnhancer:
@@ -73,7 +75,7 @@ class ConfigEnhancer:
             mode: Enhancement mode - "api", "local", or "auto" (default)
         """
         self.mode = self._detect_mode(mode)
-        self.api_key = os.environ.get('ANTHROPIC_API_KEY')
+        self.api_key = os.environ.get("ANTHROPIC_API_KEY")
         self.client = None
 
         if self.mode == "api" and ANTHROPIC_AVAILABLE and self.api_key:
@@ -93,14 +95,14 @@ class ConfigEnhancer:
             return requested_mode
 
         # Auto-detect
-        if os.environ.get('ANTHROPIC_API_KEY') and ANTHROPIC_AVAILABLE:
+        if os.environ.get("ANTHROPIC_API_KEY") and ANTHROPIC_AVAILABLE:
             logger.info("🤖 AI enhancement: API mode (Claude API detected)")
             return "api"
         else:
             logger.info("🤖 AI enhancement: LOCAL mode (using Claude Code CLI)")
             return "local"
 
-    def enhance_config_result(self, result: Dict) -> Dict:
+    def enhance_config_result(self, result: dict) -> dict:
         """
         Enhance entire configuration extraction result.
 
@@ -121,7 +123,7 @@ class ConfigEnhancer:
     # API MODE - Direct Claude API calls
     # =========================================================================
 
-    def _enhance_via_api(self, result: Dict) -> Dict:
+    def _enhance_via_api(self, result: dict) -> dict:
         """Enhance configs using Claude API"""
         if not self.client:
             logger.error("❌ API mode requested but no API key available")
@@ -134,12 +136,7 @@ class ConfigEnhancer:
             # Call Claude API
             logger.info("📡 Calling Claude API for config analysis...")
             response = self.client.messages.create(
-                model="claude-sonnet-4-20250514",
-                max_tokens=8000,
-                messages=[{
-                    "role": "user",
-                    "content": prompt
-                }]
+                model="claude-sonnet-4-20250514", max_tokens=8000, messages=[{"role": "user", "content": prompt}]
             )
 
             # Parse response
@@ -151,23 +148,23 @@ class ConfigEnhancer:
             logger.error(f"❌ API enhancement failed: {e}")
             return result
 
-    def _create_enhancement_prompt(self, result: Dict) -> str:
+    def _create_enhancement_prompt(self, result: dict) -> str:
         """Create prompt for Claude API"""
-        config_files = result.get('config_files', [])
+        config_files = result.get("config_files", [])
 
         # Summarize configs for prompt
         config_summary = []
         for cf in config_files[:10]:  # Limit to first 10 files
             settings_summary = []
-            for setting in cf.get('settings', [])[:5]:  # First 5 settings per file
+            for setting in cf.get("settings", [])[:5]:  # First 5 settings per file
                 settings_summary.append(f"  - {setting['key']}: {setting['value']} ({setting['value_type']})")
 
             config_summary.append(f"""
-File: {cf['relative_path']} ({cf['config_type']})
-Purpose: {cf['purpose']}
+File: {cf["relative_path"]} ({cf["config_type"]})
+Purpose: {cf["purpose"]}
 Settings:
 {chr(10).join(settings_summary)}
-Patterns: {', '.join(cf.get('patterns', []))}
+Patterns: {", ".join(cf.get("patterns", []))}
 """)
 
         prompt = f"""Analyze these configuration files and provide AI-enhanced insights.
@@ -207,12 +204,13 @@ Focus on actionable insights that help developers understand and improve their c
 """
         return prompt
 
-    def _parse_api_response(self, response_text: str, original_result: Dict) -> Dict:
+    def _parse_api_response(self, response_text: str, original_result: dict) -> dict:
         """Parse Claude API response and merge with original result"""
         try:
             # Extract JSON from response
             import re
-            json_match = re.search(r'\{.*\}', response_text, re.DOTALL)
+
+            json_match = re.search(r"\{.*\}", response_text, re.DOTALL)
             if not json_match:
                 logger.warning("⚠️  No JSON found in API response")
                 return original_result
@@ -220,14 +218,14 @@ Focus on actionable insights that help developers understand and improve their c
             enhancements = json.loads(json_match.group())
 
             # Merge enhancements into original result
-            original_result['ai_enhancements'] = enhancements
+            original_result["ai_enhancements"] = enhancements
 
             # Add enhancement flags to config files
-            file_enhancements = {e['file_path']: e for e in enhancements.get('file_enhancements', [])}
-            for cf in original_result.get('config_files', []):
-                file_path = cf.get('relative_path', cf.get('file_path'))
+            file_enhancements = {e["file_path"]: e for e in enhancements.get("file_enhancements", [])}
+            for cf in original_result.get("config_files", []):
+                file_path = cf.get("relative_path", cf.get("file_path"))
                 if file_path in file_enhancements:
-                    cf['ai_enhancement'] = file_enhancements[file_path]
+                    cf["ai_enhancement"] = file_enhancements[file_path]
 
             return original_result
 
@@ -239,11 +237,11 @@ Focus on actionable insights that help developers understand and improve their c
     # LOCAL MODE - Claude Code CLI
     # =========================================================================
 
-    def _enhance_via_local(self, result: Dict) -> Dict:
+    def _enhance_via_local(self, result: dict) -> dict:
         """Enhance configs using Claude Code CLI"""
         try:
             # Create temporary prompt file
-            with tempfile.NamedTemporaryFile(mode='w', suffix='.md', delete=False) as f:
+            with tempfile.NamedTemporaryFile(mode="w", suffix=".md", delete=False) as f:
                 prompt_file = Path(f.name)
                 f.write(self._create_local_prompt(result))
 
@@ -263,7 +261,7 @@ Focus on actionable insights that help developers understand and improve their c
 
             if result_data:
                 # Merge LOCAL enhancements
-                original_result['ai_enhancements'] = result_data
+                original_result["ai_enhancements"] = result_data
                 logger.info("✅ LOCAL enhancement complete")
                 return original_result
             else:
@@ -274,18 +272,18 @@ Focus on actionable insights that help developers understand and improve their c
             logger.error(f"❌ LOCAL enhancement failed: {e}")
             return result
 
-    def _create_local_prompt(self, result: Dict) -> str:
+    def _create_local_prompt(self, result: dict) -> str:
         """Create prompt file for Claude Code CLI"""
-        config_files = result.get('config_files', [])
+        config_files = result.get("config_files", [])
 
         # Format config data for Claude
         config_data = []
         for cf in config_files[:10]:
             config_data.append(f"""
-### {cf['relative_path']} ({cf['config_type']})
-- Purpose: {cf['purpose']}
-- Patterns: {', '.join(cf.get('patterns', []))}
-- Settings count: {len(cf.get('settings', []))}
+### {cf["relative_path"]} ({cf["config_type"]})
+- Purpose: {cf["purpose"]}
+- Patterns: {", ".join(cf.get("patterns", []))}
+- Settings count: {len(cf.get("settings", []))}
 """)
 
         prompt = f"""# Configuration Analysis Task
@@ -332,15 +330,15 @@ Focus on actionable insights:
 """
         return prompt
 
-    def _run_claude_cli(self, prompt_file: Path, output_file: Path) -> Optional[Dict]:
+    def _run_claude_cli(self, prompt_file: Path, output_file: Path) -> dict | None:
         """Run Claude Code CLI and wait for completion"""
         try:
             # Run claude command
             result = subprocess.run(
-                ['claude', str(prompt_file)],
+                ["claude", str(prompt_file)],
                 capture_output=True,
                 text=True,
-                timeout=300  # 5 minute timeout
+                timeout=300,  # 5 minute timeout
             )
 
             if result.returncode != 0:
@@ -350,6 +348,7 @@ Focus on actionable insights:
             # Try to find output file (Claude might save it with different name)
             # Look for JSON files created in the last minute
             import time
+
             current_time = time.time()
             potential_files = []
 
@@ -360,9 +359,9 @@ Focus on actionable insights:
             # Try to load the most recent JSON file
             for json_file in sorted(potential_files, key=lambda f: f.stat().st_mtime, reverse=True):
                 try:
-                    with open(json_file, 'r') as f:
+                    with open(json_file) as f:
                         data = json.load(f)
-                        if 'file_enhancements' in data or 'overall_insights' in data:
+                        if "file_enhancements" in data or "overall_insights" in data:
                             logger.info(f"✅ Found enhancement data in {json_file.name}")
                             return data
                 except:
@@ -383,29 +382,18 @@ def main():
     """Command-line interface for config enhancement"""
     import argparse
 
-    parser = argparse.ArgumentParser(
-        description='AI-enhance configuration extraction results'
-    )
+    parser = argparse.ArgumentParser(description="AI-enhance configuration extraction results")
+    parser.add_argument("result_file", help="Path to config extraction JSON result file")
     parser.add_argument(
-        'result_file',
-        help='Path to config extraction JSON result file'
-    )
-    parser.add_argument(
-        '--mode',
-        choices=['auto', 'api', 'local'],
-        default='auto',
-        help='Enhancement mode (default: auto)'
-    )
-    parser.add_argument(
-        '--output',
-        help='Output file for enhanced results (default: <input>_enhanced.json)'
+        "--mode", choices=["auto", "api", "local"], default="auto", help="Enhancement mode (default: auto)"
     )
+    parser.add_argument("--output", help="Output file for enhanced results (default: <input>_enhanced.json)")
 
     args = parser.parse_args()
 
     # Load result file
     try:
-        with open(args.result_file, 'r') as f:
+        with open(args.result_file) as f:
             result = json.load(f)
     except Exception as e:
         logger.error(f"❌ Failed to load result file: {e}")
@@ -416,9 +404,9 @@ def main():
     enhanced_result = enhancer.enhance_config_result(result)
 
     # Save
-    output_file = args.output or args.result_file.replace('.json', '_enhanced.json')
+    output_file = args.output or args.result_file.replace(".json", "_enhanced.json")
     try:
-        with open(output_file, 'w') as f:
+        with open(output_file, "w") as f:
             json.dump(enhanced_result, f, indent=2)
         logger.info(f"✅ Enhanced results saved to: {output_file}")
     except Exception as e:
@@ -428,5 +416,5 @@ def main():
     return 0
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(main())
diff --git a/src/skill_seekers/cli/config_extractor.py b/src/skill_seekers/cli/config_extractor.py
index 8accbb4..2ca0dca 100644
--- a/src/skill_seekers/cli/config_extractor.py
+++ b/src/skill_seekers/cli/config_extractor.py
@@ -9,19 +9,20 @@ This is different from C3.2 which extracts config examples from test code.
 C3.4 focuses on documenting the actual project configuration.
 """
 
+import ast
 import json
 import logging
 import re
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Dict, List, Optional, Any, Set, Literal
-import ast
+from typing import Any, Literal
 
 logger = logging.getLogger(__name__)
 
 # Optional dependencies
 try:
     import yaml
+
     YAML_AVAILABLE = True
 except ImportError:
     YAML_AVAILABLE = False
@@ -29,10 +30,12 @@ except ImportError:
 
 try:
     import tomli
+
     TOML_AVAILABLE = True
 except ImportError:
     try:
         import toml
+
         TOML_AVAILABLE = True
     except ImportError:
         TOML_AVAILABLE = False
@@ -42,68 +45,71 @@ except ImportError:
 @dataclass
 class ConfigSetting:
     """Individual configuration setting"""
+
     key: str
     value: Any
     value_type: str  # 'string', 'integer', 'boolean', 'array', 'object', 'null'
-    default_value: Optional[Any] = None
+    default_value: Any | None = None
     required: bool = False
-    env_var: Optional[str] = None
+    env_var: str | None = None
     description: str = ""
-    validation: Dict[str, Any] = field(default_factory=dict)
-    nested_path: List[str] = field(default_factory=list)  # For nested configs
+    validation: dict[str, Any] = field(default_factory=dict)
+    nested_path: list[str] = field(default_factory=list)  # For nested configs
 
 
 @dataclass
 class ConfigFile:
     """Represents a configuration file"""
+
     file_path: str
     relative_path: str
     config_type: Literal["json", "yaml", "toml", "env", "ini", "python", "javascript", "dockerfile", "docker-compose"]
     purpose: str  # Inferred purpose: database, api, logging, etc.
-    settings: List[ConfigSetting] = field(default_factory=list)
-    patterns: List[str] = field(default_factory=list)
-    raw_content: Optional[str] = None
-    parse_errors: List[str] = field(default_factory=list)
+    settings: list[ConfigSetting] = field(default_factory=list)
+    patterns: list[str] = field(default_factory=list)
+    raw_content: str | None = None
+    parse_errors: list[str] = field(default_factory=list)
 
 
 @dataclass
 class ConfigExtractionResult:
     """Result of config extraction"""
-    config_files: List[ConfigFile] = field(default_factory=list)
+
+    config_files: list[ConfigFile] = field(default_factory=list)
     total_files: int = 0
     total_settings: int = 0
-    detected_patterns: Dict[str, List[str]] = field(default_factory=dict)  # pattern -> files
-    errors: List[str] = field(default_factory=list)
+    detected_patterns: dict[str, list[str]] = field(default_factory=dict)  # pattern -> files
+    errors: list[str] = field(default_factory=list)
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Convert result to dictionary for JSON output"""
         return {
-            'total_files': self.total_files,
-            'total_settings': self.total_settings,
-            'detected_patterns': self.detected_patterns,
-            'config_files': [
+            "total_files": self.total_files,
+            "total_settings": self.total_settings,
+            "detected_patterns": self.detected_patterns,
+            "config_files": [
                 {
-                    'file_path': cf.file_path,
-                    'relative_path': cf.relative_path,
-                    'type': cf.config_type,
-                    'purpose': cf.purpose,
-                    'patterns': cf.patterns,
-                    'settings_count': len(cf.settings),
-                    'settings': [
+                    "file_path": cf.file_path,
+                    "relative_path": cf.relative_path,
+                    "type": cf.config_type,
+                    "purpose": cf.purpose,
+                    "patterns": cf.patterns,
+                    "settings_count": len(cf.settings),
+                    "settings": [
                         {
-                            'key': s.key,
-                            'value': s.value,
-                            'type': s.value_type,
-                            'env_var': s.env_var,
-                            'description': s.description,
+                            "key": s.key,
+                            "value": s.value,
+                            "type": s.value_type,
+                            "env_var": s.env_var,
+                            "description": s.description,
                         }
                         for s in cf.settings
                     ],
-                    'parse_errors': cf.parse_errors,
+                    "parse_errors": cf.parse_errors,
                 }
                 for cf in self.config_files
             ],
-            'errors': self.errors,
+            "errors": self.errors,
         }
 
     def to_markdown(self) -> str:
@@ -115,11 +121,11 @@ class ConfigExtractionResult:
         # Handle both dict and list formats for detected_patterns
         if self.detected_patterns:
             if isinstance(self.detected_patterns, dict):
-                patterns_str = ', '.join(self.detected_patterns.keys())
+                patterns_str = ", ".join(self.detected_patterns.keys())
             else:
-                patterns_str = ', '.join(self.detected_patterns)
+                patterns_str = ", ".join(self.detected_patterns)
         else:
-            patterns_str = 'None'
+            patterns_str = "None"
         md += f"**Detected Patterns:** {patterns_str}\n\n"
 
         if self.config_files:
@@ -148,52 +154,64 @@ class ConfigFileDetector:
 
     # Config file patterns by type
     CONFIG_PATTERNS = {
-        'json': {
-            'patterns': ['*.json', 'package.json', 'tsconfig.json', 'jsconfig.json'],
-            'names': ['config.json', 'settings.json', 'app.json', '.eslintrc.json', '.prettierrc.json'],
+        "json": {
+            "patterns": ["*.json", "package.json", "tsconfig.json", "jsconfig.json"],
+            "names": ["config.json", "settings.json", "app.json", ".eslintrc.json", ".prettierrc.json"],
         },
-        'yaml': {
-            'patterns': ['*.yaml', '*.yml'],
-            'names': ['config.yml', 'settings.yml', '.travis.yml', '.gitlab-ci.yml', 'docker-compose.yml'],
+        "yaml": {
+            "patterns": ["*.yaml", "*.yml"],
+            "names": ["config.yml", "settings.yml", ".travis.yml", ".gitlab-ci.yml", "docker-compose.yml"],
         },
-        'toml': {
-            'patterns': ['*.toml'],
-            'names': ['pyproject.toml', 'Cargo.toml', 'config.toml'],
+        "toml": {
+            "patterns": ["*.toml"],
+            "names": ["pyproject.toml", "Cargo.toml", "config.toml"],
         },
-        'env': {
-            'patterns': ['.env*', '*.env'],
-            'names': ['.env', '.env.example', '.env.local', '.env.production'],
+        "env": {
+            "patterns": [".env*", "*.env"],
+            "names": [".env", ".env.example", ".env.local", ".env.production"],
         },
-        'ini': {
-            'patterns': ['*.ini', '*.cfg'],
-            'names': ['config.ini', 'setup.cfg', 'tox.ini'],
+        "ini": {
+            "patterns": ["*.ini", "*.cfg"],
+            "names": ["config.ini", "setup.cfg", "tox.ini"],
         },
-        'python': {
-            'patterns': [],
-            'names': ['settings.py', 'config.py', 'configuration.py', 'constants.py'],
+        "python": {
+            "patterns": [],
+            "names": ["settings.py", "config.py", "configuration.py", "constants.py"],
         },
-        'javascript': {
-            'patterns': ['*.config.js', '*.config.ts'],
-            'names': ['config.js', 'next.config.js', 'vue.config.js', 'webpack.config.js'],
+        "javascript": {
+            "patterns": ["*.config.js", "*.config.ts"],
+            "names": ["config.js", "next.config.js", "vue.config.js", "webpack.config.js"],
         },
-        'dockerfile': {
-            'patterns': ['Dockerfile*'],
-            'names': ['Dockerfile', 'Dockerfile.dev', 'Dockerfile.prod'],
+        "dockerfile": {
+            "patterns": ["Dockerfile*"],
+            "names": ["Dockerfile", "Dockerfile.dev", "Dockerfile.prod"],
         },
-        'docker-compose': {
-            'patterns': ['docker-compose*.yml', 'docker-compose*.yaml'],
-            'names': ['docker-compose.yml', 'docker-compose.yaml'],
+        "docker-compose": {
+            "patterns": ["docker-compose*.yml", "docker-compose*.yaml"],
+            "names": ["docker-compose.yml", "docker-compose.yaml"],
         },
     }
 
     # Directories to skip
     SKIP_DIRS = {
-        'node_modules', 'venv', 'env', '.venv', '__pycache__', '.git',
-        'build', 'dist', '.tox', '.mypy_cache', '.pytest_cache',
-        'htmlcov', 'coverage', '.eggs', '*.egg-info'
+        "node_modules",
+        "venv",
+        "env",
+        ".venv",
+        "__pycache__",
+        ".git",
+        "build",
+        "dist",
+        ".tox",
+        ".mypy_cache",
+        ".pytest_cache",
+        "htmlcov",
+        "coverage",
+        ".eggs",
+        "*.egg-info",
     }
 
-    def find_config_files(self, directory: Path, max_files: int = 100) -> List[ConfigFile]:
+    def find_config_files(self, directory: Path, max_files: int = 100) -> list[ConfigFile]:
         """
         Find all configuration files in directory.
 
@@ -219,7 +237,7 @@ class ConfigFileDetector:
                     file_path=str(file_path),
                     relative_path=relative_path,
                     config_type=config_type,
-                    purpose=self._infer_purpose(file_path, config_type)
+                    purpose=self._infer_purpose(file_path, config_type),
                 )
                 config_files.append(config_file)
                 found_count += 1
@@ -230,7 +248,7 @@ class ConfigFileDetector:
 
     def _walk_directory(self, directory: Path):
         """Walk directory, skipping excluded directories"""
-        for item in directory.rglob('*'):
+        for item in directory.rglob("*"):
             # Skip directories
             if item.is_dir():
                 continue
@@ -241,18 +259,18 @@ class ConfigFileDetector:
 
             yield item
 
-    def _detect_config_type(self, file_path: Path) -> Optional[str]:
+    def _detect_config_type(self, file_path: Path) -> str | None:
         """Detect configuration file type"""
         filename = file_path.name.lower()
 
         # Check each config type
         for config_type, patterns in self.CONFIG_PATTERNS.items():
             # Check exact name matches
-            if filename in patterns['names']:
+            if filename in patterns["names"]:
                 return config_type
 
             # Check pattern matches
-            for pattern in patterns['patterns']:
+            for pattern in patterns["patterns"]:
                 if file_path.match(pattern):
                     return config_type
 
@@ -264,43 +282,43 @@ class ConfigFileDetector:
         filename = file_path.name.lower()
 
         # Database configs
-        if any(word in path_lower for word in ['database', 'db', 'postgres', 'mysql', 'mongo']):
-            return 'database_configuration'
+        if any(word in path_lower for word in ["database", "db", "postgres", "mysql", "mongo"]):
+            return "database_configuration"
 
         # API configs
-        if any(word in path_lower for word in ['api', 'rest', 'graphql', 'endpoint']):
-            return 'api_configuration'
+        if any(word in path_lower for word in ["api", "rest", "graphql", "endpoint"]):
+            return "api_configuration"
 
         # Logging configs
-        if any(word in path_lower for word in ['log', 'logger', 'logging']):
-            return 'logging_configuration'
+        if any(word in path_lower for word in ["log", "logger", "logging"]):
+            return "logging_configuration"
 
         # Docker configs
-        if 'docker' in filename:
-            return 'docker_configuration'
+        if "docker" in filename:
+            return "docker_configuration"
 
         # CI/CD configs
-        if any(word in path_lower for word in ['.travis', '.gitlab', '.github', 'ci', 'cd']):
-            return 'ci_cd_configuration'
+        if any(word in path_lower for word in [".travis", ".gitlab", ".github", "ci", "cd"]):
+            return "ci_cd_configuration"
 
         # Package configs
-        if filename in ['package.json', 'pyproject.toml', 'cargo.toml']:
-            return 'package_configuration'
+        if filename in ["package.json", "pyproject.toml", "cargo.toml"]:
+            return "package_configuration"
 
         # TypeScript/JavaScript configs
-        if filename in ['tsconfig.json', 'jsconfig.json']:
-            return 'typescript_configuration'
+        if filename in ["tsconfig.json", "jsconfig.json"]:
+            return "typescript_configuration"
 
         # Framework configs
-        if 'next.config' in filename or 'vue.config' in filename or 'webpack.config' in filename:
-            return 'framework_configuration'
+        if "next.config" in filename or "vue.config" in filename or "webpack.config" in filename:
+            return "framework_configuration"
 
         # Environment configs
-        if '.env' in filename:
-            return 'environment_configuration'
+        if ".env" in filename:
+            return "environment_configuration"
 
         # Default
-        return 'general_configuration'
+        return "general_configuration"
 
 
 class ConfigParser:
@@ -318,27 +336,27 @@ class ConfigParser:
         """
         try:
             # Read file content
-            with open(config_file.file_path, 'r', encoding='utf-8') as f:
+            with open(config_file.file_path, encoding="utf-8") as f:
                 config_file.raw_content = f.read()
 
             # Parse based on type
-            if config_file.config_type == 'json':
+            if config_file.config_type == "json":
                 self._parse_json(config_file)
-            elif config_file.config_type == 'yaml':
+            elif config_file.config_type == "yaml":
                 self._parse_yaml(config_file)
-            elif config_file.config_type == 'toml':
+            elif config_file.config_type == "toml":
                 self._parse_toml(config_file)
-            elif config_file.config_type == 'env':
+            elif config_file.config_type == "env":
                 self._parse_env(config_file)
-            elif config_file.config_type == 'ini':
+            elif config_file.config_type == "ini":
                 self._parse_ini(config_file)
-            elif config_file.config_type == 'python':
+            elif config_file.config_type == "python":
                 self._parse_python_config(config_file)
-            elif config_file.config_type == 'javascript':
+            elif config_file.config_type == "javascript":
                 self._parse_javascript_config(config_file)
-            elif config_file.config_type == 'dockerfile':
+            elif config_file.config_type == "dockerfile":
                 self._parse_dockerfile(config_file)
-            elif config_file.config_type == 'docker-compose':
+            elif config_file.config_type == "docker-compose":
                 self._parse_yaml(config_file)  # Docker compose is YAML
 
         except Exception as e:
@@ -376,10 +394,11 @@ class ConfigParser:
             return
 
         try:
-            if 'tomli' in globals():
+            if "tomli" in globals():
                 data = tomli.loads(config_file.raw_content)
             else:
                 import toml
+
                 data = toml.loads(config_file.raw_content)
 
             self._extract_settings_from_dict(data, config_file)
@@ -388,17 +407,17 @@ class ConfigParser:
 
     def _parse_env(self, config_file: ConfigFile):
         """Parse .env file"""
-        lines = config_file.raw_content.split('\n')
+        lines = config_file.raw_content.split("\n")
 
         for line_num, line in enumerate(lines, 1):
             line = line.strip()
 
             # Skip comments and empty lines
-            if not line or line.startswith('#'):
+            if not line or line.startswith("#"):
                 continue
 
             # Parse KEY=VALUE
-            match = re.match(r'([A-Z_][A-Z0-9_]*)\s*=\s*(.+)', line)
+            match = re.match(r"([A-Z_][A-Z0-9_]*)\s*=\s*(.+)", line)
             if match:
                 key, value = match.groups()
                 value = value.strip().strip('"').strip("'")
@@ -408,7 +427,7 @@ class ConfigParser:
                     value=value,
                     value_type=self._infer_type(value),
                     env_var=key,
-                    description=self._extract_env_description(lines, line_num - 1)
+                    description=self._extract_env_description(lines, line_num - 1),
                 )
                 config_file.settings.append(setting)
 
@@ -426,7 +445,7 @@ class ConfigParser:
                         key=f"{section}.{key}",
                         value=value,
                         value_type=self._infer_type(value),
-                        nested_path=[section, key]
+                        nested_path=[section, key],
                     )
                     config_file.settings.append(setting)
         except Exception as e:
@@ -444,7 +463,7 @@ class ConfigParser:
                         key = node.targets[0].id
 
                         # Skip private variables
-                        if key.startswith('_'):
+                        if key.startswith("_"):
                             continue
 
                         # Extract value
@@ -454,7 +473,7 @@ class ConfigParser:
                                 key=key,
                                 value=value,
                                 value_type=self._infer_type(value),
-                                description=self._extract_python_docstring(node)
+                                description=self._extract_python_docstring(node),
                             )
                             config_file.settings.append(setting)
                         except (ValueError, TypeError):
@@ -469,8 +488,8 @@ class ConfigParser:
         # Simple regex-based extraction for common patterns
         patterns = [
             r'(?:const|let|var)\s+(\w+)\s*[:=]\s*(["\'])(.*?)\2',  # String values
-            r'(?:const|let|var)\s+(\w+)\s*[:=]\s*(\d+)',  # Number values
-            r'(?:const|let|var)\s+(\w+)\s*[:=]\s*(true|false)',  # Boolean values
+            r"(?:const|let|var)\s+(\w+)\s*[:=]\s*(\d+)",  # Number values
+            r"(?:const|let|var)\s+(\w+)\s*[:=]\s*(true|false)",  # Boolean values
         ]
 
         for pattern in patterns:
@@ -479,47 +498,36 @@ class ConfigParser:
                     key = match.group(1)
                     value = match.group(3) if len(match.groups()) > 2 else match.group(2)
 
-                    setting = ConfigSetting(
-                        key=key,
-                        value=value,
-                        value_type=self._infer_type(value)
-                    )
+                    setting = ConfigSetting(key=key, value=value, value_type=self._infer_type(value))
                     config_file.settings.append(setting)
 
     def _parse_dockerfile(self, config_file: ConfigFile):
         """Parse Dockerfile configuration"""
-        lines = config_file.raw_content.split('\n')
+        lines = config_file.raw_content.split("\n")
 
         for line in lines:
             line = line.strip()
 
             # Extract ENV variables
-            if line.startswith('ENV '):
-                parts = line[4:].split('=', 1)
+            if line.startswith("ENV "):
+                parts = line[4:].split("=", 1)
                 if len(parts) == 2:
                     key, value = parts
                     setting = ConfigSetting(
-                        key=key.strip(),
-                        value=value.strip(),
-                        value_type='string',
-                        env_var=key.strip()
+                        key=key.strip(), value=value.strip(), value_type="string", env_var=key.strip()
                     )
                     config_file.settings.append(setting)
 
             # Extract ARG variables
-            elif line.startswith('ARG '):
-                parts = line[4:].split('=', 1)
+            elif line.startswith("ARG "):
+                parts = line[4:].split("=", 1)
                 key = parts[0].strip()
                 value = parts[1].strip() if len(parts) == 2 else None
 
-                setting = ConfigSetting(
-                    key=key,
-                    value=value,
-                    value_type='string'
-                )
+                setting = ConfigSetting(key=key, value=value, value_type="string")
                 config_file.settings.append(setting)
 
-    def _extract_settings_from_dict(self, data: Dict, config_file: ConfigFile, parent_path: List[str] = None):
+    def _extract_settings_from_dict(self, data: dict, config_file: ConfigFile, parent_path: list[str] = None):
         """Recursively extract settings from dictionary"""
         if parent_path is None:
             parent_path = []
@@ -530,35 +538,35 @@ class ConfigParser:
                 self._extract_settings_from_dict(value, config_file, parent_path + [key])
             else:
                 setting = ConfigSetting(
-                    key='.'.join(parent_path + [key]) if parent_path else key,
+                    key=".".join(parent_path + [key]) if parent_path else key,
                     value=value,
                     value_type=self._infer_type(value),
-                    nested_path=parent_path + [key]
+                    nested_path=parent_path + [key],
                 )
                 config_file.settings.append(setting)
 
     def _infer_type(self, value: Any) -> str:
         """Infer value type"""
         if value is None:
-            return 'null'
+            return "null"
         elif isinstance(value, bool):
-            return 'boolean'
+            return "boolean"
         elif isinstance(value, int):
-            return 'integer'
+            return "integer"
         elif isinstance(value, float):
-            return 'number'
+            return "number"
         elif isinstance(value, (list, tuple)):
-            return 'array'
+            return "array"
         elif isinstance(value, dict):
-            return 'object'
+            return "object"
         else:
-            return 'string'
+            return "string"
 
-    def _extract_env_description(self, lines: List[str], line_index: int) -> str:
+    def _extract_env_description(self, lines: list[str], line_index: int) -> str:
         """Extract description from comment above env variable"""
         if line_index > 0:
             prev_line = lines[line_index - 1].strip()
-            if prev_line.startswith('#'):
+            if prev_line.startswith("#"):
                 return prev_line[1:].strip()
         return ""
 
@@ -573,37 +581,37 @@ class ConfigPatternDetector:
 
     # Known configuration patterns
     KNOWN_PATTERNS = {
-        'database_config': {
-            'keys': ['host', 'port', 'database', 'user', 'username', 'password', 'db_name'],
-            'min_match': 3,
+        "database_config": {
+            "keys": ["host", "port", "database", "user", "username", "password", "db_name"],
+            "min_match": 3,
         },
-        'api_config': {
-            'keys': ['base_url', 'api_key', 'api_secret', 'timeout', 'retry', 'endpoint'],
-            'min_match': 2,
+        "api_config": {
+            "keys": ["base_url", "api_key", "api_secret", "timeout", "retry", "endpoint"],
+            "min_match": 2,
         },
-        'logging_config': {
-            'keys': ['level', 'format', 'handler', 'file', 'console', 'log_level'],
-            'min_match': 2,
+        "logging_config": {
+            "keys": ["level", "format", "handler", "file", "console", "log_level"],
+            "min_match": 2,
         },
-        'cache_config': {
-            'keys': ['backend', 'ttl', 'timeout', 'max_size', 'redis', 'memcached'],
-            'min_match': 2,
+        "cache_config": {
+            "keys": ["backend", "ttl", "timeout", "max_size", "redis", "memcached"],
+            "min_match": 2,
         },
-        'email_config': {
-            'keys': ['smtp_host', 'smtp_port', 'email', 'from_email', 'mail_server'],
-            'min_match': 2,
+        "email_config": {
+            "keys": ["smtp_host", "smtp_port", "email", "from_email", "mail_server"],
+            "min_match": 2,
         },
-        'auth_config': {
-            'keys': ['secret_key', 'jwt_secret', 'token', 'oauth', 'authentication'],
-            'min_match': 1,
+        "auth_config": {
+            "keys": ["secret_key", "jwt_secret", "token", "oauth", "authentication"],
+            "min_match": 1,
         },
-        'server_config': {
-            'keys': ['host', 'port', 'bind', 'workers', 'threads'],
-            'min_match': 2,
+        "server_config": {
+            "keys": ["host", "port", "bind", "workers", "threads"],
+            "min_match": 2,
         },
     }
 
-    def detect_patterns(self, config_file: ConfigFile) -> List[str]:
+    def detect_patterns(self, config_file: ConfigFile) -> list[str]:
         """
         Detect which patterns this config file matches.
 
@@ -620,8 +628,8 @@ class ConfigPatternDetector:
 
         # Check against each known pattern
         for pattern_name, pattern_def in self.KNOWN_PATTERNS.items():
-            pattern_keys = {k.lower() for k in pattern_def['keys']}
-            min_match = pattern_def['min_match']
+            pattern_keys = {k.lower() for k in pattern_def["keys"]}
+            min_match = pattern_def["min_match"]
 
             # Count matches
             matches = len(setting_keys & pattern_keys)
@@ -641,11 +649,7 @@ class ConfigExtractor:
         self.parser = ConfigParser()
         self.pattern_detector = ConfigPatternDetector()
 
-    def extract_from_directory(
-        self,
-        directory: Path,
-        max_files: int = 100
-    ) -> ConfigExtractionResult:
+    def extract_from_directory(self, directory: Path, max_files: int = 100) -> ConfigExtractionResult:
         """
         Extract configuration patterns from directory.
 
@@ -696,35 +700,35 @@ class ConfigExtractor:
 
         return result
 
-    def to_dict(self, result: ConfigExtractionResult) -> Dict:
+    def to_dict(self, result: ConfigExtractionResult) -> dict:
         """Convert result to dictionary for JSON output"""
         return {
-            'total_files': result.total_files,
-            'total_settings': result.total_settings,
-            'detected_patterns': result.detected_patterns,
-            'config_files': [
+            "total_files": result.total_files,
+            "total_settings": result.total_settings,
+            "detected_patterns": result.detected_patterns,
+            "config_files": [
                 {
-                    'file_path': cf.file_path,
-                    'relative_path': cf.relative_path,
-                    'type': cf.config_type,
-                    'purpose': cf.purpose,
-                    'patterns': cf.patterns,
-                    'settings_count': len(cf.settings),
-                    'settings': [
+                    "file_path": cf.file_path,
+                    "relative_path": cf.relative_path,
+                    "type": cf.config_type,
+                    "purpose": cf.purpose,
+                    "patterns": cf.patterns,
+                    "settings_count": len(cf.settings),
+                    "settings": [
                         {
-                            'key': s.key,
-                            'value': s.value,
-                            'type': s.value_type,
-                            'env_var': s.env_var,
-                            'description': s.description,
+                            "key": s.key,
+                            "value": s.value,
+                            "type": s.value_type,
+                            "env_var": s.env_var,
+                            "description": s.description,
                         }
                         for s in cf.settings
                     ],
-                    'parse_errors': cf.parse_errors,
+                    "parse_errors": cf.parse_errors,
                 }
                 for cf in result.config_files
             ],
-            'errors': result.errors,
+            "errors": result.errors,
         }
 
 
@@ -732,19 +736,29 @@ def main():
     """CLI entry point for config extraction"""
     import argparse
 
-    parser = argparse.ArgumentParser(description="Extract configuration patterns from codebase with optional AI enhancement")
-    parser.add_argument('directory', type=Path, help='Directory to analyze')
-    parser.add_argument('--output', '-o', type=Path, help='Output JSON file')
-    parser.add_argument('--max-files', type=int, default=100, help='Maximum config files to process')
-    parser.add_argument('--enhance', action='store_true', help='Enhance with AI analysis (API mode, requires ANTHROPIC_API_KEY)')
-    parser.add_argument('--enhance-local', action='store_true', help='Enhance with AI analysis (LOCAL mode, uses Claude Code CLI)')
-    parser.add_argument('--ai-mode', choices=['auto', 'api', 'local', 'none'], default='none',
-                        help='AI enhancement mode: auto (detect), api (Claude API), local (Claude Code CLI), none (disable)')
+    parser = argparse.ArgumentParser(
+        description="Extract configuration patterns from codebase with optional AI enhancement"
+    )
+    parser.add_argument("directory", type=Path, help="Directory to analyze")
+    parser.add_argument("--output", "-o", type=Path, help="Output JSON file")
+    parser.add_argument("--max-files", type=int, default=100, help="Maximum config files to process")
+    parser.add_argument(
+        "--enhance", action="store_true", help="Enhance with AI analysis (API mode, requires ANTHROPIC_API_KEY)"
+    )
+    parser.add_argument(
+        "--enhance-local", action="store_true", help="Enhance with AI analysis (LOCAL mode, uses Claude Code CLI)"
+    )
+    parser.add_argument(
+        "--ai-mode",
+        choices=["auto", "api", "local", "none"],
+        default="none",
+        help="AI enhancement mode: auto (detect), api (Claude API), local (Claude Code CLI), none (disable)",
+    )
 
     args = parser.parse_args()
 
     # Setup logging
-    logging.basicConfig(level=logging.INFO, format='%(levelname)s: %(message)s')
+    logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
 
     # Extract
     extractor = ConfigExtractor()
@@ -756,13 +770,14 @@ def main():
     # AI Enhancement (if requested)
     enhance_mode = args.ai_mode
     if args.enhance:
-        enhance_mode = 'api'
+        enhance_mode = "api"
     elif args.enhance_local:
-        enhance_mode = 'local'
+        enhance_mode = "local"
 
-    if enhance_mode != 'none':
+    if enhance_mode != "none":
         try:
             from skill_seekers.cli.config_enhancer import ConfigEnhancer
+
             logger.info(f"🤖 Starting AI enhancement (mode: {enhance_mode})...")
             enhancer = ConfigEnhancer(mode=enhance_mode)
             output_dict = enhancer.enhance_config_result(output_dict)
@@ -774,27 +789,27 @@ def main():
 
     # Output
     if args.output:
-        with open(args.output, 'w') as f:
+        with open(args.output, "w") as f:
             json.dump(output_dict, f, indent=2)
         print(f"✅ Saved config extraction results to: {args.output}")
     else:
         print(json.dumps(output_dict, indent=2))
 
     # Summary
-    print(f"\n📊 Summary:")
+    print("\n📊 Summary:")
     print(f"  Config files found: {result.total_files}")
     print(f"  Total settings: {result.total_settings}")
     print(f"  Detected patterns: {', '.join(result.detected_patterns.keys()) or 'None'}")
 
-    if 'ai_enhancements' in output_dict:
+    if "ai_enhancements" in output_dict:
         print(f"  ✨ AI enhancements: Yes ({enhance_mode} mode)")
-        insights = output_dict['ai_enhancements'].get('overall_insights', {})
-        if insights.get('security_issues_found'):
+        insights = output_dict["ai_enhancements"].get("overall_insights", {})
+        if insights.get("security_issues_found"):
             print(f"  🔐 Security issues found: {insights['security_issues_found']}")
 
     if result.errors:
         print(f"\n⚠️  Errors: {len(result.errors)}")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
diff --git a/src/skill_seekers/cli/config_manager.py b/src/skill_seekers/cli/config_manager.py
index 73609a1..13fbdd4 100644
--- a/src/skill_seekers/cli/config_manager.py
+++ b/src/skill_seekers/cli/config_manager.py
@@ -8,10 +8,10 @@ Provides secure storage with file permissions and auto-detection capabilities.
 import json
 import os
 import stat
+import sys
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Dict, List, Optional, Any
-import sys
+from typing import Any
 
 
 class ConfigManager:
@@ -26,28 +26,11 @@ class ConfigManager:
     # Default configuration
     DEFAULT_CONFIG = {
         "version": "1.0",
-        "github": {
-            "default_profile": None,
-            "profiles": {}
-        },
-        "rate_limit": {
-            "default_timeout_minutes": 30,
-            "auto_switch_profiles": True,
-            "show_countdown": True
-        },
-        "resume": {
-            "auto_save_interval_seconds": 60,
-            "keep_progress_days": 7
-        },
-        "api_keys": {
-            "anthropic": None,
-            "google": None,
-            "openai": None
-        },
-        "first_run": {
-            "completed": False,
-            "version": "2.7.0"
-        }
+        "github": {"default_profile": None, "profiles": {}},
+        "rate_limit": {"default_timeout_minutes": 30, "auto_switch_profiles": True, "show_countdown": True},
+        "resume": {"auto_save_interval_seconds": 60, "keep_progress_days": 7},
+        "api_keys": {"anthropic": None, "google": None, "openai": None},
+        "first_run": {"completed": False, "version": "2.7.0"},
     }
 
     def __init__(self):
@@ -65,25 +48,26 @@ class ConfigManager:
             # Set directory permissions to 700 (rwx------)
             directory.chmod(stat.S_IRWXU)
 
-    def _load_config(self) -> Dict[str, Any]:
+    def _load_config(self) -> dict[str, Any]:
         """Load configuration from file or create default."""
         if not self.config_file.exists():
             return self.DEFAULT_CONFIG.copy()
 
         try:
-            with open(self.config_file, 'r') as f:
+            with open(self.config_file) as f:
                 config = json.load(f)
 
             # Merge with defaults for any missing keys
             config = self._merge_with_defaults(config)
             return config
-        except (json.JSONDecodeError, IOError) as e:
+        except (OSError, json.JSONDecodeError) as e:
             print(f"⚠️  Warning: Could not load config file: {e}")
-            print(f"   Using default configuration.")
+            print("   Using default configuration.")
             return self.DEFAULT_CONFIG.copy()
 
-    def _merge_with_defaults(self, config: Dict[str, Any]) -> Dict[str, Any]:
+    def _merge_with_defaults(self, config: dict[str, Any]) -> dict[str, Any]:
         """Merge loaded config with defaults to ensure all keys exist."""
+
         def deep_merge(default: dict, custom: dict) -> dict:
             result = default.copy()
             for key, value in custom.items():
@@ -98,13 +82,13 @@ class ConfigManager:
     def save_config(self):
         """Save configuration to file with secure permissions."""
         try:
-            with open(self.config_file, 'w') as f:
+            with open(self.config_file, "w") as f:
                 json.dump(self.config, f, indent=2)
 
             # Set file permissions to 600 (rw-------)
             self.config_file.chmod(stat.S_IRUSR | stat.S_IWUSR)
 
-        except IOError as e:
+        except OSError as e:
             print(f"❌ Error saving config: {e}")
             sys.exit(1)
 
@@ -117,7 +101,7 @@ class ConfigManager:
         description: str = "",
         rate_limit_strategy: str = "prompt",
         timeout_minutes: int = 30,
-        set_as_default: bool = False
+        set_as_default: bool = False,
     ):
         """Add a new GitHub profile."""
         if not name:
@@ -131,7 +115,7 @@ class ConfigManager:
             "description": description,
             "rate_limit_strategy": rate_limit_strategy,
             "timeout_minutes": timeout_minutes,
-            "added_at": datetime.now().isoformat()
+            "added_at": datetime.now().isoformat(),
         }
 
         self.config["github"]["profiles"][name] = profile
@@ -142,7 +126,7 @@ class ConfigManager:
         self.save_config()
         print(f"✅ Added GitHub profile: {name}")
         if set_as_default:
-            print(f"✅ Set as default profile")
+            print("✅ Set as default profile")
 
     def remove_github_profile(self, name: str):
         """Remove a GitHub profile."""
@@ -159,7 +143,7 @@ class ConfigManager:
         self.save_config()
         print(f"✅ Removed GitHub profile: {name}")
 
-    def list_github_profiles(self) -> List[Dict[str, Any]]:
+    def list_github_profiles(self) -> list[dict[str, Any]]:
         """List all GitHub profiles."""
         profiles = []
         default = self.config["github"]["default_profile"]
@@ -171,17 +155,13 @@ class ConfigManager:
                 "strategy": data.get("rate_limit_strategy", "prompt"),
                 "timeout": data.get("timeout_minutes", 30),
                 "is_default": name == default,
-                "added_at": data.get("added_at", "Unknown")
+                "added_at": data.get("added_at", "Unknown"),
             }
             profiles.append(profile_info)
 
         return profiles
 
-    def get_github_token(
-        self,
-        profile_name: Optional[str] = None,
-        repo_url: Optional[str] = None
-    ) -> Optional[str]:
+    def get_github_token(self, profile_name: str | None = None, repo_url: str | None = None) -> str | None:
         """
         Get GitHub token with smart fallback chain.
 
@@ -214,14 +194,14 @@ class ConfigManager:
         # 4. No token available
         return None
 
-    def get_profile_for_token(self, token: str) -> Optional[str]:
+    def get_profile_for_token(self, token: str) -> str | None:
         """Get profile name for a given token."""
         for name, profile in self.config["github"]["profiles"].items():
             if profile["token"] == token:
                 return name
         return None
 
-    def get_next_profile(self, current_token: str) -> Optional[tuple]:
+    def get_next_profile(self, current_token: str) -> tuple | None:
         """
         Get next available profile for rate limit switching.
 
@@ -248,7 +228,7 @@ class ConfigManager:
         name, profile = profiles[next_idx]
         return (name, profile["token"])
 
-    def get_rate_limit_strategy(self, token: Optional[str] = None) -> str:
+    def get_rate_limit_strategy(self, token: str | None = None) -> str:
         """Get rate limit strategy for a token (or default)."""
         if token:
             profile_name = self.get_profile_for_token(token)
@@ -259,7 +239,7 @@ class ConfigManager:
         # Default strategy
         return "prompt"
 
-    def get_timeout_minutes(self, token: Optional[str] = None) -> int:
+    def get_timeout_minutes(self, token: str | None = None) -> int:
         """Get timeout minutes for a token (or default)."""
         if token:
             profile_name = self.get_profile_for_token(token)
@@ -280,7 +260,7 @@ class ConfigManager:
         self.save_config()
         print(f"✅ Set {provider.capitalize()} API key")
 
-    def get_api_key(self, provider: str) -> Optional[str]:
+    def get_api_key(self, provider: str) -> str | None:
         """
         Get API key with environment variable fallback.
 
@@ -289,11 +269,7 @@ class ConfigManager:
         2. Config file
         """
         # Check environment first
-        env_map = {
-            "anthropic": "ANTHROPIC_API_KEY",
-            "google": "GOOGLE_API_KEY",
-            "openai": "OPENAI_API_KEY"
-        }
+        env_map = {"anthropic": "ANTHROPIC_API_KEY", "google": "GOOGLE_API_KEY", "openai": "OPENAI_API_KEY"}
 
         env_var = env_map.get(provider)
         if env_var:
@@ -306,19 +282,19 @@ class ConfigManager:
 
     # Progress Management
 
-    def save_progress(self, job_id: str, progress_data: Dict[str, Any]):
+    def save_progress(self, job_id: str, progress_data: dict[str, Any]):
         """Save progress for a job."""
         progress_file = self.progress_dir / f"{job_id}.json"
 
         progress_data["last_updated"] = datetime.now().isoformat()
 
-        with open(progress_file, 'w') as f:
+        with open(progress_file, "w") as f:
             json.dump(progress_data, f, indent=2)
 
         # Set file permissions to 600
         progress_file.chmod(stat.S_IRUSR | stat.S_IWUSR)
 
-    def load_progress(self, job_id: str) -> Optional[Dict[str, Any]]:
+    def load_progress(self, job_id: str) -> dict[str, Any] | None:
         """Load progress for a job."""
         progress_file = self.progress_dir / f"{job_id}.json"
 
@@ -326,29 +302,31 @@ class ConfigManager:
             return None
 
         try:
-            with open(progress_file, 'r') as f:
+            with open(progress_file) as f:
                 return json.load(f)
-        except (json.JSONDecodeError, IOError):
+        except (OSError, json.JSONDecodeError):
             return None
 
-    def list_resumable_jobs(self) -> List[Dict[str, Any]]:
+    def list_resumable_jobs(self) -> list[dict[str, Any]]:
         """List all resumable jobs."""
         jobs = []
 
         for progress_file in self.progress_dir.glob("*.json"):
             try:
-                with open(progress_file, 'r') as f:
+                with open(progress_file) as f:
                     data = json.load(f)
 
                 if data.get("can_resume", False):
-                    jobs.append({
-                        "job_id": data.get("job_id", progress_file.stem),
-                        "started_at": data.get("started_at"),
-                        "command": data.get("command"),
-                        "progress": data.get("progress", {}),
-                        "last_updated": data.get("last_updated")
-                    })
-            except (json.JSONDecodeError, IOError):
+                    jobs.append(
+                        {
+                            "job_id": data.get("job_id", progress_file.stem),
+                            "started_at": data.get("started_at"),
+                            "command": data.get("command"),
+                            "progress": data.get("progress", {}),
+                            "last_updated": data.get("last_updated"),
+                        }
+                    )
+            except (OSError, json.JSONDecodeError):
                 continue
 
         # Sort by last updated (newest first)
@@ -447,8 +425,8 @@ class ConfigManager:
             print(f"\n📦 Resumable Jobs: {len(jobs)}")
             for job in jobs[:5]:  # Show max 5
                 print(f"  • {job['job_id']}")
-                if job.get('progress'):
-                    phase = job['progress'].get('phase', 'unknown')
+                if job.get("progress"):
+                    phase = job["progress"].get("phase", "unknown")
                     print(f"    Phase: {phase}, Last: {job['last_updated']}")
 
 
diff --git a/src/skill_seekers/cli/config_validator.py b/src/skill_seekers/cli/config_validator.py
index 65c5c65..154bdfb 100644
--- a/src/skill_seekers/cli/config_validator.py
+++ b/src/skill_seekers/cli/config_validator.py
@@ -12,8 +12,8 @@ Also provides backward compatibility detection for legacy configs.
 
 import json
 import logging
-from typing import Dict, Any, List, Optional, Union
 from pathlib import Path
+from typing import Any
 
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -25,18 +25,18 @@ class ConfigValidator:
     """
 
     # Valid source types
-    VALID_SOURCE_TYPES = {'documentation', 'github', 'pdf'}
+    VALID_SOURCE_TYPES = {"documentation", "github", "pdf"}
 
     # Valid merge modes
-    VALID_MERGE_MODES = {'rule-based', 'claude-enhanced'}
+    VALID_MERGE_MODES = {"rule-based", "claude-enhanced"}
 
     # Valid code analysis depth levels
-    VALID_DEPTH_LEVELS = {'surface', 'deep', 'full'}
+    VALID_DEPTH_LEVELS = {"surface", "deep", "full"}
 
     # Valid AI modes for C3.x enhancement
-    VALID_AI_MODES = {'auto', 'api', 'local', 'none'}
+    VALID_AI_MODES = {"auto", "api", "local", "none"}
 
-    def __init__(self, config_or_path: Union[Dict[str, Any], str]):
+    def __init__(self, config_or_path: dict[str, Any] | str):
         """
         Initialize validator with config dict or file path.
 
@@ -51,10 +51,10 @@ class ConfigValidator:
             self.config = self._load_config()
         self.is_unified = self._detect_format()
 
-    def _load_config(self) -> Dict[str, Any]:
+    def _load_config(self) -> dict[str, Any]:
         """Load JSON config file."""
         try:
-            with open(self.config_path, 'r', encoding='utf-8') as f:
+            with open(self.config_path, encoding="utf-8") as f:
                 return json.load(f)
         except FileNotFoundError:
             raise ValueError(f"Config file not found: {self.config_path}")
@@ -69,7 +69,7 @@ class ConfigValidator:
             True if unified format (has 'sources' array)
             False if legacy format
         """
-        return 'sources' in self.config and isinstance(self.config['sources'], list)
+        return "sources" in self.config and isinstance(self.config["sources"], list)
 
     def validate(self) -> bool:
         """
@@ -91,17 +91,17 @@ class ConfigValidator:
         logger.info("Validating unified config format...")
 
         # Required top-level fields
-        if 'name' not in self.config:
+        if "name" not in self.config:
             raise ValueError("Missing required field: 'name'")
 
-        if 'description' not in self.config:
+        if "description" not in self.config:
             raise ValueError("Missing required field: 'description'")
 
-        if 'sources' not in self.config:
+        if "sources" not in self.config:
             raise ValueError("Missing required field: 'sources'")
 
         # Validate sources array
-        sources = self.config['sources']
+        sources = self.config["sources"]
 
         if not isinstance(sources, list):
             raise ValueError("'sources' must be an array")
@@ -110,7 +110,7 @@ class ConfigValidator:
             raise ValueError("'sources' array cannot be empty")
 
         # Validate merge_mode (optional)
-        merge_mode = self.config.get('merge_mode', 'rule-based')
+        merge_mode = self.config.get("merge_mode", "rule-based")
         if merge_mode not in self.VALID_MERGE_MODES:
             raise ValueError(f"Invalid merge_mode: '{merge_mode}'. Must be one of {self.VALID_MERGE_MODES}")
 
@@ -121,56 +121,52 @@ class ConfigValidator:
         logger.info(f"✅ Unified config valid: {len(sources)} sources")
         return True
 
-    def _validate_source(self, source: Dict[str, Any], index: int):
+    def _validate_source(self, source: dict[str, Any], index: int):
         """Validate individual source configuration."""
         # Check source has 'type' field
-        if 'type' not in source:
+        if "type" not in source:
             raise ValueError(f"Source {index}: Missing required field 'type'")
 
-        source_type = source['type']
+        source_type = source["type"]
 
         if source_type not in self.VALID_SOURCE_TYPES:
-            raise ValueError(
-                f"Source {index}: Invalid type '{source_type}'. "
-                f"Must be one of {self.VALID_SOURCE_TYPES}"
-            )
+            raise ValueError(f"Source {index}: Invalid type '{source_type}'. Must be one of {self.VALID_SOURCE_TYPES}")
 
         # Type-specific validation
-        if source_type == 'documentation':
+        if source_type == "documentation":
             self._validate_documentation_source(source, index)
-        elif source_type == 'github':
+        elif source_type == "github":
             self._validate_github_source(source, index)
-        elif source_type == 'pdf':
+        elif source_type == "pdf":
             self._validate_pdf_source(source, index)
 
-    def _validate_documentation_source(self, source: Dict[str, Any], index: int):
+    def _validate_documentation_source(self, source: dict[str, Any], index: int):
         """Validate documentation source configuration."""
-        if 'base_url' not in source:
+        if "base_url" not in source:
             raise ValueError(f"Source {index} (documentation): Missing required field 'base_url'")
 
         # Optional but recommended fields
-        if 'selectors' not in source:
+        if "selectors" not in source:
             logger.warning(f"Source {index} (documentation): No 'selectors' specified, using defaults")
 
-        if 'max_pages' in source and not isinstance(source['max_pages'], int):
+        if "max_pages" in source and not isinstance(source["max_pages"], int):
             raise ValueError(f"Source {index} (documentation): 'max_pages' must be an integer")
 
-    def _validate_github_source(self, source: Dict[str, Any], index: int):
+    def _validate_github_source(self, source: dict[str, Any], index: int):
         """Validate GitHub source configuration."""
-        if 'repo' not in source:
+        if "repo" not in source:
             raise ValueError(f"Source {index} (github): Missing required field 'repo'")
 
         # Validate repo format (owner/repo)
-        repo = source['repo']
-        if '/' not in repo:
+        repo = source["repo"]
+        if "/" not in repo:
             raise ValueError(
-                f"Source {index} (github): Invalid repo format '{repo}'. "
-                f"Must be 'owner/repo' (e.g., 'facebook/react')"
+                f"Source {index} (github): Invalid repo format '{repo}'. Must be 'owner/repo' (e.g., 'facebook/react')"
             )
 
         # Validate code_analysis_depth if specified
-        if 'code_analysis_depth' in source:
-            depth = source['code_analysis_depth']
+        if "code_analysis_depth" in source:
+            depth = source["code_analysis_depth"]
             if depth not in self.VALID_DEPTH_LEVELS:
                 raise ValueError(
                     f"Source {index} (github): Invalid code_analysis_depth '{depth}'. "
@@ -178,29 +174,28 @@ class ConfigValidator:
                 )
 
         # Validate max_issues if specified
-        if 'max_issues' in source and not isinstance(source['max_issues'], int):
+        if "max_issues" in source and not isinstance(source["max_issues"], int):
             raise ValueError(f"Source {index} (github): 'max_issues' must be an integer")
 
         # Validate enable_codebase_analysis if specified (C3.5)
-        if 'enable_codebase_analysis' in source and not isinstance(source['enable_codebase_analysis'], bool):
+        if "enable_codebase_analysis" in source and not isinstance(source["enable_codebase_analysis"], bool):
             raise ValueError(f"Source {index} (github): 'enable_codebase_analysis' must be a boolean")
 
         # Validate ai_mode if specified (C3.5)
-        if 'ai_mode' in source:
-            ai_mode = source['ai_mode']
+        if "ai_mode" in source:
+            ai_mode = source["ai_mode"]
             if ai_mode not in self.VALID_AI_MODES:
                 raise ValueError(
-                    f"Source {index} (github): Invalid ai_mode '{ai_mode}'. "
-                    f"Must be one of {self.VALID_AI_MODES}"
+                    f"Source {index} (github): Invalid ai_mode '{ai_mode}'. Must be one of {self.VALID_AI_MODES}"
                 )
 
-    def _validate_pdf_source(self, source: Dict[str, Any], index: int):
+    def _validate_pdf_source(self, source: dict[str, Any], index: int):
         """Validate PDF source configuration."""
-        if 'path' not in source:
+        if "path" not in source:
             raise ValueError(f"Source {index} (pdf): Missing required field 'path'")
 
         # Check if file exists
-        pdf_path = source['path']
+        pdf_path = source["path"]
         if not Path(pdf_path).exists():
             logger.warning(f"Source {index} (pdf): File not found: {pdf_path}")
 
@@ -213,18 +208,18 @@ class ConfigValidator:
         logger.info("Detected legacy config format (backward compatible)")
 
         # Detect which legacy type based on fields
-        if 'base_url' in self.config:
+        if "base_url" in self.config:
             logger.info("Legacy type: documentation")
-        elif 'repo' in self.config:
+        elif "repo" in self.config:
             logger.info("Legacy type: github")
-        elif 'pdf' in self.config or 'path' in self.config:
+        elif "pdf" in self.config or "path" in self.config:
             logger.info("Legacy type: pdf")
         else:
             raise ValueError("Cannot detect legacy config type (missing base_url, repo, or pdf)")
 
         return True
 
-    def convert_legacy_to_unified(self) -> Dict[str, Any]:
+    def convert_legacy_to_unified(self) -> dict[str, Any]:
         """
         Convert legacy config to unified format.
 
@@ -238,64 +233,50 @@ class ConfigValidator:
         logger.info("Converting legacy config to unified format...")
 
         # Detect legacy type and convert
-        if 'base_url' in self.config:
+        if "base_url" in self.config:
             return self._convert_legacy_documentation()
-        elif 'repo' in self.config:
+        elif "repo" in self.config:
             return self._convert_legacy_github()
-        elif 'pdf' in self.config or 'path' in self.config:
+        elif "pdf" in self.config or "path" in self.config:
             return self._convert_legacy_pdf()
         else:
             raise ValueError("Cannot convert: unknown legacy format")
 
-    def _convert_legacy_documentation(self) -> Dict[str, Any]:
+    def _convert_legacy_documentation(self) -> dict[str, Any]:
         """Convert legacy documentation config to unified."""
         unified = {
-            'name': self.config.get('name', 'unnamed'),
-            'description': self.config.get('description', 'Documentation skill'),
-            'merge_mode': 'rule-based',
-            'sources': [
-                {
-                    'type': 'documentation',
-                    **{k: v for k, v in self.config.items()
-                       if k not in ['name', 'description']}
-                }
-            ]
+            "name": self.config.get("name", "unnamed"),
+            "description": self.config.get("description", "Documentation skill"),
+            "merge_mode": "rule-based",
+            "sources": [
+                {"type": "documentation", **{k: v for k, v in self.config.items() if k not in ["name", "description"]}}
+            ],
         }
         return unified
 
-    def _convert_legacy_github(self) -> Dict[str, Any]:
+    def _convert_legacy_github(self) -> dict[str, Any]:
         """Convert legacy GitHub config to unified."""
         unified = {
-            'name': self.config.get('name', 'unnamed'),
-            'description': self.config.get('description', 'GitHub repository skill'),
-            'merge_mode': 'rule-based',
-            'sources': [
-                {
-                    'type': 'github',
-                    **{k: v for k, v in self.config.items()
-                       if k not in ['name', 'description']}
-                }
-            ]
+            "name": self.config.get("name", "unnamed"),
+            "description": self.config.get("description", "GitHub repository skill"),
+            "merge_mode": "rule-based",
+            "sources": [
+                {"type": "github", **{k: v for k, v in self.config.items() if k not in ["name", "description"]}}
+            ],
         }
         return unified
 
-    def _convert_legacy_pdf(self) -> Dict[str, Any]:
+    def _convert_legacy_pdf(self) -> dict[str, Any]:
         """Convert legacy PDF config to unified."""
         unified = {
-            'name': self.config.get('name', 'unnamed'),
-            'description': self.config.get('description', 'PDF document skill'),
-            'merge_mode': 'rule-based',
-            'sources': [
-                {
-                    'type': 'pdf',
-                    **{k: v for k, v in self.config.items()
-                       if k not in ['name', 'description']}
-                }
-            ]
+            "name": self.config.get("name", "unnamed"),
+            "description": self.config.get("description", "PDF document skill"),
+            "merge_mode": "rule-based",
+            "sources": [{"type": "pdf", **{k: v for k, v in self.config.items() if k not in ["name", "description"]}}],
         }
         return unified
 
-    def get_sources_by_type(self, source_type: str) -> List[Dict[str, Any]]:
+    def get_sources_by_type(self, source_type: str) -> list[dict[str, Any]]:
         """
         Get all sources of a specific type.
 
@@ -308,17 +289,17 @@ class ConfigValidator:
         if not self.is_unified:
             # For legacy, convert and get sources
             unified = self.convert_legacy_to_unified()
-            sources = unified['sources']
+            sources = unified["sources"]
         else:
-            sources = self.config['sources']
+            sources = self.config["sources"]
 
-        return [s for s in sources if s.get('type') == source_type]
+        return [s for s in sources if s.get("type") == source_type]
 
     def has_multiple_sources(self) -> bool:
         """Check if config has multiple sources (requires merging)."""
         if not self.is_unified:
             return False
-        return len(self.config['sources']) > 1
+        return len(self.config["sources"]) > 1
 
     def needs_api_merge(self) -> bool:
         """
@@ -331,13 +312,11 @@ class ConfigValidator:
             return False
 
         has_docs_api = any(
-            s.get('type') == 'documentation' and s.get('extract_api', True)
-            for s in self.config['sources']
+            s.get("type") == "documentation" and s.get("extract_api", True) for s in self.config["sources"]
         )
 
         has_github_code = any(
-            s.get('type') == 'github' and s.get('include_code', False)
-            for s in self.config['sources']
+            s.get("type") == "github" and s.get("include_code", False) for s in self.config["sources"]
         )
 
         return has_docs_api and has_github_code
@@ -361,7 +340,7 @@ def validate_config(config_path: str) -> ConfigValidator:
     return validator
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     import sys
 
     if len(sys.argv) < 2:
@@ -373,18 +352,18 @@ if __name__ == '__main__':
     try:
         validator = validate_config(config_file)
 
-        print(f"\n✅ Config valid!")
+        print("\n✅ Config valid!")
         print(f"   Format: {'Unified' if validator.is_unified else 'Legacy'}")
         print(f"   Name: {validator.config.get('name')}")
 
         if validator.is_unified:
-            sources = validator.config['sources']
+            sources = validator.config["sources"]
             print(f"   Sources: {len(sources)}")
             for i, source in enumerate(sources):
-                print(f"     {i+1}. {source['type']}")
+                print(f"     {i + 1}. {source['type']}")
 
             if validator.needs_api_merge():
-                merge_mode = validator.config.get('merge_mode', 'rule-based')
+                merge_mode = validator.config.get("merge_mode", "rule-based")
                 print(f"   ⚠️  API merge required (mode: {merge_mode})")
 
     except ValueError as e:
diff --git a/src/skill_seekers/cli/conflict_detector.py b/src/skill_seekers/cli/conflict_detector.py
index 5f7d4c2..ef84ff7 100644
--- a/src/skill_seekers/cli/conflict_detector.py
+++ b/src/skill_seekers/cli/conflict_detector.py
@@ -13,9 +13,9 @@ Used by unified scraper to identify discrepancies before merging.
 
 import json
 import logging
-from typing import Dict, List, Any, Optional, Tuple
-from dataclasses import dataclass, asdict
+from dataclasses import asdict, dataclass
 from difflib import SequenceMatcher
+from typing import Any
 
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -24,13 +24,14 @@ logger = logging.getLogger(__name__)
 @dataclass
 class Conflict:
     """Represents a conflict between documentation and code."""
+
     type: str  # 'missing_in_docs', 'missing_in_code', 'signature_mismatch', 'description_mismatch'
     severity: str  # 'low', 'medium', 'high'
     api_name: str
-    docs_info: Optional[Dict[str, Any]] = None
-    code_info: Optional[Dict[str, Any]] = None
-    difference: Optional[str] = None
-    suggestion: Optional[str] = None
+    docs_info: dict[str, Any] | None = None
+    code_info: dict[str, Any] | None = None
+    difference: str | None = None
+    suggestion: str | None = None
 
 
 class ConflictDetector:
@@ -38,7 +39,7 @@ class ConflictDetector:
     Detects conflicts between documentation and code sources.
     """
 
-    def __init__(self, docs_data: Dict[str, Any], github_data: Dict[str, Any]):
+    def __init__(self, docs_data: dict[str, Any], github_data: dict[str, Any]):
         """
         Initialize conflict detector.
 
@@ -56,7 +57,7 @@ class ConflictDetector:
         logger.info(f"Loaded {len(self.docs_apis)} APIs from documentation")
         logger.info(f"Loaded {len(self.code_apis)} APIs from code")
 
-    def _extract_docs_apis(self) -> Dict[str, Dict[str, Any]]:
+    def _extract_docs_apis(self) -> dict[str, dict[str, Any]]:
         """
         Extract API information from documentation data.
 
@@ -66,42 +67,43 @@ class ConflictDetector:
         apis = {}
 
         # Documentation structure varies, but typically has 'pages' or 'references'
-        pages = self.docs_data.get('pages', {})
+        pages = self.docs_data.get("pages", {})
 
         # Handle both dict and list formats
         if isinstance(pages, dict):
             # Format: {url: page_data, ...}
             for url, page_data in pages.items():
-                content = page_data.get('content', '')
-                title = page_data.get('title', '')
+                content = page_data.get("content", "")
+                title = page_data.get("title", "")
 
                 # Simple heuristic: if title or URL contains "api", "reference", "class", "function"
                 # it might be an API page
-                if any(keyword in title.lower() or keyword in url.lower()
-                       for keyword in ['api', 'reference', 'class', 'function', 'method']):
-
+                if any(
+                    keyword in title.lower() or keyword in url.lower()
+                    for keyword in ["api", "reference", "class", "function", "method"]
+                ):
                     # Extract API signatures from content (simplified)
                     extracted_apis = self._parse_doc_content_for_apis(content, url)
                     apis.update(extracted_apis)
         elif isinstance(pages, list):
             # Format: [{url: '...', apis: [...]}, ...]
             for page in pages:
-                url = page.get('url', '')
-                page_apis = page.get('apis', [])
+                url = page.get("url", "")
+                page_apis = page.get("apis", [])
 
                 # If APIs are already extracted in the page data
                 for api in page_apis:
-                    api_name = api.get('name', '')
+                    api_name = api.get("name", "")
                     if api_name:
                         apis[api_name] = {
-                            'parameters': api.get('parameters', []),
-                            'return_type': api.get('return_type', 'Any'),
-                            'source_url': url
+                            "parameters": api.get("parameters", []),
+                            "return_type": api.get("return_type", "Any"),
+                            "source_url": url,
                         }
 
         return apis
 
-    def _parse_doc_content_for_apis(self, content: str, source_url: str) -> Dict[str, Dict]:
+    def _parse_doc_content_for_apis(self, content: str, source_url: str) -> dict[str, dict]:
         """
         Parse documentation content to extract API signatures.
 
@@ -121,13 +123,13 @@ class ConflictDetector:
         # Pattern for common API signatures
         patterns = [
             # Python style: def name(params) -> return
-            r'def\s+(\w+)\s*\(([^)]*)\)(?:\s*->\s*(\w+))?',
+            r"def\s+(\w+)\s*\(([^)]*)\)(?:\s*->\s*(\w+))?",
             # JavaScript style: function name(params)
-            r'function\s+(\w+)\s*\(([^)]*)\)',
+            r"function\s+(\w+)\s*\(([^)]*)\)",
             # C++ style: return_type name(params)
-            r'(\w+)\s+(\w+)\s*\(([^)]*)\)',
+            r"(\w+)\s+(\w+)\s*\(([^)]*)\)",
             # Method style: ClassName.method_name(params)
-            r'(\w+)\.(\w+)\s*\(([^)]*)\)'
+            r"(\w+)\.(\w+)\s*\(([^)]*)\)",
         ]
 
         for pattern in patterns:
@@ -135,17 +137,17 @@ class ConflictDetector:
                 groups = match.groups()
 
                 # Parse based on pattern matched
-                if 'def' in pattern:
+                if "def" in pattern:
                     # Python function
                     name = groups[0]
                     params_str = groups[1]
                     return_type = groups[2] if len(groups) > 2 else None
-                elif 'function' in pattern:
+                elif "function" in pattern:
                     # JavaScript function
                     name = groups[0]
                     params_str = groups[1]
                     return_type = None
-                elif '.' in pattern:
+                elif "." in pattern:
                     # Class method
                     class_name = groups[0]
                     method_name = groups[1]
@@ -162,54 +164,54 @@ class ConflictDetector:
                 params = self._parse_param_string(params_str)
 
                 apis[name] = {
-                    'name': name,
-                    'parameters': params,
-                    'return_type': return_type,
-                    'source': source_url,
-                    'raw_signature': match.group(0)
+                    "name": name,
+                    "parameters": params,
+                    "return_type": return_type,
+                    "source": source_url,
+                    "raw_signature": match.group(0),
                 }
 
         return apis
 
-    def _parse_param_string(self, params_str: str) -> List[Dict]:
+    def _parse_param_string(self, params_str: str) -> list[dict]:
         """Parse parameter string into list of parameter dicts."""
         if not params_str.strip():
             return []
 
         params = []
-        for param in params_str.split(','):
+        for param in params_str.split(","):
             param = param.strip()
             if not param:
                 continue
 
             # Try to extract name and type
-            param_info = {'name': param, 'type': None, 'default': None}
+            param_info = {"name": param, "type": None, "default": None}
 
             # Check for type annotation (: type)
-            if ':' in param:
-                parts = param.split(':', 1)
-                param_info['name'] = parts[0].strip()
+            if ":" in param:
+                parts = param.split(":", 1)
+                param_info["name"] = parts[0].strip()
                 type_part = parts[1].strip()
 
                 # Check for default value (= value)
-                if '=' in type_part:
-                    type_str, default_str = type_part.split('=', 1)
-                    param_info['type'] = type_str.strip()
-                    param_info['default'] = default_str.strip()
+                if "=" in type_part:
+                    type_str, default_str = type_part.split("=", 1)
+                    param_info["type"] = type_str.strip()
+                    param_info["default"] = default_str.strip()
                 else:
-                    param_info['type'] = type_part
+                    param_info["type"] = type_part
 
             # Check for default without type (= value)
-            elif '=' in param:
-                parts = param.split('=', 1)
-                param_info['name'] = parts[0].strip()
-                param_info['default'] = parts[1].strip()
+            elif "=" in param:
+                parts = param.split("=", 1)
+                param_info["name"] = parts[0].strip()
+                param_info["default"] = parts[1].strip()
 
             params.append(param_info)
 
         return params
 
-    def _extract_code_apis(self) -> Dict[str, Dict[str, Any]]:
+    def _extract_code_apis(self) -> dict[str, dict[str, Any]]:
         """
         Extract API information from GitHub code analysis.
 
@@ -218,61 +220,61 @@ class ConflictDetector:
         """
         apis = {}
 
-        code_analysis = self.github_data.get('code_analysis', {})
+        code_analysis = self.github_data.get("code_analysis", {})
         if not code_analysis:
             return apis
 
         # Support both 'files' and 'analyzed_files' keys
-        files = code_analysis.get('files', code_analysis.get('analyzed_files', []))
+        files = code_analysis.get("files", code_analysis.get("analyzed_files", []))
 
         for file_info in files:
-            file_path = file_info.get('file', 'unknown')
+            file_path = file_info.get("file", "unknown")
 
             # Extract classes and their methods
-            for class_info in file_info.get('classes', []):
-                class_name = class_info['name']
+            for class_info in file_info.get("classes", []):
+                class_name = class_info["name"]
 
                 # Add class itself
                 apis[class_name] = {
-                    'name': class_name,
-                    'type': 'class',
-                    'source': file_path,
-                    'line': class_info.get('line_number'),
-                    'base_classes': class_info.get('base_classes', []),
-                    'docstring': class_info.get('docstring')
+                    "name": class_name,
+                    "type": "class",
+                    "source": file_path,
+                    "line": class_info.get("line_number"),
+                    "base_classes": class_info.get("base_classes", []),
+                    "docstring": class_info.get("docstring"),
                 }
 
                 # Add methods
-                for method in class_info.get('methods', []):
+                for method in class_info.get("methods", []):
                     method_name = f"{class_name}.{method['name']}"
                     apis[method_name] = {
-                        'name': method_name,
-                        'type': 'method',
-                        'parameters': method.get('parameters', []),
-                        'return_type': method.get('return_type'),
-                        'source': file_path,
-                        'line': method.get('line_number'),
-                        'docstring': method.get('docstring'),
-                        'is_async': method.get('is_async', False)
+                        "name": method_name,
+                        "type": "method",
+                        "parameters": method.get("parameters", []),
+                        "return_type": method.get("return_type"),
+                        "source": file_path,
+                        "line": method.get("line_number"),
+                        "docstring": method.get("docstring"),
+                        "is_async": method.get("is_async", False),
                     }
 
             # Extract standalone functions
-            for func_info in file_info.get('functions', []):
-                func_name = func_info['name']
+            for func_info in file_info.get("functions", []):
+                func_name = func_info["name"]
                 apis[func_name] = {
-                    'name': func_name,
-                    'type': 'function',
-                    'parameters': func_info.get('parameters', []),
-                    'return_type': func_info.get('return_type'),
-                    'source': file_path,
-                    'line': func_info.get('line_number'),
-                    'docstring': func_info.get('docstring'),
-                    'is_async': func_info.get('is_async', False)
+                    "name": func_name,
+                    "type": "function",
+                    "parameters": func_info.get("parameters", []),
+                    "return_type": func_info.get("return_type"),
+                    "source": file_path,
+                    "line": func_info.get("line_number"),
+                    "docstring": func_info.get("docstring"),
+                    "is_async": func_info.get("is_async", False),
                 }
 
         return apis
 
-    def detect_all_conflicts(self) -> List[Conflict]:
+    def detect_all_conflicts(self) -> list[Conflict]:
         """
         Detect all types of conflicts.
 
@@ -296,7 +298,7 @@ class ConflictDetector:
 
         return conflicts
 
-    def _find_missing_in_docs(self) -> List[Conflict]:
+    def _find_missing_in_docs(self) -> list[Conflict]:
         """Find APIs that exist in code but not in documentation."""
         conflicts = []
 
@@ -304,40 +306,46 @@ class ConflictDetector:
             # Simple name matching (can be enhanced with fuzzy matching)
             if api_name not in self.docs_apis:
                 # Check if it's a private/internal API (often not documented)
-                is_private = api_name.startswith('_') or '__' in api_name
-                severity = 'low' if is_private else 'medium'
+                is_private = api_name.startswith("_") or "__" in api_name
+                severity = "low" if is_private else "medium"
 
-                conflicts.append(Conflict(
-                    type='missing_in_docs',
-                    severity=severity,
-                    api_name=api_name,
-                    code_info=code_info,
-                    difference=f"API exists in code ({code_info['source']}) but not found in documentation",
-                    suggestion="Add documentation for this API" if not is_private else "Consider if this internal API should be documented"
-                ))
+                conflicts.append(
+                    Conflict(
+                        type="missing_in_docs",
+                        severity=severity,
+                        api_name=api_name,
+                        code_info=code_info,
+                        difference=f"API exists in code ({code_info['source']}) but not found in documentation",
+                        suggestion="Add documentation for this API"
+                        if not is_private
+                        else "Consider if this internal API should be documented",
+                    )
+                )
 
         logger.info(f"Found {len(conflicts)} APIs missing in documentation")
         return conflicts
 
-    def _find_missing_in_code(self) -> List[Conflict]:
+    def _find_missing_in_code(self) -> list[Conflict]:
         """Find APIs that are documented but don't exist in code."""
         conflicts = []
 
         for api_name, docs_info in self.docs_apis.items():
             if api_name not in self.code_apis:
-                conflicts.append(Conflict(
-                    type='missing_in_code',
-                    severity='high',  # This is serious - documented but doesn't exist
-                    api_name=api_name,
-                    docs_info=docs_info,
-                    difference=f"API documented ({docs_info.get('source', 'unknown')}) but not found in code",
-                    suggestion="Update documentation to remove this API, or add it to codebase"
-                ))
+                conflicts.append(
+                    Conflict(
+                        type="missing_in_code",
+                        severity="high",  # This is serious - documented but doesn't exist
+                        api_name=api_name,
+                        docs_info=docs_info,
+                        difference=f"API documented ({docs_info.get('source', 'unknown')}) but not found in code",
+                        suggestion="Update documentation to remove this API, or add it to codebase",
+                    )
+                )
 
         logger.info(f"Found {len(conflicts)} APIs missing in code")
         return conflicts
 
-    def _find_signature_mismatches(self) -> List[Conflict]:
+    def _find_signature_mismatches(self) -> list[Conflict]:
         """Find APIs where signature differs between docs and code."""
         conflicts = []
 
@@ -352,41 +360,43 @@ class ConflictDetector:
             mismatch = self._compare_signatures(docs_info, code_info)
 
             if mismatch:
-                conflicts.append(Conflict(
-                    type='signature_mismatch',
-                    severity=mismatch['severity'],
-                    api_name=api_name,
-                    docs_info=docs_info,
-                    code_info=code_info,
-                    difference=mismatch['difference'],
-                    suggestion=mismatch['suggestion']
-                ))
+                conflicts.append(
+                    Conflict(
+                        type="signature_mismatch",
+                        severity=mismatch["severity"],
+                        api_name=api_name,
+                        docs_info=docs_info,
+                        code_info=code_info,
+                        difference=mismatch["difference"],
+                        suggestion=mismatch["suggestion"],
+                    )
+                )
 
         logger.info(f"Found {len(conflicts)} signature mismatches")
         return conflicts
 
-    def _compare_signatures(self, docs_info: Dict, code_info: Dict) -> Optional[Dict]:
+    def _compare_signatures(self, docs_info: dict, code_info: dict) -> dict | None:
         """
         Compare signatures between docs and code.
 
         Returns:
             Dict with mismatch details if conflict found, None otherwise
         """
-        docs_params = docs_info.get('parameters', [])
-        code_params = code_info.get('parameters', [])
+        docs_params = docs_info.get("parameters", [])
+        code_params = code_info.get("parameters", [])
 
         # Compare parameter counts
         if len(docs_params) != len(code_params):
             return {
-                'severity': 'medium',
-                'difference': f"Parameter count mismatch: docs has {len(docs_params)}, code has {len(code_params)}",
-                'suggestion': f"Documentation shows {len(docs_params)} parameters, but code has {len(code_params)}"
+                "severity": "medium",
+                "difference": f"Parameter count mismatch: docs has {len(docs_params)}, code has {len(code_params)}",
+                "suggestion": f"Documentation shows {len(docs_params)} parameters, but code has {len(code_params)}",
             }
 
         # Compare parameter names and types
         for i, (doc_param, code_param) in enumerate(zip(docs_params, code_params)):
-            doc_name = doc_param.get('name', '')
-            code_name = code_param.get('name', '')
+            doc_name = doc_param.get("name", "")
+            code_name = code_param.get("name", "")
 
             # Parameter name mismatch
             if doc_name != code_name:
@@ -394,36 +404,36 @@ class ConflictDetector:
                 similarity = SequenceMatcher(None, doc_name, code_name).ratio()
                 if similarity < 0.8:  # Not similar enough
                     return {
-                        'severity': 'medium',
-                        'difference': f"Parameter {i+1} name mismatch: '{doc_name}' in docs vs '{code_name}' in code",
-                        'suggestion': f"Update documentation to use parameter name '{code_name}'"
+                        "severity": "medium",
+                        "difference": f"Parameter {i + 1} name mismatch: '{doc_name}' in docs vs '{code_name}' in code",
+                        "suggestion": f"Update documentation to use parameter name '{code_name}'",
                     }
 
             # Type mismatch
-            doc_type = doc_param.get('type')
-            code_type = code_param.get('type_hint')
+            doc_type = doc_param.get("type")
+            code_type = code_param.get("type_hint")
 
             if doc_type and code_type and doc_type != code_type:
                 return {
-                    'severity': 'low',
-                    'difference': f"Parameter '{doc_name}' type mismatch: '{doc_type}' in docs vs '{code_type}' in code",
-                    'suggestion': f"Verify correct type for parameter '{doc_name}'"
+                    "severity": "low",
+                    "difference": f"Parameter '{doc_name}' type mismatch: '{doc_type}' in docs vs '{code_type}' in code",
+                    "suggestion": f"Verify correct type for parameter '{doc_name}'",
                 }
 
         # Compare return types if both have them
-        docs_return = docs_info.get('return_type')
-        code_return = code_info.get('return_type')
+        docs_return = docs_info.get("return_type")
+        code_return = code_info.get("return_type")
 
         if docs_return and code_return and docs_return != code_return:
             return {
-                'severity': 'low',
-                'difference': f"Return type mismatch: '{docs_return}' in docs vs '{code_return}' in code",
-                'suggestion': "Verify correct return type"
+                "severity": "low",
+                "difference": f"Return type mismatch: '{docs_return}' in docs vs '{code_return}' in code",
+                "suggestion": "Verify correct return type",
             }
 
         return None
 
-    def generate_summary(self, conflicts: List[Conflict]) -> Dict[str, Any]:
+    def generate_summary(self, conflicts: list[Conflict]) -> dict[str, Any]:
         """
         Generate summary statistics for conflicts.
 
@@ -434,25 +444,25 @@ class ConflictDetector:
             Summary dict with statistics
         """
         summary = {
-            'total': len(conflicts),
-            'by_type': {},
-            'by_severity': {},
-            'apis_affected': len(set(c.api_name for c in conflicts))
+            "total": len(conflicts),
+            "by_type": {},
+            "by_severity": {},
+            "apis_affected": len(set(c.api_name for c in conflicts)),
         }
 
         # Count by type
-        for conflict_type in ['missing_in_docs', 'missing_in_code', 'signature_mismatch', 'description_mismatch']:
+        for conflict_type in ["missing_in_docs", "missing_in_code", "signature_mismatch", "description_mismatch"]:
             count = sum(1 for c in conflicts if c.type == conflict_type)
-            summary['by_type'][conflict_type] = count
+            summary["by_type"][conflict_type] = count
 
         # Count by severity
-        for severity in ['low', 'medium', 'high']:
+        for severity in ["low", "medium", "high"]:
             count = sum(1 for c in conflicts if c.severity == severity)
-            summary['by_severity'][severity] = count
+            summary["by_severity"][severity] = count
 
         return summary
 
-    def save_conflicts(self, conflicts: List[Conflict], output_path: str):
+    def save_conflicts(self, conflicts: list[Conflict], output_path: str):
         """
         Save conflicts to JSON file.
 
@@ -460,18 +470,15 @@ class ConflictDetector:
             conflicts: List of Conflict objects
             output_path: Path to output JSON file
         """
-        data = {
-            'conflicts': [asdict(c) for c in conflicts],
-            'summary': self.generate_summary(conflicts)
-        }
+        data = {"conflicts": [asdict(c) for c in conflicts], "summary": self.generate_summary(conflicts)}
 
-        with open(output_path, 'w', encoding='utf-8') as f:
+        with open(output_path, "w", encoding="utf-8") as f:
             json.dump(data, f, indent=2, ensure_ascii=False)
 
         logger.info(f"Conflicts saved to: {output_path}")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     import sys
 
     if len(sys.argv) < 3:
@@ -482,10 +489,10 @@ if __name__ == '__main__':
     github_file = sys.argv[2]
 
     # Load data
-    with open(docs_file, 'r') as f:
+    with open(docs_file) as f:
         docs_data = json.load(f)
 
-    with open(github_file, 'r') as f:
+    with open(github_file) as f:
         github_data = json.load(f)
 
     # Detect conflicts
@@ -498,16 +505,16 @@ if __name__ == '__main__':
     print(f"   Total conflicts: {summary['total']}")
     print(f"   APIs affected: {summary['apis_affected']}")
     print("\n   By Type:")
-    for conflict_type, count in summary['by_type'].items():
+    for conflict_type, count in summary["by_type"].items():
         if count > 0:
             print(f"     {conflict_type}: {count}")
     print("\n   By Severity:")
-    for severity, count in summary['by_severity'].items():
+    for severity, count in summary["by_severity"].items():
         if count > 0:
-            emoji = '🔴' if severity == 'high' else '🟡' if severity == 'medium' else '🟢'
+            emoji = "🔴" if severity == "high" else "🟡" if severity == "medium" else "🟢"
             print(f"     {emoji} {severity}: {count}")
 
     # Save to file
-    output_file = 'conflicts.json'
+    output_file = "conflicts.json"
     detector.save_conflicts(conflicts, output_file)
     print(f"\n✅ Full report saved to: {output_file}")
diff --git a/src/skill_seekers/cli/constants.py b/src/skill_seekers/cli/constants.py
index 2685e93..87fcb9a 100644
--- a/src/skill_seekers/cli/constants.py
+++ b/src/skill_seekers/cli/constants.py
@@ -8,7 +8,7 @@ across the CLI tools to improve maintainability and clarity.
 
 # Default scraping limits
 DEFAULT_RATE_LIMIT = 0.5  # seconds between requests
-DEFAULT_MAX_PAGES = 500   # maximum pages to scrape
+DEFAULT_MAX_PAGES = 500  # maximum pages to scrape
 DEFAULT_CHECKPOINT_INTERVAL = 1000  # pages between checkpoints
 DEFAULT_ASYNC_MODE = False  # use async mode for parallel scraping (opt-in)
 
@@ -26,7 +26,7 @@ CONTENT_MATCH_POINTS = 1  # points for content keyword match
 
 # API-based enhancement limits (uses Anthropic API)
 API_CONTENT_LIMIT = 100000  # max characters for API enhancement
-API_PREVIEW_LIMIT = 40000   # max characters for preview
+API_PREVIEW_LIMIT = 40000  # max characters for preview
 
 # Local enhancement limits (uses Claude Code Max)
 LOCAL_CONTENT_LIMIT = 50000  # max characters for local enhancement
@@ -36,7 +36,7 @@ LOCAL_PREVIEW_LIMIT = 20000  # max characters for preview
 
 # Estimation and discovery settings
 DEFAULT_MAX_DISCOVERY = 1000  # default max pages to discover
-DISCOVERY_THRESHOLD = 10000   # threshold for warnings
+DISCOVERY_THRESHOLD = 10000  # threshold for warnings
 
 # ===== FILE LIMITS =====
 
@@ -48,25 +48,25 @@ MAX_CODE_BLOCKS_PER_PAGE = 5  # maximum code blocks to extract per page
 
 __all__ = [
     # Scraping
-    'DEFAULT_RATE_LIMIT',
-    'DEFAULT_MAX_PAGES',
-    'DEFAULT_CHECKPOINT_INTERVAL',
-    'DEFAULT_ASYNC_MODE',
-    'CONTENT_PREVIEW_LENGTH',
-    'MAX_PAGES_WARNING_THRESHOLD',
-    'MIN_CATEGORIZATION_SCORE',
-    'URL_MATCH_POINTS',
-    'TITLE_MATCH_POINTS',
-    'CONTENT_MATCH_POINTS',
+    "DEFAULT_RATE_LIMIT",
+    "DEFAULT_MAX_PAGES",
+    "DEFAULT_CHECKPOINT_INTERVAL",
+    "DEFAULT_ASYNC_MODE",
+    "CONTENT_PREVIEW_LENGTH",
+    "MAX_PAGES_WARNING_THRESHOLD",
+    "MIN_CATEGORIZATION_SCORE",
+    "URL_MATCH_POINTS",
+    "TITLE_MATCH_POINTS",
+    "CONTENT_MATCH_POINTS",
     # Enhancement
-    'API_CONTENT_LIMIT',
-    'API_PREVIEW_LIMIT',
-    'LOCAL_CONTENT_LIMIT',
-    'LOCAL_PREVIEW_LIMIT',
+    "API_CONTENT_LIMIT",
+    "API_PREVIEW_LIMIT",
+    "LOCAL_CONTENT_LIMIT",
+    "LOCAL_PREVIEW_LIMIT",
     # Estimation
-    'DEFAULT_MAX_DISCOVERY',
-    'DISCOVERY_THRESHOLD',
+    "DEFAULT_MAX_DISCOVERY",
+    "DISCOVERY_THRESHOLD",
     # Limits
-    'MAX_REFERENCE_FILES',
-    'MAX_CODE_BLOCKS_PER_PAGE',
+    "MAX_REFERENCE_FILES",
+    "MAX_CODE_BLOCKS_PER_PAGE",
 ]
diff --git a/src/skill_seekers/cli/dependency_analyzer.py b/src/skill_seekers/cli/dependency_analyzer.py
index 17cd422..3df9ac5 100644
--- a/src/skill_seekers/cli/dependency_analyzer.py
+++ b/src/skill_seekers/cli/dependency_analyzer.py
@@ -37,15 +37,16 @@ Credits:
 - NetworkX for graph algorithms: https://networkx.org/
 """
 
-import re
 import ast
 import logging
-from pathlib import Path
-from typing import Dict, List, Set, Tuple, Optional, Any
+import re
 from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
 
 try:
     import networkx as nx
+
     NETWORKX_AVAILABLE = True
 except ImportError:
     NETWORKX_AVAILABLE = False
@@ -56,6 +57,7 @@ logger = logging.getLogger(__name__)
 @dataclass
 class DependencyInfo:
     """Information about a single dependency relationship."""
+
     source_file: str
     imported_module: str
     import_type: str  # 'import', 'from', 'require', 'include'
@@ -66,10 +68,11 @@ class DependencyInfo:
 @dataclass
 class FileNode:
     """Represents a file node in the dependency graph."""
+
     file_path: str
     language: str
-    dependencies: List[str] = field(default_factory=list)
-    imported_by: List[str] = field(default_factory=list)
+    dependencies: list[str] = field(default_factory=list)
+    imported_by: list[str] = field(default_factory=list)
 
 
 class DependencyAnalyzer:
@@ -83,16 +86,13 @@ class DependencyAnalyzer:
     def __init__(self):
         """Initialize dependency analyzer."""
         if not NETWORKX_AVAILABLE:
-            raise ImportError(
-                "NetworkX is required for dependency analysis. "
-                "Install with: pip install networkx"
-            )
+            raise ImportError("NetworkX is required for dependency analysis. Install with: pip install networkx")
 
         self.graph = nx.DiGraph()  # Directed graph for dependencies
-        self.file_dependencies: Dict[str, List[DependencyInfo]] = {}
-        self.file_nodes: Dict[str, FileNode] = {}
+        self.file_dependencies: dict[str, list[DependencyInfo]] = {}
+        self.file_nodes: dict[str, FileNode] = {}
 
-    def analyze_file(self, file_path: str, content: str, language: str) -> List[DependencyInfo]:
+    def analyze_file(self, file_path: str, content: str, language: str) -> list[DependencyInfo]:
         """
         Extract dependencies from a source file.
 
@@ -104,23 +104,23 @@ class DependencyAnalyzer:
         Returns:
             List of DependencyInfo objects
         """
-        if language == 'Python':
+        if language == "Python":
             deps = self._extract_python_imports(content, file_path)
-        elif language in ('JavaScript', 'TypeScript'):
+        elif language in ("JavaScript", "TypeScript"):
             deps = self._extract_js_imports(content, file_path)
-        elif language in ('C++', 'C'):
+        elif language in ("C++", "C"):
             deps = self._extract_cpp_includes(content, file_path)
-        elif language == 'C#':
+        elif language == "C#":
             deps = self._extract_csharp_imports(content, file_path)
-        elif language == 'Go':
+        elif language == "Go":
             deps = self._extract_go_imports(content, file_path)
-        elif language == 'Rust':
+        elif language == "Rust":
             deps = self._extract_rust_imports(content, file_path)
-        elif language == 'Java':
+        elif language == "Java":
             deps = self._extract_java_imports(content, file_path)
-        elif language == 'Ruby':
+        elif language == "Ruby":
             deps = self._extract_ruby_imports(content, file_path)
-        elif language == 'PHP':
+        elif language == "PHP":
             deps = self._extract_php_imports(content, file_path)
         else:
             logger.warning(f"Unsupported language: {language}")
@@ -130,15 +130,11 @@ class DependencyAnalyzer:
 
         # Create file node
         imported_modules = [dep.imported_module for dep in deps]
-        self.file_nodes[file_path] = FileNode(
-            file_path=file_path,
-            language=language,
-            dependencies=imported_modules
-        )
+        self.file_nodes[file_path] = FileNode(file_path=file_path, language=language, dependencies=imported_modules)
 
         return deps
 
-    def _extract_python_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_python_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract Python import statements using AST.
 
@@ -159,33 +155,37 @@ class DependencyAnalyzer:
         for node in ast.walk(tree):
             if isinstance(node, ast.Import):
                 for alias in node.names:
-                    deps.append(DependencyInfo(
-                        source_file=file_path,
-                        imported_module=alias.name,
-                        import_type='import',
-                        is_relative=False,
-                        line_number=node.lineno
-                    ))
+                    deps.append(
+                        DependencyInfo(
+                            source_file=file_path,
+                            imported_module=alias.name,
+                            import_type="import",
+                            is_relative=False,
+                            line_number=node.lineno,
+                        )
+                    )
 
             elif isinstance(node, ast.ImportFrom):
-                module = node.module or ''
+                module = node.module or ""
                 is_relative = node.level > 0
 
                 # Handle relative imports
                 if is_relative:
-                    module = '.' * node.level + module
+                    module = "." * node.level + module
 
-                deps.append(DependencyInfo(
-                    source_file=file_path,
-                    imported_module=module,
-                    import_type='from',
-                    is_relative=is_relative,
-                    line_number=node.lineno
-                ))
+                deps.append(
+                    DependencyInfo(
+                        source_file=file_path,
+                        imported_module=module,
+                        import_type="from",
+                        is_relative=is_relative,
+                        line_number=node.lineno,
+                    )
+                )
 
         return deps
 
-    def _extract_js_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_js_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract JavaScript/TypeScript import statements.
 
@@ -202,35 +202,39 @@ class DependencyAnalyzer:
         import_pattern = r"import\s+(?:[\w\s{},*]+\s+from\s+)?['\"]([^'\"]+)['\"]"
         for match in re.finditer(import_pattern, content):
             module = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
-            is_relative = module.startswith('.') or module.startswith('/')
+            line_num = content[: match.start()].count("\n") + 1
+            is_relative = module.startswith(".") or module.startswith("/")
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=module,
-                import_type='import',
-                is_relative=is_relative,
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=module,
+                    import_type="import",
+                    is_relative=is_relative,
+                    line_number=line_num,
+                )
+            )
 
         # CommonJS requires: require('module')
         require_pattern = r"require\s*\(['\"]([^'\"]+)['\"]\)"
         for match in re.finditer(require_pattern, content):
             module = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
-            is_relative = module.startswith('.') or module.startswith('/')
+            line_num = content[: match.start()].count("\n") + 1
+            is_relative = module.startswith(".") or module.startswith("/")
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=module,
-                import_type='require',
-                is_relative=is_relative,
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=module,
+                    import_type="require",
+                    is_relative=is_relative,
+                    line_number=line_num,
+                )
+            )
 
         return deps
 
-    def _extract_cpp_includes(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_cpp_includes(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract C++ #include directives.
 
@@ -244,22 +248,24 @@ class DependencyAnalyzer:
         include_pattern = r'#include\s+[<"]([^>"]+)[>"]'
         for match in re.finditer(include_pattern, content):
             header = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
             # Headers with "" are usually local, <> are system headers
             is_relative = '"' in match.group(0)
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=header,
-                import_type='include',
-                is_relative=is_relative,
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=header,
+                    import_type="include",
+                    is_relative=is_relative,
+                    line_number=line_num,
+                )
+            )
 
         return deps
 
-    def _extract_csharp_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_csharp_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract C# using statements.
 
@@ -275,27 +281,29 @@ class DependencyAnalyzer:
         deps = []
 
         # Match using statements: using [static] Namespace[.Type];
-        using_pattern = r'using\s+(?:static\s+)?(?:(\w+)\s*=\s*)?([A-Za-z_][\w.]*)\s*;'
+        using_pattern = r"using\s+(?:static\s+)?(?:(\w+)\s*=\s*)?([A-Za-z_][\w.]*)\s*;"
         for match in re.finditer(using_pattern, content):
             alias = match.group(1)  # Optional alias
             namespace = match.group(2)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
             # Skip 'using' statements for IDisposable (using var x = ...)
-            if '=' in match.group(0) and not alias:
+            if "=" in match.group(0) and not alias:
                 continue
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=namespace,
-                import_type='using',
-                is_relative=False,  # C# uses absolute namespaces
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=namespace,
+                    import_type="using",
+                    is_relative=False,  # C# uses absolute namespaces
+                    line_number=line_num,
+                )
+            )
 
         return deps
 
-    def _extract_go_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_go_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract Go import statements.
 
@@ -314,21 +322,23 @@ class DependencyAnalyzer:
         for match in re.finditer(single_import_pattern, content):
             alias = match.group(1)  # Optional alias
             package = match.group(2)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
             # Check if relative (starts with ./ or ../)
-            is_relative = package.startswith('./')
+            is_relative = package.startswith("./")
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=package,
-                import_type='import',
-                is_relative=is_relative,
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=package,
+                    import_type="import",
+                    is_relative=is_relative,
+                    line_number=line_num,
+                )
+            )
 
         # Multi-import block: import ( ... )
-        multi_import_pattern = r'import\s*\((.*?)\)'
+        multi_import_pattern = r"import\s*\((.*?)\)"
         for match in re.finditer(multi_import_pattern, content, re.DOTALL):
             block = match.group(1)
             block_start = match.start()
@@ -338,21 +348,23 @@ class DependencyAnalyzer:
             for line_match in re.finditer(import_line_pattern, block):
                 alias = line_match.group(1)
                 package = line_match.group(2)
-                line_num = content[:block_start + line_match.start()].count('\n') + 1
+                line_num = content[: block_start + line_match.start()].count("\n") + 1
 
-                is_relative = package.startswith('./')
+                is_relative = package.startswith("./")
 
-                deps.append(DependencyInfo(
-                    source_file=file_path,
-                    imported_module=package,
-                    import_type='import',
-                    is_relative=is_relative,
-                    line_number=line_num
-                ))
+                deps.append(
+                    DependencyInfo(
+                        source_file=file_path,
+                        imported_module=package,
+                        import_type="import",
+                        is_relative=is_relative,
+                        line_number=line_num,
+                    )
+                )
 
         return deps
 
-    def _extract_rust_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_rust_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract Rust use statements.
 
@@ -369,43 +381,47 @@ class DependencyAnalyzer:
 
         # Match use statements: use path::to::item; (including curly braces with spaces)
         # This pattern matches: use word::word; or use word::{item, item};
-        use_pattern = r'use\s+([\w:{}]+(?:\s*,\s*[\w:{}]+)*|[\w:]+::\{[^}]+\})\s*;'
+        use_pattern = r"use\s+([\w:{}]+(?:\s*,\s*[\w:{}]+)*|[\w:]+::\{[^}]+\})\s*;"
         for match in re.finditer(use_pattern, content):
             module_path = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
             # Determine if relative
-            is_relative = module_path.startswith(('self::', 'super::'))
+            is_relative = module_path.startswith(("self::", "super::"))
 
             # Handle curly brace imports (use std::{io, fs})
-            if '{' in module_path:
+            if "{" in module_path:
                 # Extract base path
-                base_path = module_path.split('{')[0].rstrip(':')
+                base_path = module_path.split("{")[0].rstrip(":")
                 # Extract items inside braces
-                items_match = re.search(r'\{([^}]+)\}', module_path)
+                items_match = re.search(r"\{([^}]+)\}", module_path)
                 if items_match:
-                    items = [item.strip() for item in items_match.group(1).split(',')]
+                    items = [item.strip() for item in items_match.group(1).split(",")]
                     for item in items:
                         full_path = f"{base_path}::{item}" if base_path else item
-                        deps.append(DependencyInfo(
-                            source_file=file_path,
-                            imported_module=full_path,
-                            import_type='use',
-                            is_relative=is_relative,
-                            line_number=line_num
-                        ))
+                        deps.append(
+                            DependencyInfo(
+                                source_file=file_path,
+                                imported_module=full_path,
+                                import_type="use",
+                                is_relative=is_relative,
+                                line_number=line_num,
+                            )
+                        )
             else:
-                deps.append(DependencyInfo(
-                    source_file=file_path,
-                    imported_module=module_path,
-                    import_type='use',
-                    is_relative=is_relative,
-                    line_number=line_num
-                ))
+                deps.append(
+                    DependencyInfo(
+                        source_file=file_path,
+                        imported_module=module_path,
+                        import_type="use",
+                        is_relative=is_relative,
+                        line_number=line_num,
+                    )
+                )
 
         return deps
 
-    def _extract_java_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_java_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract Java import statements.
 
@@ -420,22 +436,24 @@ class DependencyAnalyzer:
         deps = []
 
         # Match import statements: import [static] package.Class;
-        import_pattern = r'import\s+(?:static\s+)?([A-Za-z_][\w.]*(?:\.\*)?)\s*;'
+        import_pattern = r"import\s+(?:static\s+)?([A-Za-z_][\w.]*(?:\.\*)?)\s*;"
         for match in re.finditer(import_pattern, content):
             import_path = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=import_path,
-                import_type='import',
-                is_relative=False,  # Java uses absolute package names
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=import_path,
+                    import_type="import",
+                    is_relative=False,  # Java uses absolute package names
+                    line_number=line_num,
+                )
+            )
 
         return deps
 
-    def _extract_ruby_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_ruby_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract Ruby require/require_relative/load statements.
 
@@ -453,47 +471,53 @@ class DependencyAnalyzer:
         require_pattern = r"require\s+['\"]([^'\"]+)['\"]"
         for match in re.finditer(require_pattern, content):
             module = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=module,
-                import_type='require',
-                is_relative=False,  # require looks in load path
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=module,
+                    import_type="require",
+                    is_relative=False,  # require looks in load path
+                    line_number=line_num,
+                )
+            )
 
         # Match require_relative: require_relative 'file'
         require_relative_pattern = r"require_relative\s+['\"]([^'\"]+)['\"]"
         for match in re.finditer(require_relative_pattern, content):
             module = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=module,
-                import_type='require_relative',
-                is_relative=True,
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=module,
+                    import_type="require_relative",
+                    is_relative=True,
+                    line_number=line_num,
+                )
+            )
 
         # Match load: load 'script.rb'
         load_pattern = r"load\s+['\"]([^'\"]+)['\"]"
         for match in re.finditer(load_pattern, content):
             module = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=module,
-                import_type='load',
-                is_relative=True,  # load is usually relative
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=module,
+                    import_type="load",
+                    is_relative=True,  # load is usually relative
+                    line_number=line_num,
+                )
+            )
 
         return deps
 
-    def _extract_php_imports(self, content: str, file_path: str) -> List[DependencyInfo]:
+    def _extract_php_imports(self, content: str, file_path: str) -> list[DependencyInfo]:
         """
         Extract PHP require/include/use statements.
 
@@ -513,35 +537,39 @@ class DependencyAnalyzer:
         require_pattern = r"(?:require|include)(?:_once)?\s+['\"]([^'\"]+)['\"]"
         for match in re.finditer(require_pattern, content):
             module = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
             # Determine import type
-            import_type = 'require' if 'require' in match.group(0) else 'include'
+            import_type = "require" if "require" in match.group(0) else "include"
 
             # PHP file paths are relative by default
-            is_relative = not module.startswith(('/', 'http://', 'https://'))
+            is_relative = not module.startswith(("/", "http://", "https://"))
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=module,
-                import_type=import_type,
-                is_relative=is_relative,
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=module,
+                    import_type=import_type,
+                    is_relative=is_relative,
+                    line_number=line_num,
+                )
+            )
 
         # Match namespace use: use Namespace\Class;
-        use_pattern = r'use\s+([A-Za-z_][\w\\]*)\s*(?:as\s+\w+)?\s*;'
+        use_pattern = r"use\s+([A-Za-z_][\w\\]*)\s*(?:as\s+\w+)?\s*;"
         for match in re.finditer(use_pattern, content):
             namespace = match.group(1)
-            line_num = content[:match.start()].count('\n') + 1
+            line_num = content[: match.start()].count("\n") + 1
 
-            deps.append(DependencyInfo(
-                source_file=file_path,
-                imported_module=namespace,
-                import_type='use',
-                is_relative=False,  # Namespaces are absolute
-                line_number=line_num
-            ))
+            deps.append(
+                DependencyInfo(
+                    source_file=file_path,
+                    imported_module=namespace,
+                    import_type="use",
+                    is_relative=False,  # Namespaces are absolute
+                    line_number=line_num,
+                )
+            )
 
         return deps
 
@@ -566,12 +594,7 @@ class DependencyAnalyzer:
 
                 if target and target in self.file_nodes:
                     # Add edge from source to dependency
-                    self.graph.add_edge(
-                        file_path,
-                        target,
-                        import_type=dep.import_type,
-                        line_number=dep.line_number
-                    )
+                    self.graph.add_edge(file_path, target, import_type=dep.import_type, line_number=dep.line_number)
 
                     # Update imported_by lists
                     if target in self.file_nodes:
@@ -579,7 +602,7 @@ class DependencyAnalyzer:
 
         return self.graph
 
-    def _resolve_import(self, source_file: str, imported_module: str, is_relative: bool) -> Optional[str]:
+    def _resolve_import(self, source_file: str, imported_module: str, is_relative: bool) -> str | None:
         """
         Resolve import statement to actual file path.
 
@@ -609,7 +632,7 @@ class DependencyAnalyzer:
 
         return None
 
-    def detect_cycles(self) -> List[List[str]]:
+    def detect_cycles(self) -> list[list[str]]:
         """
         Detect circular dependencies in the graph.
 
@@ -627,7 +650,7 @@ class DependencyAnalyzer:
             logger.error(f"Error detecting cycles: {e}")
             return []
 
-    def get_strongly_connected_components(self) -> List[Set[str]]:
+    def get_strongly_connected_components(self) -> list[set[str]]:
         """
         Get strongly connected components (groups of mutually dependent files).
 
@@ -645,13 +668,14 @@ class DependencyAnalyzer:
         """
         try:
             from networkx.drawing.nx_pydot import write_dot
+
             write_dot(self.graph, output_path)
             logger.info(f"Exported graph to DOT format: {output_path}")
         except ImportError:
             logger.warning("pydot not installed - cannot export to DOT format")
             logger.warning("Install with: pip install pydot")
 
-    def export_json(self) -> Dict[str, Any]:
+    def export_json(self) -> dict[str, Any]:
         """
         Export graph as JSON structure.
 
@@ -659,22 +683,19 @@ class DependencyAnalyzer:
             Dictionary with nodes and edges
         """
         return {
-            'nodes': [
-                {
-                    'file': node,
-                    'language': data.get('language', 'Unknown')
-                }
+            "nodes": [
+                {"file": node, "language": data.get("language", "Unknown")}
                 for node, data in self.graph.nodes(data=True)
             ],
-            'edges': [
+            "edges": [
                 {
-                    'source': source,
-                    'target': target,
-                    'import_type': data.get('import_type', 'unknown'),
-                    'line_number': data.get('line_number', 0)
+                    "source": source,
+                    "target": target,
+                    "import_type": data.get("import_type", "unknown"),
+                    "line_number": data.get("line_number", 0),
                 }
                 for source, target, data in self.graph.edges(data=True)
-            ]
+            ],
         }
 
     def export_mermaid(self) -> str:
@@ -684,7 +705,7 @@ class DependencyAnalyzer:
         Returns:
             Mermaid diagram as string
         """
-        lines = ['graph TD']
+        lines = ["graph TD"]
 
         # Create node labels (shorten file paths for readability)
         node_ids = {}
@@ -700,9 +721,9 @@ class DependencyAnalyzer:
             target_id = node_ids[target]
             lines.append(f"    {source_id} --> {target_id}")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def get_statistics(self) -> Dict[str, Any]:
+    def get_statistics(self) -> dict[str, Any]:
         """
         Get graph statistics.
 
@@ -710,20 +731,15 @@ class DependencyAnalyzer:
             Dictionary with various statistics
         """
         return {
-            'total_files': self.graph.number_of_nodes(),
-            'total_dependencies': self.graph.number_of_edges(),
-            'circular_dependencies': len(self.detect_cycles()),
-            'strongly_connected_components': len(self.get_strongly_connected_components()),
-            'avg_dependencies_per_file': (
-                self.graph.number_of_edges() / self.graph.number_of_nodes()
-                if self.graph.number_of_nodes() > 0 else 0
+            "total_files": self.graph.number_of_nodes(),
+            "total_dependencies": self.graph.number_of_edges(),
+            "circular_dependencies": len(self.detect_cycles()),
+            "strongly_connected_components": len(self.get_strongly_connected_components()),
+            "avg_dependencies_per_file": (
+                self.graph.number_of_edges() / self.graph.number_of_nodes() if self.graph.number_of_nodes() > 0 else 0
             ),
-            'files_with_no_dependencies': len([
-                node for node in self.graph.nodes()
-                if self.graph.out_degree(node) == 0
-            ]),
-            'files_not_imported': len([
-                node for node in self.graph.nodes()
-                if self.graph.in_degree(node) == 0
-            ]),
+            "files_with_no_dependencies": len(
+                [node for node in self.graph.nodes() if self.graph.out_degree(node) == 0]
+            ),
+            "files_not_imported": len([node for node in self.graph.nodes() if self.graph.in_degree(node) == 0]),
         }
diff --git a/src/skill_seekers/cli/doc_scraper.py b/src/skill_seekers/cli/doc_scraper.py
index 9f536e4..a9482c5 100755
--- a/src/skill_seekers/cli/doc_scraper.py
+++ b/src/skill_seekers/cli/doc_scraper.py
@@ -9,39 +9,40 @@ Usage:
     skill-seekers scrape --url https://react.dev/ --name react
 """
 
-import os
-import sys
-import json
-import time
-import re
 import argparse
-import hashlib
-import logging
 import asyncio
-import requests
-import httpx
+import hashlib
+import json
+import logging
+import os
+import re
+import sys
+import time
+from collections import defaultdict, deque
 from pathlib import Path
+from typing import Any, Optional
 from urllib.parse import urljoin, urlparse
+
+import httpx
+import requests
 from bs4 import BeautifulSoup
-from collections import deque, defaultdict
-from typing import Optional, Dict, List, Tuple, Set, Deque, Any
 
 # Add parent directory to path for imports when run as script
 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
-from skill_seekers.cli.llms_txt_detector import LlmsTxtDetector
-from skill_seekers.cli.llms_txt_parser import LlmsTxtParser
-from skill_seekers.cli.llms_txt_downloader import LlmsTxtDownloader
-from skill_seekers.cli.language_detector import LanguageDetector
 from skill_seekers.cli.constants import (
-    DEFAULT_RATE_LIMIT,
-    DEFAULT_MAX_PAGES,
-    DEFAULT_CHECKPOINT_INTERVAL,
-    DEFAULT_ASYNC_MODE,
     CONTENT_PREVIEW_LENGTH,
+    DEFAULT_ASYNC_MODE,
+    DEFAULT_CHECKPOINT_INTERVAL,
+    DEFAULT_MAX_PAGES,
+    DEFAULT_RATE_LIMIT,
     MAX_PAGES_WARNING_THRESHOLD,
-    MIN_CATEGORIZATION_SCORE
+    MIN_CATEGORIZATION_SCORE,
 )
+from skill_seekers.cli.language_detector import LanguageDetector
+from skill_seekers.cli.llms_txt_detector import LlmsTxtDetector
+from skill_seekers.cli.llms_txt_downloader import LlmsTxtDownloader
+from skill_seekers.cli.llms_txt_parser import LlmsTxtParser
 
 # Configure logging
 logger = logging.getLogger(__name__)
@@ -61,14 +62,10 @@ def setup_logging(verbose: bool = False, quiet: bool = False) -> None:
     else:
         level = logging.INFO
 
-    logging.basicConfig(
-        level=level,
-        format='%(message)s',
-        force=True
-    )
+    logging.basicConfig(level=level, format="%(message)s", force=True)
 
 
-def infer_description_from_docs(base_url: str, first_page_content: Optional[str] = None, name: str = '') -> str:
+def infer_description_from_docs(base_url: str, first_page_content: str | None = None, name: str = "") -> str:
     """
     Infer skill description from documentation metadata or first page content.
 
@@ -88,58 +85,64 @@ def infer_description_from_docs(base_url: str, first_page_content: Optional[str]
     # If we have first page content, try to extract description
     if first_page_content:
         try:
-            soup = BeautifulSoup(first_page_content, 'html.parser')
+            soup = BeautifulSoup(first_page_content, "html.parser")
 
             # Strategy 1: Try meta description tag
-            meta_desc = soup.find('meta', {'name': 'description'})
-            if meta_desc and meta_desc.get('content'):
-                desc = meta_desc['content'].strip()
+            meta_desc = soup.find("meta", {"name": "description"})
+            if meta_desc and meta_desc.get("content"):
+                desc = meta_desc["content"].strip()
                 if len(desc) > 20:  # Meaningful length
                     # Clean and format
                     if len(desc) > 150:
-                        desc = desc[:147] + '...'
-                    return f'Use when {desc.lower()}'
+                        desc = desc[:147] + "..."
+                    return f"Use when {desc.lower()}"
 
             # Strategy 2: Try OpenGraph description
-            og_desc = soup.find('meta', {'property': 'og:description'})
-            if og_desc and og_desc.get('content'):
-                desc = og_desc['content'].strip()
+            og_desc = soup.find("meta", {"property": "og:description"})
+            if og_desc and og_desc.get("content"):
+                desc = og_desc["content"].strip()
                 if len(desc) > 20:
                     if len(desc) > 150:
-                        desc = desc[:147] + '...'
-                    return f'Use when {desc.lower()}'
+                        desc = desc[:147] + "..."
+                    return f"Use when {desc.lower()}"
 
             # Strategy 3: Extract first meaningful paragraph from main content
             # Look for common documentation main content areas
             main_content = None
-            for selector in ['article', 'main', 'div[role="main"]', 'div.content', 'div.doc-content']:
+            for selector in ["article", "main", 'div[role="main"]', "div.content", "div.doc-content"]:
                 main_content = soup.select_one(selector)
                 if main_content:
                     break
 
             if main_content:
                 # Find first paragraph
-                for p in main_content.find_all('p', limit=5):
+                for p in main_content.find_all("p", limit=5):
                     text = p.get_text().strip()
                     # Skip empty, very short, or navigation-like paragraphs
-                    if len(text) > 30 and not any(skip in text.lower() for skip in ['table of contents', 'on this page', 'navigation']):
+                    if len(text) > 30 and not any(
+                        skip in text.lower() for skip in ["table of contents", "on this page", "navigation"]
+                    ):
                         # Clean and format
                         if len(text) > 150:
-                            text = text[:147] + '...'
-                        return f'Use when working with {text.lower()}'
+                            text = text[:147] + "..."
+                        return f"Use when working with {text.lower()}"
 
         except Exception as e:
             logger.debug(f"Could not infer description from page content: {e}")
 
     # Improved fallback template
-    return f'Use when working with {name}' if name else f'Use when working with documentation at {urlparse(base_url).netloc}'
+    return (
+        f"Use when working with {name}"
+        if name
+        else f"Use when working with documentation at {urlparse(base_url).netloc}"
+    )
 
 
 class DocToSkillConverter:
-    def __init__(self, config: Dict[str, Any], dry_run: bool = False, resume: bool = False) -> None:
+    def __init__(self, config: dict[str, Any], dry_run: bool = False, resume: bool = False) -> None:
         self.config = config
-        self.name = config['name']
-        self.base_url = config['base_url']
+        self.name = config["name"]
+        self.base_url = config["base_url"]
         self.dry_run = dry_run
         self.resume = resume
 
@@ -149,34 +152,33 @@ class DocToSkillConverter:
         self.checkpoint_file = f"{self.data_dir}/checkpoint.json"
 
         # Checkpoint config
-        checkpoint_config = config.get('checkpoint', {})
-        self.checkpoint_enabled = checkpoint_config.get('enabled', False)
-        self.checkpoint_interval = checkpoint_config.get('interval', DEFAULT_CHECKPOINT_INTERVAL)
+        checkpoint_config = config.get("checkpoint", {})
+        self.checkpoint_enabled = checkpoint_config.get("enabled", False)
+        self.checkpoint_interval = checkpoint_config.get("interval", DEFAULT_CHECKPOINT_INTERVAL)
 
         # llms.txt detection state
-        skip_llms_txt_value = config.get('skip_llms_txt', False)
+        skip_llms_txt_value = config.get("skip_llms_txt", False)
         if not isinstance(skip_llms_txt_value, bool):
             logger.warning(
-                "Invalid value for 'skip_llms_txt': %r (expected bool). Defaulting to False.",
-                skip_llms_txt_value
+                "Invalid value for 'skip_llms_txt': %r (expected bool). Defaulting to False.", skip_llms_txt_value
             )
             self.skip_llms_txt = False
         else:
             self.skip_llms_txt = skip_llms_txt_value
         self.llms_txt_detected = False
         self.llms_txt_variant = None
-        self.llms_txt_variants: List[str] = []  # Track all downloaded variants
+        self.llms_txt_variants: list[str] = []  # Track all downloaded variants
 
         # Parallel scraping config
-        self.workers = config.get('workers', 1)
-        self.async_mode = config.get('async_mode', DEFAULT_ASYNC_MODE)
+        self.workers = config.get("workers", 1)
+        self.async_mode = config.get("async_mode", DEFAULT_ASYNC_MODE)
 
         # State
         self.visited_urls: set[str] = set()
         # Support multiple starting URLs
-        start_urls = config.get('start_urls', [self.base_url])
+        start_urls = config.get("start_urls", [self.base_url])
         self.pending_urls = deque(start_urls)
-        self.pages: List[Dict[str, Any]] = []
+        self.pages: list[dict[str, Any]] = []
         self.pages_scraped = 0
 
         # Language detection
@@ -185,6 +187,7 @@ class DocToSkillConverter:
         # Thread-safe lock for parallel scraping
         if self.workers > 1:
             import threading
+
             self.lock = threading.Lock()
 
         # Create directories (unless dry-run)
@@ -197,7 +200,7 @@ class DocToSkillConverter:
         # Load checkpoint if resuming
         if resume and not dry_run:
             self.load_checkpoint()
-    
+
     def is_valid_url(self, url: str) -> bool:
         """Check if URL should be scraped based on patterns.
 
@@ -211,12 +214,12 @@ class DocToSkillConverter:
             return False
 
         # Include patterns
-        includes = self.config.get('url_patterns', {}).get('include', [])
+        includes = self.config.get("url_patterns", {}).get("include", [])
         if includes and not any(pattern in url for pattern in includes):
             return False
 
         # Exclude patterns
-        excludes = self.config.get('url_patterns', {}).get('exclude', [])
+        excludes = self.config.get("url_patterns", {}).get("exclude", [])
         if any(pattern in url for pattern in excludes):
             return False
 
@@ -233,11 +236,11 @@ class DocToSkillConverter:
             "pending_urls": list(self.pending_urls),
             "pages_scraped": self.pages_scraped,
             "last_updated": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
-            "checkpoint_interval": self.checkpoint_interval
+            "checkpoint_interval": self.checkpoint_interval,
         }
 
         try:
-            with open(self.checkpoint_file, 'w', encoding='utf-8') as f:
+            with open(self.checkpoint_file, "w", encoding="utf-8") as f:
                 json.dump(checkpoint_data, f, indent=2)
             logger.info("  💾 Checkpoint saved (%d pages)", self.pages_scraped)
         except Exception as e:
@@ -250,7 +253,7 @@ class DocToSkillConverter:
             return
 
         try:
-            with open(self.checkpoint_file, 'r', encoding='utf-8') as f:
+            with open(self.checkpoint_file, encoding="utf-8") as f:
                 checkpoint_data = json.load(f)
 
             self.visited_urls = set(checkpoint_data["visited_urls"])
@@ -261,7 +264,7 @@ class DocToSkillConverter:
             logger.info("   Pages already scraped: %d", self.pages_scraped)
             logger.info("   URLs visited: %d", len(self.visited_urls))
             logger.info("   URLs pending: %d", len(self.pending_urls))
-            logger.info("   Last updated: %s", checkpoint_data['last_updated'])
+            logger.info("   Last updated: %s", checkpoint_data["last_updated"])
             logger.info("")
 
         except Exception as e:
@@ -277,79 +280,72 @@ class DocToSkillConverter:
             except Exception as e:
                 logger.warning("⚠️  Failed to clear checkpoint: %s", e)
 
-    def extract_content(self, soup: Any, url: str) -> Dict[str, Any]:
+    def extract_content(self, soup: Any, url: str) -> dict[str, Any]:
         """Extract content with improved code and pattern detection"""
         page = {
-            'url': url,
-            'title': '',
-            'content': '',
-            'headings': [],
-            'code_samples': [],
-            'patterns': [],  # NEW: Extract common patterns
-            'links': []
+            "url": url,
+            "title": "",
+            "content": "",
+            "headings": [],
+            "code_samples": [],
+            "patterns": [],  # NEW: Extract common patterns
+            "links": [],
         }
-        
-        selectors = self.config.get('selectors', {})
-        
+
+        selectors = self.config.get("selectors", {})
+
         # Extract title
-        title_elem = soup.select_one(selectors.get('title', 'title'))
+        title_elem = soup.select_one(selectors.get("title", "title"))
         if title_elem:
-            page['title'] = self.clean_text(title_elem.get_text())
-        
+            page["title"] = self.clean_text(title_elem.get_text())
+
         # Find main content
-        main_selector = selectors.get('main_content', 'div[role="main"]')
+        main_selector = selectors.get("main_content", 'div[role="main"]')
         main = soup.select_one(main_selector)
-        
+
         if not main:
             logger.warning("⚠ No content: %s", url)
             return page
-        
+
         # Extract headings with better structure
-        for h in main.find_all(['h1', 'h2', 'h3', 'h4', 'h5', 'h6']):
+        for h in main.find_all(["h1", "h2", "h3", "h4", "h5", "h6"]):
             text = self.clean_text(h.get_text())
             if text:
-                page['headings'].append({
-                    'level': h.name,
-                    'text': text,
-                    'id': h.get('id', '')
-                })
-        
+                page["headings"].append({"level": h.name, "text": text, "id": h.get("id", "")})
+
         # Extract code with language detection
-        code_selector = selectors.get('code_blocks', 'pre code')
+        code_selector = selectors.get("code_blocks", "pre code")
         for code_elem in main.select(code_selector):
             code = code_elem.get_text()
             if len(code.strip()) > 10:
                 # Try to detect language
                 lang = self.detect_language(code_elem, code)
-                page['code_samples'].append({
-                    'code': code.strip(),
-                    'language': lang
-                })
-        
+                page["code_samples"].append({"code": code.strip(), "language": lang})
+
         # Extract patterns (NEW: common code patterns)
-        page['patterns'] = self.extract_patterns(main, page['code_samples'])
-        
+        page["patterns"] = self.extract_patterns(main, page["code_samples"])
+
         # Extract paragraphs
         paragraphs = []
-        for p in main.find_all('p'):
+        for p in main.find_all("p"):
             text = self.clean_text(p.get_text())
             if text and len(text) > 20:  # Skip very short paragraphs
                 paragraphs.append(text)
-        
-        page['content'] = '\n\n'.join(paragraphs)
+
+        page["content"] = "\n\n".join(paragraphs)
 
         # Extract links from entire page (not just main content)
         # This allows discovery of navigation links outside the main content area
-        for link in soup.find_all('a', href=True):
-            href = urljoin(url, link['href'])
+        for link in soup.find_all("a", href=True):
+            href = urljoin(url, link["href"])
             # Strip anchor fragments to avoid treating #anchors as separate pages
-            href = href.split('#')[0]
-            if self.is_valid_url(href) and href not in page['links']:
-                page['links'].append(href)
+            href = href.split("#")[0]
+            if self.is_valid_url(href) and href not in page["links"]:
+                page["links"].append(href)
 
         return page
 
-    def _extract_markdown_content(self, content: str, url: str) -> Dict[str, Any]:
+    def _extract_markdown_content(self, content: str, url: str) -> dict[str, Any]:
         """Extract structured content from a Markdown file.
 
         Parses markdown files from llms.txt URLs to extract:
@@ -382,76 +378,61 @@ class DocToSkillConverter:
         import re
 
         # Detect if content is actually HTML (some .md URLs return HTML)
-        if content.strip().startswith('<!DOCTYPE') or content.strip().startswith('<html'):
+        if content.strip().startswith("<!DOCTYPE") or content.strip().startswith("<html"):
             return self._extract_html_as_markdown(content, url)
 
-        page = {
-            'url': url,
-            'title': '',
-            'content': '',
-            'headings': [],
-            'code_samples': [],
-            'patterns': [],
-            'links': []
-        }
+        page = {"url": url, "title": "", "content": "", "headings": [], "code_samples": [], "patterns": [], "links": []}
 
-        lines = content.split('\n')
+        lines = content.split("\n")
 
         # Extract title from first h1
         for line in lines:
-            if line.startswith('# '):
-                page['title'] = line[2:].strip()
+            if line.startswith("# "):
+                page["title"] = line[2:].strip()
                 break
 
         # Extract headings (h2-h6)
         for line in lines:
-            match = re.match(r'^(#{2,6})\s+(.+)$', line)
+            match = re.match(r"^(#{2,6})\s+(.+)$", line)
             if match:
                 level = len(match.group(1))
                 text = match.group(2).strip()
-                page['headings'].append({
-                    'level': f'h{level}',
-                    'text': text,
-                    'id': text.lower().replace(' ', '-')
-                })
+                page["headings"].append({"level": f"h{level}", "text": text, "id": text.lower().replace(" ", "-")})
 
         # Extract code blocks with language
-        code_blocks = re.findall(r'```(\w+)?\n(.*?)```', content, re.DOTALL)
+        code_blocks = re.findall(r"```(\w+)?\n(.*?)```", content, re.DOTALL)
         for lang, code in code_blocks:
             if len(code.strip()) > 10:
-                page['code_samples'].append({
-                    'code': code.strip(),
-                    'language': lang or 'unknown'
-                })
+                page["code_samples"].append({"code": code.strip(), "language": lang or "unknown"})
 
         # Extract content (paragraphs)
-        content_no_code = re.sub(r'```.*?```', '', content, flags=re.DOTALL)
+        content_no_code = re.sub(r"```.*?```", "", content, flags=re.DOTALL)
         paragraphs = []
-        for para in content_no_code.split('\n\n'):
+        for para in content_no_code.split("\n\n"):
             text = para.strip()
             # Skip headings and short text
-            if text and len(text) > 20 and not text.startswith('#'):
+            if text and len(text) > 20 and not text.startswith("#"):
                 paragraphs.append(text)
-        page['content'] = '\n\n'.join(paragraphs)
+        page["content"] = "\n\n".join(paragraphs)
 
         # Extract links from markdown (only .md files to avoid client-side rendered HTML pages)
-        md_links = re.findall(r'\[([^\]]*)\]\(([^)]+)\)', content)
+        md_links = re.findall(r"\[([^\]]*)\]\(([^)]+)\)", content)
         for _, href in md_links:
-            if href.startswith('http'):
+            if href.startswith("http"):
                 full_url = href
-            elif not href.startswith('#'):
+            elif not href.startswith("#"):
                 full_url = urljoin(url, href)
             else:
                 continue
             # Strip anchor fragments
-            full_url = full_url.split('#')[0]
+            full_url = full_url.split("#")[0]
             # Only include .md URLs to avoid client-side rendered HTML pages
-            if '.md' in full_url and self.is_valid_url(full_url) and full_url not in page['links']:
-                page['links'].append(full_url)
+            if ".md" in full_url and self.is_valid_url(full_url) and full_url not in page["links"]:
+                page["links"].append(full_url)
 
         return page
 
-    def _extract_html_as_markdown(self, html_content: str, url: str) -> Dict[str, Any]:
+    def _extract_html_as_markdown(self, html_content: str, url: str) -> dict[str, Any]:
         """Extract content from HTML and convert to markdown-like structure.
 
         Fallback method when .md URL returns HTML content instead of markdown.
@@ -483,22 +464,14 @@ class DocToSkillConverter:
             Falls back to <body> if no semantic content container found.
             Language detection uses detect_language() method.
         """
-        page = {
-            'url': url,
-            'title': '',
-            'content': '',
-            'headings': [],
-            'code_samples': [],
-            'patterns': [],
-            'links': []
-        }
+        page = {"url": url, "title": "", "content": "", "headings": [], "code_samples": [], "patterns": [], "links": []}
 
-        soup = BeautifulSoup(html_content, 'html.parser')
+        soup = BeautifulSoup(html_content, "html.parser")
 
         # Try to extract title
-        title_elem = soup.select_one('title')
+        title_elem = soup.select_one("title")
         if title_elem:
-            page['title'] = self.clean_text(title_elem.get_text())
+            page["title"] = self.clean_text(title_elem.get_text())
 
         # Try to find main content area
         main = soup.select_one('main, article, [role="main"], .content')
@@ -507,32 +480,25 @@ class DocToSkillConverter:
 
         if main:
             # Extract headings
-            for h in main.find_all(['h1', 'h2', 'h3', 'h4', 'h5', 'h6']):
+            for h in main.find_all(["h1", "h2", "h3", "h4", "h5", "h6"]):
                 text = self.clean_text(h.get_text())
                 if text:
-                    page['headings'].append({
-                        'level': h.name,
-                        'text': text,
-                        'id': h.get('id', '')
-                    })
+                    page["headings"].append({"level": h.name, "text": text, "id": h.get("id", "")})
 
             # Extract code blocks
-            for code_elem in main.select('pre code, pre'):
+            for code_elem in main.select("pre code, pre"):
                 code = code_elem.get_text()
                 if len(code.strip()) > 10:
                     lang = self.detect_language(code_elem, code)
-                    page['code_samples'].append({
-                        'code': code.strip(),
-                        'language': lang
-                    })
+                    page["code_samples"].append({"code": code.strip(), "language": lang})
 
             # Extract paragraphs
             paragraphs = []
-            for p in main.find_all('p'):
+            for p in main.find_all("p"):
                 text = self.clean_text(p.get_text())
                 if text and len(text) > 20:
                     paragraphs.append(text)
-            page['content'] = '\n\n'.join(paragraphs)
+            page["content"] = "\n\n".join(paragraphs)
 
         return page
 
@@ -548,47 +514,46 @@ class DocToSkillConverter:
             logger.debug(f"Low confidence language detection: {lang} ({confidence:.2f})")
 
         return lang  # Return string for backward compatibility
-    
-    def extract_patterns(self, main: Any, code_samples: List[Dict[str, Any]]) -> List[Dict[str, str]]:
+
+    def extract_patterns(self, main: Any, code_samples: list[dict[str, Any]]) -> list[dict[str, str]]:
         """Extract common coding patterns (NEW FEATURE)"""
         patterns = []
-        
+
         # Look for "Example:" or "Pattern:" sections
-        for elem in main.find_all(['p', 'div']):
+        for elem in main.find_all(["p", "div"]):
             text = elem.get_text().lower()
-            if any(word in text for word in ['example:', 'pattern:', 'usage:', 'typical use']):
+            if any(word in text for word in ["example:", "pattern:", "usage:", "typical use"]):
                 # Get the code that follows
-                next_code = elem.find_next(['pre', 'code'])
+                next_code = elem.find_next(["pre", "code"])
                 if next_code:
-                    patterns.append({
-                        'description': self.clean_text(elem.get_text()),
-                        'code': next_code.get_text().strip()
-                    })
-        
+                    patterns.append(
+                        {"description": self.clean_text(elem.get_text()), "code": next_code.get_text().strip()}
+                    )
+
         return patterns[:5]  # Limit to 5 most relevant patterns
-    
+
     def clean_text(self, text: str) -> str:
         """Clean text content"""
-        text = re.sub(r'\s+', ' ', text)
+        text = re.sub(r"\s+", " ", text)
         return text.strip()
-    
-    def save_page(self, page: Dict[str, Any]) -> None:
+
+    def save_page(self, page: dict[str, Any]) -> None:
         """Save page data (skip pages with empty content)"""
         # Skip pages with empty or very short content
-        if not page.get('content') or len(page.get('content', '')) < 50:
-            logger.debug("Skipping page with empty/short content: %s", page.get('url', 'unknown'))
+        if not page.get("content") or len(page.get("content", "")) < 50:
+            logger.debug("Skipping page with empty/short content: %s", page.get("url", "unknown"))
             return
 
-        url_hash = hashlib.md5(page['url'].encode()).hexdigest()[:10]
-        safe_title = re.sub(r'[^\w\s-]', '', page['title'])[:50]
-        safe_title = re.sub(r'[-\s]+', '_', safe_title)
+        url_hash = hashlib.md5(page["url"].encode()).hexdigest()[:10]
+        safe_title = re.sub(r"[^\w\s-]", "", page["title"])[:50]
+        safe_title = re.sub(r"[-\s]+", "_", safe_title)
 
         filename = f"{safe_title}_{url_hash}.json"
         filepath = os.path.join(self.data_dir, "pages", filename)
 
-        with open(filepath, 'w', encoding='utf-8') as f:
+        with open(filepath, "w", encoding="utf-8") as f:
             json.dump(page, f, indent=2, ensure_ascii=False)
-    
+
     def scrape_page(self, url: str) -> None:
         """Scrape a single page with thread-safe operations.
 
@@ -604,15 +569,15 @@ class DocToSkillConverter:
         """
         try:
             # Scraping part (no lock needed - independent)
-            headers = {'User-Agent': 'Mozilla/5.0 (Documentation Scraper)'}
+            headers = {"User-Agent": "Mozilla/5.0 (Documentation Scraper)"}
             response = requests.get(url, headers=headers, timeout=30)
             response.raise_for_status()
 
             # Check if this is a Markdown file
-            if url.endswith('.md') or '.md' in url:
+            if url.endswith(".md") or ".md" in url:
                 page = self._extract_markdown_content(response.text, url)
             else:
-                soup = BeautifulSoup(response.content, 'html.parser')
+                soup = BeautifulSoup(response.content, "html.parser")
                 page = self.extract_content(soup, url)
 
             # Thread-safe operations (lock required)
@@ -623,7 +588,7 @@ class DocToSkillConverter:
                     self.pages.append(page)
 
                     # Add new URLs
-                    for link in page['links']:
+                    for link in page["links"]:
                         if link not in self.visited_urls and link not in self.pending_urls:
                             self.pending_urls.append(link)
             else:
@@ -633,12 +598,12 @@ class DocToSkillConverter:
                 self.pages.append(page)
 
                 # Add new URLs
-                for link in page['links']:
+                for link in page["links"]:
                     if link not in self.visited_urls and link not in self.pending_urls:
                         self.pending_urls.append(link)
 
             # Rate limiting
-            rate_limit = self.config.get('rate_limit', DEFAULT_RATE_LIMIT)
+            rate_limit = self.config.get("rate_limit", DEFAULT_RATE_LIMIT)
             if rate_limit > 0:
                 time.sleep(rate_limit)
 
@@ -665,16 +630,16 @@ class DocToSkillConverter:
         async with semaphore:  # Limit concurrent requests
             try:
                 # Async HTTP request
-                headers = {'User-Agent': 'Mozilla/5.0 (Documentation Scraper)'}
+                headers = {"User-Agent": "Mozilla/5.0 (Documentation Scraper)"}
                 response = await client.get(url, headers=headers, timeout=30.0)
                 response.raise_for_status()
 
                 # Check if this is a Markdown file
-                if url.endswith('.md') or '.md' in url:
+                if url.endswith(".md") or ".md" in url:
                     page = self._extract_markdown_content(response.text, url)
                 else:
                     # BeautifulSoup parsing (still synchronous, but fast)
-                    soup = BeautifulSoup(response.content, 'html.parser')
+                    soup = BeautifulSoup(response.content, "html.parser")
                     page = self.extract_content(soup, url)
 
                 # Async-safe operations (no lock needed - single event loop)
@@ -683,19 +648,19 @@ class DocToSkillConverter:
                 self.pages.append(page)
 
                 # Add new URLs
-                for link in page['links']:
+                for link in page["links"]:
                     if link not in self.visited_urls and link not in self.pending_urls:
                         self.pending_urls.append(link)
 
                 # Rate limiting
-                rate_limit = self.config.get('rate_limit', DEFAULT_RATE_LIMIT)
+                rate_limit = self.config.get("rate_limit", DEFAULT_RATE_LIMIT)
                 if rate_limit > 0:
                     await asyncio.sleep(rate_limit)
 
             except Exception as e:
                 logger.error("  ✗ Error scraping %s: %s: %s", url, type(e).__name__, e)
 
-    def _convert_to_md_urls(self, urls: List[str]) -> List[str]:
+    def _convert_to_md_urls(self, urls: list[str]) -> list[str]:
         """
         Convert URLs to .md format, trying /index.html.md suffix for non-.md URLs.
         不预先检查 URL 是否存在，直接加入队列，在爬取时再验证。
@@ -709,11 +674,11 @@ class DocToSkillConverter:
         md_urls = []
 
         for url in urls:
-            if '.md' in url:
+            if ".md" in url:
                 md_urls.append(url)
             else:
                 # 直接转换为 .md 格式，不发送 HEAD 请求检查
-                url = url.rstrip('/')
+                url = url.rstrip("/")
                 md_url = f"{url}/index.html.md"
                 md_urls.append(md_url)
 
@@ -756,7 +721,7 @@ class DocToSkillConverter:
         logger.info("\n🔍 Checking for llms.txt at %s...", self.base_url)
 
         # Check for explicit config URL first
-        explicit_url = self.config.get('llms_txt_url')
+        explicit_url = self.config.get("llms_txt_url")
         if explicit_url:
             logger.info("\n📌 Using explicit llms_txt_url from config: %s", explicit_url)
 
@@ -770,7 +735,7 @@ class DocToSkillConverter:
                 filepath = os.path.join(self.skill_dir, "references", filename)
                 os.makedirs(os.path.dirname(filepath), exist_ok=True)
 
-                with open(filepath, 'w', encoding='utf-8') as f:
+                with open(filepath, "w", encoding="utf-8") as f:
                     f.write(content)
                 logger.info("  💾 Saved %s (%d chars)", filename, len(content))
 
@@ -781,8 +746,8 @@ class DocToSkillConverter:
                 if variants:
                     logger.info("\n🔍 Found %d total variant(s), downloading remaining...", len(variants))
                     for variant_info in variants:
-                        url = variant_info['url']
-                        variant = variant_info['variant']
+                        url = variant_info["url"]
+                        variant = variant_info["variant"]
 
                         # Skip the explicit one we already downloaded
                         if url == explicit_url:
@@ -795,7 +760,7 @@ class DocToSkillConverter:
                         if extra_content:
                             extra_filename = extra_downloader.get_proper_filename()
                             extra_filepath = os.path.join(self.skill_dir, "references", extra_filename)
-                            with open(extra_filepath, 'w', encoding='utf-8') as f:
+                            with open(extra_filepath, "w", encoding="utf-8") as f:
                                 f.write(extra_content)
                             logger.info("     ✓ %s (%d chars)", extra_filename, len(extra_content))
 
@@ -807,8 +772,11 @@ class DocToSkillConverter:
                 if extracted_urls:
                     # Convert non-.md URLs to .md format by trying /index.html.md suffix
                     md_urls = self._convert_to_md_urls(extracted_urls)
-                    logger.info("\n🔗 Found %d URLs in llms.txt (%d .md files), starting BFS crawl...",
-                               len(extracted_urls), len(md_urls))
+                    logger.info(
+                        "\n🔗 Found %d URLs in llms.txt (%d .md files), starting BFS crawl...",
+                        len(extracted_urls),
+                        len(md_urls),
+                    )
 
                     # Filter URLs based on url_patterns config
                     for url in md_urls:
@@ -819,7 +787,7 @@ class DocToSkillConverter:
 
                     # Return False to trigger HTML scraping with the populated pending_urls
                     self.llms_txt_detected = True
-                    self.llms_txt_variant = 'explicit'
+                    self.llms_txt_variant = "explicit"
                     return False  # Continue with BFS crawling
 
                 # Fallback: if no URLs found, use section-based parsing
@@ -831,7 +799,7 @@ class DocToSkillConverter:
                         self.pages.append(page)
 
                     self.llms_txt_detected = True
-                    self.llms_txt_variant = 'explicit'
+                    self.llms_txt_variant = "explicit"
                     return True
 
         # Auto-detection: Find ALL variants
@@ -847,8 +815,8 @@ class DocToSkillConverter:
         # Download ALL variants
         downloaded = {}
         for variant_info in variants:
-            url = variant_info['url']
-            variant = variant_info['variant']
+            url = variant_info["url"]
+            variant = variant_info["variant"]
 
             logger.info("  📥 Downloading %s...", variant)
             downloader = LlmsTxtDownloader(url)
@@ -856,11 +824,7 @@ class DocToSkillConverter:
 
             if content:
                 filename = downloader.get_proper_filename()
-                downloaded[variant] = {
-                    'content': content,
-                    'filename': filename,
-                    'size': len(content)
-                }
+                downloaded[variant] = {"content": content, "filename": filename, "size": len(content)}
                 logger.info("     ✓ %s (%d chars)", filename, len(content))
 
         if not downloaded:
@@ -871,24 +835,27 @@ class DocToSkillConverter:
         os.makedirs(os.path.join(self.skill_dir, "references"), exist_ok=True)
 
         for variant, data in downloaded.items():
-            filepath = os.path.join(self.skill_dir, "references", data['filename'])
-            with open(filepath, 'w', encoding='utf-8') as f:
-                f.write(data['content'])
-            logger.info("  💾 Saved %s", data['filename'])
+            filepath = os.path.join(self.skill_dir, "references", data["filename"])
+            with open(filepath, "w", encoding="utf-8") as f:
+                f.write(data["content"])
+            logger.info("  💾 Saved %s", data["filename"])
 
         # Parse LARGEST variant for skill building
-        largest = max(downloaded.items(), key=lambda x: x[1]['size'])
-        logger.info("\n📄 Parsing %s for skill building...", largest[1]['filename'])
+        largest = max(downloaded.items(), key=lambda x: x[1]["size"])
+        logger.info("\n📄 Parsing %s for skill building...", largest[1]["filename"])
 
-        parser = LlmsTxtParser(largest[1]['content'], self.base_url)
+        parser = LlmsTxtParser(largest[1]["content"], self.base_url)
 
         # Extract URLs from llms.txt and add to pending_urls for BFS crawling
         extracted_urls = parser.extract_urls()
         if extracted_urls:
             # Convert non-.md URLs to .md format by trying /index.html.md suffix
             md_urls = self._convert_to_md_urls(extracted_urls)
-            logger.info("\n🔗 Found %d URLs in llms.txt (%d .md files), starting BFS crawl...",
-                       len(extracted_urls), len(md_urls))
+            logger.info(
+                "\n🔗 Found %d URLs in llms.txt (%d .md files), starting BFS crawl...",
+                len(extracted_urls),
+                len(md_urls),
+            )
 
             # Filter URLs based on url_patterns config
             for url in md_urls:
@@ -956,7 +923,7 @@ class DocToSkillConverter:
                 logger.info("Workers: %d parallel threads", self.workers)
             logger.info("")
 
-        max_pages = self.config.get('max_pages', DEFAULT_MAX_PAGES)
+        max_pages = self.config.get("max_pages", DEFAULT_MAX_PAGES)
 
         # Handle unlimited mode
         if max_pages is None or max_pages == -1:
@@ -982,16 +949,16 @@ class DocToSkillConverter:
                     # Just show what would be scraped
                     logger.info("  [Preview] %s", url)
                     try:
-                        headers = {'User-Agent': 'Mozilla/5.0 (Documentation Scraper - Dry Run)'}
+                        headers = {"User-Agent": "Mozilla/5.0 (Documentation Scraper - Dry Run)"}
                         response = requests.get(url, headers=headers, timeout=10)
-                        soup = BeautifulSoup(response.content, 'html.parser')
+                        soup = BeautifulSoup(response.content, "html.parser")
 
-                        main_selector = self.config.get('selectors', {}).get('main_content', 'div[role="main"]')
+                        main_selector = self.config.get("selectors", {}).get("main_content", 'div[role="main"]')
                         main = soup.select_one(main_selector)
 
                         if main:
-                            for link in main.find_all('a', href=True):
-                                href = urljoin(url, link['href'])
+                            for link in main.find_all("a", href=True):
+                                href = urljoin(url, link["href"])
                                 if self.is_valid_url(href) and href not in self.visited_urls:
                                     self.pending_urls.append(href)
                     except Exception as e:
@@ -1115,13 +1082,13 @@ class DocToSkillConverter:
             logger.info("Workers: %d concurrent tasks (async)", self.workers)
             logger.info("")
 
-        max_pages = self.config.get('max_pages', DEFAULT_MAX_PAGES)
+        max_pages = self.config.get("max_pages", DEFAULT_MAX_PAGES)
 
         # Handle unlimited mode
         if max_pages is None or max_pages == -1:
             logger.warning("⚠️  UNLIMITED MODE: No page limit (will scrape all pages)\n")
             unlimited = True
-            preview_limit = float('inf')
+            preview_limit = float("inf")
         else:
             unlimited = False
             preview_limit = 20 if self.dry_run else max_pages
@@ -1130,10 +1097,7 @@ class DocToSkillConverter:
         semaphore = asyncio.Semaphore(self.workers)
 
         # Create shared HTTP client with connection pooling
-        async with httpx.AsyncClient(
-            timeout=30.0,
-            limits=httpx.Limits(max_connections=self.workers * 2)
-        ) as client:
+        async with httpx.AsyncClient(timeout=30.0, limits=httpx.Limits(max_connections=self.workers * 2)) as client:
             tasks = []
 
             while self.pending_urls and (unlimited or len(self.visited_urls) < preview_limit):
@@ -1156,9 +1120,7 @@ class DocToSkillConverter:
                         if self.dry_run:
                             logger.info("  [Preview] %s", url)
                         else:
-                            task = asyncio.create_task(
-                                self.scrape_page_async(url, semaphore, client)
-                            )
+                            task = asyncio.create_task(self.scrape_page_async(url, semaphore, client))
                             tasks.append(task)
 
                 # Wait for batch to complete before continuing
@@ -1192,53 +1154,53 @@ class DocToSkillConverter:
     def save_summary(self) -> None:
         """Save scraping summary"""
         summary = {
-            'name': self.name,
-            'total_pages': len(self.pages),
-            'base_url': self.base_url,
-            'llms_txt_detected': self.llms_txt_detected,
-            'llms_txt_variant': self.llms_txt_variant,
-            'pages': [{'title': p['title'], 'url': p['url']} for p in self.pages]
+            "name": self.name,
+            "total_pages": len(self.pages),
+            "base_url": self.base_url,
+            "llms_txt_detected": self.llms_txt_detected,
+            "llms_txt_variant": self.llms_txt_variant,
+            "pages": [{"title": p["title"], "url": p["url"]} for p in self.pages],
         }
 
-        with open(f"{self.data_dir}/summary.json", 'w', encoding='utf-8') as f:
+        with open(f"{self.data_dir}/summary.json", "w", encoding="utf-8") as f:
             json.dump(summary, f, indent=2, ensure_ascii=False)
-    
-    def load_scraped_data(self) -> List[Dict[str, Any]]:
+
+    def load_scraped_data(self) -> list[dict[str, Any]]:
         """Load previously scraped data"""
         pages = []
         pages_dir = Path(self.data_dir) / "pages"
-        
+
         if not pages_dir.exists():
             return []
-        
+
         for json_file in pages_dir.glob("*.json"):
             try:
-                with open(json_file, 'r', encoding='utf-8') as f:
+                with open(json_file, encoding="utf-8") as f:
                     pages.append(json.load(f))
             except Exception as e:
                 logger.error("⚠️  Error loading scraped data file %s: %s: %s", json_file, type(e).__name__, e)
                 logger.error("   Suggestion: File may be corrupted, consider re-scraping with --fresh")
-        
+
         return pages
-    
-    def smart_categorize(self, pages: List[Dict[str, Any]]) -> Dict[str, List[Dict[str, Any]]]:
+
+    def smart_categorize(self, pages: list[dict[str, Any]]) -> dict[str, list[dict[str, Any]]]:
         """Improved categorization with better pattern matching"""
-        category_defs = self.config.get('categories', {})
-        
+        category_defs = self.config.get("categories", {})
+
         # Default smart categories if none provided
         if not category_defs:
             category_defs = self.infer_categories(pages)
 
-        categories: Dict[str, List[Dict[str, Any]]] = {cat: [] for cat in category_defs.keys()}
-        categories['other'] = []
-        
+        categories: dict[str, list[dict[str, Any]]] = {cat: [] for cat in category_defs.keys()}
+        categories["other"] = []
+
         for page in pages:
-            url = page['url'].lower()
-            title = page['title'].lower()
-            content = page.get('content', '').lower()[:CONTENT_PREVIEW_LENGTH]  # Check first N chars for categorization
-            
+            url = page["url"].lower()
+            title = page["title"].lower()
+            content = page.get("content", "").lower()[:CONTENT_PREVIEW_LENGTH]  # Check first N chars for categorization
+
             categorized = False
-            
+
             # Match against keywords
             for cat, keywords in category_defs.items():
                 score = 0
@@ -1250,138 +1212,140 @@ class DocToSkillConverter:
                         score += 2
                     if keyword in content:
                         score += 1
-                
+
                 if score >= MIN_CATEGORIZATION_SCORE:  # Threshold for categorization
                     categories[cat].append(page)
                     categorized = True
                     break
-            
+
             if not categorized:
-                categories['other'].append(page)
-        
+                categories["other"].append(page)
+
         # Remove empty categories
         categories = {k: v for k, v in categories.items() if v}
-        
+
         return categories
-    
-    def infer_categories(self, pages: List[Dict[str, Any]]) -> Dict[str, List[str]]:
+
+    def infer_categories(self, pages: list[dict[str, Any]]) -> dict[str, list[str]]:
         """Infer categories from URL patterns (IMPROVED)"""
         url_segments: defaultdict[str, int] = defaultdict(int)
-        
+
         for page in pages:
-            path = urlparse(page['url']).path
-            segments = [s for s in path.split('/') if s and s not in ['en', 'stable', 'latest', 'docs']]
-            
+            path = urlparse(page["url"]).path
+            segments = [s for s in path.split("/") if s and s not in ["en", "stable", "latest", "docs"]]
+
             for seg in segments:
                 url_segments[seg] += 1
-        
+
         # Top segments become categories
         top_segments = sorted(url_segments.items(), key=lambda x: x[1], reverse=True)[:8]
-        
+
         categories = {}
         for seg, count in top_segments:
             if count >= 3:  # At least 3 pages
                 categories[seg] = [seg]
-        
+
         # Add common defaults
-        if 'tutorial' not in categories and any('tutorial' in url for url in [p['url'] for p in pages]):
-            categories['tutorials'] = ['tutorial', 'guide', 'getting-started']
-        
-        if 'api' not in categories and any('api' in url or 'reference' in url for url in [p['url'] for p in pages]):
-            categories['api'] = ['api', 'reference', 'class']
-        
+        if "tutorial" not in categories and any("tutorial" in url for url in [p["url"] for p in pages]):
+            categories["tutorials"] = ["tutorial", "guide", "getting-started"]
+
+        if "api" not in categories and any("api" in url or "reference" in url for url in [p["url"] for p in pages]):
+            categories["api"] = ["api", "reference", "class"]
+
         return categories
-    
-    def generate_quick_reference(self, pages: List[Dict[str, Any]]) -> List[Dict[str, str]]:
+
+    def generate_quick_reference(self, pages: list[dict[str, Any]]) -> list[dict[str, str]]:
         """Generate quick reference from common patterns (NEW FEATURE)"""
         quick_ref = []
-        
+
         # Collect all patterns
         all_patterns = []
         for page in pages:
-            all_patterns.extend(page.get('patterns', []))
-        
+            all_patterns.extend(page.get("patterns", []))
+
         # Get most common code patterns
         seen_codes = set()
         for pattern in all_patterns:
-            code = pattern['code']
+            code = pattern["code"]
             if code not in seen_codes and len(code) < 300:
                 quick_ref.append(pattern)
                 seen_codes.add(code)
                 if len(quick_ref) >= 15:
                     break
-        
+
         return quick_ref
-    
-    def create_reference_file(self, category: str, pages: List[Dict[str, Any]]) -> None:
+
+    def create_reference_file(self, category: str, pages: list[dict[str, Any]]) -> None:
         """Create enhanced reference file"""
         if not pages:
             return
-        
+
         lines = []
         lines.append(f"# {self.name.title()} - {category.replace('_', ' ').title()}\n")
         lines.append(f"**Pages:** {len(pages)}\n")
         lines.append("---\n")
-        
+
         for page in pages:
             lines.append(f"## {page['title']}\n")
             lines.append(f"**URL:** {page['url']}\n")
-            
+
             # Table of contents from headings
-            if page.get('headings'):
+            if page.get("headings"):
                 lines.append("**Contents:**")
-                for h in page['headings'][:10]:
-                    level = int(h['level'][1]) if len(h['level']) > 1 else 1
+                for h in page["headings"][:10]:
+                    level = int(h["level"][1]) if len(h["level"]) > 1 else 1
                     indent = "  " * max(0, level - 2)
                     lines.append(f"{indent}- {h['text']}")
                 lines.append("")
-            
+
             # Content (NO TRUNCATION)
-            if page.get('content'):
-                lines.append(page['content'])
+            if page.get("content"):
+                lines.append(page["content"])
                 lines.append("")
 
             # Code examples with language (NO TRUNCATION)
-            if page.get('code_samples'):
+            if page.get("code_samples"):
                 lines.append("**Examples:**\n")
-                for i, sample in enumerate(page['code_samples'][:4], 1):
-                    lang = sample.get('language', 'unknown')
-                    code = sample.get('code', sample if isinstance(sample, str) else '')
+                for i, sample in enumerate(page["code_samples"][:4], 1):
+                    lang = sample.get("language", "unknown")
+                    code = sample.get("code", sample if isinstance(sample, str) else "")
                     lines.append(f"Example {i} ({lang}):")
                     lines.append(f"```{lang}")
                     lines.append(code)  # Full code, no truncation
                     lines.append("```\n")
-            
+
             lines.append("---\n")
-        
+
         filepath = os.path.join(self.skill_dir, "references", f"{category}.md")
-        with open(filepath, 'w', encoding='utf-8') as f:
-            f.write('\n'.join(lines))
+        with open(filepath, "w", encoding="utf-8") as f:
+            f.write("\n".join(lines))
 
         logger.info("  ✓ %s.md (%d pages)", category, len(pages))
-    
-    def create_enhanced_skill_md(self, categories: Dict[str, List[Dict[str, Any]]], quick_ref: List[Dict[str, str]]) -> None:
+
+    def create_enhanced_skill_md(
+        self, categories: dict[str, list[dict[str, Any]]], quick_ref: list[dict[str, str]]
+    ) -> None:
         """Create SKILL.md with actual examples (IMPROVED)"""
         # Try to infer description if not in config
-        if 'description' not in self.config:
+        if "description" not in self.config:
             # Get first page HTML content to infer description
             first_page_html = None
             for pages in categories.values():
                 if pages:
-                    first_page_html = pages[0].get('raw_html', '')
+                    first_page_html = pages[0].get("raw_html", "")
                     break
             description = infer_description_from_docs(self.base_url, first_page_html, self.name)
         else:
-            description = self.config['description']
-        
+            description = self.config["description"]
+
         # Extract actual code examples from docs
         example_codes = []
         for pages in categories.values():
             for page in pages[:3]:  # First 3 pages per category
-                for sample in page.get('code_samples', [])[:2]:  # First 2 samples per page
-                    code = sample.get('code', sample if isinstance(sample, str) else '')
-                    lang = sample.get('language', 'unknown')
-                    if len(code) < 200 and lang != 'unknown':
+                for sample in page.get("code_samples", [])[:2]:  # First 2 samples per page
+                    code = sample.get("code", sample if isinstance(sample, str) else "")
+                    lang = sample.get("language", "unknown")
+                    if len(code) < 200 and lang != "unknown":
                         example_codes.append((lang, code))
                     if len(example_codes) >= 10:
                         break
@@ -1389,7 +1353,7 @@ class DocToSkillConverter:
                     break
             if len(example_codes) >= 10:
                 break
-        
+
         content = f"""---
 name: {self.name}
 description: {description}
@@ -1413,38 +1377,38 @@ This skill should be triggered when:
 ### Common Patterns
 
 """
-        
+
         # Add actual quick reference patterns
         if quick_ref:
             for i, pattern in enumerate(quick_ref[:8], 1):
-                desc = pattern.get('description', 'Example pattern')
+                desc = pattern.get("description", "Example pattern")
                 # Format description: extract first sentence, truncate if too long
-                first_sentence = desc.split('.')[0] if '.' in desc else desc
+                first_sentence = desc.split(".")[0] if "." in desc else desc
                 if len(first_sentence) > 150:
-                    first_sentence = first_sentence[:147] + '...'
+                    first_sentence = first_sentence[:147] + "..."
 
                 content += f"**Pattern {i}:** {first_sentence}\n\n"
                 content += "```\n"
-                content += pattern.get('code', '')[:300]
+                content += pattern.get("code", "")[:300]
                 content += "\n```\n\n"
         else:
             content += "*Quick reference patterns will be added as you use the skill.*\n\n"
-        
+
         # Add example codes from docs
         if example_codes:
             content += "### Example Code Patterns\n\n"
             for i, (lang, code) in enumerate(example_codes[:5], 1):
                 content += f"**Example {i}** ({lang}):\n```{lang}\n{code}\n```\n\n"
-        
-        content += f"""## Reference Files
+
+        content += """## Reference Files
 
 This skill includes comprehensive documentation in `references/`:
 
 """
-        
+
         for cat in sorted(categories.keys()):
             content += f"- **{cat}.md** - {cat.replace('_', ' ').title()} documentation\n"
-        
+
         content += """
 Use `view` to read specific reference files when detailed information is needed.
 
@@ -1487,30 +1451,30 @@ To refresh this skill with updated documentation:
 1. Re-run the scraper with the same configuration
 2. The skill will be rebuilt with the latest information
 """
-        
+
         filepath = os.path.join(self.skill_dir, "SKILL.md")
-        with open(filepath, 'w', encoding='utf-8') as f:
+        with open(filepath, "w", encoding="utf-8") as f:
             f.write(content)
 
         logger.info("  ✓ SKILL.md (enhanced with %d examples)", len(example_codes))
-    
-    def create_index(self, categories: Dict[str, List[Dict[str, Any]]]) -> None:
+
+    def create_index(self, categories: dict[str, list[dict[str, Any]]]) -> None:
         """Create navigation index"""
         lines = []
         lines.append(f"# {self.name.title()} Documentation Index\n")
         lines.append("## Categories\n")
-        
+
         for cat, pages in sorted(categories.items()):
             lines.append(f"### {cat.replace('_', ' ').title()}")
             lines.append(f"**File:** `{cat}.md`")
             lines.append(f"**Pages:** {len(pages)}\n")
-        
+
         filepath = os.path.join(self.skill_dir, "references", "index.md")
-        with open(filepath, 'w', encoding='utf-8') as f:
-            f.write('\n'.join(lines))
+        with open(filepath, "w", encoding="utf-8") as f:
+            f.write("\n".join(lines))
 
         logger.info("  ✓ index.md")
-    
+
     def build_skill(self) -> bool:
         """Build the skill from scraped data.
 
@@ -1561,7 +1525,7 @@ To refresh this skill with updated documentation:
         return True
 
 
-def validate_config(config: Dict[str, Any]) -> Tuple[List[str], List[str]]:
+def validate_config(config: dict[str, Any]) -> tuple[list[str], list[str]]:
     """Validate configuration structure and values.
 
     Args:
@@ -1579,56 +1543,56 @@ def validate_config(config: Dict[str, Any]) -> Tuple[List[str], List[str]]:
     warnings = []
 
     # Required fields
-    required_fields = ['name', 'base_url']
+    required_fields = ["name", "base_url"]
     for field in required_fields:
         if field not in config:
             errors.append(f"Missing required field: '{field}'")
 
     # Validate name (alphanumeric, hyphens, underscores only)
-    if 'name' in config:
-        if not re.match(r'^[a-zA-Z0-9_-]+$', config['name']):
+    if "name" in config:
+        if not re.match(r"^[a-zA-Z0-9_-]+$", config["name"]):
             errors.append(f"Invalid name: '{config['name']}' (use only letters, numbers, hyphens, underscores)")
 
     # Validate base_url
-    if 'base_url' in config:
-        if not config['base_url'].startswith(('http://', 'https://')):
+    if "base_url" in config:
+        if not config["base_url"].startswith(("http://", "https://")):
             errors.append(f"Invalid base_url: '{config['base_url']}' (must start with http:// or https://)")
 
     # Validate selectors structure
-    if 'selectors' in config:
-        if not isinstance(config['selectors'], dict):
+    if "selectors" in config:
+        if not isinstance(config["selectors"], dict):
             errors.append("'selectors' must be a dictionary")
         else:
-            recommended_selectors = ['main_content', 'title', 'code_blocks']
+            recommended_selectors = ["main_content", "title", "code_blocks"]
             for selector in recommended_selectors:
-                if selector not in config['selectors']:
+                if selector not in config["selectors"]:
                     warnings.append(f"Missing recommended selector: '{selector}'")
     else:
         warnings.append("Missing 'selectors' section (recommended)")
 
     # Validate url_patterns
-    if 'url_patterns' in config:
-        if not isinstance(config['url_patterns'], dict):
+    if "url_patterns" in config:
+        if not isinstance(config["url_patterns"], dict):
             errors.append("'url_patterns' must be a dictionary")
         else:
-            for key in ['include', 'exclude']:
-                if key in config['url_patterns']:
-                    if not isinstance(config['url_patterns'][key], list):
+            for key in ["include", "exclude"]:
+                if key in config["url_patterns"]:
+                    if not isinstance(config["url_patterns"][key], list):
                         errors.append(f"'url_patterns.{key}' must be a list")
 
     # Validate categories
-    if 'categories' in config:
-        if not isinstance(config['categories'], dict):
+    if "categories" in config:
+        if not isinstance(config["categories"], dict):
             errors.append("'categories' must be a dictionary")
         else:
-            for cat_name, keywords in config['categories'].items():
+            for cat_name, keywords in config["categories"].items():
                 if not isinstance(keywords, list):
                     errors.append(f"'categories.{cat_name}' must be a list of keywords")
 
     # Validate rate_limit
-    if 'rate_limit' in config:
+    if "rate_limit" in config:
         try:
-            rate = float(config['rate_limit'])
+            rate = float(config["rate_limit"])
             if rate < 0:
                 errors.append(f"'rate_limit' must be non-negative (got {rate})")
             elif rate > 10:
@@ -1637,8 +1601,8 @@ def validate_config(config: Dict[str, Any]) -> Tuple[List[str], List[str]]:
             errors.append(f"'rate_limit' must be a number (got {config['rate_limit']})")
 
     # Validate max_pages
-    if 'max_pages' in config:
-        max_p_value = config['max_pages']
+    if "max_pages" in config:
+        max_p_value = config["max_pages"]
 
         # Allow None for unlimited
         if max_p_value is None:
@@ -1657,18 +1621,18 @@ def validate_config(config: Dict[str, Any]) -> Tuple[List[str], List[str]]:
                 errors.append(f"'max_pages' must be an integer, -1, or null (got {config['max_pages']})")
 
     # Validate start_urls if present
-    if 'start_urls' in config:
-        if not isinstance(config['start_urls'], list):
+    if "start_urls" in config:
+        if not isinstance(config["start_urls"], list):
             errors.append("'start_urls' must be a list")
         else:
-            for url in config['start_urls']:
-                if not url.startswith(('http://', 'https://')):
+            for url in config["start_urls"]:
+                if not url.startswith(("http://", "https://")):
                     errors.append(f"Invalid start_url: '{url}' (must start with http:// or https://)")
 
     return errors, warnings
 
 
-def load_config(config_path: str) -> Dict[str, Any]:
+def load_config(config_path: str) -> dict[str, Any]:
     """Load and validate configuration from JSON file.
 
     Args:
@@ -1686,7 +1650,7 @@ def load_config(config_path: str) -> Dict[str, Any]:
         'react'
     """
     try:
-        with open(config_path, 'r', encoding='utf-8') as f:
+        with open(config_path, encoding="utf-8") as f:
             config = json.load(f)
     except json.JSONDecodeError as e:
         logger.error("❌ Error: Invalid JSON in config file: %s", config_path)
@@ -1720,7 +1684,7 @@ def load_config(config_path: str) -> Dict[str, Any]:
     return config
 
 
-def interactive_config() -> Dict[str, Any]:
+def interactive_config() -> dict[str, Any]:
     """Interactive configuration wizard for creating new configs.
 
     Prompts user for all required configuration fields step-by-step
@@ -1735,48 +1699,48 @@ def interactive_config() -> Dict[str, Any]:
         >>> config['name']
         'react'
     """
-    logger.info("\n" + "="*60)
+    logger.info("\n" + "=" * 60)
     logger.info("Documentation to Skill Converter")
-    logger.info("="*60 + "\n")
+    logger.info("=" * 60 + "\n")
+
+    config: dict[str, Any] = {}
 
-    config: Dict[str, Any] = {}
-    
     # Basic info
-    config['name'] = input("Skill name (e.g., 'react', 'godot'): ").strip()
-    config['description'] = input("Skill description: ").strip()
-    config['base_url'] = input("Base URL (e.g., https://docs.example.com/): ").strip()
-    
-    if not config['base_url'].endswith('/'):
-        config['base_url'] += '/'
-    
+    config["name"] = input("Skill name (e.g., 'react', 'godot'): ").strip()
+    config["description"] = input("Skill description: ").strip()
+    config["base_url"] = input("Base URL (e.g., https://docs.example.com/): ").strip()
+
+    if not config["base_url"].endswith("/"):
+        config["base_url"] += "/"
+
     # Selectors
     logger.info("\nCSS Selectors (press Enter for defaults):")
     selectors = {}
-    selectors['main_content'] = input("  Main content [div[role='main']]: ").strip() or "div[role='main']"
-    selectors['title'] = input("  Title [title]: ").strip() or "title"
-    selectors['code_blocks'] = input("  Code blocks [pre code]: ").strip() or "pre code"
-    config['selectors'] = selectors
-    
+    selectors["main_content"] = input("  Main content [div[role='main']]: ").strip() or "div[role='main']"
+    selectors["title"] = input("  Title [title]: ").strip() or "title"
+    selectors["code_blocks"] = input("  Code blocks [pre code]: ").strip() or "pre code"
+    config["selectors"] = selectors
+
     # URL patterns
     logger.info("\nURL Patterns (comma-separated, optional):")
     include = input("  Include: ").strip()
     exclude = input("  Exclude: ").strip()
-    config['url_patterns'] = {
-        'include': [p.strip() for p in include.split(',') if p.strip()],
-        'exclude': [p.strip() for p in exclude.split(',') if p.strip()]
+    config["url_patterns"] = {
+        "include": [p.strip() for p in include.split(",") if p.strip()],
+        "exclude": [p.strip() for p in exclude.split(",") if p.strip()],
     }
-    
+
     # Settings
     rate = input(f"\nRate limit (seconds) [{DEFAULT_RATE_LIMIT}]: ").strip()
-    config['rate_limit'] = float(rate) if rate else DEFAULT_RATE_LIMIT
+    config["rate_limit"] = float(rate) if rate else DEFAULT_RATE_LIMIT
 
     max_p = input(f"Max pages [{DEFAULT_MAX_PAGES}]: ").strip()
-    config['max_pages'] = int(max_p) if max_p else DEFAULT_MAX_PAGES
-    
+    config["max_pages"] = int(max_p) if max_p else DEFAULT_MAX_PAGES
+
     return config
 
 
-def check_existing_data(name: str) -> Tuple[bool, int]:
+def check_existing_data(name: str) -> tuple[bool, int]:
     """Check if scraped data already exists for a skill.
 
     Args:
@@ -1792,9 +1756,9 @@ def check_existing_data(name: str) -> Tuple[bool, int]:
     """
     data_dir = f"output/{name}_data"
     if os.path.exists(data_dir) and os.path.exists(f"{data_dir}/summary.json"):
-        with open(f"{data_dir}/summary.json", 'r', encoding='utf-8') as f:
+        with open(f"{data_dir}/summary.json", encoding="utf-8") as f:
             summary = json.load(f)
-        return True, summary.get('total_pages', 0)
+        return True, summary.get("total_pages", 0)
     return False, 0
 
 
@@ -1814,53 +1778,63 @@ def setup_argument_parser() -> argparse.ArgumentParser:
         configs/react.json
     """
     parser = argparse.ArgumentParser(
-        description='Convert documentation websites to Claude skills',
-        formatter_class=argparse.RawDescriptionHelpFormatter
+        description="Convert documentation websites to Claude skills",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
     )
 
-    parser.add_argument('--interactive', '-i', action='store_true',
-                       help='Interactive configuration mode')
-    parser.add_argument('--config', '-c', type=str,
-                       help='Load configuration from file (e.g., configs/godot.json)')
-    parser.add_argument('--name', type=str,
-                       help='Skill name')
-    parser.add_argument('--url', type=str,
-                       help='Base documentation URL')
-    parser.add_argument('--description', '-d', type=str,
-                       help='Skill description')
-    parser.add_argument('--skip-scrape', action='store_true',
-                       help='Skip scraping, use existing data')
-    parser.add_argument('--dry-run', action='store_true',
-                       help='Preview what will be scraped without actually scraping')
-    parser.add_argument('--enhance', action='store_true',
-                       help='Enhance SKILL.md using Claude API after building (requires API key)')
-    parser.add_argument('--enhance-local', action='store_true',
-                       help='Enhance SKILL.md using Claude Code (no API key needed, runs in background)')
-    parser.add_argument('--interactive-enhancement', action='store_true',
-                       help='Open terminal window for enhancement (use with --enhance-local)')
-    parser.add_argument('--api-key', type=str,
-                       help='Anthropic API key for --enhance (or set ANTHROPIC_API_KEY)')
-    parser.add_argument('--resume', action='store_true',
-                       help='Resume from last checkpoint (for interrupted scrapes)')
-    parser.add_argument('--fresh', action='store_true',
-                       help='Clear checkpoint and start fresh')
-    parser.add_argument('--rate-limit', '-r', type=float, metavar='SECONDS',
-                       help=f'Override rate limit in seconds (default: from config or {DEFAULT_RATE_LIMIT}). Use 0 for no delay.')
-    parser.add_argument('--workers', '-w', type=int, metavar='N',
-                       help='Number of parallel workers for faster scraping (default: 1, max: 10)')
-    parser.add_argument('--async', dest='async_mode', action='store_true',
-                       help='Enable async mode for better parallel performance (2-3x faster than threads)')
-    parser.add_argument('--no-rate-limit', action='store_true',
-                       help='Disable rate limiting completely (same as --rate-limit 0)')
-    parser.add_argument('--verbose', '-v', action='store_true',
-                       help='Enable verbose output (DEBUG level logging)')
-    parser.add_argument('--quiet', '-q', action='store_true',
-                       help='Minimize output (WARNING level logging only)')
+    parser.add_argument("--interactive", "-i", action="store_true", help="Interactive configuration mode")
+    parser.add_argument("--config", "-c", type=str, help="Load configuration from file (e.g., configs/godot.json)")
+    parser.add_argument("--name", type=str, help="Skill name")
+    parser.add_argument("--url", type=str, help="Base documentation URL")
+    parser.add_argument("--description", "-d", type=str, help="Skill description")
+    parser.add_argument("--skip-scrape", action="store_true", help="Skip scraping, use existing data")
+    parser.add_argument("--dry-run", action="store_true", help="Preview what will be scraped without actually scraping")
+    parser.add_argument(
+        "--enhance", action="store_true", help="Enhance SKILL.md using Claude API after building (requires API key)"
+    )
+    parser.add_argument(
+        "--enhance-local",
+        action="store_true",
+        help="Enhance SKILL.md using Claude Code (no API key needed, runs in background)",
+    )
+    parser.add_argument(
+        "--interactive-enhancement",
+        action="store_true",
+        help="Open terminal window for enhancement (use with --enhance-local)",
+    )
+    parser.add_argument("--api-key", type=str, help="Anthropic API key for --enhance (or set ANTHROPIC_API_KEY)")
+    parser.add_argument("--resume", action="store_true", help="Resume from last checkpoint (for interrupted scrapes)")
+    parser.add_argument("--fresh", action="store_true", help="Clear checkpoint and start fresh")
+    parser.add_argument(
+        "--rate-limit",
+        "-r",
+        type=float,
+        metavar="SECONDS",
+        help=f"Override rate limit in seconds (default: from config or {DEFAULT_RATE_LIMIT}). Use 0 for no delay.",
+    )
+    parser.add_argument(
+        "--workers",
+        "-w",
+        type=int,
+        metavar="N",
+        help="Number of parallel workers for faster scraping (default: 1, max: 10)",
+    )
+    parser.add_argument(
+        "--async",
+        dest="async_mode",
+        action="store_true",
+        help="Enable async mode for better parallel performance (2-3x faster than threads)",
+    )
+    parser.add_argument(
+        "--no-rate-limit", action="store_true", help="Disable rate limiting completely (same as --rate-limit 0)"
+    )
+    parser.add_argument("--verbose", "-v", action="store_true", help="Enable verbose output (DEBUG level logging)")
+    parser.add_argument("--quiet", "-q", action="store_true", help="Minimize output (WARNING level logging only)")
 
     return parser
 
 
-def get_configuration(args: argparse.Namespace) -> Dict[str, Any]:
+def get_configuration(args: argparse.Namespace) -> dict[str, Any]:
     """Load or create configuration from command-line arguments.
 
     Handles three configuration modes:
@@ -1889,25 +1863,21 @@ def get_configuration(args: argparse.Namespace) -> Dict[str, Any]:
         config = interactive_config()
     else:
         config = {
-            'name': args.name,
-            'description': args.description or f'Use when working with {args.name}',
-            'base_url': args.url,
-            'selectors': {
-                'main_content': "div[role='main']",
-                'title': 'title',
-                'code_blocks': 'pre code'
-            },
-            'url_patterns': {'include': [], 'exclude': []},
-            'rate_limit': DEFAULT_RATE_LIMIT,
-            'max_pages': DEFAULT_MAX_PAGES
+            "name": args.name,
+            "description": args.description or f"Use when working with {args.name}",
+            "base_url": args.url,
+            "selectors": {"main_content": "div[role='main']", "title": "title", "code_blocks": "pre code"},
+            "url_patterns": {"include": [], "exclude": []},
+            "rate_limit": DEFAULT_RATE_LIMIT,
+            "max_pages": DEFAULT_MAX_PAGES,
         }
 
     # Apply CLI overrides for rate limiting
     if args.no_rate_limit:
-        config['rate_limit'] = 0
+        config["rate_limit"] = 0
         logger.info("⚡ Rate limiting disabled")
     elif args.rate_limit is not None:
-        config['rate_limit'] = args.rate_limit
+        config["rate_limit"] = args.rate_limit
         if args.rate_limit == 0:
             logger.info("⚡ Rate limiting disabled")
         else:
@@ -1923,14 +1893,14 @@ def get_configuration(args: argparse.Namespace) -> Dict[str, Any]:
         if args.workers > 10:
             logger.warning("⚠️  Warning: --workers capped at 10 (requested %d)", args.workers)
             args.workers = 10
-        config['workers'] = args.workers
+        config["workers"] = args.workers
         if args.workers > 1:
             logger.info("🚀 Parallel scraping enabled: %d workers", args.workers)
 
     # Apply CLI override for async mode
     if args.async_mode:
-        config['async_mode'] = True
-        if config.get('workers', 1) > 1:
+        config["async_mode"] = True
+        if config.get("workers", 1) > 1:
             logger.info("⚡ Async mode enabled (2-3x faster than threads)")
         else:
             logger.warning("⚠️  Async mode enabled but workers=1. Consider using --workers 4 for better performance")
@@ -1938,7 +1908,7 @@ def get_configuration(args: argparse.Namespace) -> Dict[str, Any]:
     return config
 
 
-def execute_scraping_and_building(config: Dict[str, Any], args: argparse.Namespace) -> Optional['DocToSkillConverter']:
+def execute_scraping_and_building(config: dict[str, Any], args: argparse.Namespace) -> Optional["DocToSkillConverter"]:
     """Execute the scraping and skill building process.
 
     Handles dry run mode, existing data checks, scraping with checkpoints,
@@ -1970,23 +1940,24 @@ def execute_scraping_and_building(config: Dict[str, Any], args: argparse.Namespa
         converter.scrape_all()
 
         logger.info("\n📋 Configuration Summary:")
-        logger.info("   Name: %s", config['name'])
-        logger.info("   Base URL: %s", config['base_url'])
-        logger.info("   Max pages: %d", config.get('max_pages', DEFAULT_MAX_PAGES))
-        logger.info("   Rate limit: %ss", config.get('rate_limit', DEFAULT_RATE_LIMIT))
-        logger.info("   Categories: %d", len(config.get('categories', {})))
+        logger.info("   Name: %s", config["name"])
+        logger.info("   Base URL: %s", config["base_url"])
+        logger.info("   Max pages: %d", config.get("max_pages", DEFAULT_MAX_PAGES))
+        logger.info("   Rate limit: %ss", config.get("rate_limit", DEFAULT_RATE_LIMIT))
+        logger.info("   Categories: %d", len(config.get("categories", {})))
         return None
 
     # Check for existing data
-    exists, page_count = check_existing_data(config['name'])
+    exists, page_count = check_existing_data(config["name"])
 
     if exists and not args.skip_scrape and not args.fresh:
         # Check force_rescrape flag from config
-        if config.get('force_rescrape', False):
+        if config.get("force_rescrape", False):
             # Auto-delete cached data and rescrape
             logger.info("\n✓ Found existing data: %d pages", page_count)
             logger.info("  force_rescrape enabled - deleting cached data and rescaping")
             import shutil
+
             data_dir = f"output/{config['name']}_data"
             if os.path.exists(data_dir):
                 shutil.rmtree(data_dir)
@@ -1995,7 +1966,7 @@ def execute_scraping_and_building(config: Dict[str, Any], args: argparse.Namespa
             # Only prompt if force_rescrape is False
             logger.info("\n✓ Found existing data: %d pages", page_count)
             response = input("Use existing data? (y/n): ").strip().lower()
-            if response == 'y':
+            if response == "y":
                 args.skip_scrape = True
     elif exists and args.fresh:
         logger.info("\n✓ Found existing data: %d pages", page_count)
@@ -2024,9 +1995,9 @@ def execute_scraping_and_building(config: Dict[str, Any], args: argparse.Namespa
             if converter.checkpoint_enabled:
                 converter.save_checkpoint()
                 logger.info("💾 Progress saved to checkpoint")
-                logger.info("   Resume with: --config %s --resume", args.config if args.config else 'config.json')
+                logger.info("   Resume with: --config %s --resume", args.config if args.config else "config.json")
             response = input("Continue with skill building? (y/n): ").strip().lower()
-            if response != 'y':
+            if response != "y":
                 return None
     else:
         logger.info("\n⏭️  Skipping scrape, using existing data")
@@ -2040,7 +2011,7 @@ def execute_scraping_and_building(config: Dict[str, Any], args: argparse.Namespa
     return converter
 
 
-def execute_enhancement(config: Dict[str, Any], args: argparse.Namespace) -> None:
+def execute_enhancement(config: dict[str, Any], args: argparse.Namespace) -> None:
     """Execute optional SKILL.md enhancement with Claude.
 
     Supports two enhancement modes:
@@ -2067,9 +2038,9 @@ def execute_enhancement(config: Dict[str, Any], args: argparse.Namespace) -> Non
         logger.info("=" * 60 + "\n")
 
         try:
-            enhance_cmd = ['python3', 'cli/enhance_skill.py', f'output/{config["name"]}/']
+            enhance_cmd = ["python3", "cli/enhance_skill.py", f"output/{config['name']}/"]
             if args.api_key:
-                enhance_cmd.extend(['--api-key', args.api_key])
+                enhance_cmd.extend(["--api-key", args.api_key])
 
             result = subprocess.run(enhance_cmd, check=True)
             if result.returncode == 0:
@@ -2078,7 +2049,7 @@ def execute_enhancement(config: Dict[str, Any], args: argparse.Namespace) -> Non
             logger.warning("\n⚠ Enhancement failed, but skill was still built")
         except FileNotFoundError:
             logger.warning("\n⚠ enhance_skill.py not found. Run manually:")
-            logger.info("  skill-seekers-enhance output/%s/", config['name'])
+            logger.info("  skill-seekers-enhance output/%s/", config["name"])
 
     # Optional enhancement with Claude Code (local, no API key)
     if args.enhance_local:
@@ -2090,9 +2061,9 @@ def execute_enhancement(config: Dict[str, Any], args: argparse.Namespace) -> Non
         logger.info("=" * 60 + "\n")
 
         try:
-            enhance_cmd = ['skill-seekers-enhance', f'output/{config["name"]}/']
+            enhance_cmd = ["skill-seekers-enhance", f"output/{config['name']}/"]
             if args.interactive_enhancement:
-                enhance_cmd.append('--interactive-enhancement')
+                enhance_cmd.append("--interactive-enhancement")
 
             result = subprocess.run(enhance_cmd, check=True)
 
@@ -2102,18 +2073,18 @@ def execute_enhancement(config: Dict[str, Any], args: argparse.Namespace) -> Non
             logger.warning("\n⚠ Enhancement failed, but skill was still built")
         except FileNotFoundError:
             logger.warning("\n⚠ skill-seekers-enhance command not found. Run manually:")
-            logger.info("  skill-seekers-enhance output/%s/", config['name'])
+            logger.info("  skill-seekers-enhance output/%s/", config["name"])
 
     # Print packaging instructions
     logger.info("\n📦 Package your skill:")
-    logger.info("  skill-seekers-package output/%s/", config['name'])
+    logger.info("  skill-seekers-package output/%s/", config["name"])
 
     # Suggest enhancement if not done
     if not args.enhance and not args.enhance_local:
         logger.info("\n💡 Optional: Enhance SKILL.md with Claude:")
-        logger.info("  Local (recommended):  skill-seekers-enhance output/%s/", config['name'])
+        logger.info("  Local (recommended):  skill-seekers-enhance output/%s/", config["name"])
         logger.info("                        or re-run with: --enhance-local")
-        logger.info("  API-based:            skill-seekers-enhance-api output/%s/", config['name'])
+        logger.info("  API-based:            skill-seekers-enhance-api output/%s/", config["name"])
         logger.info("                        or re-run with: --enhance")
         logger.info("\n💡 Tip: Use --interactive-enhancement with --enhance-local to open terminal window")
 
diff --git a/src/skill_seekers/cli/enhance_skill.py b/src/skill_seekers/cli/enhance_skill.py
index e24048f..646d9ad 100644
--- a/src/skill_seekers/cli/enhance_skill.py
+++ b/src/skill_seekers/cli/enhance_skill.py
@@ -15,10 +15,9 @@ Usage:
     skill-seekers enhance output/react/ --target openai --api-key sk-proj-...
 """
 
+import argparse
 import os
 import sys
-import json
-import argparse
 from pathlib import Path
 
 # Add parent directory to path for imports when run as script
@@ -42,9 +41,7 @@ class SkillEnhancer:
         self.skill_md_path = self.skill_dir / "SKILL.md"
 
         # Get API key - support both ANTHROPIC_API_KEY and ANTHROPIC_AUTH_TOKEN
-        self.api_key = (api_key or
-                       os.environ.get('ANTHROPIC_API_KEY') or
-                       os.environ.get('ANTHROPIC_AUTH_TOKEN'))
+        self.api_key = api_key or os.environ.get("ANTHROPIC_API_KEY") or os.environ.get("ANTHROPIC_AUTH_TOKEN")
         if not self.api_key:
             raise ValueError(
                 "No API key provided. Set ANTHROPIC_API_KEY or ANTHROPIC_AUTH_TOKEN "
@@ -52,10 +49,10 @@ class SkillEnhancer:
             )
 
         # Support custom base URL for alternative API endpoints
-        base_url = os.environ.get('ANTHROPIC_BASE_URL')
-        client_kwargs = {'api_key': self.api_key}
+        base_url = os.environ.get("ANTHROPIC_BASE_URL")
+        client_kwargs = {"api_key": self.api_key}
         if base_url:
-            client_kwargs['base_url'] = base_url
+            client_kwargs["base_url"] = base_url
             print(f"ℹ️  Using custom API base URL: {base_url}")
 
         self.client = anthropic.Anthropic(**client_kwargs)
@@ -64,7 +61,7 @@ class SkillEnhancer:
         """Read existing SKILL.md"""
         if not self.skill_md_path.exists():
             return None
-        return self.skill_md_path.read_text(encoding='utf-8')
+        return self.skill_md_path.read_text(encoding="utf-8")
 
     def enhance_skill_md(self, references, current_skill_md):
         """Use Claude to enhance SKILL.md"""
@@ -80,17 +77,14 @@ class SkillEnhancer:
                 model="claude-sonnet-4-20250514",
                 max_tokens=4096,
                 temperature=0.3,
-                messages=[{
-                    "role": "user",
-                    "content": prompt
-                }]
+                messages=[{"role": "user", "content": prompt}],
             )
 
             # Handle response content - newer SDK versions may include ThinkingBlock
             # Find the TextBlock containing the actual response
             enhanced_content = None
             for block in message.content:
-                if hasattr(block, 'text'):
+                if hasattr(block, "text"):
                     enhanced_content = block.text
                     break
 
@@ -113,10 +107,10 @@ class SkillEnhancer:
         # Analyze sources
         sources_found = set()
         for metadata in references.values():
-            sources_found.add(metadata['source'])
+            sources_found.add(metadata["source"])
 
         # Analyze conflicts if present
-        has_conflicts = any('conflicts' in meta['path'] for meta in references.values())
+        has_conflicts = any("conflicts" in meta["path"] for meta in references.values())
 
         prompt = f"""You are enhancing a Claude skill's SKILL.md file. This skill is about: {skill_name}
 
@@ -124,14 +118,14 @@ I've scraped documentation from multiple sources and organized it into reference
 
 SKILL OVERVIEW:
 - Name: {skill_name}
-- Source Types: {', '.join(sorted(sources_found))}
-- Multi-Source: {'Yes' if len(sources_found) > 1 else 'No'}
-- Conflicts Detected: {'Yes - see conflicts.md in references' if has_conflicts else 'No'}
+- Source Types: {", ".join(sorted(sources_found))}
+- Multi-Source: {"Yes" if len(sources_found) > 1 else "No"}
+- Conflicts Detected: {"Yes - see conflicts.md in references" if has_conflicts else "No"}
 
 CURRENT SKILL.MD:
-{'```markdown' if current_skill_md else '(none - create from scratch)'}
-{current_skill_md or 'No existing SKILL.md'}
-{'```' if current_skill_md else ''}
+{"```markdown" if current_skill_md else "(none - create from scratch)"}
+{current_skill_md or "No existing SKILL.md"}
+{"```" if current_skill_md else ""}
 
 SOURCE ANALYSIS:
 This skill combines knowledge from {len(sources_found)} source type(s):
@@ -141,8 +135,8 @@ This skill combines knowledge from {len(sources_found)} source type(s):
         # Group references by (source_type, repo_id) for multi-source support
         by_source = {}
         for filename, metadata in references.items():
-            source = metadata['source']
-            repo_id = metadata.get('repo_id')  # None for single-source
+            source = metadata["source"]
+            repo_id = metadata.get("repo_id")  # None for single-source
             key = (source, repo_id) if repo_id else (source, None)
 
             if key not in by_source:
@@ -150,7 +144,7 @@ This skill combines knowledge from {len(sources_found)} source type(s):
             by_source[key].append((filename, metadata))
 
         # Add source breakdown with repo identity
-        for (source, repo_id) in sorted(by_source.keys()):
+        for source, repo_id in sorted(by_source.keys()):
             files = by_source[(source, repo_id)]
             if repo_id:
                 prompt += f"\n**{source.upper()} - {repo_id} ({len(files)} file(s))**\n"
@@ -164,14 +158,14 @@ This skill combines knowledge from {len(sources_found)} source type(s):
         prompt += "\n\nREFERENCE DOCUMENTATION:\n"
 
         # Add references grouped by (source, repo_id) with metadata
-        for (source, repo_id) in sorted(by_source.keys()):
+        for source, repo_id in sorted(by_source.keys()):
             if repo_id:
                 prompt += f"\n### {source.upper()} SOURCES - {repo_id}\n\n"
             else:
                 prompt += f"\n### {source.upper()} SOURCES\n\n"
 
             for filename, metadata in by_source[(source, repo_id)]:
-                content = metadata['content']
+                content = metadata["content"]
                 # Limit per-file to 30K
                 if len(content) > 30000:
                     content = content[:30000] + "\n\n[Content truncated for size...]"
@@ -197,12 +191,12 @@ MULTI-REPOSITORY HANDLING:
         # Detect multiple repos from same source type
         repo_ids = set()
         for metadata in references.values():
-            if metadata.get('repo_id'):
-                repo_ids.add(metadata['repo_id'])
+            if metadata.get("repo_id"):
+                repo_ids.add(metadata["repo_id"])
 
         if len(repo_ids) > 1:
             prompt += f"""
-⚠️ MULTIPLE REPOSITORIES DETECTED: {', '.join(sorted(repo_ids))}
+⚠️ MULTIPLE REPOSITORIES DETECTED: {", ".join(sorted(repo_ids))}
 
 This skill combines codebase analysis from {len(repo_ids)} different repositories.
 Each repo has its own ARCHITECTURE.md, patterns, examples, and configuration.
@@ -285,27 +279,23 @@ Return ONLY the complete SKILL.md content, starting with the frontmatter (---).
         """Save the enhanced SKILL.md"""
         # Backup original
         if self.skill_md_path.exists():
-            backup_path = self.skill_md_path.with_suffix('.md.backup')
+            backup_path = self.skill_md_path.with_suffix(".md.backup")
             self.skill_md_path.rename(backup_path)
             print(f"  💾 Backed up original to: {backup_path.name}")
 
         # Save enhanced version
-        self.skill_md_path.write_text(content, encoding='utf-8')
-        print(f"  ✅ Saved enhanced SKILL.md")
+        self.skill_md_path.write_text(content, encoding="utf-8")
+        print("  ✅ Saved enhanced SKILL.md")
 
     def run(self):
         """Main enhancement workflow"""
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print(f"ENHANCING SKILL: {self.skill_dir.name}")
-        print(f"{'='*60}\n")
+        print(f"{'=' * 60}\n")
 
         # Read reference files
         print("📖 Reading reference documentation...")
-        references = read_reference_files(
-            self.skill_dir,
-            max_chars=API_CONTENT_LIMIT,
-            preview_limit=API_PREVIEW_LIMIT
-        )
+        references = read_reference_files(self.skill_dir, max_chars=API_CONTENT_LIMIT, preview_limit=API_PREVIEW_LIMIT)
 
         if not references:
             print("❌ No reference files found to analyze")
@@ -314,11 +304,11 @@ Return ONLY the complete SKILL.md content, starting with the frontmatter (---).
         # Analyze sources
         sources_found = set()
         for metadata in references.values():
-            sources_found.add(metadata['source'])
+            sources_found.add(metadata["source"])
 
         print(f"  ✓ Read {len(references)} reference files")
         print(f"  ✓ Sources: {', '.join(sorted(sources_found))}")
-        total_size = sum(meta['size'] for meta in references.values())
+        total_size = sum(meta["size"] for meta in references.values())
         print(f"  ✓ Total size: {total_size:,} characters\n")
 
         # Read current SKILL.md
@@ -326,7 +316,7 @@ Return ONLY the complete SKILL.md content, starting with the frontmatter (---).
         if current_skill_md:
             print(f"  ℹ Found existing SKILL.md ({len(current_skill_md)} chars)")
         else:
-            print(f"  ℹ No existing SKILL.md, will create new one")
+            print("  ℹ No existing SKILL.md, will create new one")
 
         # Enhance with Claude
         enhanced = self.enhance_skill_md(references, current_skill_md)
@@ -341,11 +331,11 @@ Return ONLY the complete SKILL.md content, starting with the frontmatter (---).
         print("💾 Saving enhanced SKILL.md...")
         self.save_enhanced_skill_md(enhanced)
 
-        print(f"\n✅ Enhancement complete!")
-        print(f"\nNext steps:")
+        print("\n✅ Enhancement complete!")
+        print("\nNext steps:")
         print(f"  1. Review: {self.skill_md_path}")
         print(f"  2. If you don't like it, restore backup: {self.skill_md_path.with_suffix('.md.backup')}")
-        print(f"  3. Package your skill:")
+        print("  3. Package your skill:")
         print(f"     skill-seekers package {self.skill_dir}/")
 
         return True
@@ -353,7 +343,7 @@ Return ONLY the complete SKILL.md content, starting with the frontmatter (---).
 
 def main():
     parser = argparse.ArgumentParser(
-        description='Enhance SKILL.md using platform AI APIs',
+        description="Enhance SKILL.md using platform AI APIs",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -374,19 +364,18 @@ Examples:
 
   # Dry run
   skill-seekers enhance output/godot/ --dry-run
-"""
+""",
     )
 
-    parser.add_argument('skill_dir', type=str,
-                       help='Path to skill directory (e.g., output/steam-inventory/)')
-    parser.add_argument('--api-key', type=str,
-                       help='Platform API key (or set environment variable)')
-    parser.add_argument('--target',
-                       choices=['claude', 'gemini', 'openai'],
-                       default='claude',
-                       help='Target LLM platform (default: claude)')
-    parser.add_argument('--dry-run', action='store_true',
-                       help='Show what would be done without calling API')
+    parser.add_argument("skill_dir", type=str, help="Path to skill directory (e.g., output/steam-inventory/)")
+    parser.add_argument("--api-key", type=str, help="Platform API key (or set environment variable)")
+    parser.add_argument(
+        "--target",
+        choices=["claude", "gemini", "openai"],
+        default="claude",
+        help="Target LLM platform (default: claude)",
+    )
+    parser.add_argument("--dry-run", action="store_true", help="Show what would be done without calling API")
 
     args = parser.parse_args()
 
@@ -402,7 +391,7 @@ Examples:
 
     # Dry run mode
     if args.dry_run:
-        print(f"🔍 DRY RUN MODE")
+        print("🔍 DRY RUN MODE")
         print(f"   Would enhance: {skill_dir}")
         print(f"   References: {skill_dir / 'references'}")
         print(f"   SKILL.md: {skill_dir / 'SKILL.md'}")
@@ -427,7 +416,7 @@ Examples:
 
         if not adaptor.supports_enhancement():
             print(f"❌ Error: {adaptor.PLATFORM_NAME} does not support AI enhancement")
-            print(f"\nSupported platforms for enhancement:")
+            print("\nSupported platforms for enhancement:")
             print("  - Claude AI (Anthropic)")
             print("  - Google Gemini")
             print("  - OpenAI ChatGPT")
@@ -436,7 +425,7 @@ Examples:
         # Get API key
         api_key = args.api_key
         if not api_key:
-            api_key = os.environ.get(adaptor.get_env_var_name(), '').strip()
+            api_key = os.environ.get(adaptor.get_env_var_name(), "").strip()
 
         if not api_key:
             print(f"❌ Error: {adaptor.get_env_var_name()} not set")
@@ -447,19 +436,19 @@ Examples:
             sys.exit(1)
 
         # Run enhancement using adaptor
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print(f"ENHANCING SKILL: {skill_dir}")
         print(f"Platform: {adaptor.PLATFORM_NAME}")
-        print(f"{'='*60}\n")
+        print(f"{'=' * 60}\n")
 
         success = adaptor.enhance(Path(skill_dir), api_key)
 
         if success:
-            print(f"\n✅ Enhancement complete!")
-            print(f"\nNext steps:")
+            print("\n✅ Enhancement complete!")
+            print("\nNext steps:")
             print(f"  1. Review: {Path(skill_dir) / 'SKILL.md'}")
             print(f"  2. If you don't like it, restore backup: {Path(skill_dir) / 'SKILL.md.backup'}")
-            print(f"  3. Package your skill:")
+            print("  3. Package your skill:")
             print(f"     skill-seekers package {skill_dir}/ --target {args.target}")
 
         sys.exit(0 if success else 1)
@@ -474,6 +463,7 @@ Examples:
     except Exception as e:
         print(f"❌ Unexpected error: {e}")
         import traceback
+
         traceback.print_exc()
         sys.exit(1)
 
diff --git a/src/skill_seekers/cli/enhance_skill_local.py b/src/skill_seekers/cli/enhance_skill_local.py
index 4209230..bb8463b 100644
--- a/src/skill_seekers/cli/enhance_skill_local.py
+++ b/src/skill_seekers/cli/enhance_skill_local.py
@@ -36,15 +36,15 @@ Terminal Selection:
     Supported terminals: Ghostty, iTerm, Terminal, WezTerm
 """
 
-import os
-import sys
-import time
-import subprocess
-import tempfile
 import json
+import os
+import subprocess
+import sys
+import tempfile
 import threading
-from pathlib import Path
+import time
 from datetime import datetime
+from pathlib import Path
 
 # Add parent directory to path for imports when run as script
 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
@@ -77,29 +77,29 @@ def detect_terminal_app():
     """
     # Map TERM_PROGRAM values to macOS app names
     TERMINAL_MAP = {
-        'Apple_Terminal': 'Terminal',
-        'iTerm.app': 'iTerm',
-        'ghostty': 'Ghostty',
-        'WezTerm': 'WezTerm',
+        "Apple_Terminal": "Terminal",
+        "iTerm.app": "iTerm",
+        "ghostty": "Ghostty",
+        "WezTerm": "WezTerm",
     }
 
     # Priority 1: Check SKILL_SEEKER_TERMINAL env var (explicit preference)
-    preferred_terminal = os.environ.get('SKILL_SEEKER_TERMINAL', '').strip()
+    preferred_terminal = os.environ.get("SKILL_SEEKER_TERMINAL", "").strip()
     if preferred_terminal:
-        return preferred_terminal, 'SKILL_SEEKER_TERMINAL'
+        return preferred_terminal, "SKILL_SEEKER_TERMINAL"
 
     # Priority 2: Check TERM_PROGRAM (inherit current terminal)
-    term_program = os.environ.get('TERM_PROGRAM', '').strip()
+    term_program = os.environ.get("TERM_PROGRAM", "").strip()
     if term_program and term_program in TERMINAL_MAP:
-        return TERMINAL_MAP[term_program], 'TERM_PROGRAM'
+        return TERMINAL_MAP[term_program], "TERM_PROGRAM"
 
     # Priority 3: Fallback to Terminal.app
     if term_program:
         # TERM_PROGRAM is set but unknown
-        return 'Terminal', f'unknown TERM_PROGRAM ({term_program})'
+        return "Terminal", f"unknown TERM_PROGRAM ({term_program})"
     else:
         # No TERM_PROGRAM set
-        return 'Terminal', 'default'
+        return "Terminal", "default"
 
 
 class LocalSkillEnhancer:
@@ -132,7 +132,7 @@ class LocalSkillEnhancer:
         Returns:
             Summarized content
         """
-        lines = content.split('\n')
+        lines = content.split("\n")
         target_lines = int(len(lines) * target_ratio)
 
         # Priority 1: Keep introduction (first 20%)
@@ -146,7 +146,7 @@ class LocalSkillEnhancer:
         block_start_idx = 0
 
         for i, line in enumerate(lines[intro_lines:], start=intro_lines):
-            if line.strip().startswith('```'):
+            if line.strip().startswith("```"):
                 if in_code_block:
                     # End of code block - add closing ``` and save
                     current_block.append(line)
@@ -174,9 +174,9 @@ class LocalSkillEnhancer:
         headings_added = 0
         while i < len(lines) and headings_added < 10:
             line = lines[i]
-            if line.startswith('#'):
+            if line.startswith("#"):
                 # Found heading - keep it and next 3 lines
-                chunk = lines[i:min(i+4, len(lines))]
+                chunk = lines[i : min(i + 4, len(lines))]
                 result.extend(chunk)
                 headings_added += 1
                 i += 4
@@ -185,7 +185,7 @@ class LocalSkillEnhancer:
 
         result.append("\n\n[Content intelligently summarized - full details in reference files]")
 
-        return '\n'.join(result)
+        return "\n".join(result)
 
     def create_enhancement_prompt(self, use_summarization=False, summarization_ratio=0.3):
         """Create the prompt file for Claude Code
@@ -197,9 +197,7 @@ class LocalSkillEnhancer:
 
         # Read reference files (with enriched metadata)
         references = read_reference_files(
-            self.skill_dir,
-            max_chars=LOCAL_CONTENT_LIMIT,
-            preview_limit=LOCAL_PREVIEW_LIMIT
+            self.skill_dir, max_chars=LOCAL_CONTENT_LIMIT, preview_limit=LOCAL_PREVIEW_LIMIT
         )
 
         if not references:
@@ -209,52 +207,54 @@ class LocalSkillEnhancer:
         # Analyze sources
         sources_found = set()
         for metadata in references.values():
-            sources_found.add(metadata['source'])
+            sources_found.add(metadata["source"])
 
         # Calculate total size
-        total_ref_size = sum(meta['size'] for meta in references.values())
+        total_ref_size = sum(meta["size"] for meta in references.values())
 
         # Apply summarization if requested or if content is too large
         if use_summarization or total_ref_size > 30000:
             if not use_summarization:
                 print(f"  ⚠️  Large skill detected ({total_ref_size:,} chars)")
-                print(f"  📊 Applying smart summarization (target: {int(summarization_ratio*100)}% of original)")
+                print(f"  📊 Applying smart summarization (target: {int(summarization_ratio * 100)}% of original)")
                 print()
 
             # Summarize each reference
             for filename, metadata in references.items():
-                summarized = self.summarize_reference(metadata['content'], summarization_ratio)
-                metadata['content'] = summarized
-                metadata['size'] = len(summarized)
+                summarized = self.summarize_reference(metadata["content"], summarization_ratio)
+                metadata["content"] = summarized
+                metadata["size"] = len(summarized)
 
-            new_size = sum(meta['size'] for meta in references.values())
-            print(f"  ✓ Reduced from {total_ref_size:,} to {new_size:,} chars ({int(new_size/total_ref_size*100)}%)")
+            new_size = sum(meta["size"] for meta in references.values())
+            print(
+                f"  ✓ Reduced from {total_ref_size:,} to {new_size:,} chars ({int(new_size / total_ref_size * 100)}%)"
+            )
             print()
 
         # Read current SKILL.md
         current_skill_md = ""
         if self.skill_md_path.exists():
-            current_skill_md = self.skill_md_path.read_text(encoding='utf-8')
+            current_skill_md = self.skill_md_path.read_text(encoding="utf-8")
 
         # Analyze conflicts if present
-        has_conflicts = any('conflicts' in meta['path'] for meta in references.values())
+        has_conflicts = any("conflicts" in meta["path"] for meta in references.values())
 
         # Build prompt with multi-source awareness
         prompt = f"""I need you to enhance the SKILL.md file for the {self.skill_dir.name} skill.
 
 SKILL OVERVIEW:
 - Name: {self.skill_dir.name}
-- Source Types: {', '.join(sorted(sources_found))}
-- Multi-Source: {'Yes' if len(sources_found) > 1 else 'No'}
-- Conflicts Detected: {'Yes - see conflicts.md in references' if has_conflicts else 'No'}
+- Source Types: {", ".join(sorted(sources_found))}
+- Multi-Source: {"Yes" if len(sources_found) > 1 else "No"}
+- Conflicts Detected: {"Yes - see conflicts.md in references" if has_conflicts else "No"}
 
 CURRENT SKILL.MD:
-{'-'*60}
-{current_skill_md if current_skill_md else '(No existing SKILL.md - create from scratch)'}
-{'-'*60}
+{"-" * 60}
+{current_skill_md if current_skill_md else "(No existing SKILL.md - create from scratch)"}
+{"-" * 60}
 
 SOURCE ANALYSIS:
-{'-'*60}
+{"-" * 60}
 This skill combines knowledge from {len(sources_found)} source type(s):
 
 """
@@ -262,8 +262,8 @@ This skill combines knowledge from {len(sources_found)} source type(s):
         # Group references by (source_type, repo_id) for multi-source support
         by_source = {}
         for filename, metadata in references.items():
-            source = metadata['source']
-            repo_id = metadata.get('repo_id')  # None for single-source
+            source = metadata["source"]
+            repo_id = metadata.get("repo_id")  # None for single-source
             key = (source, repo_id) if repo_id else (source, None)
 
             if key not in by_source:
@@ -271,7 +271,7 @@ This skill combines knowledge from {len(sources_found)} source type(s):
             by_source[key].append((filename, metadata))
 
         # Add source breakdown with repo identity
-        for (source, repo_id) in sorted(by_source.keys()):
+        for source, repo_id in sorted(by_source.keys()):
             files = by_source[(source, repo_id)]
             if repo_id:
                 prompt += f"\n**{source.upper()} - {repo_id} ({len(files)} file(s))**\n"
@@ -283,14 +283,14 @@ This skill combines knowledge from {len(sources_found)} source type(s):
                 prompt += f"- ... and {len(files) - 5} more\n"
 
         prompt += f"""
-{'-'*60}
+{"-" * 60}
 
 REFERENCE DOCUMENTATION:
-{'-'*60}
+{"-" * 60}
 """
 
         # Add references grouped by (source, repo_id) with metadata
-        for (source, repo_id) in sorted(by_source.keys()):
+        for source, repo_id in sorted(by_source.keys()):
             if repo_id:
                 prompt += f"\n### {source.upper()} SOURCES - {repo_id}\n\n"
             else:
@@ -298,7 +298,7 @@ REFERENCE DOCUMENTATION:
 
             for filename, metadata in by_source[(source, repo_id)]:
                 # Further limit per-file to 12K to be safe
-                content = metadata['content']
+                content = metadata["content"]
                 max_per_file = 12000
                 if len(content) > max_per_file:
                     content = content[:max_per_file] + "\n\n[Content truncated for size...]"
@@ -311,7 +311,7 @@ REFERENCE DOCUMENTATION:
                 prompt += f"{content}\n"
 
         prompt += f"""
-{'-'*60}
+{"-" * 60}
 
 REFERENCE PRIORITY (when sources differ):
 1. **Code patterns (codebase_analysis)**: Ground truth - what the code actually does
@@ -325,12 +325,12 @@ MULTI-REPOSITORY HANDLING:
         # Detect multiple repos from same source type
         repo_ids = set()
         for metadata in references.values():
-            if metadata.get('repo_id'):
-                repo_ids.add(metadata['repo_id'])
+            if metadata.get("repo_id"):
+                repo_ids.add(metadata["repo_id"])
 
         if len(repo_ids) > 1:
             prompt += f"""
-⚠️ MULTIPLE REPOSITORIES DETECTED: {', '.join(sorted(repo_ids))}
+⚠️ MULTIPLE REPOSITORIES DETECTED: {", ".join(sorted(repo_ids))}
 
 This skill combines codebase analysis from {len(repo_ids)} different repositories.
 Each repo has its own ARCHITECTURE.md, patterns, examples, and configuration.
@@ -435,10 +435,10 @@ After writing, the file SKILL.md should:
             "progress": progress,
             "timestamp": datetime.now().isoformat(),
             "skill_dir": str(self.skill_dir),
-            "error": error
+            "error": error,
         }
 
-        self.status_file.write_text(json.dumps(status_data, indent=2), encoding='utf-8')
+        self.status_file.write_text(json.dumps(status_data, indent=2), encoding="utf-8")
 
     def read_status(self):
         """Read enhancement status from file.
@@ -450,7 +450,7 @@ After writing, the file SKILL.md should:
             return None
 
         try:
-            return json.loads(self.status_file.read_text(encoding='utf-8'))
+            return json.loads(self.status_file.read_text(encoding="utf-8"))
         except:
             return None
 
@@ -482,9 +482,9 @@ After writing, the file SKILL.md should:
         # Daemon mode: Run as persistent process with monitoring
         if daemon:
             return self._run_daemon(timeout)
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print(f"LOCAL ENHANCEMENT: {self.skill_dir.name}")
-        print(f"{'='*60}\n")
+        print(f"{'=' * 60}\n")
 
         # Validate
         if not self.skill_dir.exists():
@@ -494,9 +494,7 @@ After writing, the file SKILL.md should:
         # Read reference files
         print("📖 Reading reference documentation...")
         references = read_reference_files(
-            self.skill_dir,
-            max_chars=LOCAL_CONTENT_LIMIT,
-            preview_limit=LOCAL_PREVIEW_LIMIT
+            self.skill_dir, max_chars=LOCAL_CONTENT_LIMIT, preview_limit=LOCAL_PREVIEW_LIMIT
         )
 
         if not references:
@@ -504,7 +502,7 @@ After writing, the file SKILL.md should:
             return False
 
         print(f"  ✓ Read {len(references)} reference files")
-        total_size = sum(ref['size'] for ref in references.values())
+        total_size = sum(ref["size"] for ref in references.values())
         print(f"  ✓ Total size: {total_size:,} characters\n")
 
         # Check if we need smart summarization
@@ -513,7 +511,7 @@ After writing, the file SKILL.md should:
         if use_summarization:
             print("⚠️  LARGE SKILL DETECTED")
             print(f"  📊 Reference content: {total_size:,} characters")
-            print(f"  💡 Claude CLI limit: ~30,000-40,000 characters")
+            print("  💡 Claude CLI limit: ~30,000-40,000 characters")
             print()
             print("  🔧 Applying smart summarization to ensure success...")
             print("     • Keeping introductions and overviews")
@@ -530,13 +528,13 @@ After writing, the file SKILL.md should:
             return False
 
         # Save prompt to temp file
-        with tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False, encoding='utf-8') as f:
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".txt", delete=False, encoding="utf-8") as f:
             prompt_file = f.name
             f.write(prompt)
 
         if use_summarization:
             print(f"  ✓ Prompt created and optimized ({len(prompt):,} characters)")
-            print(f"  ✓ Ready for Claude CLI (within safe limits)")
+            print("  ✓ Ready for Claude CLI (within safe limits)")
             print()
         else:
             print(f"  ✓ Prompt saved ({len(prompt):,} characters)\n")
@@ -555,49 +553,49 @@ After writing, the file SKILL.md should:
         print()
 
         # Create a shell script to run in the terminal
-        shell_script = f'''#!/bin/bash
+        shell_script = f"""#!/bin/bash
 claude {prompt_file}
 echo ""
 echo "✅ Enhancement complete!"
 echo "Press any key to close..."
 read -n 1
 rm {prompt_file}
-'''
+"""
 
         # Save shell script
-        with tempfile.NamedTemporaryFile(mode='w', suffix='.sh', delete=False) as f:
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".sh", delete=False) as f:
             script_file = f.name
             f.write(shell_script)
 
         os.chmod(script_file, 0o755)
 
         # Launch in new terminal (macOS specific)
-        if sys.platform == 'darwin':
+        if sys.platform == "darwin":
             # Detect which terminal app to use
             terminal_app, detection_method = detect_terminal_app()
 
             # Show detection info
-            if detection_method == 'SKILL_SEEKER_TERMINAL':
+            if detection_method == "SKILL_SEEKER_TERMINAL":
                 print(f"   Using terminal: {terminal_app} (from SKILL_SEEKER_TERMINAL)")
-            elif detection_method == 'TERM_PROGRAM':
+            elif detection_method == "TERM_PROGRAM":
                 print(f"   Using terminal: {terminal_app} (inherited from current terminal)")
-            elif detection_method.startswith('unknown TERM_PROGRAM'):
+            elif detection_method.startswith("unknown TERM_PROGRAM"):
                 print(f"⚠️  {detection_method}")
-                print(f"   → Using Terminal.app as fallback")
+                print("   → Using Terminal.app as fallback")
             else:
                 print(f"   Using terminal: {terminal_app} (default)")
 
             try:
-                subprocess.Popen(['open', '-a', terminal_app, script_file])
+                subprocess.Popen(["open", "-a", terminal_app, script_file])
             except Exception as e:
                 print(f"⚠️  Error launching {terminal_app}: {e}")
                 print(f"\nManually run: {script_file}")
                 return False
         else:
             print("⚠️  Auto-launch only works on macOS")
-            print(f"\nManually run this command in a new terminal:")
+            print("\nManually run this command in a new terminal:")
             print(f"  claude '{prompt_file}'")
-            print(f"\nThen delete the prompt file:")
+            print("\nThen delete the prompt file:")
             print(f"  rm '{prompt_file}'")
             return False
 
@@ -614,7 +612,9 @@ rm {prompt_file}
         print()
         print("💡 When done:")
         print(f"  1. Check the enhanced SKILL.md: {self.skill_md_path}")
-        print(f"  2. If you don't like it, restore: mv {self.skill_md_path.with_suffix('.md.backup')} {self.skill_md_path}")
+        print(
+            f"  2. If you don't like it, restore: mv {self.skill_md_path.with_suffix('.md.backup')} {self.skill_md_path}"
+        )
         print(f"  3. Package: skill-seekers package {self.skill_dir}/")
 
         return True
@@ -630,10 +630,9 @@ rm {prompt_file}
             bool: True if enhancement succeeded
         """
         import time
-        from pathlib import Path
 
         print("✨ Running Claude Code enhancement (headless mode)...")
-        print(f"   Timeout: {timeout} seconds ({timeout//60} minutes)")
+        print(f"   Timeout: {timeout} seconds ({timeout // 60} minutes)")
         print()
 
         # Record initial state
@@ -652,11 +651,11 @@ rm {prompt_file}
             print()
 
             result = subprocess.run(
-                ['claude', '--dangerously-skip-permissions', prompt_file],
+                ["claude", "--dangerously-skip-permissions", prompt_file],
                 capture_output=True,
                 text=True,
                 timeout=timeout,
-                cwd=str(self.skill_dir)  # Run from skill directory
+                cwd=str(self.skill_dir),  # Run from skill directory
             )
 
             elapsed = time.time() - start_time
@@ -681,21 +680,21 @@ rm {prompt_file}
 
                         return True
                     else:
-                        print(f"⚠️  Claude finished but SKILL.md was not updated")
+                        print("⚠️  Claude finished but SKILL.md was not updated")
                         print(f"   Initial: mtime={initial_mtime}, size={initial_size}")
                         print(f"   Final:   mtime={new_mtime}, size={new_size}")
-                        print(f"   This might indicate an error during enhancement")
+                        print("   This might indicate an error during enhancement")
                         print()
                         # Show last 20 lines of stdout for debugging
                         if result.stdout:
                             print("   Last output from Claude:")
-                            lines = result.stdout.strip().split('\n')[-20:]
+                            lines = result.stdout.strip().split("\n")[-20:]
                             for line in lines:
                                 print(f"   | {line}")
                         print()
                         return False
                 else:
-                    print(f"❌ SKILL.md not found after enhancement")
+                    print("❌ SKILL.md not found after enhancement")
                     return False
             else:
                 print(f"❌ Claude Code returned error (exit code: {result.returncode})")
@@ -750,9 +749,9 @@ rm {prompt_file}
         Returns:
             bool: True if background task started successfully
         """
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print(f"BACKGROUND ENHANCEMENT: {self.skill_dir.name}")
-        print(f"{'='*60}\n")
+        print(f"{'=' * 60}\n")
 
         # Write initial status
         self.write_status("pending", "Starting background enhancement...")
@@ -764,9 +763,7 @@ rm {prompt_file}
 
                 # Read reference files
                 references = read_reference_files(
-                    self.skill_dir,
-                    max_chars=LOCAL_CONTENT_LIMIT,
-                    preview_limit=LOCAL_PREVIEW_LIMIT
+                    self.skill_dir, max_chars=LOCAL_CONTENT_LIMIT, preview_limit=LOCAL_PREVIEW_LIMIT
                 )
 
                 if not references:
@@ -785,7 +782,7 @@ rm {prompt_file}
                     return
 
                 # Save prompt to temp file
-                with tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False, encoding='utf-8') as f:
+                with tempfile.NamedTemporaryFile(mode="w", suffix=".txt", delete=False, encoding="utf-8") as f:
                     prompt_file = f.name
                     f.write(prompt)
 
@@ -794,12 +791,7 @@ rm {prompt_file}
                 # Run enhancement
                 if headless:
                     # Run headless (subprocess.run - blocking in thread)
-                    result = subprocess.run(
-                        ['claude', prompt_file],
-                        capture_output=True,
-                        text=True,
-                        timeout=timeout
-                    )
+                    result = subprocess.run(["claude", prompt_file], capture_output=True, text=True, timeout=timeout)
 
                     # Clean up
                     try:
@@ -848,9 +840,9 @@ rm {prompt_file}
         Returns:
             bool: True if daemon started successfully
         """
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print(f"DAEMON MODE: {self.skill_dir.name}")
-        print(f"{'='*60}\n")
+        print(f"{'=' * 60}\n")
 
         # Write initial status
         self.write_status("pending", "Starting daemon process...")
@@ -939,7 +931,7 @@ except Exception as e:
 
         # Save daemon script
         daemon_script_path = self.skill_dir / ".enhancement_daemon.py"
-        daemon_script_path.write_text(daemon_script, encoding='utf-8')
+        daemon_script_path.write_text(daemon_script, encoding="utf-8")
         daemon_script_path.chmod(0o755)
 
         # Start daemon process (fully detached)
@@ -950,19 +942,16 @@ except Exception as e:
             if self.force:
                 # Force mode: No output, fully silent
                 subprocess.Popen(
-                    ['nohup', 'python3', str(daemon_script_path)],
+                    ["nohup", "python3", str(daemon_script_path)],
                     stdout=subprocess.DEVNULL,
                     stderr=subprocess.DEVNULL,
-                    start_new_session=True
+                    start_new_session=True,
                 )
             else:
                 # Normal mode: Log to file
-                with open(log_file, 'w') as log:
+                with open(log_file, "w") as log:
                     subprocess.Popen(
-                        ['nohup', 'python3', str(daemon_script_path)],
-                        stdout=log,
-                        stderr=log,
-                        start_new_session=True
+                        ["nohup", "python3", str(daemon_script_path)], stdout=log, stderr=log, start_new_session=True
                     )
 
             # Give daemon time to start
@@ -971,7 +960,7 @@ except Exception as e:
             # Read status to verify it started
             status = self.read_status()
 
-            if status and status.get('status') in ['pending', 'running']:
+            if status and status.get("status") in ["pending", "running"]:
                 print("✅ Daemon process started successfully!")
                 print()
                 print("📊 Monitoring:")
@@ -1032,43 +1021,31 @@ Mode Comparison:
 Force Mode (Default ON):
   By default, all modes skip confirmations (auto-yes).
   Use --no-force to enable confirmation prompts.
-"""
+""",
+    )
+
+    parser.add_argument("skill_directory", help="Path to skill directory (e.g., output/react/)")
+
+    parser.add_argument(
+        "--interactive-enhancement",
+        action="store_true",
+        help="Open terminal window for enhancement (default: headless mode)",
     )
 
     parser.add_argument(
-        'skill_directory',
-        help='Path to skill directory (e.g., output/react/)'
+        "--background", action="store_true", help="Run in background and return immediately (non-blocking)"
+    )
+
+    parser.add_argument("--daemon", action="store_true", help="Run as persistent daemon process (fully detached)")
+
+    parser.add_argument(
+        "--no-force",
+        action="store_true",
+        help="Disable force mode: enable confirmation prompts (default: force mode ON)",
     )
 
     parser.add_argument(
-        '--interactive-enhancement',
-        action='store_true',
-        help='Open terminal window for enhancement (default: headless mode)'
-    )
-
-    parser.add_argument(
-        '--background',
-        action='store_true',
-        help='Run in background and return immediately (non-blocking)'
-    )
-
-    parser.add_argument(
-        '--daemon',
-        action='store_true',
-        help='Run as persistent daemon process (fully detached)'
-    )
-
-    parser.add_argument(
-        '--no-force',
-        action='store_true',
-        help='Disable force mode: enable confirmation prompts (default: force mode ON)'
-    )
-
-    parser.add_argument(
-        '--timeout',
-        type=int,
-        default=600,
-        help='Timeout in seconds for headless mode (default: 600 = 10 minutes)'
+        "--timeout", type=int, default=600, help="Timeout in seconds for headless mode (default: 600 = 10 minutes)"
     )
 
     args = parser.parse_args()
@@ -1084,12 +1061,7 @@ Force Mode (Default ON):
     # Force mode is ON by default, use --no-force to disable
     enhancer = LocalSkillEnhancer(args.skill_directory, force=not args.no_force)
     headless = not args.interactive_enhancement  # Invert: default is headless
-    success = enhancer.run(
-        headless=headless,
-        timeout=args.timeout,
-        background=args.background,
-        daemon=args.daemon
-    )
+    success = enhancer.run(headless=headless, timeout=args.timeout, background=args.background, daemon=args.daemon)
 
     sys.exit(0 if success else 1)
 
diff --git a/src/skill_seekers/cli/enhance_status.py b/src/skill_seekers/cli/enhance_status.py
index 4a76e58..8590f64 100644
--- a/src/skill_seekers/cli/enhance_status.py
+++ b/src/skill_seekers/cli/enhance_status.py
@@ -10,9 +10,8 @@ Usage:
     skill-seekers enhance-status output/react/ --json
 """
 
-import os
-import sys
 import json
+import sys
 import time
 from pathlib import Path
 
@@ -32,7 +31,7 @@ def read_status(skill_dir):
         return None
 
     try:
-        return json.loads(status_file.read_text(encoding='utf-8'))
+        return json.loads(status_file.read_text(encoding="utf-8"))
     except Exception as e:
         return {"error": f"Failed to read status: {e}"}
 
@@ -53,26 +52,21 @@ def format_status(status):
         return f"❌ {status['error']}"
 
     # Status emoji mapping
-    status_emojis = {
-        "pending": "⏳",
-        "running": "🔄",
-        "completed": "✅",
-        "failed": "❌"
-    }
+    status_emojis = {"pending": "⏳", "running": "🔄", "completed": "✅", "failed": "❌"}
 
-    emoji = status_emojis.get(status.get('status', ''), '❓')
-    status_text = status.get('status', 'unknown').upper()
-    message = status.get('message', '')
-    progress = status.get('progress', 0.0)
-    timestamp = status.get('timestamp', 'unknown')
-    error = status.get('error')
-    pid = status.get('pid')
+    emoji = status_emojis.get(status.get("status", ""), "❓")
+    status_text = status.get("status", "unknown").upper()
+    message = status.get("message", "")
+    progress = status.get("progress", 0.0)
+    timestamp = status.get("timestamp", "unknown")
+    error = status.get("error")
+    pid = status.get("pid")
 
     # Build output
     lines = []
-    lines.append(f"\n{'='*60}")
+    lines.append(f"\n{'=' * 60}")
     lines.append(f"ENHANCEMENT STATUS: {status_text}")
-    lines.append(f"{'='*60}\n")
+    lines.append(f"{'=' * 60}\n")
 
     lines.append(f"{emoji} Status: {status_text}")
 
@@ -81,7 +75,7 @@ def format_status(status):
 
     if progress > 0:
         progress_pct = int(progress * 100)
-        progress_bar = '█' * (progress_pct // 5) + '░' * (20 - progress_pct // 5)
+        progress_bar = "█" * (progress_pct // 5) + "░" * (20 - progress_pct // 5)
         lines.append(f"   Progress: [{progress_bar}] {progress_pct}%")
 
     if pid:
@@ -94,7 +88,7 @@ def format_status(status):
 
     lines.append("")
 
-    return '\n'.join(lines)
+    return "\n".join(lines)
 
 
 def watch_status(skill_dir, interval=2):
@@ -106,7 +100,7 @@ def watch_status(skill_dir, interval=2):
     """
     print(f"👀 Watching enhancement status for: {skill_dir}")
     print(f"   Update interval: {interval} seconds")
-    print(f"   Press Ctrl+C to stop\n")
+    print("   Press Ctrl+C to stop\n")
 
     try:
         last_status = None
@@ -123,7 +117,7 @@ def watch_status(skill_dir, interval=2):
                 last_status = status
 
                 # Exit if completed or failed
-                if status and status.get('status') in ['completed', 'failed']:
+                if status and status.get("status") in ["completed", "failed"]:
                     break
 
             time.sleep(interval)
@@ -149,32 +143,18 @@ Examples:
 
   # Get JSON output (for scripts)
   skill-seekers enhance-status output/react/ --json
-"""
+""",
     )
 
-    parser.add_argument(
-        'skill_directory',
-        help='Path to skill directory (e.g., output/react/)'
-    )
+    parser.add_argument("skill_directory", help="Path to skill directory (e.g., output/react/)")
 
     parser.add_argument(
-        '--watch', '-w',
-        action='store_true',
-        help='Watch status in real-time (updates every 2 seconds)'
+        "--watch", "-w", action="store_true", help="Watch status in real-time (updates every 2 seconds)"
     )
 
-    parser.add_argument(
-        '--json',
-        action='store_true',
-        help='Output raw JSON (for scripting)'
-    )
+    parser.add_argument("--json", action="store_true", help="Output raw JSON (for scripting)")
 
-    parser.add_argument(
-        '--interval',
-        type=int,
-        default=2,
-        help='Watch update interval in seconds (default: 2)'
-    )
+    parser.add_argument("--interval", type=int, default=2, help="Watch update interval in seconds (default: 2)")
 
     args = parser.parse_args()
 
@@ -197,9 +177,9 @@ Examples:
     # Exit code based on status
     if not status:
         sys.exit(2)  # No status found
-    elif status.get('status') == 'completed':
+    elif status.get("status") == "completed":
         sys.exit(0)  # Success
-    elif status.get('status') == 'failed':
+    elif status.get("status") == "failed":
         sys.exit(1)  # Failed
     else:
         sys.exit(0)  # In progress
diff --git a/src/skill_seekers/cli/estimate_pages.py b/src/skill_seekers/cli/estimate_pages.py
index 0527805..da68c3e 100755
--- a/src/skill_seekers/cli/estimate_pages.py
+++ b/src/skill_seekers/cli/estimate_pages.py
@@ -4,23 +4,20 @@ Page Count Estimator for Skill Seeker
 Quickly estimates how many pages a config will scrape without downloading content
 """
 
-import sys
+import json
 import os
+import sys
+import time
+from pathlib import Path
+from urllib.parse import urljoin, urlparse
+
 import requests
 from bs4 import BeautifulSoup
-from urllib.parse import urljoin, urlparse
-import time
-import json
-from pathlib import Path
 
 # Add parent directory to path for imports when run as script
 sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
-from skill_seekers.cli.constants import (
-    DEFAULT_RATE_LIMIT,
-    DEFAULT_MAX_DISCOVERY,
-    DISCOVERY_THRESHOLD
-)
+from skill_seekers.cli.constants import DEFAULT_MAX_DISCOVERY, DEFAULT_RATE_LIMIT, DISCOVERY_THRESHOLD
 
 
 def estimate_pages(config, max_discovery=DEFAULT_MAX_DISCOVERY, timeout=30):
@@ -35,20 +32,20 @@ def estimate_pages(config, max_discovery=DEFAULT_MAX_DISCOVERY, timeout=30):
     Returns:
         dict with estimation results
     """
-    base_url = config['base_url']
-    start_urls = config.get('start_urls', [base_url])
-    url_patterns = config.get('url_patterns', {'include': [], 'exclude': []})
-    rate_limit = config.get('rate_limit', DEFAULT_RATE_LIMIT)
+    base_url = config["base_url"]
+    start_urls = config.get("start_urls", [base_url])
+    url_patterns = config.get("url_patterns", {"include": [], "exclude": []})
+    rate_limit = config.get("rate_limit", DEFAULT_RATE_LIMIT)
 
     visited = set()
     pending = list(start_urls)
     discovered = 0
 
-    include_patterns = url_patterns.get('include', [])
-    exclude_patterns = url_patterns.get('exclude', [])
+    include_patterns = url_patterns.get("include", [])
+    exclude_patterns = url_patterns.get("exclude", [])
 
     # Handle unlimited mode
-    unlimited = (max_discovery == -1 or max_discovery is None)
+    unlimited = max_discovery == -1 or max_discovery is None
 
     print(f"🔍 Estimating pages for: {config['name']}")
     print(f"📍 Base URL: {base_url}")
@@ -56,8 +53,8 @@ def estimate_pages(config, max_discovery=DEFAULT_MAX_DISCOVERY, timeout=30):
     print(f"⏱️  Rate limit: {rate_limit}s")
 
     if unlimited:
-        print(f"🔢 Max discovery: UNLIMITED (will discover all pages)")
-        print(f"⚠️  WARNING: This may take a long time!")
+        print("🔢 Max discovery: UNLIMITED (will discover all pages)")
+        print("⚠️  WARNING: This may take a long time!")
     else:
         print(f"🔢 Max discovery: {max_discovery}")
 
@@ -80,26 +77,26 @@ def estimate_pages(config, max_discovery=DEFAULT_MAX_DISCOVERY, timeout=30):
         if discovered % 10 == 0:
             elapsed = time.time() - start_time
             rate = discovered / elapsed if elapsed > 0 else 0
-            print(f"⏳ Discovered: {discovered} pages ({rate:.1f} pages/sec)", end='\r')
+            print(f"⏳ Discovered: {discovered} pages ({rate:.1f} pages/sec)", end="\r")
 
         try:
             # HEAD request first to check if page exists (faster)
             head_response = requests.head(url, timeout=timeout, allow_redirects=True)
 
             # Skip non-HTML content
-            content_type = head_response.headers.get('Content-Type', '')
-            if 'text/html' not in content_type:
+            content_type = head_response.headers.get("Content-Type", "")
+            if "text/html" not in content_type:
                 continue
 
             # Now GET the page to find links
             response = requests.get(url, timeout=timeout)
             response.raise_for_status()
 
-            soup = BeautifulSoup(response.content, 'html.parser')
+            soup = BeautifulSoup(response.content, "html.parser")
 
             # Find all links
-            for link in soup.find_all('a', href=True):
-                href = link['href']
+            for link in soup.find_all("a", href=True):
+                href = link["href"]
                 full_url = urljoin(url, href)
 
                 # Normalize URL
@@ -117,10 +114,10 @@ def estimate_pages(config, max_discovery=DEFAULT_MAX_DISCOVERY, timeout=30):
             # Rate limiting
             time.sleep(rate_limit)
 
-        except requests.RequestException as e:
+        except requests.RequestException:
             # Silently skip errors during estimation
             pass
-        except Exception as e:
+        except Exception:
             # Silently skip other errors
             pass
 
@@ -128,13 +125,13 @@ def estimate_pages(config, max_discovery=DEFAULT_MAX_DISCOVERY, timeout=30):
 
     # Results
     results = {
-        'discovered': discovered,
-        'pending': len(pending),
-        'estimated_total': discovered + len(pending),
-        'elapsed_seconds': round(elapsed, 2),
-        'discovery_rate': round(discovered / elapsed if elapsed > 0 else 0, 2),
-        'hit_limit': (not unlimited) and (discovered >= max_discovery),
-        'unlimited': unlimited
+        "discovered": discovered,
+        "pending": len(pending),
+        "estimated_total": discovered + len(pending),
+        "elapsed_seconds": round(elapsed, 2),
+        "discovery_rate": round(discovered / elapsed if elapsed > 0 else 0, 2),
+        "hit_limit": (not unlimited) and (discovered >= max_discovery),
+        "unlimited": unlimited,
     }
 
     return results
@@ -143,7 +140,7 @@ def estimate_pages(config, max_discovery=DEFAULT_MAX_DISCOVERY, timeout=30):
 def is_valid_url(url, base_url, include_patterns, exclude_patterns):
     """Check if URL should be crawled"""
     # Must be same domain
-    if not url.startswith(base_url.rstrip('/')):
+    if not url.startswith(base_url.rstrip("/")):
         return False
 
     # Check exclude patterns first
@@ -180,11 +177,11 @@ def print_results(results, config):
     print(f"⏱️  Time Elapsed: {results['elapsed_seconds']}s")
     print(f"⚡ Discovery Rate: {results['discovery_rate']} pages/sec")
 
-    if results.get('unlimited', False):
+    if results.get("unlimited", False):
         print()
         print("✅ UNLIMITED MODE - Discovered all reachable pages")
         print(f"   Total pages: {results['estimated_total']}")
-    elif results['hit_limit']:
+    elif results["hit_limit"]:
         print()
         print("⚠️  Hit discovery limit - actual total may be higher")
         print("   Increase max_discovery parameter for more accurate estimate")
@@ -195,8 +192,8 @@ def print_results(results, config):
     print("=" * 70)
     print()
 
-    estimated = results['estimated_total']
-    current_max = config.get('max_pages', 100)
+    estimated = results["estimated_total"]
+    current_max = config.get("max_pages", 100)
 
     if estimated <= current_max:
         print(f"✅ Current max_pages ({current_max}) is sufficient")
@@ -207,7 +204,7 @@ def print_results(results, config):
         print(f"   (Estimated {estimated} + 50 buffer)")
 
     # Estimate time for full scrape
-    rate_limit = config.get('rate_limit', DEFAULT_RATE_LIMIT)
+    rate_limit = config.get("rate_limit", DEFAULT_RATE_LIMIT)
     estimated_time = (estimated * rate_limit) / 60  # in minutes
 
     print()
@@ -220,7 +217,7 @@ def print_results(results, config):
 def load_config(config_path):
     """Load configuration from JSON file"""
     try:
-        with open(config_path, 'r') as f:
+        with open(config_path) as f:
             config = json.load(f)
         return config
     except FileNotFoundError:
@@ -298,7 +295,7 @@ def list_all_configs():
 
         # Try to load the config to get name and description
         try:
-            with open(config_file, 'r') as f:
+            with open(config_file) as f:
                 config_data = json.load(f)
 
             name = config_data.get("name", config_file.stem)
@@ -308,20 +305,19 @@ def list_all_configs():
             if len(description) > 60:
                 description = description[:57] + "..."
 
-            by_category[category].append({
-                "file": config_file.name,
-                "path": str(rel_path),
-                "name": name,
-                "description": description
-            })
+            by_category[category].append(
+                {"file": config_file.name, "path": str(rel_path), "name": name, "description": description}
+            )
         except Exception as e:
             # If we can't parse the config, just use the filename
-            by_category[category].append({
-                "file": config_file.name,
-                "path": str(rel_path),
-                "name": config_file.stem,
-                "description": f"⚠️  Error loading config: {e}"
-            })
+            by_category[category].append(
+                {
+                    "file": config_file.name,
+                    "path": str(rel_path),
+                    "name": config_file.stem,
+                    "description": f"⚠️  Error loading config: {e}",
+                }
+            )
 
     # Print configs by category
     total = 0
@@ -351,7 +347,7 @@ def main():
     import argparse
 
     parser = argparse.ArgumentParser(
-        description='Estimate page count for Skill Seeker configs',
+        description="Estimate page count for Skill Seeker configs",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -366,18 +362,25 @@ Examples:
 
   # Quick estimate (stop at 100 pages)
   skill-seekers estimate configs/vue.json --max-discovery 100
-        """
+        """,
     )
 
-    parser.add_argument('config', nargs='?', help='Path to config JSON file')
-    parser.add_argument('--all', action='store_true',
-                       help='List all available configs from api/configs_repo/official/')
-    parser.add_argument('--max-discovery', '-m', type=int, default=DEFAULT_MAX_DISCOVERY,
-                       help=f'Maximum pages to discover (default: {DEFAULT_MAX_DISCOVERY}, use -1 for unlimited)')
-    parser.add_argument('--unlimited', '-u', action='store_true',
-                       help='Remove discovery limit - discover all pages (same as --max-discovery -1)')
-    parser.add_argument('--timeout', '-t', type=int, default=30,
-                       help='HTTP request timeout in seconds (default: 30)')
+    parser.add_argument("config", nargs="?", help="Path to config JSON file")
+    parser.add_argument("--all", action="store_true", help="List all available configs from api/configs_repo/official/")
+    parser.add_argument(
+        "--max-discovery",
+        "-m",
+        type=int,
+        default=DEFAULT_MAX_DISCOVERY,
+        help=f"Maximum pages to discover (default: {DEFAULT_MAX_DISCOVERY}, use -1 for unlimited)",
+    )
+    parser.add_argument(
+        "--unlimited",
+        "-u",
+        action="store_true",
+        help="Remove discovery limit - discover all pages (same as --max-discovery -1)",
+    )
+    parser.add_argument("--timeout", "-t", type=int, default=30, help="HTTP request timeout in seconds (default: 30)")
 
     args = parser.parse_args()
 
@@ -401,7 +404,7 @@ Examples:
         print_results(results, config)
 
         # Return exit code based on results
-        if results['hit_limit']:
+        if results["hit_limit"]:
             return 2  # Warning: hit limit
         return 0  # Success
 
@@ -413,5 +416,5 @@ Examples:
         return 1
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(main())
diff --git a/src/skill_seekers/cli/generate_router.py b/src/skill_seekers/cli/generate_router.py
index 72eef9d..7f501a4 100644
--- a/src/skill_seekers/cli/generate_router.py
+++ b/src/skill_seekers/cli/generate_router.py
@@ -12,17 +12,17 @@ Phase 4 enhancements:
 - GitHub issue links for context
 """
 
+import argparse
 import json
 import sys
-import argparse
 from pathlib import Path
-from typing import Dict, List, Any, Tuple, Optional
+from typing import Any, Optional
 
 # Import three-stream data classes (Phase 1)
 try:
-    from .github_fetcher import ThreeStreamData, DocsStream, InsightsStream
-    from .merge_sources import categorize_issues_by_topic
+    from .github_fetcher import DocsStream, InsightsStream, ThreeStreamData
     from .markdown_cleaner import MarkdownCleaner
+    from .merge_sources import categorize_issues_by_topic
 except ImportError:
     # Fallback if github_fetcher not available
     ThreeStreamData = None
@@ -34,10 +34,9 @@ except ImportError:
 class RouterGenerator:
     """Generates router skills that direct to specialized sub-skills with GitHub integration"""
 
-    def __init__(self,
-                 config_paths: List[str],
-                 router_name: str = None,
-                 github_streams: Optional['ThreeStreamData'] = None):
+    def __init__(
+        self, config_paths: list[str], router_name: str = None, github_streams: Optional["ThreeStreamData"] = None
+    ):
         """
         Initialize router generator with optional GitHub streams.
 
@@ -60,21 +59,21 @@ class RouterGenerator:
         if github_streams and github_streams.insights_stream:
             self.github_metadata = github_streams.insights_stream.metadata
             self.github_issues = {
-                'common_problems': github_streams.insights_stream.common_problems,
-                'known_solutions': github_streams.insights_stream.known_solutions,
-                'top_labels': github_streams.insights_stream.top_labels
+                "common_problems": github_streams.insights_stream.common_problems,
+                "known_solutions": github_streams.insights_stream.known_solutions,
+                "top_labels": github_streams.insights_stream.top_labels,
             }
 
         if github_streams and github_streams.docs_stream:
             self.github_docs = {
-                'readme': github_streams.docs_stream.readme,
-                'contributing': github_streams.docs_stream.contributing
+                "readme": github_streams.docs_stream.readme,
+                "contributing": github_streams.docs_stream.contributing,
             }
 
-    def load_config(self, path: Path) -> Dict[str, Any]:
+    def load_config(self, path: Path) -> dict[str, Any]:
         """Load a config file"""
         try:
-            with open(path, 'r') as f:
+            with open(path) as f:
                 return json.load(f)
         except Exception as e:
             print(f"❌ Error loading {path}: {e}")
@@ -83,17 +82,17 @@ class RouterGenerator:
     def infer_router_name(self) -> str:
         """Infer router name from sub-skill names"""
         # Find common prefix
-        names = [cfg['name'] for cfg in self.configs]
+        names = [cfg["name"] for cfg in self.configs]
         if not names:
             return "router"
 
         # Get common prefix before first dash
         first_name = names[0]
-        if '-' in first_name:
-            return first_name.split('-')[0]
+        if "-" in first_name:
+            return first_name.split("-")[0]
         return first_name
 
-    def extract_routing_keywords(self) -> Dict[str, List[str]]:
+    def extract_routing_keywords(self) -> dict[str, list[str]]:
         """
         Extract keywords for routing to each skill (Phase 4 enhanced).
 
@@ -103,26 +102,26 @@ class RouterGenerator:
         routing = {}
 
         for config in self.configs:
-            name = config['name']
+            name = config["name"]
             keywords = []
 
             # Extract from categories (base weight: 1x)
-            if 'categories' in config:
-                keywords.extend(config['categories'].keys())
+            if "categories" in config:
+                keywords.extend(config["categories"].keys())
 
             # Extract from name (part after dash)
-            if '-' in name:
-                skill_topic = name.split('-', 1)[1]
+            if "-" in name:
+                skill_topic = name.split("-", 1)[1]
                 keywords.append(skill_topic)
 
             # Phase 4: Add GitHub issue labels (weight 2x by including twice)
             if self.github_issues:
                 # Get top labels related to this skill topic
-                top_labels = self.github_issues.get('top_labels', [])
+                top_labels = self.github_issues.get("top_labels", [])
                 skill_keywords = set(keywords)
 
                 for label_info in top_labels[:10]:  # Top 10 labels
-                    label = label_info['label'].lower()
+                    label = label_info["label"].lower()
 
                     # Check if label relates to any skill keyword
                     if any(keyword.lower() in label or label in keyword.lower() for keyword in skill_keywords):
@@ -141,7 +140,7 @@ class RouterGenerator:
 
         return routing
 
-    def _extract_skill_specific_labels(self, skill_name: str, skill_keywords: set) -> List[str]:
+    def _extract_skill_specific_labels(self, skill_name: str, skill_keywords: set) -> list[str]:
         """
         Extract labels from GitHub issues that match this specific skill.
 
@@ -159,14 +158,14 @@ class RouterGenerator:
         if not self.github_issues:
             return []
 
-        common_problems = self.github_issues.get('common_problems', [])
-        known_solutions = self.github_issues.get('known_solutions', [])
+        common_problems = self.github_issues.get("common_problems", [])
+        known_solutions = self.github_issues.get("known_solutions", [])
         all_issues = common_problems + known_solutions
 
         matching_labels = set()
 
         for issue in all_issues:
-            issue_labels = issue.get('labels', [])
+            issue_labels = issue.get("labels", [])
             issue_labels_lower = [label.lower() for label in issue_labels]
 
             # Check if this issue relates to the skill
@@ -180,13 +179,20 @@ class RouterGenerator:
                 # Add ALL labels from this matching issue
                 for label in issue_labels_lower:
                     # Skip generic labels that don't add routing value
-                    if label not in ['bug', 'enhancement', 'question', 'help wanted',
-                                   'good first issue', 'documentation', 'duplicate']:
+                    if label not in [
+                        "bug",
+                        "enhancement",
+                        "question",
+                        "help wanted",
+                        "good first issue",
+                        "documentation",
+                        "duplicate",
+                    ]:
                         matching_labels.add(label)
 
         return list(matching_labels)
 
-    def _generate_frontmatter(self, routing_keywords: Dict[str, List[str]]) -> str:
+    def _generate_frontmatter(self, routing_keywords: dict[str, list[str]]) -> str:
         """
         Generate YAML frontmatter compliant with agentskills.io spec.
 
@@ -201,16 +207,16 @@ class RouterGenerator:
         # Build comprehensive description from all sub-skills
         all_topics = []
         for config in self.configs:
-            desc = config.get('description', '')
+            desc = config.get("description", "")
             # Extract key topics from description (simple extraction)
-            topics = [word.strip() for word in desc.split(',') if word.strip()]
+            topics = [word.strip() for word in desc.split(",") if word.strip()]
             all_topics.extend(topics[:2])  # Max 2 topics per skill
 
         # Create keyword-rich description
         unique_topics = list(dict.fromkeys(all_topics))[:7]  # Top 7 unique topics
 
         if unique_topics:
-            topics_str = ', '.join(unique_topics)
+            topics_str = ", ".join(unique_topics)
             description = f"{self.router_name.title()} framework. Use when working with: {topics_str}"
         else:
             description = f"Use when working with {self.router_name.title()} development and programming"
@@ -225,21 +231,21 @@ class RouterGenerator:
 
         # Try to get language-specific compatibility if GitHub metadata available
         if self.github_metadata:
-            language = self.github_metadata.get('language', '')
+            language = self.github_metadata.get("language", "")
             compatibility_map = {
-                'Python': f'Python 3.10+, requires {self.router_name} package',
-                'JavaScript': f'Node.js 18+, requires {self.router_name} package',
-                'TypeScript': f'Node.js 18+, TypeScript 5+, requires {self.router_name} package',
-                'Go': f'Go 1.20+, requires {self.router_name} package',
-                'Rust': f'Rust 1.70+, requires {self.router_name} package',
-                'Java': f'Java 17+, requires {self.router_name} package',
+                "Python": f"Python 3.10+, requires {self.router_name} package",
+                "JavaScript": f"Node.js 18+, requires {self.router_name} package",
+                "TypeScript": f"Node.js 18+, TypeScript 5+, requires {self.router_name} package",
+                "Go": f"Go 1.20+, requires {self.router_name} package",
+                "Rust": f"Rust 1.70+, requires {self.router_name} package",
+                "Java": f"Java 17+, requires {self.router_name} package",
             }
             if language in compatibility_map:
                 compatibility = compatibility_map[language]
 
             # Try to extract license
-            if isinstance(self.github_metadata.get('license'), dict):
-                license_info = self.github_metadata['license'].get('name', 'MIT')
+            if isinstance(self.github_metadata.get("license"), dict):
+                license_info = self.github_metadata["license"].get("name", "MIT")
 
         frontmatter = f"""---
 name: {self.router_name}
@@ -289,27 +295,27 @@ compatibility: {compatibility}
         """
         # Remove router name prefix
         if skill_name.startswith(f"{self.router_name}-"):
-            topic = skill_name[len(self.router_name)+1:]
+            topic = skill_name[len(self.router_name) + 1 :]
         else:
             topic = skill_name
 
         # Capitalize and add context
-        topic = topic.replace('-', ' ').title()
+        topic = topic.replace("-", " ").title()
 
         # Add common suffixes for context
         topic_map = {
-            'oauth': 'OAuth authentication',
-            'auth': 'authentication',
-            'async': 'async patterns',
-            'api': 'API integration',
-            'orm': 'ORM queries',
-            'hooks': 'hooks',
-            'routing': 'routing',
-            'testing': 'testing',
-            '2d': '2D development',
-            '3d': '3D development',
-            'scripting': 'scripting',
-            'physics': 'physics',
+            "oauth": "OAuth authentication",
+            "auth": "authentication",
+            "async": "async patterns",
+            "api": "API integration",
+            "orm": "ORM queries",
+            "hooks": "hooks",
+            "routing": "routing",
+            "testing": "testing",
+            "2d": "2D development",
+            "3d": "3D development",
+            "scripting": "scripting",
+            "physics": "physics",
         }
 
         topic_lower = topic.lower()
@@ -319,7 +325,7 @@ compatibility: {compatibility}
 
         return topic
 
-    def _generate_dynamic_examples(self, routing_keywords: Dict[str, List[str]]) -> str:
+    def _generate_dynamic_examples(self, routing_keywords: dict[str, list[str]]) -> str:
         """
         Generate examples dynamically from actual sub-skill names and keywords.
 
@@ -351,10 +357,7 @@ compatibility: {compatibility}
             topic = self._extract_topic_from_skill(first_skill)
             keyword = first_keywords[0] if first_keywords else topic
 
-            examples.append(
-                f'**Q:** "How do I implement {keyword}?"\n'
-                f'**A:** Activates {first_skill} skill'
-            )
+            examples.append(f'**Q:** "How do I implement {keyword}?"\n**A:** Activates {first_skill} skill')
 
         # Example 2: Different skill (second sub-skill if available)
         if len(skill_names) >= 2:
@@ -365,8 +368,7 @@ compatibility: {compatibility}
             keyword = second_keywords[0] if second_keywords else topic
 
             examples.append(
-                f'**Q:** "Working with {keyword} in {self.router_name.title()}"\n'
-                f'**A:** Activates {second_skill} skill'
+                f'**Q:** "Working with {keyword} in {self.router_name.title()}"\n**A:** Activates {second_skill} skill'
             )
 
         # Example 3: Multi-skill activation (if 2+ skills)
@@ -378,13 +380,12 @@ compatibility: {compatibility}
             topic_2 = self._extract_topic_from_skill(skill_2)
 
             examples.append(
-                f'**Q:** "Combining {topic_1} with {topic_2}"\n'
-                f'**A:** Activates {skill_1} + {skill_2} skills'
+                f'**Q:** "Combining {topic_1} with {topic_2}"\n**A:** Activates {skill_1} + {skill_2} skills'
             )
 
-        return '\n\n'.join(examples)
+        return "\n\n".join(examples)
 
-    def _generate_examples_from_github(self, routing_keywords: Dict[str, List[str]]) -> str:
+    def _generate_examples_from_github(self, routing_keywords: dict[str, list[str]]) -> str:
         """
         Generate examples from real GitHub issue titles.
 
@@ -402,7 +403,7 @@ compatibility: {compatibility}
             return self._generate_dynamic_examples(routing_keywords)
 
         examples = []
-        common_problems = self.github_issues.get('common_problems', [])
+        common_problems = self.github_issues.get("common_problems", [])
 
         if not common_problems:
             return self._generate_dynamic_examples(routing_keywords)
@@ -414,29 +415,26 @@ compatibility: {compatibility}
 
             # Find first issue matching this skill's keywords
             for issue in common_problems:
-                issue_labels = [label.lower() for label in issue.get('labels', [])]
+                issue_labels = [label.lower() for label in issue.get("labels", [])]
                 if any(label in skill_keywords_lower for label in issue_labels):
                     matched_issue = issue
                     common_problems.remove(issue)  # Don't reuse same issue
                     break
 
             if matched_issue:
-                title = matched_issue.get('title', '')
+                title = matched_issue.get("title", "")
                 question = self._convert_issue_to_question(title)
-                examples.append(
-                    f'**Q:** "{question}"\n'
-                    f'**A:** Activates {skill_name} skill'
-                )
+                examples.append(f'**Q:** "{question}"\n**A:** Activates {skill_name} skill')
             else:
                 # Fallback to keyword-based example for this skill
                 topic = self._extract_topic_from_skill(skill_name)
                 keyword = keywords[0] if keywords else topic
                 examples.append(
                     f'**Q:** "Working with {keyword} in {self.router_name.title()}"\n'
-                    f'**A:** Activates {skill_name} skill'
+                    f"**A:** Activates {skill_name} skill"
                 )
 
-        return '\n\n'.join(examples) if examples else self._generate_dynamic_examples(routing_keywords)
+        return "\n\n".join(examples) if examples else self._generate_dynamic_examples(routing_keywords)
 
     def _convert_issue_to_question(self, issue_title: str) -> str:
         """
@@ -456,24 +454,24 @@ compatibility: {compatibility}
         title_lower = issue_title.lower()
 
         # Pattern 1: Error/Failure issues
-        if 'fail' in title_lower or 'error' in title_lower or 'issue' in title_lower:
-            cleaned = issue_title.replace(' fails', '').replace(' errors', '').replace(' issue', '')
+        if "fail" in title_lower or "error" in title_lower or "issue" in title_lower:
+            cleaned = issue_title.replace(" fails", "").replace(" errors", "").replace(" issue", "")
             return f"How do I fix {cleaned.lower()}?"
 
         # Pattern 2: Documentation requests
-        if 'documentation' in title_lower or 'docs' in title_lower:
-            cleaned = issue_title.replace(' documentation', '').replace(' docs', '')
+        if "documentation" in title_lower or "docs" in title_lower:
+            cleaned = issue_title.replace(" documentation", "").replace(" docs", "")
             return f"How do I use {cleaned.lower()}?"
 
         # Pattern 3: Feature requests
-        if title_lower.startswith('add ') or title_lower.startswith('added '):
-            feature = issue_title.replace('Add ', '').replace('Added ', '')
+        if title_lower.startswith("add ") or title_lower.startswith("added "):
+            feature = issue_title.replace("Add ", "").replace("Added ", "")
             return f"How do I implement {feature.lower()}?"
 
         # Default: Generic question
         return f"How do I handle {issue_title.lower()}?"
 
-    def _extract_common_patterns(self) -> List[Dict[str, str]]:
+    def _extract_common_patterns(self) -> list[dict[str, str]]:
         """
         Extract problem-solution patterns from closed GitHub issues.
 
@@ -487,25 +485,21 @@ compatibility: {compatibility}
         if not self.github_issues:
             return []
 
-        known_solutions = self.github_issues.get('known_solutions', [])
+        known_solutions = self.github_issues.get("known_solutions", [])
         if not known_solutions:
             return []
 
         patterns = []
 
         # Top 5 closed issues with most engagement (comments indicate usefulness)
-        top_solutions = sorted(known_solutions, key=lambda x: x.get('comments', 0), reverse=True)[:5]
+        top_solutions = sorted(known_solutions, key=lambda x: x.get("comments", 0), reverse=True)[:5]
 
         for issue in top_solutions:
-            title = issue.get('title', '')
-            number = issue.get('number', 0)
+            title = issue.get("title", "")
+            number = issue.get("number", 0)
             problem, solution = self._parse_issue_pattern(title)
 
-            patterns.append({
-                'problem': problem,
-                'solution': solution,
-                'issue_number': number
-            })
+            patterns.append({"problem": problem, "solution": solution, "issue_number": number})
 
         return patterns
 
@@ -530,24 +524,24 @@ compatibility: {compatibility}
         title_lower = issue_title.lower()
 
         # Pattern 1: "Fixed X" → "X not working" / "See fix"
-        if title_lower.startswith('fixed ') or title_lower.startswith('fix '):
-            problem_text = issue_title.replace('Fixed ', '').replace('Fix ', '')
+        if title_lower.startswith("fixed ") or title_lower.startswith("fix "):
+            problem_text = issue_title.replace("Fixed ", "").replace("Fix ", "")
             return (f"{problem_text} not working", "See fix implementation details")
 
         # Pattern 2: "Resolved X" → "X issue" / "See resolution"
-        if title_lower.startswith('resolved ') or title_lower.startswith('resolve '):
-            problem_text = issue_title.replace('Resolved ', '').replace('Resolve ', '')
+        if title_lower.startswith("resolved ") or title_lower.startswith("resolve "):
+            problem_text = issue_title.replace("Resolved ", "").replace("Resolve ", "")
             return (f"{problem_text} issue", "See resolution approach")
 
         # Pattern 3: "Added X" → "Missing X" / "Use X"
-        if title_lower.startswith('added ') or title_lower.startswith('add '):
-            feature_text = issue_title.replace('Added ', '').replace('Add ', '')
+        if title_lower.startswith("added ") or title_lower.startswith("add "):
+            feature_text = issue_title.replace("Added ", "").replace("Add ", "")
             return (f"Missing {feature_text}", f"Use {feature_text} feature")
 
         # Default: Use title as-is
         return (issue_title, "See issue for solution details")
 
-    def _detect_framework(self) -> Optional[str]:
+    def _detect_framework(self) -> str | None:
         """
         Detect framework from router name and GitHub metadata.
 
@@ -561,14 +555,14 @@ compatibility: {compatibility}
         router_lower = self.router_name.lower()
 
         framework_keywords = {
-            'fastapi': 'fastapi',
-            'django': 'django',
-            'flask': 'flask',
-            'react': 'react',
-            'vue': 'vue',
-            'express': 'express',
-            'fastmcp': 'fastmcp',
-            'mcp': 'fastmcp',
+            "fastapi": "fastapi",
+            "django": "django",
+            "flask": "flask",
+            "react": "react",
+            "vue": "vue",
+            "express": "express",
+            "fastmcp": "fastmcp",
+            "mcp": "fastmcp",
         }
 
         # Check router name first
@@ -578,7 +572,7 @@ compatibility: {compatibility}
 
         # Check GitHub description if available
         if self.github_metadata:
-            description = self.github_metadata.get('description', '').lower()
+            description = self.github_metadata.get("description", "").lower()
             for keyword, framework in framework_keywords.items():
                 if keyword in description:
                     return framework
@@ -599,7 +593,7 @@ compatibility: {compatibility}
             Formatted Quick Start section with install + hello world code
         """
         templates = {
-            'fastapi': """## Quick Start
+            "fastapi": """## Quick Start
 
 ```bash
 pip install fastapi uvicorn
@@ -617,7 +611,7 @@ def read_root():
 # Run: uvicorn main:app --reload
 ```
 """,
-            'fastmcp': """## Quick Start
+            "fastmcp": """## Quick Start
 
 ```bash
 pip install fastmcp
@@ -633,7 +627,7 @@ def greet(name: str) -> str:
     return f"Hello, {name}!"
 ```
 """,
-            'django': """## Quick Start
+            "django": """## Quick Start
 
 ```bash
 pip install django
@@ -644,7 +638,7 @@ python manage.py runserver
 
 Visit http://127.0.0.1:8000/ to see your Django app.
 """,
-            'react': """## Quick Start
+            "react": """## Quick Start
 
 ```bash
 npx create-react-app my-app
@@ -677,16 +671,16 @@ export default App;
         all_topics = []
 
         for config in self.configs:
-            desc = config.get('description', '')
+            desc = config.get("description", "")
             # Extract key topics from description (simple comma-separated extraction)
-            topics = [topic.strip() for topic in desc.split(',') if topic.strip()]
+            topics = [topic.strip() for topic in desc.split(",") if topic.strip()]
             all_topics.extend(topics[:2])  # Max 2 topics per skill
 
         # Deduplicate and take top 5-7 topics
         unique_topics = list(dict.fromkeys(all_topics))[:7]
 
         if not unique_topics:
-            return f'Use when working with {self.router_name} development and programming'
+            return f"Use when working with {self.router_name} development and programming"
 
         # Format as user-friendly bulleted list
         description = f"""Use this skill when working with:
@@ -695,8 +689,8 @@ export default App;
 
         for topic in unique_topics:
             # Clean up topic text (remove "when working with" prefixes if present)
-            topic = topic.replace('when working with', '').strip()
-            topic = topic.replace('Use when', '').strip()
+            topic = topic.replace("when working with", "").strip()
+            topic = topic.replace("Use when", "").strip()
             if topic:
                 description += f"- {topic}\n"
 
@@ -721,7 +715,10 @@ export default App;
         # NEW: Generate comprehensive description from all sub-skills
         when_to_use = self._generate_comprehensive_description()
 
-        skill_md = frontmatter + "\n\n" + f"""# {self.router_name.replace('-', ' ').title()} Documentation
+        skill_md = (
+            frontmatter
+            + "\n\n"
+            + f"""# {self.router_name.replace("-", " ").title()} Documentation
 
 ## When to Use This Skill
 
@@ -730,26 +727,27 @@ export default App;
 This is a router skill that directs your questions to specialized sub-skills for efficient, focused assistance.
 
 """
+        )
 
         # Phase 4: Add GitHub repository metadata
         if self.github_metadata:
             # NEW: Use html_url from GitHub metadata instead of base_url from config
-            repo_url = self.github_metadata.get('html_url', '')
-            stars = self.github_metadata.get('stars', 0)
-            language = self.github_metadata.get('language', 'Unknown')
-            description = self.github_metadata.get('description', '')
+            repo_url = self.github_metadata.get("html_url", "")
+            stars = self.github_metadata.get("stars", 0)
+            language = self.github_metadata.get("language", "Unknown")
+            description = self.github_metadata.get("description", "")
 
             skill_md += f"""## Repository Info
 
 **Repository:** {repo_url}
 **Stars:** ⭐ {stars:,} | **Language:** {language}
-{f'**Description:** {description}' if description else ''}
+{f"**Description:** {description}" if description else ""}
 
 """
 
         # Phase 4: Add Quick Start from README
-        if self.github_docs and self.github_docs.get('readme'):
-            readme = self.github_docs['readme']
+        if self.github_docs and self.github_docs.get("readme"):
+            readme = self.github_docs["readme"]
 
             # NEW: Clean HTML and extract meaningful content
             quick_start = self._extract_clean_readme_section(readme)
@@ -768,14 +766,20 @@ This is a router skill that directs your questions to specialized sub-skills for
                 if framework:
                     hello_world = self._get_framework_hello_world(framework)
                     if hello_world:
-                        skill_md += hello_world + "\n*Note: Generic template. See references/getting_started.md for project-specific setup.*\n\n"
+                        skill_md += (
+                            hello_world
+                            + "\n*Note: Generic template. See references/getting_started.md for project-specific setup.*\n\n"
+                        )
         else:
             # No README available - try framework fallback
             framework = self._detect_framework()
             if framework:
                 hello_world = self._get_framework_hello_world(framework)
                 if hello_world:
-                    skill_md += hello_world + "\n*Note: Generic template. Check repository for specific installation instructions.*\n\n"
+                    skill_md += (
+                        hello_world
+                        + "\n*Note: Generic template. Check repository for specific installation instructions.*\n\n"
+                    )
 
         skill_md += """## How It Works
 
@@ -785,11 +789,11 @@ This skill analyzes your question and activates the appropriate specialized skil
 
         # List sub-skills
         for config in self.configs:
-            name = config['name']
-            desc = config.get('description', '')
+            name = config["name"]
+            desc = config.get("description", "")
             # Remove router name prefix from description if present
             if desc.startswith(f"{self.router_name.title()} -"):
-                desc = desc.split(' - ', 1)[1]
+                desc = desc.split(" - ", 1)[1]
 
             skill_md += f"### {name}\n{desc}\n\n"
 
@@ -808,7 +812,7 @@ The router analyzes your question for topic keywords and activates relevant skil
             skill_md += f"- {keyword_str} → **{skill_name}**\n"
 
         # Quick reference
-        skill_md += f"""
+        skill_md += """
 
 ## Quick Reference
 
@@ -839,7 +843,7 @@ For quick answers, this router provides basic overview information. For detailed
 
         # Phase 4: Add Common Issues from GitHub (Summary with Reference)
         if self.github_issues:
-            common_problems = self.github_issues.get('common_problems', [])[:5]  # Top 5
+            common_problems = self.github_issues.get("common_problems", [])[:5]  # Top 5
 
             if common_problems:
                 skill_md += """
@@ -850,9 +854,9 @@ Top 5 GitHub issues from the community:
 
 """
                 for i, issue in enumerate(common_problems, 1):
-                    title = issue.get('title', '')
-                    number = issue.get('number', 0)
-                    comments = issue.get('comments', 0)
+                    title = issue.get("title", "")
+                    number = issue.get("number", 0)
+                    comments = issue.get("comments", 0)
 
                     skill_md += f"{i}. **{title}** (Issue #{number}, {comments} comments)\n"
 
@@ -871,9 +875,9 @@ Problem-solution patterns from resolved GitHub issues:
 
 """
                 for i, pattern in enumerate(patterns, 1):
-                    problem = pattern['problem']
-                    solution = pattern['solution']
-                    issue_num = pattern['issue_number']
+                    problem = pattern["problem"]
+                    solution = pattern["solution"]
+                    issue_num = pattern["issue_number"]
 
                     skill_md += f"**Pattern {i}**: {problem}\n"
                     skill_md += f"→ **Solution**: {solution} ([Issue #{issue_num}](references/github_issues.md))\n\n"
@@ -888,10 +892,10 @@ Detailed documentation available in:
 """
         if self.github_issues:
             skill_md += "- `references/github_issues.md` - Community problems and solutions\n"
-        if self.github_docs and self.github_docs.get('readme'):
+        if self.github_docs and self.github_docs.get("readme"):
             skill_md += "- `references/getting_started.md` - Detailed setup guide\n"
 
-        skill_md += f"""
+        skill_md += """
 
 ## Need Help?
 
@@ -904,7 +908,7 @@ Simply ask your question and mention the topic. The router will find the right s
 
         return skill_md
 
-    def generate_subskill_issues_section(self, skill_name: str, topics: List[str]) -> str:
+    def generate_subskill_issues_section(self, skill_name: str, topics: list[str]) -> str:
         """
         Generate "Common Issues" section for a sub-skill (Phase 4).
 
@@ -918,8 +922,8 @@ Simply ask your question and mention the topic. The router will find the right s
         if not self.github_issues or not categorize_issues_by_topic:
             return ""
 
-        common_problems = self.github_issues.get('common_problems', [])
-        known_solutions = self.github_issues.get('known_solutions', [])
+        common_problems = self.github_issues.get("common_problems", [])
+        known_solutions = self.github_issues.get("known_solutions", [])
 
         # Categorize issues by topic
         categorized = categorize_issues_by_topic(common_problems, known_solutions, topics)
@@ -944,11 +948,11 @@ GitHub issues related to this topic:
             issues_md += f"\n### {topic.title()}\n\n"
 
             for issue in issues[:3]:  # Top 3 per topic
-                title = issue.get('title', '')
-                number = issue.get('number', 0)
-                state = issue.get('state', 'unknown')
-                comments = issue.get('comments', 0)
-                labels = issue.get('labels', [])
+                title = issue.get("title", "")
+                number = issue.get("number", 0)
+                state = issue.get("state", "unknown")
+                comments = issue.get("comments", 0)
+                labels = issue.get("labels", [])
 
                 # Format issue
                 state_icon = "🔴" if state == "open" else "✅"
@@ -964,21 +968,24 @@ GitHub issues related to this topic:
 
         return issues_md
 
-    def create_router_config(self) -> Dict[str, Any]:
+    def create_router_config(self) -> dict[str, Any]:
         """Create router configuration"""
         routing_keywords = self.extract_routing_keywords()
 
         router_config = {
             "name": self.router_name,
-            "description": self.base_config.get('description', f'Use when working with {self.router_name} documentation (router for multiple sub-skills)'),
-            "base_url": self.base_config['base_url'],
-            "selectors": self.base_config.get('selectors', {}),
-            "url_patterns": self.base_config.get('url_patterns', {}),
-            "rate_limit": self.base_config.get('rate_limit', 0.5),
+            "description": self.base_config.get(
+                "description",
+                f"Use when working with {self.router_name} documentation (router for multiple sub-skills)",
+            ),
+            "base_url": self.base_config["base_url"],
+            "selectors": self.base_config.get("selectors", {}),
+            "url_patterns": self.base_config.get("url_patterns", {}),
+            "rate_limit": self.base_config.get("rate_limit", 0.5),
             "max_pages": 500,  # Router only scrapes overview pages
             "_router": True,
-            "_sub_skills": [cfg['name'] for cfg in self.configs],
-            "_routing_keywords": routing_keywords
+            "_sub_skills": [cfg["name"] for cfg in self.configs],
+            "_routing_keywords": routing_keywords,
         }
 
         return router_config
@@ -993,34 +1000,38 @@ GitHub issues related to this topic:
         md = "# Common GitHub Issues\n\n"
         md += "Top issues reported by the community:\n\n"
 
-        common_problems = self.github_issues.get('common_problems', [])[:10] if self.github_issues else []
-        known_solutions = self.github_issues.get('known_solutions', [])[:10] if self.github_issues else []
+        common_problems = self.github_issues.get("common_problems", [])[:10] if self.github_issues else []
+        known_solutions = self.github_issues.get("known_solutions", [])[:10] if self.github_issues else []
 
         if common_problems:
             md += "## Open Issues (Common Problems)\n\n"
             for i, issue in enumerate(common_problems, 1):
-                title = issue.get('title', '')
-                number = issue.get('number', 0)
-                comments = issue.get('comments', 0)
-                labels = issue.get('labels', [])
+                title = issue.get("title", "")
+                number = issue.get("number", 0)
+                comments = issue.get("comments", 0)
+                labels = issue.get("labels", [])
                 if isinstance(labels, list):
-                    labels_str = ', '.join(str(label) for label in labels)
+                    labels_str = ", ".join(str(label) for label in labels)
                 else:
-                    labels_str = str(labels) if labels else ''
+                    labels_str = str(labels) if labels else ""
 
                 md += f"### {i}. {title}\n\n"
                 md += f"**Issue**: #{number}\n"
                 md += f"**Comments**: {comments}\n"
                 if labels_str:
                     md += f"**Labels**: {labels_str}\n"
-                md += f"**Link**: https://github.com/{self.github_metadata.get('html_url', '').replace('https://github.com/', '')}/issues/{number}\n\n" if self.github_metadata else "\n\n"
+                md += (
+                    f"**Link**: https://github.com/{self.github_metadata.get('html_url', '').replace('https://github.com/', '')}/issues/{number}\n\n"
+                    if self.github_metadata
+                    else "\n\n"
+                )
 
         if known_solutions:
             md += "\n## Closed Issues (Known Solutions)\n\n"
             for i, issue in enumerate(known_solutions, 1):
-                title = issue.get('title', '')
-                number = issue.get('number', 0)
-                comments = issue.get('comments', 0)
+                title = issue.get("title", "")
+                number = issue.get("number", 0)
+                comments = issue.get("comments", 0)
 
                 md += f"### {i}. {title}\n\n"
                 md += f"**Issue**: #{number} (Closed)\n"
@@ -1042,8 +1053,8 @@ GitHub issues related to this topic:
         md = "# Getting Started\n\n"
         md += "*Extracted from project README*\n\n"
 
-        if self.github_docs and self.github_docs.get('readme'):
-            readme = self.github_docs['readme']
+        if self.github_docs and self.github_docs.get("readme"):
+            readme = self.github_docs["readme"]
 
             # Clean and extract full quick start section (up to 2000 chars)
             cleaner = MarkdownCleaner()
@@ -1069,16 +1080,16 @@ GitHub issues related to this topic:
         # 1. GitHub Issues Reference
         if self.github_issues:
             issues_md = self._generate_github_issues_reference()
-            with open(references_dir / 'github_issues.md', 'w') as f:
+            with open(references_dir / "github_issues.md", "w") as f:
                 f.write(issues_md)
 
         # 2. Getting Started Reference
-        if self.github_docs and self.github_docs.get('readme'):
+        if self.github_docs and self.github_docs.get("readme"):
             getting_started_md = self._generate_getting_started_reference()
-            with open(references_dir / 'getting_started.md', 'w') as f:
+            with open(references_dir / "getting_started.md", "w") as f:
                 f.write(getting_started_md)
 
-    def generate(self, output_dir: Path = None) -> Tuple[Path, Path]:
+    def generate(self, output_dir: Path = None) -> tuple[Path, Path]:
         """Generate router skill and config with progressive disclosure"""
         if output_dir is None:
             output_dir = self.config_paths[0].parent
@@ -1090,11 +1101,11 @@ GitHub issues related to this topic:
         skill_path = output_dir.parent / f"output/{self.router_name}/SKILL.md"
         skill_path.parent.mkdir(parents=True, exist_ok=True)
 
-        with open(skill_path, 'w') as f:
+        with open(skill_path, "w") as f:
             f.write(skill_md)
 
         # NEW: Create references/ directory and generate reference files
-        references_dir = skill_path.parent / 'references'
+        references_dir = skill_path.parent / "references"
         references_dir.mkdir(parents=True, exist_ok=True)
         self._generate_reference_files(references_dir)
 
@@ -1102,7 +1113,7 @@ GitHub issues related to this topic:
         router_config = self.create_router_config()
         config_path = output_dir / f"{self.router_name}.json"
 
-        with open(config_path, 'w') as f:
+        with open(config_path, "w") as f:
             json.dump(router_config, f, indent=2)
 
         return config_path, skill_path
@@ -1125,24 +1136,14 @@ Examples:
 
   # Custom output directory
   python3 generate_router.py configs/godot-*.json --output-dir configs/routers/
-        """
+        """,
     )
 
-    parser.add_argument(
-        'configs',
-        nargs='+',
-        help='Sub-skill config files'
-    )
+    parser.add_argument("configs", nargs="+", help="Sub-skill config files")
 
-    parser.add_argument(
-        '--name',
-        help='Router skill name (default: inferred from sub-skills)'
-    )
+    parser.add_argument("--name", help="Router skill name (default: inferred from sub-skills)")
 
-    parser.add_argument(
-        '--output-dir',
-        help='Output directory (default: same as input configs)'
-    )
+    parser.add_argument("--output-dir", help="Output directory (default: same as input configs)")
 
     args = parser.parse_args()
 
@@ -1150,16 +1151,16 @@ Examples:
     config_files = []
     for path_str in args.configs:
         path = Path(path_str)
-        if path.exists() and not path.stem.endswith('-router'):
+        if path.exists() and not path.stem.endswith("-router"):
             config_files.append(path_str)
 
     if not config_files:
         print("❌ Error: No valid config files provided")
         sys.exit(1)
 
-    print(f"\n{'='*60}")
+    print(f"\n{'=' * 60}")
     print("ROUTER SKILL GENERATOR")
-    print(f"{'='*60}")
+    print(f"{'=' * 60}")
     print(f"Sub-skills: {len(config_files)}")
     for cfg in config_files:
         print(f"  - {Path(cfg).stem}")
@@ -1172,11 +1173,11 @@ Examples:
     print(f"✅ Router config created: {config_path}")
     print(f"✅ Router SKILL.md created: {skill_path}")
     print("")
-    print(f"{'='*60}")
+    print(f"{'=' * 60}")
     print("NEXT STEPS")
-    print(f"{'='*60}")
+    print(f"{'=' * 60}")
     print(f"1. Review router SKILL.md: {skill_path}")
-    print(f"2. Optionally scrape router (for overview pages):")
+    print("2. Optionally scrape router (for overview pages):")
     print(f"     skill-seekers scrape --config {config_path}")
     print("3. Package router skill:")
     print(f"     skill-seekers package output/{generator.router_name}/")
diff --git a/src/skill_seekers/cli/github_fetcher.py b/src/skill_seekers/cli/github_fetcher.py
index 72146e5..5799a3d 100644
--- a/src/skill_seekers/cli/github_fetcher.py
+++ b/src/skill_seekers/cli/github_fetcher.py
@@ -12,43 +12,47 @@ This is the foundation of the unified codebase analyzer architecture.
 import os
 import subprocess
 import tempfile
+from collections import Counter
 from dataclasses import dataclass
 from pathlib import Path
-from typing import List, Dict, Optional, Tuple
-from collections import Counter
+
 import requests
 
-from .rate_limit_handler import RateLimitHandler, RateLimitError, create_github_headers
 from .config_manager import get_config_manager
+from .rate_limit_handler import RateLimitError, RateLimitHandler, create_github_headers
 
 
 @dataclass
 class CodeStream:
     """Code files for C3.x analysis."""
+
     directory: Path
-    files: List[Path]
+    files: list[Path]
 
 
 @dataclass
 class DocsStream:
     """Documentation files from repository."""
-    readme: Optional[str]
-    contributing: Optional[str]
-    docs_files: List[Dict]  # [{"path": "docs/oauth.md", "content": "..."}]
+
+    readme: str | None
+    contributing: str | None
+    docs_files: list[dict]  # [{"path": "docs/oauth.md", "content": "..."}]
 
 
 @dataclass
 class InsightsStream:
     """GitHub metadata and issues."""
-    metadata: Dict  # stars, forks, language, etc.
-    common_problems: List[Dict]
-    known_solutions: List[Dict]
-    top_labels: List[Dict]
+
+    metadata: dict  # stars, forks, language, etc.
+    common_problems: list[dict]
+    known_solutions: list[dict]
+    top_labels: list[dict]
 
 
 @dataclass
 class ThreeStreamData:
     """Complete output from GitHub fetcher."""
+
     code_stream: CodeStream
     docs_stream: DocsStream
     insights_stream: InsightsStream
@@ -73,11 +77,7 @@ class GitHubThreeStreamFetcher:
     """
 
     def __init__(
-        self,
-        repo_url: str,
-        github_token: Optional[str] = None,
-        interactive: bool = True,
-        profile_name: Optional[str] = None
+        self, repo_url: str, github_token: str | None = None, interactive: bool = True, profile_name: str | None = None
     ):
         """
         Initialize fetcher.
@@ -89,7 +89,7 @@ class GitHubThreeStreamFetcher:
             profile_name: Name of the GitHub profile being used
         """
         self.repo_url = repo_url
-        self.github_token = github_token or os.getenv('GITHUB_TOKEN')
+        self.github_token = github_token or os.getenv("GITHUB_TOKEN")
         self.owner, self.repo = self.parse_repo_url(repo_url)
         self.interactive = interactive
 
@@ -99,12 +99,10 @@ class GitHubThreeStreamFetcher:
             profile_name = config.get_profile_for_token(self.github_token)
 
         self.rate_limiter = RateLimitHandler(
-            token=self.github_token,
-            interactive=interactive,
-            profile_name=profile_name
+            token=self.github_token, interactive=interactive, profile_name=profile_name
         )
 
-    def parse_repo_url(self, url: str) -> Tuple[str, str]:
+    def parse_repo_url(self, url: str) -> tuple[str, str]:
         """
         Parse GitHub URL to extract owner and repo.
 
@@ -115,18 +113,18 @@ class GitHubThreeStreamFetcher:
             Tuple of (owner, repo)
         """
         # Remove .git suffix if present
-        if url.endswith('.git'):
+        if url.endswith(".git"):
             url = url[:-4]  # Remove last 4 characters (.git)
 
         # Handle git@ URLs (SSH format)
-        if url.startswith('git@github.com:'):
-            parts = url.replace('git@github.com:', '').split('/')
+        if url.startswith("git@github.com:"):
+            parts = url.replace("git@github.com:", "").split("/")
             if len(parts) >= 2:
                 return parts[0], parts[1]
 
         # Handle HTTPS URLs
-        if 'github.com/' in url:
-            parts = url.split('github.com/')[-1].split('/')
+        if "github.com/" in url:
+            parts = url.split("github.com/")[-1].split("/")
             if len(parts) >= 2:
                 return parts[0], parts[1]
 
@@ -150,18 +148,18 @@ class GitHubThreeStreamFetcher:
             raise RateLimitError("Rate limit check failed during startup")
 
         if output_dir is None:
-            output_dir = Path(tempfile.mkdtemp(prefix='github_fetch_'))
+            output_dir = Path(tempfile.mkdtemp(prefix="github_fetch_"))
 
         print(f"📦 Cloning {self.repo_url}...")
         local_path = self.clone_repo(output_dir)
 
-        print(f"🔍 Fetching GitHub metadata...")
+        print("🔍 Fetching GitHub metadata...")
         metadata = self.fetch_github_metadata()
 
-        print(f"🐛 Fetching issues...")
+        print("🐛 Fetching issues...")
         issues = self.fetch_issues(max_issues=100)
 
-        print(f"📂 Classifying files...")
+        print("📂 Classifying files...")
         code_files, doc_files = self.classify_files(local_path)
         print(f"  - Code: {len(code_files)} files")
         print(f"  - Docs: {len(doc_files)} files")
@@ -171,25 +169,22 @@ class GitHubThreeStreamFetcher:
 
         # Build three streams
         return ThreeStreamData(
-            code_stream=CodeStream(
-                directory=local_path,
-                files=code_files
-            ),
+            code_stream=CodeStream(directory=local_path, files=code_files),
             docs_stream=DocsStream(
-                readme=self.read_file(local_path / 'README.md'),
-                contributing=self.read_file(local_path / 'CONTRIBUTING.md'),
+                readme=self.read_file(local_path / "README.md"),
+                contributing=self.read_file(local_path / "CONTRIBUTING.md"),
                 docs_files=[
-                    {'path': str(f.relative_to(local_path)), 'content': self.read_file(f)}
+                    {"path": str(f.relative_to(local_path)), "content": self.read_file(f)}
                     for f in doc_files
-                    if f.name not in ['README.md', 'CONTRIBUTING.md']
-                ]
+                    if f.name not in ["README.md", "CONTRIBUTING.md"]
+                ],
             ),
             insights_stream=InsightsStream(
                 metadata=metadata,
-                common_problems=issue_insights['common_problems'],
-                known_solutions=issue_insights['known_solutions'],
-                top_labels=issue_insights['top_labels']
-            )
+                common_problems=issue_insights["common_problems"],
+                known_solutions=issue_insights["known_solutions"],
+                top_labels=issue_insights["top_labels"],
+            ),
         )
 
     def clone_repo(self, output_dir: Path) -> Path:
@@ -206,7 +201,7 @@ class GitHubThreeStreamFetcher:
         repo_dir.mkdir(parents=True, exist_ok=True)
 
         # Clone with depth 1 for speed
-        cmd = ['git', 'clone', '--depth', '1', self.repo_url, str(repo_dir)]
+        cmd = ["git", "clone", "--depth", "1", self.repo_url, str(repo_dir)]
         result = subprocess.run(cmd, capture_output=True, text=True)
 
         if result.returncode != 0:
@@ -214,7 +209,7 @@ class GitHubThreeStreamFetcher:
 
         return repo_dir
 
-    def fetch_github_metadata(self) -> Dict:
+    def fetch_github_metadata(self) -> dict:
         """
         Fetch repo metadata via GitHub API.
 
@@ -238,35 +233,35 @@ class GitHubThreeStreamFetcher:
             data = response.json()
 
             return {
-                'stars': data.get('stargazers_count', 0),
-                'forks': data.get('forks_count', 0),
-                'open_issues': data.get('open_issues_count', 0),
-                'language': data.get('language', 'Unknown'),
-                'description': data.get('description', ''),
-                'homepage': data.get('homepage', ''),
-                'created_at': data.get('created_at', ''),
-                'updated_at': data.get('updated_at', ''),
-                'html_url': data.get('html_url', ''),  # NEW: Repository URL
-                'license': data.get('license', {})  # NEW: License info
+                "stars": data.get("stargazers_count", 0),
+                "forks": data.get("forks_count", 0),
+                "open_issues": data.get("open_issues_count", 0),
+                "language": data.get("language", "Unknown"),
+                "description": data.get("description", ""),
+                "homepage": data.get("homepage", ""),
+                "created_at": data.get("created_at", ""),
+                "updated_at": data.get("updated_at", ""),
+                "html_url": data.get("html_url", ""),  # NEW: Repository URL
+                "license": data.get("license", {}),  # NEW: License info
             }
         except RateLimitError:
             raise
         except Exception as e:
             print(f"⚠️  Failed to fetch metadata: {e}")
             return {
-                'stars': 0,
-                'forks': 0,
-                'open_issues': 0,
-                'language': 'Unknown',
-                'description': '',
-                'homepage': '',
-                'created_at': '',
-                'updated_at': '',
-                'html_url': '',  # NEW: Repository URL
-                'license': {}  # NEW: License info
+                "stars": 0,
+                "forks": 0,
+                "open_issues": 0,
+                "language": "Unknown",
+                "description": "",
+                "homepage": "",
+                "created_at": "",
+                "updated_at": "",
+                "html_url": "",  # NEW: Repository URL
+                "license": {},  # NEW: License info
             }
 
-    def fetch_issues(self, max_issues: int = 100) -> List[Dict]:
+    def fetch_issues(self, max_issues: int = 100) -> list[dict]:
         """
         Fetch GitHub issues (open + closed).
 
@@ -279,14 +274,14 @@ class GitHubThreeStreamFetcher:
         all_issues = []
 
         # Fetch open issues
-        all_issues.extend(self._fetch_issues_page(state='open', max_count=max_issues // 2))
+        all_issues.extend(self._fetch_issues_page(state="open", max_count=max_issues // 2))
 
         # Fetch closed issues
-        all_issues.extend(self._fetch_issues_page(state='closed', max_count=max_issues // 2))
+        all_issues.extend(self._fetch_issues_page(state="closed", max_count=max_issues // 2))
 
         return all_issues
 
-    def _fetch_issues_page(self, state: str, max_count: int) -> List[Dict]:
+    def _fetch_issues_page(self, state: str, max_count: int) -> list[dict]:
         """
         Fetch one page of issues.
 
@@ -304,10 +299,10 @@ class GitHubThreeStreamFetcher:
         headers = create_github_headers(self.github_token)
 
         params = {
-            'state': state,
-            'per_page': min(max_count, 100),  # GitHub API limit
-            'sort': 'comments',
-            'direction': 'desc'
+            "state": state,
+            "per_page": min(max_count, 100),  # GitHub API limit
+            "sort": "comments",
+            "direction": "desc",
         }
 
         try:
@@ -321,7 +316,7 @@ class GitHubThreeStreamFetcher:
             issues = response.json()
 
             # Filter out pull requests (they appear in issues endpoint)
-            issues = [issue for issue in issues if 'pull_request' not in issue]
+            issues = [issue for issue in issues if "pull_request" not in issue]
 
             return issues
         except RateLimitError:
@@ -330,7 +325,7 @@ class GitHubThreeStreamFetcher:
             print(f"⚠️  Failed to fetch {state} issues: {e}")
             return []
 
-    def classify_files(self, repo_path: Path) -> Tuple[List[Path], List[Path]]:
+    def classify_files(self, repo_path: Path) -> tuple[list[Path], list[Path]]:
         """
         Split files into code vs documentation.
 
@@ -354,36 +349,61 @@ class GitHubThreeStreamFetcher:
 
         # Documentation patterns
         doc_patterns = [
-            '**/README.md',
-            '**/CONTRIBUTING.md',
-            '**/CHANGELOG.md',
-            '**/LICENSE.md',
-            'docs/*.md',            # Files directly in docs/
-            'docs/**/*.md',          # Files in subdirectories of docs/
-            'doc/*.md',              # Files directly in doc/
-            'doc/**/*.md',            # Files in subdirectories of doc/
-            'documentation/*.md',     # Files directly in documentation/
-            'documentation/**/*.md',  # Files in subdirectories of documentation/
-            '**/*.rst',
+            "**/README.md",
+            "**/CONTRIBUTING.md",
+            "**/CHANGELOG.md",
+            "**/LICENSE.md",
+            "docs/*.md",  # Files directly in docs/
+            "docs/**/*.md",  # Files in subdirectories of docs/
+            "doc/*.md",  # Files directly in doc/
+            "doc/**/*.md",  # Files in subdirectories of doc/
+            "documentation/*.md",  # Files directly in documentation/
+            "documentation/**/*.md",  # Files in subdirectories of documentation/
+            "**/*.rst",
         ]
 
         # Code extensions
         code_extensions = [
-            '.py', '.js', '.ts', '.jsx', '.tsx',
-            '.go', '.rs', '.java', '.kt',
-            '.c', '.cpp', '.h', '.hpp',
-            '.rb', '.php', '.swift', '.cs',
-            '.scala', '.clj', '.cljs'
+            ".py",
+            ".js",
+            ".ts",
+            ".jsx",
+            ".tsx",
+            ".go",
+            ".rs",
+            ".java",
+            ".kt",
+            ".c",
+            ".cpp",
+            ".h",
+            ".hpp",
+            ".rb",
+            ".php",
+            ".swift",
+            ".cs",
+            ".scala",
+            ".clj",
+            ".cljs",
         ]
 
         # Directories to exclude
         exclude_dirs = [
-            'node_modules', '__pycache__', 'venv', '.venv',
-            '.git', 'build', 'dist', '.tox', '.pytest_cache',
-            'htmlcov', '.mypy_cache', '.eggs', '*.egg-info'
+            "node_modules",
+            "__pycache__",
+            "venv",
+            ".venv",
+            ".git",
+            "build",
+            "dist",
+            ".tox",
+            ".pytest_cache",
+            "htmlcov",
+            ".mypy_cache",
+            ".eggs",
+            "*.egg-info",
         ]
 
-        for file_path in repo_path.rglob('*'):
+        for file_path in repo_path.rglob("*"):
             if not file_path.is_file():
                 continue
 
@@ -392,8 +412,8 @@ class GitHubThreeStreamFetcher:
                 continue
 
             # Skip hidden files (but allow docs in docs/ directories)
-            is_in_docs_dir = any(pattern in str(file_path) for pattern in ['docs/', 'doc/', 'documentation/'])
-            if any(part.startswith('.') for part in file_path.parts):
+            is_in_docs_dir = any(pattern in str(file_path) for pattern in ["docs/", "doc/", "documentation/"])
+            if any(part.startswith(".") for part in file_path.parts):
                 if not is_in_docs_dir:
                     continue
 
@@ -407,7 +427,7 @@ class GitHubThreeStreamFetcher:
 
         return code_files, doc_files
 
-    def analyze_issues(self, issues: List[Dict]) -> Dict:
+    def analyze_issues(self, issues: list[dict]) -> dict:
         """
         Analyze GitHub issues to extract insights.
 
@@ -446,44 +466,41 @@ class GitHubThreeStreamFetcher:
 
         for issue in issues:
             # Handle both string labels and dict labels (GitHub API format)
-            raw_labels = issue.get('labels', [])
+            raw_labels = issue.get("labels", [])
             labels = []
             for label in raw_labels:
                 if isinstance(label, dict):
-                    labels.append(label.get('name', ''))
+                    labels.append(label.get("name", ""))
                 else:
                     labels.append(str(label))
             all_labels.extend(labels)
 
             issue_data = {
-                'title': issue.get('title', ''),
-                'number': issue.get('number', 0),
-                'labels': labels,
-                'comments': issue.get('comments', 0),
-                'state': issue.get('state', 'unknown')
+                "title": issue.get("title", ""),
+                "number": issue.get("number", 0),
+                "labels": labels,
+                "comments": issue.get("comments", 0),
+                "state": issue.get("state", "unknown"),
             }
 
             # Open issues with many comments = common problems
-            if issue['state'] == 'open' and issue.get('comments', 0) >= 5:
+            if issue["state"] == "open" and issue.get("comments", 0) >= 5:
                 common_problems.append(issue_data)
 
             # Closed issues with comments = known solutions
-            elif issue['state'] == 'closed' and issue.get('comments', 0) > 0:
+            elif issue["state"] == "closed" and issue.get("comments", 0) > 0:
                 known_solutions.append(issue_data)
 
         # Count label frequency
         label_counts = Counter(all_labels)
 
         return {
-            'common_problems': sorted(common_problems, key=lambda x: x['comments'], reverse=True)[:10],
-            'known_solutions': sorted(known_solutions, key=lambda x: x['comments'], reverse=True)[:10],
-            'top_labels': [
-                {'label': label, 'count': count}
-                for label, count in label_counts.most_common(10)
-            ]
+            "common_problems": sorted(common_problems, key=lambda x: x["comments"], reverse=True)[:10],
+            "known_solutions": sorted(known_solutions, key=lambda x: x["comments"], reverse=True)[:10],
+            "top_labels": [{"label": label, "count": count} for label, count in label_counts.most_common(10)],
         }
 
-    def read_file(self, file_path: Path) -> Optional[str]:
+    def read_file(self, file_path: Path) -> str | None:
         """
         Read file content safely.
 
@@ -497,10 +514,10 @@ class GitHubThreeStreamFetcher:
             return None
 
         try:
-            return file_path.read_text(encoding='utf-8')
+            return file_path.read_text(encoding="utf-8")
         except Exception:
             # Try with different encoding
             try:
-                return file_path.read_text(encoding='latin-1')
+                return file_path.read_text(encoding="latin-1")
             except Exception:
                 return None
diff --git a/src/skill_seekers/cli/github_scraper.py b/src/skill_seekers/cli/github_scraper.py
index c6900a4..e39c246 100644
--- a/src/skill_seekers/cli/github_scraper.py
+++ b/src/skill_seekers/cli/github_scraper.py
@@ -14,15 +14,14 @@ Usage:
     skill-seekers github --repo owner/repo --token $GITHUB_TOKEN
 """
 
-import os
-import sys
-import json
-import re
 import argparse
+import json
 import logging
+import os
+import re
+import sys
 from pathlib import Path
-from typing import Dict, List, Optional, Any
-from datetime import datetime
+from typing import Any, Optional
 
 try:
     from github import Github, GithubException, Repository
@@ -34,20 +33,19 @@ except ImportError:
 # Try to import pathspec for .gitignore support
 try:
     import pathspec
+
     PATHSPEC_AVAILABLE = True
 except ImportError:
     PATHSPEC_AVAILABLE = False
 
 # Configure logging FIRST (before using logger)
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s - %(levelname)s - %(message)s'
-)
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
 logger = logging.getLogger(__name__)
 
 # Import code analyzer for deep code analysis
 try:
     from .code_analyzer import CodeAnalyzer
+
     CODE_ANALYZER_AVAILABLE = True
 except ImportError:
     CODE_ANALYZER_AVAILABLE = False
@@ -55,13 +53,25 @@ except ImportError:
 
 # Directories to exclude from local repository analysis
 EXCLUDED_DIRS = {
-    'venv', 'env', '.venv', '.env',  # Virtual environments
-    'node_modules', '__pycache__', '.pytest_cache',  # Dependencies and caches
-    '.git', '.svn', '.hg',  # Version control
-    'build', 'dist', '*.egg-info',  # Build artifacts
-    'htmlcov', '.coverage',  # Coverage reports
-    '.tox', '.nox',  # Testing environments
-    '.mypy_cache', '.ruff_cache',  # Linter caches
+    "venv",
+    "env",
+    ".venv",
+    ".env",  # Virtual environments
+    "node_modules",
+    "__pycache__",
+    ".pytest_cache",  # Dependencies and caches
+    ".git",
+    ".svn",
+    ".hg",  # Version control
+    "build",
+    "dist",
+    "*.egg-info",  # Build artifacts
+    "htmlcov",
+    ".coverage",  # Coverage reports
+    ".tox",
+    ".nox",  # Testing environments
+    ".mypy_cache",
+    ".ruff_cache",  # Linter caches
 }
 
 
@@ -80,10 +90,10 @@ def extract_description_from_readme(readme_content: str, repo_name: str) -> str:
         Description string, or improved fallback if extraction fails
     """
     if not readme_content:
-        return f'Use when working with {repo_name.split("/")[-1]}'
+        return f"Use when working with {repo_name.split('/')[-1]}"
 
     try:
-        lines = readme_content.split('\n')
+        lines = readme_content.split("\n")
 
         # Skip badges, images, title - find first meaningful text paragraph
         meaningful_paragraph = None
@@ -93,7 +103,7 @@ def extract_description_from_readme(readme_content: str, repo_name: str) -> str:
             stripped = line.strip()
 
             # Track code blocks
-            if stripped.startswith('```'):
+            if stripped.startswith("```"):
                 in_code_block = not in_code_block
                 continue
 
@@ -102,11 +112,11 @@ def extract_description_from_readme(readme_content: str, repo_name: str) -> str:
                 continue
 
             # Skip empty lines, badges, images, HTML
-            if not stripped or stripped.startswith(('#', '!', '<', '[![', '[![')):
+            if not stripped or stripped.startswith(("#", "!", "<", "[![", "[![")):
                 continue
 
             # Skip lines that are just links or badges
-            if stripped.startswith('[') and '](' in stripped and len(stripped) < 100:
+            if stripped.startswith("[") and "](" in stripped and len(stripped) < 100:
                 continue
 
             # Found a meaningful paragraph - take up to 200 chars
@@ -117,33 +127,33 @@ def extract_description_from_readme(readme_content: str, repo_name: str) -> str:
         if meaningful_paragraph:
             # Clean up and extract purpose
             # Remove markdown formatting
-            clean = re.sub(r'\[([^\]]+)\]\([^\)]+\)', r'\1', meaningful_paragraph)  # Links
-            clean = re.sub(r'[*_`]', '', clean)  # Bold, italic, code
-            clean = re.sub(r'<[^>]+>', '', clean)  # HTML tags
+            clean = re.sub(r"\[([^\]]+)\]\([^\)]+\)", r"\1", meaningful_paragraph)  # Links
+            clean = re.sub(r"[*_`]", "", clean)  # Bold, italic, code
+            clean = re.sub(r"<[^>]+>", "", clean)  # HTML tags
 
             # Truncate if too long (keep first sentence or ~150 chars)
-            if '. ' in clean:
-                first_sentence = clean.split('. ')[0] + '.'
+            if ". " in clean:
+                first_sentence = clean.split(". ")[0] + "."
                 if len(first_sentence) < 200:
                     clean = first_sentence
 
             if len(clean) > 150:
-                clean = clean[:147] + '...'
+                clean = clean[:147] + "..."
 
             # Format as "Use when..." description
             # If it already starts with action words, use as-is
-            action_words = ['build', 'create', 'develop', 'work', 'use', 'implement', 'manage']
+            action_words = ["build", "create", "develop", "work", "use", "implement", "manage"]
             if any(clean.lower().startswith(word) for word in action_words):
-                return f'Use when {clean.lower()}'
+                return f"Use when {clean.lower()}"
             else:
-                return f'Use when working with {clean.lower()}'
+                return f"Use when working with {clean.lower()}"
 
     except Exception as e:
         logger.debug(f"Could not extract description from README: {e}")
 
     # Improved fallback
-    project_name = repo_name.split('/')[-1]
-    return f'Use when working with {project_name}'
+    project_name = repo_name.split("/")[-1]
+    return f"Use when working with {project_name}"
 
 
 class GitHubScraper:
@@ -162,16 +172,16 @@ class GitHubScraper:
     - Releases
     """
 
-    def __init__(self, config: Dict[str, Any], local_repo_path: Optional[str] = None):
+    def __init__(self, config: dict[str, Any], local_repo_path: str | None = None):
         """Initialize GitHub scraper with configuration."""
         self.config = config
-        self.repo_name = config['repo']
-        self.name = config.get('name', self.repo_name.split('/')[-1])
+        self.repo_name = config["repo"]
+        self.name = config.get("name", self.repo_name.split("/")[-1])
         # Set initial description (will be improved after README extraction if not in config)
-        self.description = config.get('description', f'Use when working with {self.repo_name.split("/")[-1]}')
+        self.description = config.get("description", f"Use when working with {self.repo_name.split('/')[-1]}")
 
         # Local repository path (optional - enables unlimited analysis)
-        self.local_repo_path = local_repo_path or config.get('local_repo_path')
+        self.local_repo_path = local_repo_path or config.get("local_repo_path")
         if self.local_repo_path:
             self.local_repo_path = os.path.expanduser(self.local_repo_path)
             logger.info(f"Local repository mode enabled: {self.local_repo_path}")
@@ -180,22 +190,16 @@ class GitHubScraper:
         self.excluded_dirs = set(EXCLUDED_DIRS)  # Start with smart defaults
 
         # Option 1: Replace mode - Use only specified exclusions
-        if 'exclude_dirs' in config:
-            self.excluded_dirs = set(config['exclude_dirs'])
-            logger.warning(
-                f"Using custom directory exclusions ({len(self.excluded_dirs)} dirs) - "
-                "defaults overridden"
-            )
+        if "exclude_dirs" in config:
+            self.excluded_dirs = set(config["exclude_dirs"])
+            logger.warning(f"Using custom directory exclusions ({len(self.excluded_dirs)} dirs) - defaults overridden")
             logger.debug(f"Custom exclusions: {sorted(self.excluded_dirs)}")
 
         # Option 2: Extend mode - Add to default exclusions
-        elif 'exclude_dirs_additional' in config:
-            additional = set(config['exclude_dirs_additional'])
+        elif "exclude_dirs_additional" in config:
+            additional = set(config["exclude_dirs_additional"])
             self.excluded_dirs = self.excluded_dirs.union(additional)
-            logger.info(
-                f"Added {len(additional)} custom directory exclusions "
-                f"(total: {len(self.excluded_dirs)})"
-            )
+            logger.info(f"Added {len(additional)} custom directory exclusions (total: {len(self.excluded_dirs)})")
             logger.debug(f"Additional exclusions: {sorted(additional)}")
 
         # Load .gitignore for additional exclusions (C2.1)
@@ -206,20 +210,20 @@ class GitHubScraper:
         # GitHub client setup (C1.1)
         token = self._get_token()
         self.github = Github(token) if token else Github()
-        self.repo: Optional[Repository.Repository] = None
+        self.repo: Repository.Repository | None = None
 
         # Options
-        self.include_issues = config.get('include_issues', True)
-        self.max_issues = config.get('max_issues', 100)
-        self.include_changelog = config.get('include_changelog', True)
-        self.include_releases = config.get('include_releases', True)
-        self.include_code = config.get('include_code', False)
-        self.code_analysis_depth = config.get('code_analysis_depth', 'surface')  # 'surface', 'deep', 'full'
-        self.file_patterns = config.get('file_patterns', [])
+        self.include_issues = config.get("include_issues", True)
+        self.max_issues = config.get("max_issues", 100)
+        self.include_changelog = config.get("include_changelog", True)
+        self.include_releases = config.get("include_releases", True)
+        self.include_code = config.get("include_code", False)
+        self.code_analysis_depth = config.get("code_analysis_depth", "surface")  # 'surface', 'deep', 'full'
+        self.file_patterns = config.get("file_patterns", [])
 
         # Initialize code analyzer if deep analysis requested
         self.code_analyzer = None
-        if self.code_analysis_depth != 'surface' and CODE_ANALYZER_AVAILABLE:
+        if self.code_analysis_depth != "surface" and CODE_ANALYZER_AVAILABLE:
             self.code_analyzer = CodeAnalyzer(depth=self.code_analysis_depth)
             logger.info(f"Code analysis depth: {self.code_analysis_depth}")
 
@@ -229,30 +233,30 @@ class GitHubScraper:
 
         # Extracted data storage
         self.extracted_data = {
-            'repo_info': {},
-            'readme': '',
-            'file_tree': [],
-            'languages': {},
-            'signatures': [],
-            'test_examples': [],
-            'issues': [],
-            'changelog': '',
-            'releases': []
+            "repo_info": {},
+            "readme": "",
+            "file_tree": [],
+            "languages": {},
+            "signatures": [],
+            "test_examples": [],
+            "issues": [],
+            "changelog": "",
+            "releases": [],
         }
 
-    def _get_token(self) -> Optional[str]:
+    def _get_token(self) -> str | None:
         """
         Get GitHub token from env var or config (both options supported).
         Priority: GITHUB_TOKEN env var > config file > None
         """
         # Try environment variable first (recommended)
-        token = os.getenv('GITHUB_TOKEN')
+        token = os.getenv("GITHUB_TOKEN")
         if token:
             logger.info("Using GitHub token from GITHUB_TOKEN environment variable")
             return token
 
         # Fall back to config file
-        token = self.config.get('github_token')
+        token = self.config.get("github_token")
         if token:
             logger.warning("Using GitHub token from config file (less secure)")
             return token
@@ -260,7 +264,7 @@ class GitHubScraper:
         logger.warning("No GitHub token provided - using unauthenticated access (lower rate limits)")
         return None
 
-    def scrape(self) -> Dict[str, Any]:
+    def scrape(self) -> dict[str, Any]:
         """
         Main scraping entry point.
         Executes all C1 tasks in sequence.
@@ -313,21 +317,21 @@ class GitHubScraper:
             self.repo = self.github.get_repo(self.repo_name)
 
             # Extract basic repo info
-            self.extracted_data['repo_info'] = {
-                'name': self.repo.name,
-                'full_name': self.repo.full_name,
-                'description': self.repo.description,
-                'url': self.repo.html_url,
-                'homepage': self.repo.homepage,
-                'stars': self.repo.stargazers_count,
-                'forks': self.repo.forks_count,
-                'open_issues': self.repo.open_issues_count,
-                'default_branch': self.repo.default_branch,
-                'created_at': self.repo.created_at.isoformat() if self.repo.created_at else None,
-                'updated_at': self.repo.updated_at.isoformat() if self.repo.updated_at else None,
-                'language': self.repo.language,
-                'license': self.repo.license.name if self.repo.license else None,
-                'topics': self.repo.get_topics()
+            self.extracted_data["repo_info"] = {
+                "name": self.repo.name,
+                "full_name": self.repo.full_name,
+                "description": self.repo.description,
+                "url": self.repo.html_url,
+                "homepage": self.repo.homepage,
+                "stars": self.repo.stargazers_count,
+                "forks": self.repo.forks_count,
+                "open_issues": self.repo.open_issues_count,
+                "default_branch": self.repo.default_branch,
+                "created_at": self.repo.created_at.isoformat() if self.repo.created_at else None,
+                "updated_at": self.repo.updated_at.isoformat() if self.repo.updated_at else None,
+                "language": self.repo.language,
+                "license": self.repo.license.name if self.repo.license else None,
+                "topics": self.repo.get_topics(),
             }
 
             logger.info(f"Repository fetched: {self.repo.full_name} ({self.repo.stargazers_count} stars)")
@@ -337,7 +341,7 @@ class GitHubScraper:
                 raise ValueError(f"Repository not found: {self.repo_name}")
             raise
 
-    def _get_file_content(self, file_path: str) -> Optional[str]:
+    def _get_file_content(self, file_path: str) -> str | None:
         """
         Safely get file content, handling symlinks and encoding issues.
 
@@ -353,8 +357,8 @@ class GitHubScraper:
                 return None
 
             # Handle symlinks - follow the target to get actual file
-            if hasattr(content, 'type') and content.type == 'symlink':
-                target = getattr(content, 'target', None)
+            if hasattr(content, "type") and content.type == "symlink":
+                target = getattr(content, "target", None)
                 if target:
                     target = target.strip()
                     logger.debug(f"File {file_path} is a symlink to {target}, following...")
@@ -369,14 +373,15 @@ class GitHubScraper:
 
             # Handle large files (encoding="none") - download via URL
             # GitHub API doesn't base64-encode files >1MB
-            if hasattr(content, 'encoding') and content.encoding in [None, "none"]:
-                download_url = getattr(content, 'download_url', None)
-                file_size = getattr(content, 'size', 0)
+            if hasattr(content, "encoding") and content.encoding in [None, "none"]:
+                download_url = getattr(content, "download_url", None)
+                file_size = getattr(content, "size", 0)
 
                 if download_url:
                     logger.info(f"File {file_path} is large ({file_size:,} bytes), downloading via URL...")
                     try:
                         import requests
+
                         response = requests.get(download_url, timeout=30)
                         response.raise_for_status()
                         return response.text
@@ -390,7 +395,7 @@ class GitHubScraper:
             # Handle regular files - decode content
             try:
                 if isinstance(content.decoded_content, bytes):
-                    return content.decoded_content.decode('utf-8')
+                    return content.decoded_content.decode("utf-8")
                 else:
                     return str(content.decoded_content)
             except (UnicodeDecodeError, AttributeError, LookupError, AssertionError) as e:
@@ -398,7 +403,7 @@ class GitHubScraper:
                 # Try alternative encoding
                 try:
                     if isinstance(content.decoded_content, bytes):
-                        return content.decoded_content.decode('latin-1')
+                        return content.decoded_content.decode("latin-1")
                 except Exception:
                     return None
                 return None
@@ -414,21 +419,17 @@ class GitHubScraper:
         logger.info("Extracting README...")
 
         # Try common README locations
-        readme_files = ['README.md', 'README.rst', 'README.txt', 'README',
-                       'docs/README.md', '.github/README.md']
+        readme_files = ["README.md", "README.rst", "README.txt", "README", "docs/README.md", ".github/README.md"]
 
         for readme_path in readme_files:
             readme_content = self._get_file_content(readme_path)
             if readme_content:
-                self.extracted_data['readme'] = readme_content
+                self.extracted_data["readme"] = readme_content
                 logger.info(f"README found: {readme_path}")
 
                 # Update description if not explicitly set in config
-                if 'description' not in self.config:
-                    smart_description = extract_description_from_readme(
-                        self.extracted_data['readme'],
-                        self.repo_name
-                    )
+                if "description" not in self.config:
+                    smart_description = extract_description_from_readme(self.extracted_data["readme"], self.repo_name)
                     self.description = smart_description
                     logger.debug(f"Generated description: {self.description}")
 
@@ -461,10 +462,10 @@ class GitHubScraper:
             languages = self.repo.get_languages()
             total_bytes = sum(languages.values())
 
-            self.extracted_data['languages'] = {
+            self.extracted_data["languages"] = {
                 lang: {
-                    'bytes': bytes_count,
-                    'percentage': round((bytes_count / total_bytes) * 100, 2) if total_bytes > 0 else 0
+                    "bytes": bytes_count,
+                    "percentage": round((bytes_count / total_bytes) * 100, 2) if total_bytes > 0 else 0,
                 }
                 for lang, bytes_count in languages.items()
             }
@@ -486,7 +487,7 @@ class GitHubScraper:
             True if directory should be excluded
         """
         # Check directory name
-        if dir_name in self.excluded_dirs or dir_name.startswith('.'):
+        if dir_name in self.excluded_dirs or dir_name.startswith("."):
             return True
 
         # Check full path if provided (for nested exclusions like "TextMesh Pro/Examples & Extras")
@@ -500,14 +501,14 @@ class GitHubScraper:
         if self.gitignore_spec and dir_path:
             # For directories, we need to check both with and without trailing slash
             # as .gitignore patterns can match either way
-            dir_path_with_slash = dir_path if dir_path.endswith('/') else dir_path + '/'
+            dir_path_with_slash = dir_path if dir_path.endswith("/") else dir_path + "/"
             if self.gitignore_spec.match_file(dir_path) or self.gitignore_spec.match_file(dir_path_with_slash):
                 logger.debug(f"Directory excluded by .gitignore: {dir_path}")
                 return True
 
         return False
 
-    def _load_gitignore(self) -> Optional['pathspec.PathSpec']:
+    def _load_gitignore(self) -> Optional["pathspec.PathSpec"]:
         """
         Load .gitignore file and create pathspec matcher (C2.1).
 
@@ -522,14 +523,14 @@ class GitHubScraper:
         if not self.local_repo_path:
             return None
 
-        gitignore_path = Path(self.local_repo_path) / '.gitignore'
+        gitignore_path = Path(self.local_repo_path) / ".gitignore"
         if not gitignore_path.exists():
             logger.debug(f"No .gitignore found in {self.local_repo_path}")
             return None
 
         try:
-            with open(gitignore_path, 'r', encoding='utf-8') as f:
-                spec = pathspec.PathSpec.from_lines('gitwildmatch', f)
+            with open(gitignore_path, encoding="utf-8") as f:
+                spec = pathspec.PathSpec.from_lines("gitwildmatch", f)
             logger.info(f"Loaded .gitignore from {gitignore_path}")
             return spec
         except Exception as e:
@@ -561,8 +562,8 @@ class GitHubScraper:
         for root, dirs, files in os.walk(self.local_repo_path):
             # Calculate relative path from repo root first (needed for exclusion checks)
             rel_root = os.path.relpath(root, self.local_repo_path)
-            if rel_root == '.':
-                rel_root = ''
+            if rel_root == ".":
+                rel_root = ""
 
             # Exclude directories in-place to prevent os.walk from descending into them
             # Pass both dir name and full path for path-based exclusions
@@ -579,11 +580,7 @@ class GitHubScraper:
             # Add directories
             for dir_name in dirs:
                 dir_path = os.path.join(rel_root, dir_name) if rel_root else dir_name
-                file_tree.append({
-                    'path': dir_path,
-                    'type': 'dir',
-                    'size': None
-                })
+                file_tree.append({"path": dir_path, "type": "dir", "size": None})
 
             # Add files
             for file_name in files:
@@ -594,13 +591,9 @@ class GitHubScraper:
                 except OSError:
                     file_size = None
 
-                file_tree.append({
-                    'path': file_path,
-                    'type': 'file',
-                    'size': file_size
-                })
+                file_tree.append({"path": file_path, "type": "file", "size": file_size})
 
-        self.extracted_data['file_tree'] = file_tree
+        self.extracted_data["file_tree"] = file_tree
         logger.info(f"File tree built (local mode): {len(file_tree)} items ({excluded_count} directories excluded)")
 
     def _extract_file_tree_github(self):
@@ -613,16 +606,16 @@ class GitHubScraper:
                 file_content = contents.pop(0)
 
                 file_info = {
-                    'path': file_content.path,
-                    'type': file_content.type,
-                    'size': file_content.size if file_content.type == 'file' else None
+                    "path": file_content.path,
+                    "type": file_content.type,
+                    "size": file_content.size if file_content.type == "file" else None,
                 }
                 file_tree.append(file_info)
 
                 if file_content.type == "dir":
                     contents.extend(self.repo.get_contents(file_content.path))
 
-            self.extracted_data['file_tree'] = file_tree
+            self.extracted_data["file_tree"] = file_tree
             logger.info(f"File tree built (GitHub API mode): {len(file_tree)} items")
 
         except GithubException as e:
@@ -637,7 +630,7 @@ class GitHubScraper:
         - deep: Parse files for signatures, parameters, types
         - full: Complete AST analysis (future enhancement)
         """
-        if self.code_analysis_depth == 'surface':
+        if self.code_analysis_depth == "surface":
             logger.info("Code extraction: Surface level (file tree only)")
             return
 
@@ -648,22 +641,22 @@ class GitHubScraper:
         logger.info(f"Extracting code signatures ({self.code_analysis_depth} analysis)...")
 
         # Get primary language for the repository
-        languages = self.extracted_data.get('languages', {})
+        languages = self.extracted_data.get("languages", {})
         if not languages:
             logger.warning("No languages detected - skipping code analysis")
             return
 
         # Determine primary language
-        primary_language = max(languages.items(), key=lambda x: x[1]['bytes'])[0]
+        primary_language = max(languages.items(), key=lambda x: x[1]["bytes"])[0]
         logger.info(f"Primary language: {primary_language}")
 
         # Determine file extensions to analyze
         extension_map = {
-            'Python': ['.py'],
-            'JavaScript': ['.js', '.jsx'],
-            'TypeScript': ['.ts', '.tsx'],
-            'C': ['.c', '.h'],
-            'C++': ['.cpp', '.hpp', '.cc', '.hh', '.cxx']
+            "Python": [".py"],
+            "JavaScript": [".js", ".jsx"],
+            "TypeScript": [".ts", ".tsx"],
+            "C": [".c", ".h"],
+            "C++": [".cpp", ".hpp", ".cc", ".hh", ".cxx"],
         }
 
         extensions = extension_map.get(primary_language, [])
@@ -673,10 +666,10 @@ class GitHubScraper:
 
         # Analyze files matching patterns and extensions
         analyzed_files = []
-        file_tree = self.extracted_data.get('file_tree', [])
+        file_tree = self.extracted_data.get("file_tree", [])
 
         for file_info in file_tree:
-            file_path = file_info['path']
+            file_path = file_info["path"]
 
             # Check if file matches extension
             if not any(file_path.endswith(ext) for ext in extensions):
@@ -685,6 +678,7 @@ class GitHubScraper:
             # Check if file matches patterns (if specified)
             if self.file_patterns:
                 import fnmatch
+
                 if not any(fnmatch.fnmatch(file_path, pattern) for pattern in self.file_patterns):
                     continue
 
@@ -694,29 +688,23 @@ class GitHubScraper:
                 if self.local_repo_path:
                     # Local mode - read from filesystem
                     full_path = os.path.join(self.local_repo_path, file_path)
-                    with open(full_path, 'r', encoding='utf-8') as f:
+                    with open(full_path, encoding="utf-8") as f:
                         content = f.read()
                 else:
                     # GitHub API mode - fetch from API
                     file_content = self.repo.get_contents(file_path)
-                    content = file_content.decoded_content.decode('utf-8')
+                    content = file_content.decoded_content.decode("utf-8")
 
-                analysis_result = self.code_analyzer.analyze_file(
-                    file_path,
-                    content,
-                    primary_language
-                )
+                analysis_result = self.code_analyzer.analyze_file(file_path, content, primary_language)
 
-                if analysis_result and (analysis_result.get('classes') or analysis_result.get('functions')):
-                    analyzed_files.append({
-                        'file': file_path,
-                        'language': primary_language,
-                        **analysis_result
-                    })
+                if analysis_result and (analysis_result.get("classes") or analysis_result.get("functions")):
+                    analyzed_files.append({"file": file_path, "language": primary_language, **analysis_result})
 
-                    logger.debug(f"Analyzed {file_path}: "
-                               f"{len(analysis_result.get('classes', []))} classes, "
-                               f"{len(analysis_result.get('functions', []))} functions")
+                    logger.debug(
+                        f"Analyzed {file_path}: "
+                        f"{len(analysis_result.get('classes', []))} classes, "
+                        f"{len(analysis_result.get('functions', []))} functions"
+                    )
 
             except Exception as e:
                 logger.debug(f"Could not analyze {file_path}: {e}")
@@ -724,22 +712,23 @@ class GitHubScraper:
 
             # Limit number of files analyzed to avoid rate limits (GitHub API mode only)
             if not self.local_repo_path and len(analyzed_files) >= 50:
-                logger.info(f"Reached analysis limit (50 files, GitHub API mode)")
+                logger.info("Reached analysis limit (50 files, GitHub API mode)")
                 break
 
-        self.extracted_data['code_analysis'] = {
-            'depth': self.code_analysis_depth,
-            'language': primary_language,
-            'files_analyzed': len(analyzed_files),
-            'files': analyzed_files
+        self.extracted_data["code_analysis"] = {
+            "depth": self.code_analysis_depth,
+            "language": primary_language,
+            "files_analyzed": len(analyzed_files),
+            "files": analyzed_files,
         }
 
         # Calculate totals
-        total_classes = sum(len(f.get('classes', [])) for f in analyzed_files)
-        total_functions = sum(len(f.get('functions', [])) for f in analyzed_files)
+        total_classes = sum(len(f.get("classes", [])) for f in analyzed_files)
+        total_functions = sum(len(f.get("functions", [])) for f in analyzed_files)
 
-        logger.info(f"Code analysis complete: {len(analyzed_files)} files, "
-                   f"{total_classes} classes, {total_functions} functions")
+        logger.info(
+            f"Code analysis complete: {len(analyzed_files)} files, {total_classes} classes, {total_functions} functions"
+        )
 
     def _extract_issues(self):
         """C1.7: Extract GitHub Issues (open/closed, labels, milestones)."""
@@ -747,29 +736,29 @@ class GitHubScraper:
 
         try:
             # Fetch recent issues (open + closed)
-            issues = self.repo.get_issues(state='all', sort='updated', direction='desc')
+            issues = self.repo.get_issues(state="all", sort="updated", direction="desc")
 
             issue_list = []
-            for issue in issues[:self.max_issues]:
+            for issue in issues[: self.max_issues]:
                 # Skip pull requests (they appear in issues)
                 if issue.pull_request:
                     continue
 
                 issue_data = {
-                    'number': issue.number,
-                    'title': issue.title,
-                    'state': issue.state,
-                    'labels': [label.name for label in issue.labels],
-                    'milestone': issue.milestone.title if issue.milestone else None,
-                    'created_at': issue.created_at.isoformat() if issue.created_at else None,
-                    'updated_at': issue.updated_at.isoformat() if issue.updated_at else None,
-                    'closed_at': issue.closed_at.isoformat() if issue.closed_at else None,
-                    'url': issue.html_url,
-                    'body': issue.body[:500] if issue.body else None  # First 500 chars
+                    "number": issue.number,
+                    "title": issue.title,
+                    "state": issue.state,
+                    "labels": [label.name for label in issue.labels],
+                    "milestone": issue.milestone.title if issue.milestone else None,
+                    "created_at": issue.created_at.isoformat() if issue.created_at else None,
+                    "updated_at": issue.updated_at.isoformat() if issue.updated_at else None,
+                    "closed_at": issue.closed_at.isoformat() if issue.closed_at else None,
+                    "url": issue.html_url,
+                    "body": issue.body[:500] if issue.body else None,  # First 500 chars
                 }
                 issue_list.append(issue_data)
 
-            self.extracted_data['issues'] = issue_list
+            self.extracted_data["issues"] = issue_list
             logger.info(f"Extracted {len(issue_list)} issues")
 
         except GithubException as e:
@@ -780,14 +769,21 @@ class GitHubScraper:
         logger.info("Extracting CHANGELOG...")
 
         # Try common changelog locations
-        changelog_files = ['CHANGELOG.md', 'CHANGES.md', 'HISTORY.md',
-                          'CHANGELOG.rst', 'CHANGELOG.txt', 'CHANGELOG',
-                          'docs/CHANGELOG.md', '.github/CHANGELOG.md']
+        changelog_files = [
+            "CHANGELOG.md",
+            "CHANGES.md",
+            "HISTORY.md",
+            "CHANGELOG.rst",
+            "CHANGELOG.txt",
+            "CHANGELOG",
+            "docs/CHANGELOG.md",
+            ".github/CHANGELOG.md",
+        ]
 
         for changelog_path in changelog_files:
             changelog_content = self._get_file_content(changelog_path)
             if changelog_content:
-                self.extracted_data['changelog'] = changelog_content
+                self.extracted_data["changelog"] = changelog_content
                 logger.info(f"CHANGELOG found: {changelog_path}")
                 return
 
@@ -803,20 +799,20 @@ class GitHubScraper:
             release_list = []
             for release in releases:
                 release_data = {
-                    'tag_name': release.tag_name,
-                    'name': release.title,
-                    'body': release.body,
-                    'draft': release.draft,
-                    'prerelease': release.prerelease,
-                    'created_at': release.created_at.isoformat() if release.created_at else None,
-                    'published_at': release.published_at.isoformat() if release.published_at else None,
-                    'url': release.html_url,
-                    'tarball_url': release.tarball_url,
-                    'zipball_url': release.zipball_url
+                    "tag_name": release.tag_name,
+                    "name": release.title,
+                    "body": release.body,
+                    "draft": release.draft,
+                    "prerelease": release.prerelease,
+                    "created_at": release.created_at.isoformat() if release.created_at else None,
+                    "published_at": release.published_at.isoformat() if release.published_at else None,
+                    "url": release.html_url,
+                    "tarball_url": release.tarball_url,
+                    "zipball_url": release.zipball_url,
                 }
                 release_list.append(release_data)
 
-            self.extracted_data['releases'] = release_list
+            self.extracted_data["releases"] = release_list
             logger.info(f"Extracted {len(release_list)} releases")
 
         except GithubException as e:
@@ -824,9 +820,9 @@ class GitHubScraper:
 
     def _save_data(self):
         """Save extracted data to JSON file."""
-        os.makedirs('output', exist_ok=True)
+        os.makedirs("output", exist_ok=True)
 
-        with open(self.data_file, 'w', encoding='utf-8') as f:
+        with open(self.data_file, "w", encoding="utf-8") as f:
             json.dump(self.extracted_data, f, indent=2, ensure_ascii=False)
 
         logger.info(f"Data saved to: {self.data_file}")
@@ -837,10 +833,10 @@ class GitHubToSkillConverter:
     Convert extracted GitHub data to Claude skill format (C1.10).
     """
 
-    def __init__(self, config: Dict[str, Any]):
+    def __init__(self, config: dict[str, Any]):
         """Initialize converter with configuration."""
         self.config = config
-        self.name = config.get('name', config['repo'].split('/')[-1])
+        self.name = config.get("name", config["repo"].split("/")[-1])
 
         # Paths
         self.data_file = f"output/{self.name}_github_data.json"
@@ -850,23 +846,23 @@ class GitHubToSkillConverter:
         self.data = self._load_data()
 
         # Set description (smart extraction from README if available)
-        if 'description' in config:
-            self.description = config['description']
+        if "description" in config:
+            self.description = config["description"]
         else:
             # Try to extract from README in loaded data
-            readme_content = self.data.get('readme', '')
-            repo_name = config['repo']
+            readme_content = self.data.get("readme", "")
+            repo_name = config["repo"]
             if readme_content:
                 self.description = extract_description_from_readme(readme_content, repo_name)
             else:
-                self.description = f'Use when working with {repo_name.split("/")[-1]}'
+                self.description = f"Use when working with {repo_name.split('/')[-1]}"
 
-    def _load_data(self) -> Dict[str, Any]:
+    def _load_data(self) -> dict[str, Any]:
         """Load extracted GitHub data from JSON."""
         if not os.path.exists(self.data_file):
             raise FileNotFoundError(f"Data file not found: {self.data_file}")
 
-        with open(self.data_file, 'r', encoding='utf-8') as f:
+        with open(self.data_file, encoding="utf-8") as f:
             return json.load(f)
 
     def build_skill(self):
@@ -889,12 +885,12 @@ class GitHubToSkillConverter:
 
     def _generate_skill_md(self):
         """Generate main SKILL.md file (rich version with C3.x data if available)."""
-        repo_info = self.data.get('repo_info', {})
-        c3_data = self.data.get('c3_analysis', {})
+        repo_info = self.data.get("repo_info", {})
+        c3_data = self.data.get("c3_analysis", {})
         has_c3_data = bool(c3_data)
 
         # Generate skill name (lowercase, hyphens only, max 64 chars)
-        skill_name = self.name.lower().replace('_', '-').replace(' ', '-')[:64]
+        skill_name = self.name.lower().replace("_", "-").replace(" ", "-")[:64]
 
         # Truncate description to 1024 chars if needed
         desc = self.description[:1024] if len(self.description) > 1024 else self.description
@@ -905,23 +901,23 @@ name: {skill_name}
 description: {desc}
 ---
 
-# {repo_info.get('name', self.name)}
+# {repo_info.get("name", self.name)}
 
 {self.description}
 
 ## Description
 
-{repo_info.get('description', 'GitHub repository skill')}
+{repo_info.get("description", "GitHub repository skill")}
 
-**Repository:** [{repo_info.get('full_name', 'N/A')}]({repo_info.get('url', '#')})
-**Language:** {repo_info.get('language', 'N/A')}
-**Stars:** {repo_info.get('stars', 0):,}
-**License:** {repo_info.get('license', 'N/A')}
+**Repository:** [{repo_info.get("full_name", "N/A")}]({repo_info.get("url", "#")})
+**Language:** {repo_info.get("language", "N/A")}
+**Stars:** {repo_info.get("stars", 0):,}
+**License:** {repo_info.get("license", "N/A")}
 
 ## When to Use This Skill
 
 Use this skill when you need to:
-- Understand how to use {repo_info.get('name', self.name)}
+- Understand how to use {repo_info.get("name", self.name)}
 - Look up API documentation and implementation details
 - Find real-world usage examples from the codebase
 - Review design patterns and architecture
@@ -944,19 +940,19 @@ Use this skill when you need to:
         skill_content += self._format_languages() + "\n\n"
 
         # Add C3.x pattern summary if available
-        if has_c3_data and c3_data.get('patterns'):
+        if has_c3_data and c3_data.get("patterns"):
             skill_content += self._format_pattern_summary(c3_data)
 
         # Add code examples if available (C3.2 test examples)
-        if has_c3_data and c3_data.get('test_examples'):
+        if has_c3_data and c3_data.get("test_examples"):
             skill_content += self._format_code_examples(c3_data)
 
         # Add API Reference if available (C2.5)
-        if has_c3_data and c3_data.get('api_reference'):
+        if has_c3_data and c3_data.get("api_reference"):
             skill_content += self._format_api_reference(c3_data)
 
         # Add Architecture Overview if available (C3.7)
-        if has_c3_data and c3_data.get('architecture'):
+        if has_c3_data and c3_data.get("architecture"):
             skill_content += self._format_architecture(c3_data)
 
         # Add Known Issues section
@@ -976,13 +972,13 @@ Use this skill when you need to:
 
         if has_c3_data:
             skill_content += "\n### Codebase Analysis References\n\n"
-            if c3_data.get('patterns'):
+            if c3_data.get("patterns"):
                 skill_content += "- `references/codebase_analysis/patterns/` - Design patterns detected\n"
-            if c3_data.get('test_examples'):
+            if c3_data.get("test_examples"):
                 skill_content += "- `references/codebase_analysis/examples/` - Test examples extracted\n"
-            if c3_data.get('config_patterns'):
+            if c3_data.get("config_patterns"):
                 skill_content += "- `references/codebase_analysis/configuration/` - Configuration analysis\n"
-            if c3_data.get('architecture'):
+            if c3_data.get("architecture"):
                 skill_content += "- `references/codebase_analysis/ARCHITECTURE.md` - Architecture overview\n"
 
         # Usage
@@ -998,27 +994,27 @@ Use this skill when you need to:
 
         # Write to file
         skill_path = f"{self.skill_dir}/SKILL.md"
-        with open(skill_path, 'w', encoding='utf-8') as f:
+        with open(skill_path, "w", encoding="utf-8") as f:
             f.write(skill_content)
 
-        line_count = len(skill_content.split('\n'))
+        line_count = len(skill_content.split("\n"))
         logger.info(f"Generated: {skill_path} ({line_count} lines)")
 
     def _format_languages(self) -> str:
         """Format language breakdown."""
-        languages = self.data.get('languages', {})
+        languages = self.data.get("languages", {})
         if not languages:
             return "No language data available"
 
         lines = []
-        for lang, info in sorted(languages.items(), key=lambda x: x[1]['bytes'], reverse=True):
+        for lang, info in sorted(languages.items(), key=lambda x: x[1]["bytes"], reverse=True):
             lines.append(f"- **{lang}:** {info['percentage']:.1f}%")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
     def _format_recent_releases(self) -> str:
         """Format recent releases (top 3)."""
-        releases = self.data.get('releases', [])
+        releases = self.data.get("releases", [])
         if not releases:
             return "No releases available"
 
@@ -1026,11 +1022,11 @@ Use this skill when you need to:
         for release in releases[:3]:
             lines.append(f"- **{release['tag_name']}** ({release['published_at'][:10]}): {release['name']}")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def _format_pattern_summary(self, c3_data: Dict[str, Any]) -> str:
+    def _format_pattern_summary(self, c3_data: dict[str, Any]) -> str:
         """Format design patterns summary (C3.1)."""
-        patterns_data = c3_data.get('patterns', [])
+        patterns_data = c3_data.get("patterns", [])
         if not patterns_data:
             return ""
 
@@ -1039,10 +1035,10 @@ Use this skill when you need to:
         by_class = {}
 
         for pattern_file in patterns_data:
-            for pattern in pattern_file.get('patterns', []):
-                ptype = pattern.get('pattern_type', 'Unknown')
-                cls = pattern.get('class_name', '')
-                confidence = pattern.get('confidence', 0)
+            for pattern in pattern_file.get("patterns", []):
+                ptype = pattern.get("pattern_type", "Unknown")
+                cls = pattern.get("class_name", "")
+                confidence = pattern.get("confidence", 0)
 
                 # Skip low confidence
                 if confidence < 0.7:
@@ -1050,7 +1046,7 @@ Use this skill when you need to:
 
                 # Deduplicate by class
                 key = f"{cls}:{ptype}"
-                if key not in by_class or by_class[key]['confidence'] < confidence:
+                if key not in by_class or by_class[key]["confidence"] < confidence:
                     by_class[key] = pattern
 
                 # Count by type
@@ -1069,16 +1065,16 @@ Use this skill when you need to:
         content += f"\n*Total: {len(by_class)} high-confidence patterns*\n\n"
         return content
 
-    def _format_code_examples(self, c3_data: Dict[str, Any]) -> str:
+    def _format_code_examples(self, c3_data: dict[str, Any]) -> str:
         """Format code examples (C3.2)."""
-        examples_data = c3_data.get('test_examples', {})
-        examples = examples_data.get('examples', [])
+        examples_data = c3_data.get("test_examples", {})
+        examples = examples_data.get("examples", [])
 
         if not examples:
             return ""
 
         # Filter high-value examples (complexity > 0.7)
-        high_value = [ex for ex in examples if ex.get('complexity_score', 0) > 0.7]
+        high_value = [ex for ex in examples if ex.get("complexity_score", 0) > 0.7]
 
         if not high_value:
             return ""
@@ -1087,20 +1083,20 @@ Use this skill when you need to:
         content += "*High-quality examples from codebase (C3.2)*\n\n"
 
         # Top 10 examples
-        for ex in sorted(high_value, key=lambda x: x.get('complexity_score', 0), reverse=True)[:10]:
-            desc = ex.get('description', 'Example')
-            lang = ex.get('language', 'python')
-            code = ex.get('code', '')
-            complexity = ex.get('complexity_score', 0)
+        for ex in sorted(high_value, key=lambda x: x.get("complexity_score", 0), reverse=True)[:10]:
+            desc = ex.get("description", "Example")
+            lang = ex.get("language", "python")
+            code = ex.get("code", "")
+            complexity = ex.get("complexity_score", 0)
 
             content += f"**{desc}** (complexity: {complexity:.2f})\n\n"
             content += f"```{lang}\n{code}\n```\n\n"
 
         return content
 
-    def _format_api_reference(self, c3_data: Dict[str, Any]) -> str:
+    def _format_api_reference(self, c3_data: dict[str, Any]) -> str:
         """Format API reference (C2.5)."""
-        api_ref = c3_data.get('api_reference', {})
+        api_ref = c3_data.get("api_reference", {})
 
         if not api_ref:
             return ""
@@ -1121,9 +1117,9 @@ Use this skill when you need to:
         content += "*See `references/codebase_analysis/api_reference/` for complete API docs*\n\n"
         return content
 
-    def _format_architecture(self, c3_data: Dict[str, Any]) -> str:
+    def _format_architecture(self, c3_data: dict[str, Any]) -> str:
         """Format architecture overview (C3.7)."""
-        arch_data = c3_data.get('architecture', {})
+        arch_data = c3_data.get("architecture", {})
 
         if not arch_data:
             return ""
@@ -1132,7 +1128,7 @@ Use this skill when you need to:
         content += "*From C3.7 codebase analysis*\n\n"
 
         # Architecture patterns
-        patterns = arch_data.get('patterns', [])
+        patterns = arch_data.get("patterns", [])
         if patterns:
             content += "**Architectural Patterns:**\n"
             for pattern in patterns[:5]:
@@ -1140,10 +1136,10 @@ Use this skill when you need to:
             content += "\n"
 
         # Dependencies (C2.6)
-        dep_data = c3_data.get('dependency_graph', {})
+        dep_data = c3_data.get("dependency_graph", {})
         if dep_data:
-            total_deps = dep_data.get('total_dependencies', 0)
-            circular = len(dep_data.get('circular_dependencies', []))
+            total_deps = dep_data.get("total_dependencies", 0)
+            circular = len(dep_data.get("circular_dependencies", []))
             if total_deps > 0:
                 content += f"**Dependencies:** {total_deps} total"
                 if circular > 0:
@@ -1155,7 +1151,7 @@ Use this skill when you need to:
 
     def _format_known_issues(self) -> str:
         """Format known issues from GitHub."""
-        issues = self.data.get('issues', [])
+        issues = self.data.get("issues", [])
 
         if not issues:
             return ""
@@ -1165,111 +1161,111 @@ Use this skill when you need to:
 
         # Top 5 issues
         for issue in issues[:5]:
-            title = issue.get('title', 'Untitled')
-            number = issue.get('number', 0)
-            labels = ', '.join(issue.get('labels', []))
+            title = issue.get("title", "Untitled")
+            number = issue.get("number", 0)
+            labels = ", ".join(issue.get("labels", []))
             content += f"- **#{number}**: {title}"
             if labels:
                 content += f" [`{labels}`]"
             content += "\n"
 
-        content += f"\n*See `references/issues.md` for complete list*\n\n"
+        content += "\n*See `references/issues.md` for complete list*\n\n"
         return content
 
     def _generate_references(self):
         """Generate all reference files."""
         # README
-        if self.data.get('readme'):
+        if self.data.get("readme"):
             readme_path = f"{self.skill_dir}/references/README.md"
-            with open(readme_path, 'w', encoding='utf-8') as f:
-                f.write(self.data['readme'])
+            with open(readme_path, "w", encoding="utf-8") as f:
+                f.write(self.data["readme"])
             logger.info(f"Generated: {readme_path}")
 
         # CHANGELOG
-        if self.data.get('changelog'):
+        if self.data.get("changelog"):
             changelog_path = f"{self.skill_dir}/references/CHANGELOG.md"
-            with open(changelog_path, 'w', encoding='utf-8') as f:
-                f.write(self.data['changelog'])
+            with open(changelog_path, "w", encoding="utf-8") as f:
+                f.write(self.data["changelog"])
             logger.info(f"Generated: {changelog_path}")
 
         # Issues
-        if self.data.get('issues'):
+        if self.data.get("issues"):
             self._generate_issues_reference()
 
         # Releases
-        if self.data.get('releases'):
+        if self.data.get("releases"):
             self._generate_releases_reference()
 
         # File structure
-        if self.data.get('file_tree'):
+        if self.data.get("file_tree"):
             self._generate_file_structure_reference()
 
     def _generate_issues_reference(self):
         """Generate issues.md reference file."""
-        issues = self.data['issues']
+        issues = self.data["issues"]
 
         content = f"# GitHub Issues\n\nRecent issues from the repository ({len(issues)} total).\n\n"
 
         # Group by state
-        open_issues = [i for i in issues if i['state'] == 'open']
-        closed_issues = [i for i in issues if i['state'] == 'closed']
+        open_issues = [i for i in issues if i["state"] == "open"]
+        closed_issues = [i for i in issues if i["state"] == "closed"]
 
         content += f"## Open Issues ({len(open_issues)})\n\n"
         for issue in open_issues[:20]:
-            labels = ', '.join(issue['labels']) if issue['labels'] else 'No labels'
+            labels = ", ".join(issue["labels"]) if issue["labels"] else "No labels"
             content += f"### #{issue['number']}: {issue['title']}\n"
             content += f"**Labels:** {labels} | **Created:** {issue['created_at'][:10]}\n"
             content += f"[View on GitHub]({issue['url']})\n\n"
 
         content += f"\n## Recently Closed Issues ({len(closed_issues)})\n\n"
         for issue in closed_issues[:10]:
-            labels = ', '.join(issue['labels']) if issue['labels'] else 'No labels'
+            labels = ", ".join(issue["labels"]) if issue["labels"] else "No labels"
             content += f"### #{issue['number']}: {issue['title']}\n"
             content += f"**Labels:** {labels} | **Closed:** {issue['closed_at'][:10]}\n"
             content += f"[View on GitHub]({issue['url']})\n\n"
 
         issues_path = f"{self.skill_dir}/references/issues.md"
-        with open(issues_path, 'w', encoding='utf-8') as f:
+        with open(issues_path, "w", encoding="utf-8") as f:
             f.write(content)
         logger.info(f"Generated: {issues_path}")
 
     def _generate_releases_reference(self):
         """Generate releases.md reference file."""
-        releases = self.data['releases']
+        releases = self.data["releases"]
 
         content = f"# Releases\n\nVersion history for this repository ({len(releases)} releases).\n\n"
 
         for release in releases:
             content += f"## {release['tag_name']}: {release['name']}\n"
             content += f"**Published:** {release['published_at'][:10]}\n"
-            if release['prerelease']:
-                content += f"**Pre-release**\n"
+            if release["prerelease"]:
+                content += "**Pre-release**\n"
             content += f"\n{release['body']}\n\n"
             content += f"[View on GitHub]({release['url']})\n\n---\n\n"
 
         releases_path = f"{self.skill_dir}/references/releases.md"
-        with open(releases_path, 'w', encoding='utf-8') as f:
+        with open(releases_path, "w", encoding="utf-8") as f:
             f.write(content)
         logger.info(f"Generated: {releases_path}")
 
     def _generate_file_structure_reference(self):
         """Generate file_structure.md reference file."""
-        file_tree = self.data['file_tree']
+        file_tree = self.data["file_tree"]
 
-        content = f"# Repository File Structure\n\n"
+        content = "# Repository File Structure\n\n"
         content += f"Total items: {len(file_tree)}\n\n"
         content += "```\n"
 
         # Build tree structure
         for item in file_tree:
-            indent = "  " * item['path'].count('/')
-            icon = "📁" if item['type'] == 'dir' else "📄"
+            indent = "  " * item["path"].count("/")
+            icon = "📁" if item["type"] == "dir" else "📄"
             content += f"{indent}{icon} {os.path.basename(item['path'])}\n"
 
         content += "```\n"
 
         structure_path = f"{self.skill_dir}/references/file_structure.md"
-        with open(structure_path, 'w', encoding='utf-8') as f:
+        with open(structure_path, "w", encoding="utf-8") as f:
             f.write(content)
         logger.info(f"Generated: {structure_path}")
 
@@ -1277,63 +1273,64 @@ Use this skill when you need to:
 def main():
     """C1.10: CLI tool entry point."""
     parser = argparse.ArgumentParser(
-        description='GitHub Repository to Claude Skill Converter',
+        description="GitHub Repository to Claude Skill Converter",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
   skill-seekers github --repo facebook/react
   skill-seekers github --config configs/react_github.json
   skill-seekers github --repo owner/repo --token $GITHUB_TOKEN
-        """
+        """,
     )
 
-    parser.add_argument('--repo', help='GitHub repository (owner/repo)')
-    parser.add_argument('--config', help='Path to config JSON file')
-    parser.add_argument('--token', help='GitHub personal access token')
-    parser.add_argument('--name', help='Skill name (default: repo name)')
-    parser.add_argument('--description', help='Skill description')
-    parser.add_argument('--no-issues', action='store_true', help='Skip GitHub issues')
-    parser.add_argument('--no-changelog', action='store_true', help='Skip CHANGELOG')
-    parser.add_argument('--no-releases', action='store_true', help='Skip releases')
-    parser.add_argument('--max-issues', type=int, default=100, help='Max issues to fetch')
-    parser.add_argument('--scrape-only', action='store_true', help='Only scrape, don\'t build skill')
-    parser.add_argument('--enhance', action='store_true',
-                       help='Enhance SKILL.md using Claude API after building (requires API key)')
-    parser.add_argument('--enhance-local', action='store_true',
-                       help='Enhance SKILL.md using Claude Code (no API key needed)')
-    parser.add_argument('--api-key', type=str,
-                       help='Anthropic API key for --enhance (or set ANTHROPIC_API_KEY)')
-    parser.add_argument('--non-interactive', action='store_true',
-                       help='Non-interactive mode for CI/CD (fail fast on rate limits)')
-    parser.add_argument('--profile', type=str,
-                       help='GitHub profile name to use from config')
+    parser.add_argument("--repo", help="GitHub repository (owner/repo)")
+    parser.add_argument("--config", help="Path to config JSON file")
+    parser.add_argument("--token", help="GitHub personal access token")
+    parser.add_argument("--name", help="Skill name (default: repo name)")
+    parser.add_argument("--description", help="Skill description")
+    parser.add_argument("--no-issues", action="store_true", help="Skip GitHub issues")
+    parser.add_argument("--no-changelog", action="store_true", help="Skip CHANGELOG")
+    parser.add_argument("--no-releases", action="store_true", help="Skip releases")
+    parser.add_argument("--max-issues", type=int, default=100, help="Max issues to fetch")
+    parser.add_argument("--scrape-only", action="store_true", help="Only scrape, don't build skill")
+    parser.add_argument(
+        "--enhance", action="store_true", help="Enhance SKILL.md using Claude API after building (requires API key)"
+    )
+    parser.add_argument(
+        "--enhance-local", action="store_true", help="Enhance SKILL.md using Claude Code (no API key needed)"
+    )
+    parser.add_argument("--api-key", type=str, help="Anthropic API key for --enhance (or set ANTHROPIC_API_KEY)")
+    parser.add_argument(
+        "--non-interactive", action="store_true", help="Non-interactive mode for CI/CD (fail fast on rate limits)"
+    )
+    parser.add_argument("--profile", type=str, help="GitHub profile name to use from config")
 
     args = parser.parse_args()
 
     # Build config from args or file
     if args.config:
-        with open(args.config, 'r', encoding='utf-8') as f:
+        with open(args.config, encoding="utf-8") as f:
             config = json.load(f)
         # Override with CLI args if provided
         if args.non_interactive:
-            config['interactive'] = False
+            config["interactive"] = False
         if args.profile:
-            config['github_profile'] = args.profile
+            config["github_profile"] = args.profile
     elif args.repo:
         config = {
-            'repo': args.repo,
-            'name': args.name or args.repo.split('/')[-1],
-            'description': args.description or f'Use when working with {args.repo.split("/")[-1]}',
-            'github_token': args.token,
-            'include_issues': not args.no_issues,
-            'include_changelog': not args.no_changelog,
-            'include_releases': not args.no_releases,
-            'max_issues': args.max_issues,
-            'interactive': not args.non_interactive,
-            'github_profile': args.profile
+            "repo": args.repo,
+            "name": args.name or args.repo.split("/")[-1],
+            "description": args.description or f"Use when working with {args.repo.split('/')[-1]}",
+            "github_token": args.token,
+            "include_issues": not args.no_issues,
+            "include_changelog": not args.no_changelog,
+            "include_releases": not args.no_releases,
+            "max_issues": args.max_issues,
+            "interactive": not args.non_interactive,
+            "github_profile": args.profile,
         }
     else:
-        parser.error('Either --repo or --config is required')
+        parser.error("Either --repo or --config is required")
 
     try:
         # Phase 1: Scrape GitHub repository
@@ -1348,7 +1345,7 @@ Examples:
         converter = GitHubToSkillConverter(config)
         converter.build_skill()
 
-        skill_name = config.get('name', config['repo'].split('/')[-1])
+        skill_name = config.get("name", config["repo"].split("/")[-1])
         skill_dir = f"output/{skill_name}"
 
         # Phase 3: Optional enhancement
@@ -1357,9 +1354,10 @@ Examples:
 
             if args.enhance_local:
                 # Local enhancement using Claude Code
-                from skill_seekers.cli.enhance_skill_local import LocalSkillEnhancer
                 from pathlib import Path
 
+                from skill_seekers.cli.enhance_skill_local import LocalSkillEnhancer
+
                 enhancer = LocalSkillEnhancer(Path(skill_dir))
                 enhancer.run(headless=True)
                 logger.info("✅ Local enhancement complete!")
@@ -1367,7 +1365,8 @@ Examples:
             elif args.enhance:
                 # API-based enhancement
                 import os
-                api_key = args.api_key or os.environ.get('ANTHROPIC_API_KEY')
+
+                api_key = args.api_key or os.environ.get("ANTHROPIC_API_KEY")
                 if not api_key:
                     logger.error("❌ ANTHROPIC_API_KEY not set. Use --api-key or set environment variable.")
                     logger.info("💡 Tip: Use --enhance-local instead (no API key needed)")
@@ -1375,6 +1374,7 @@ Examples:
                     # Import and run API enhancement
                     try:
                         from skill_seekers.cli.enhance_skill import enhance_skill_md
+
                         enhance_skill_md(skill_dir, api_key)
                         logger.info("✅ API enhancement complete!")
                     except ImportError:
@@ -1386,7 +1386,7 @@ Examples:
         if not (args.enhance or args.enhance_local):
             logger.info("\n💡 Optional: Enhance SKILL.md with Claude:")
             logger.info(f"  Local (recommended):  skill-seekers enhance {skill_dir}/")
-            logger.info(f"                        or re-run with: --enhance-local")
+            logger.info("                        or re-run with: --enhance-local")
 
         logger.info(f"\nNext step: skill-seekers package {skill_dir}/")
 
@@ -1395,5 +1395,5 @@ Examples:
         sys.exit(1)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
diff --git a/src/skill_seekers/cli/guide_enhancer.py b/src/skill_seekers/cli/guide_enhancer.py
index 686b987..25a2e8d 100644
--- a/src/skill_seekers/cli/guide_enhancer.py
+++ b/src/skill_seekers/cli/guide_enhancer.py
@@ -20,7 +20,7 @@ import subprocess
 import tempfile
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Dict, List, Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING
 
 # Avoid circular imports by using TYPE_CHECKING
 if TYPE_CHECKING:
@@ -40,15 +40,17 @@ else:
         @dataclass
         class TroubleshootingItem:
             problem: str
-            symptoms: List[str] = field(default_factory=list)
+            symptoms: list[str] = field(default_factory=list)
             solution: str = ""
-            diagnostic_steps: List[str] = field(default_factory=list)
+            diagnostic_steps: list[str] = field(default_factory=list)
+
 
 logger = logging.getLogger(__name__)
 
 # Conditional import for Anthropic API
 try:
     import anthropic
+
     ANTHROPIC_AVAILABLE = True
 except ImportError:
     ANTHROPIC_AVAILABLE = False
@@ -58,9 +60,10 @@ except ImportError:
 @dataclass
 class StepEnhancement:
     """Enhanced step information (internal use only)"""
+
     step_index: int
     explanation: str  # Natural language explanation
-    variations: List[str] = field(default_factory=list)  # Alternative approaches
+    variations: list[str] = field(default_factory=list)  # Alternative approaches
 
 
 class GuideEnhancer:
@@ -81,7 +84,7 @@ class GuideEnhancer:
             mode: Enhancement mode - "api", "local", or "auto"
         """
         self.mode = self._detect_mode(mode)
-        self.api_key = os.environ.get('ANTHROPIC_API_KEY')
+        self.api_key = os.environ.get("ANTHROPIC_API_KEY")
         self.client = None
 
         if self.mode == "api":
@@ -119,7 +122,7 @@ class GuideEnhancer:
         """
         if requested_mode == "auto":
             # Prefer API if key available, else LOCAL
-            if os.environ.get('ANTHROPIC_API_KEY') and ANTHROPIC_AVAILABLE:
+            if os.environ.get("ANTHROPIC_API_KEY") and ANTHROPIC_AVAILABLE:
                 return "api"
             elif self._check_claude_cli():
                 return "local"
@@ -130,17 +133,12 @@ class GuideEnhancer:
     def _check_claude_cli(self) -> bool:
         """Check if Claude Code CLI is available."""
         try:
-            result = subprocess.run(
-                ['claude', '--version'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["claude", "--version"], capture_output=True, text=True, timeout=5)
             return result.returncode == 0
         except (FileNotFoundError, subprocess.TimeoutExpired):
             return False
 
-    def enhance_guide(self, guide_data: Dict) -> Dict:
+    def enhance_guide(self, guide_data: dict) -> dict:
         """
         Apply all 5 enhancements to a guide.
 
@@ -164,7 +162,7 @@ class GuideEnhancer:
             logger.info("📝 Returning original guide without enhancement")
             return guide_data
 
-    def enhance_step_descriptions(self, steps: List[Dict]) -> List[StepEnhancement]:
+    def enhance_step_descriptions(self, steps: list[dict]) -> list[StepEnhancement]:
         """
         Enhancement 1: Add natural language explanations to steps.
 
@@ -187,17 +185,17 @@ class GuideEnhancer:
             data = json.loads(response)
             return [
                 StepEnhancement(
-                    step_index=item.get('step_index', i),
-                    explanation=item.get('explanation', ''),
-                    variations=item.get('variations', [])
+                    step_index=item.get("step_index", i),
+                    explanation=item.get("explanation", ""),
+                    variations=item.get("variations", []),
                 )
-                for i, item in enumerate(data.get('step_descriptions', []))
+                for i, item in enumerate(data.get("step_descriptions", []))
             ]
         except (json.JSONDecodeError, KeyError) as e:
             logger.warning(f"⚠️  Failed to parse step descriptions: {e}")
             return []
 
-    def enhance_troubleshooting(self, guide_data: Dict) -> List[TroubleshootingItem]:
+    def enhance_troubleshooting(self, guide_data: dict) -> list[TroubleshootingItem]:
         """
         Enhancement 2: Generate diagnostic flows + solutions.
 
@@ -220,18 +218,18 @@ class GuideEnhancer:
             data = json.loads(response)
             return [
                 TroubleshootingItem(
-                    problem=item.get('problem', ''),
-                    symptoms=item.get('symptoms', []),
-                    diagnostic_steps=item.get('diagnostic_steps', []),
-                    solution=item.get('solution', '')
+                    problem=item.get("problem", ""),
+                    symptoms=item.get("symptoms", []),
+                    diagnostic_steps=item.get("diagnostic_steps", []),
+                    solution=item.get("solution", ""),
                 )
-                for item in data.get('troubleshooting', [])
+                for item in data.get("troubleshooting", [])
             ]
         except (json.JSONDecodeError, KeyError) as e:
             logger.warning(f"⚠️  Failed to parse troubleshooting items: {e}")
             return []
 
-    def enhance_prerequisites(self, prereqs: List[str]) -> List[PrerequisiteItem]:
+    def enhance_prerequisites(self, prereqs: list[str]) -> list[PrerequisiteItem]:
         """
         Enhancement 3: Explain why prerequisites are needed.
 
@@ -253,18 +251,14 @@ class GuideEnhancer:
         try:
             data = json.loads(response)
             return [
-                PrerequisiteItem(
-                    name=item.get('name', ''),
-                    why=item.get('why', ''),
-                    setup=item.get('setup', '')
-                )
-                for item in data.get('prerequisites_detailed', [])
+                PrerequisiteItem(name=item.get("name", ""), why=item.get("why", ""), setup=item.get("setup", ""))
+                for item in data.get("prerequisites_detailed", [])
             ]
         except (json.JSONDecodeError, KeyError) as e:
             logger.warning(f"⚠️  Failed to parse prerequisites: {e}")
             return []
 
-    def enhance_next_steps(self, guide_data: Dict) -> List[str]:
+    def enhance_next_steps(self, guide_data: dict) -> list[str]:
         """
         Enhancement 4: Suggest related guides and variations.
 
@@ -285,12 +279,12 @@ class GuideEnhancer:
 
         try:
             data = json.loads(response)
-            return data.get('next_steps', [])
+            return data.get("next_steps", [])
         except (json.JSONDecodeError, KeyError) as e:
             logger.warning(f"⚠️  Failed to parse next steps: {e}")
             return []
 
-    def enhance_use_cases(self, guide_data: Dict) -> List[str]:
+    def enhance_use_cases(self, guide_data: dict) -> list[str]:
         """
         Enhancement 5: Generate real-world scenario examples.
 
@@ -311,14 +305,14 @@ class GuideEnhancer:
 
         try:
             data = json.loads(response)
-            return data.get('use_cases', [])
+            return data.get("use_cases", [])
         except (json.JSONDecodeError, KeyError) as e:
             logger.warning(f"⚠️  Failed to parse use cases: {e}")
             return []
 
     # === AI Call Methods ===
 
-    def _call_ai(self, prompt: str, max_tokens: int = 4000) -> Optional[str]:
+    def _call_ai(self, prompt: str, max_tokens: int = 4000) -> str | None:
         """
         Call AI with the given prompt.
 
@@ -335,7 +329,7 @@ class GuideEnhancer:
             return self._call_claude_local(prompt)
         return None
 
-    def _call_claude_api(self, prompt: str, max_tokens: int = 4000) -> Optional[str]:
+    def _call_claude_api(self, prompt: str, max_tokens: int = 4000) -> str | None:
         """
         Call Claude API.
 
@@ -351,16 +345,14 @@ class GuideEnhancer:
 
         try:
             response = self.client.messages.create(
-                model="claude-sonnet-4-20250514",
-                max_tokens=max_tokens,
-                messages=[{"role": "user", "content": prompt}]
+                model="claude-sonnet-4-20250514", max_tokens=max_tokens, messages=[{"role": "user", "content": prompt}]
             )
             return response.content[0].text
         except Exception as e:
             logger.warning(f"⚠️  Claude API call failed: {e}")
             return None
 
-    def _call_claude_local(self, prompt: str) -> Optional[str]:
+    def _call_claude_local(self, prompt: str) -> str | None:
         """
         Call Claude Code CLI.
 
@@ -372,16 +364,16 @@ class GuideEnhancer:
         """
         try:
             # Create temporary prompt file
-            with tempfile.NamedTemporaryFile(mode='w', suffix='.md', delete=False) as f:
+            with tempfile.NamedTemporaryFile(mode="w", suffix=".md", delete=False) as f:
                 f.write(prompt)
                 prompt_file = f.name
 
             # Run claude CLI
             result = subprocess.run(
-                ['claude', prompt_file],
+                ["claude", prompt_file],
                 capture_output=True,
                 text=True,
-                timeout=300  # 5 min timeout
+                timeout=300,  # 5 min timeout
             )
 
             # Clean up prompt file
@@ -399,7 +391,7 @@ class GuideEnhancer:
 
     # === Prompt Creation Methods ===
 
-    def _enhance_via_api(self, guide_data: Dict) -> Dict:
+    def _enhance_via_api(self, guide_data: dict) -> dict:
         """
         Enhance guide via API mode.
 
@@ -417,7 +409,7 @@ class GuideEnhancer:
 
         return self._parse_enhancement_response(response, guide_data)
 
-    def _enhance_via_local(self, guide_data: Dict) -> Dict:
+    def _enhance_via_local(self, guide_data: dict) -> dict:
         """
         Enhance guide via LOCAL mode.
 
@@ -435,7 +427,7 @@ class GuideEnhancer:
 
         return self._parse_enhancement_response(response, guide_data)
 
-    def _create_enhancement_prompt(self, guide_data: Dict) -> str:
+    def _create_enhancement_prompt(self, guide_data: dict) -> str:
         """
         Create comprehensive enhancement prompt for all 5 enhancements.
 
@@ -445,13 +437,13 @@ class GuideEnhancer:
         Returns:
             Complete prompt text
         """
-        title = guide_data.get('title', 'Unknown Guide')
-        steps = guide_data.get('steps', [])
-        language = guide_data.get('language', 'python')
-        prerequisites = guide_data.get('prerequisites', [])
+        title = guide_data.get("title", "Unknown Guide")
+        steps = guide_data.get("steps", [])
+        language = guide_data.get("language", "python")
+        prerequisites = guide_data.get("prerequisites", [])
 
         steps_text = self._format_steps_for_prompt(steps)
-        prereqs_text = ', '.join(prerequisites) if prerequisites else 'None specified'
+        prereqs_text = ", ".join(prerequisites) if prerequisites else "None specified"
 
         prompt = f"""I need you to enhance this how-to guide with 5 improvements:
 
@@ -528,7 +520,7 @@ IMPORTANT: Return ONLY valid JSON, no markdown code blocks or extra text.
 """
         return prompt
 
-    def _create_step_description_prompt(self, steps: List[Dict]) -> str:
+    def _create_step_description_prompt(self, steps: list[dict]) -> str:
         """Create prompt for step descriptions only."""
         steps_text = self._format_steps_for_prompt(steps)
         return f"""Generate natural language explanations for these code steps:
@@ -546,11 +538,11 @@ Return JSON:
 IMPORTANT: Return ONLY valid JSON.
 """
 
-    def _create_troubleshooting_prompt(self, guide_data: Dict) -> str:
+    def _create_troubleshooting_prompt(self, guide_data: dict) -> str:
         """Create prompt for troubleshooting items."""
-        title = guide_data.get('title', 'Unknown')
-        language = guide_data.get('language', 'python')
-        steps = guide_data.get('steps', [])
+        title = guide_data.get("title", "Unknown")
+        language = guide_data.get("language", "python")
+        steps = guide_data.get("steps", [])
         steps_text = self._format_steps_for_prompt(steps)
 
         return f"""Generate troubleshooting guidance for this {language} workflow:
@@ -575,9 +567,9 @@ Return JSON with 3-5 common errors:
 IMPORTANT: Return ONLY valid JSON.
 """
 
-    def _create_prerequisites_prompt(self, prereqs: List[str]) -> str:
+    def _create_prerequisites_prompt(self, prereqs: list[str]) -> str:
         """Create prompt for prerequisites enhancement."""
-        prereqs_text = ', '.join(prereqs)
+        prereqs_text = ", ".join(prereqs)
         return f"""Explain why these prerequisites are needed and how to install them:
 
 Prerequisites: {prereqs_text}
@@ -593,9 +585,9 @@ Return JSON:
 IMPORTANT: Return ONLY valid JSON.
 """
 
-    def _create_next_steps_prompt(self, guide_data: Dict) -> str:
+    def _create_next_steps_prompt(self, guide_data: dict) -> str:
         """Create prompt for next steps suggestions."""
-        title = guide_data.get('title', 'Unknown')
+        title = guide_data.get("title", "Unknown")
         return f"""Suggest 3-5 related guides and learning paths after completing: {title}
 
 Return JSON:
@@ -610,10 +602,10 @@ Return JSON:
 IMPORTANT: Return ONLY valid JSON.
 """
 
-    def _create_use_cases_prompt(self, guide_data: Dict) -> str:
+    def _create_use_cases_prompt(self, guide_data: dict) -> str:
         """Create prompt for use case examples."""
-        title = guide_data.get('title', 'Unknown')
-        description = guide_data.get('description', '')
+        title = guide_data.get("title", "Unknown")
+        description = guide_data.get("description", "")
 
         return f"""Generate 2-3 real-world use cases for this guide:
 
@@ -632,23 +624,23 @@ Return JSON:
 IMPORTANT: Return ONLY valid JSON.
 """
 
-    def _format_steps_for_prompt(self, steps: List[Dict]) -> str:
+    def _format_steps_for_prompt(self, steps: list[dict]) -> str:
         """Format steps for inclusion in prompts."""
         if not steps:
             return "No steps provided"
 
         formatted = []
         for i, step in enumerate(steps):
-            desc = step.get('description', '')
-            code = step.get('code', '')
+            desc = step.get("description", "")
+            code = step.get("code", "")
             if code:
-                formatted.append(f"Step {i+1}: {desc}\n```\n{code}\n```")
+                formatted.append(f"Step {i + 1}: {desc}\n```\n{code}\n```")
             else:
-                formatted.append(f"Step {i+1}: {desc}")
+                formatted.append(f"Step {i + 1}: {desc}")
 
         return "\n\n".join(formatted)
 
-    def _parse_enhancement_response(self, response: str, guide_data: Dict) -> Dict:
+    def _parse_enhancement_response(self, response: str, guide_data: dict) -> dict:
         """
         Parse AI enhancement response.
 
@@ -661,8 +653,8 @@ IMPORTANT: Return ONLY valid JSON.
         """
         try:
             # Try to extract JSON from response (in case there's extra text)
-            json_start = response.find('{')
-            json_end = response.rfind('}') + 1
+            json_start = response.find("{")
+            json_end = response.rfind("}") + 1
             if json_start >= 0 and json_end > json_start:
                 json_text = response[json_start:json_end]
                 data = json.loads(json_text)
@@ -673,46 +665,42 @@ IMPORTANT: Return ONLY valid JSON.
             enhanced = guide_data.copy()
 
             # Step descriptions
-            if 'step_descriptions' in data:
-                enhanced['step_enhancements'] = [
+            if "step_descriptions" in data:
+                enhanced["step_enhancements"] = [
                     StepEnhancement(
-                        step_index=item.get('step_index', i),
-                        explanation=item.get('explanation', ''),
-                        variations=item.get('variations', [])
+                        step_index=item.get("step_index", i),
+                        explanation=item.get("explanation", ""),
+                        variations=item.get("variations", []),
                     )
-                    for i, item in enumerate(data['step_descriptions'])
+                    for i, item in enumerate(data["step_descriptions"])
                 ]
 
             # Troubleshooting
-            if 'troubleshooting' in data:
-                enhanced['troubleshooting_detailed'] = [
+            if "troubleshooting" in data:
+                enhanced["troubleshooting_detailed"] = [
                     TroubleshootingItem(
-                        problem=item.get('problem', ''),
-                        symptoms=item.get('symptoms', []),
-                        diagnostic_steps=item.get('diagnostic_steps', []),
-                        solution=item.get('solution', '')
+                        problem=item.get("problem", ""),
+                        symptoms=item.get("symptoms", []),
+                        diagnostic_steps=item.get("diagnostic_steps", []),
+                        solution=item.get("solution", ""),
                     )
-                    for item in data['troubleshooting']
+                    for item in data["troubleshooting"]
                 ]
 
             # Prerequisites
-            if 'prerequisites_detailed' in data:
-                enhanced['prerequisites_detailed'] = [
-                    PrerequisiteItem(
-                        name=item.get('name', ''),
-                        why=item.get('why', ''),
-                        setup=item.get('setup', '')
-                    )
-                    for item in data['prerequisites_detailed']
+            if "prerequisites_detailed" in data:
+                enhanced["prerequisites_detailed"] = [
+                    PrerequisiteItem(name=item.get("name", ""), why=item.get("why", ""), setup=item.get("setup", ""))
+                    for item in data["prerequisites_detailed"]
                 ]
 
             # Next steps
-            if 'next_steps' in data:
-                enhanced['next_steps_detailed'] = data['next_steps']
+            if "next_steps" in data:
+                enhanced["next_steps_detailed"] = data["next_steps"]
 
             # Use cases
-            if 'use_cases' in data:
-                enhanced['use_cases'] = data['use_cases']
+            if "use_cases" in data:
+                enhanced["use_cases"] = data["use_cases"]
 
             logger.info("✅ Successfully enhanced guide with all 5 improvements")
             return enhanced
diff --git a/src/skill_seekers/cli/how_to_guide_builder.py b/src/skill_seekers/cli/how_to_guide_builder.py
index 7b952bf..2c8b3f5 100644
--- a/src/skill_seekers/cli/how_to_guide_builder.py
+++ b/src/skill_seekers/cli/how_to_guide_builder.py
@@ -30,15 +30,15 @@ Example workflow → guide transformation:
 """
 
 import ast
-import re
+import hashlib
 import json
 import logging
-import hashlib
-from dataclasses import dataclass, field, asdict
-from typing import List, Dict, Optional, Literal, Tuple, Set
-from pathlib import Path
+import re
 from collections import defaultdict
+from dataclasses import asdict, dataclass, field
 from datetime import datetime
+from pathlib import Path
+from typing import Literal
 
 logger = logging.getLogger(__name__)
 
@@ -47,9 +47,11 @@ logger = logging.getLogger(__name__)
 # DATA MODELS
 # ============================================================================
 
+
 @dataclass
 class PrerequisiteItem:
     """Enhanced prerequisite with explanation (AI enhancement)"""
+
     name: str
     why: str  # Why this is needed
     setup: str  # How to install/configure
@@ -58,87 +60,88 @@ class PrerequisiteItem:
 @dataclass
 class TroubleshootingItem:
     """Enhanced troubleshooting with solutions (AI enhancement)"""
+
     problem: str
-    symptoms: List[str] = field(default_factory=list)  # How to recognize this issue
+    symptoms: list[str] = field(default_factory=list)  # How to recognize this issue
     solution: str = ""  # Step-by-step fix
-    diagnostic_steps: List[str] = field(default_factory=list)  # How to diagnose
+    diagnostic_steps: list[str] = field(default_factory=list)  # How to diagnose
 
 
 @dataclass
 class WorkflowStep:
     """Single step in a workflow guide"""
+
     step_number: int
     code: str
     description: str
-    expected_result: Optional[str] = None
-    verification: Optional[str] = None  # Assertion or checkpoint
-    setup_required: Optional[str] = None
-    explanation: Optional[str] = None  # Why this step matters
-    common_pitfall: Optional[str] = None  # Warning for this step
-    common_variations: List[str] = field(default_factory=list)  # AI: Alternative approaches
+    expected_result: str | None = None
+    verification: str | None = None  # Assertion or checkpoint
+    setup_required: str | None = None
+    explanation: str | None = None  # Why this step matters
+    common_pitfall: str | None = None  # Warning for this step
+    common_variations: list[str] = field(default_factory=list)  # AI: Alternative approaches
 
 
 @dataclass
 class HowToGuide:
     """Complete how-to guide generated from workflow(s)"""
+
     guide_id: str
     title: str
     overview: str
     complexity_level: Literal["beginner", "intermediate", "advanced"]
 
     # Prerequisites
-    prerequisites: List[str] = field(default_factory=list)
-    required_imports: List[str] = field(default_factory=list)
-    required_fixtures: List[str] = field(default_factory=list)
+    prerequisites: list[str] = field(default_factory=list)
+    required_imports: list[str] = field(default_factory=list)
+    required_fixtures: list[str] = field(default_factory=list)
 
     # Content
-    workflows: List[Dict] = field(default_factory=list)  # Source workflow examples
-    steps: List[WorkflowStep] = field(default_factory=list)
+    workflows: list[dict] = field(default_factory=list)  # Source workflow examples
+    steps: list[WorkflowStep] = field(default_factory=list)
 
     # Metadata
     use_case: str = ""
-    tags: List[str] = field(default_factory=list)
+    tags: list[str] = field(default_factory=list)
     estimated_time: str = "10 minutes"
-    source_files: List[str] = field(default_factory=list)
+    source_files: list[str] = field(default_factory=list)
 
     # Optional AI enhancement (basic)
-    common_pitfalls: List[str] = field(default_factory=list)
-    troubleshooting: Dict[str, str] = field(default_factory=dict)
-    variations: List[str] = field(default_factory=list)
-    related_guides: List[str] = field(default_factory=list)
+    common_pitfalls: list[str] = field(default_factory=list)
+    troubleshooting: dict[str, str] = field(default_factory=dict)
+    variations: list[str] = field(default_factory=list)
+    related_guides: list[str] = field(default_factory=list)
 
     # AI enhancement (comprehensive - NEW)
-    prerequisites_detailed: List[PrerequisiteItem] = field(default_factory=list)
-    troubleshooting_detailed: List[TroubleshootingItem] = field(default_factory=list)
-    next_steps_detailed: List[str] = field(default_factory=list)
-    use_cases: List[str] = field(default_factory=list)
+    prerequisites_detailed: list[PrerequisiteItem] = field(default_factory=list)
+    troubleshooting_detailed: list[TroubleshootingItem] = field(default_factory=list)
+    next_steps_detailed: list[str] = field(default_factory=list)
+    use_cases: list[str] = field(default_factory=list)
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Convert to dictionary"""
         result = asdict(self)
         # Convert WorkflowStep objects to dicts
-        result['steps'] = [asdict(step) for step in self.steps]
+        result["steps"] = [asdict(step) for step in self.steps]
         return result
 
 
 @dataclass
 class GuideCollection:
     """Collection of guides organized by category"""
-    total_guides: int
-    guides_by_complexity: Dict[str, int]
-    guides_by_use_case: Dict[str, List[HowToGuide]]
-    guides: List[HowToGuide]
 
-    def to_dict(self) -> Dict:
+    total_guides: int
+    guides_by_complexity: dict[str, int]
+    guides_by_use_case: dict[str, list[HowToGuide]]
+    guides: list[HowToGuide]
+
+    def to_dict(self) -> dict:
         """Convert to dictionary"""
         return {
-            'total_guides': self.total_guides,
-            'guides_by_complexity': self.guides_by_complexity,
-            'guides_by_use_case': {
-                k: [g.to_dict() for g in v]
-                for k, v in self.guides_by_use_case.items()
-            },
-            'guides': [g.to_dict() for g in self.guides]
+            "total_guides": self.total_guides,
+            "guides_by_complexity": self.guides_by_complexity,
+            "guides_by_use_case": {k: [g.to_dict() for g in v] for k, v in self.guides_by_use_case.items()},
+            "guides": [g.to_dict() for g in self.guides],
         }
 
 
@@ -146,10 +149,11 @@ class GuideCollection:
 # WORKFLOW ANALYZER
 # ============================================================================
 
+
 class WorkflowAnalyzer:
     """Analyze workflow examples to extract steps and metadata"""
 
-    def analyze_workflow(self, workflow: Dict) -> Tuple[List[WorkflowStep], Dict]:
+    def analyze_workflow(self, workflow: dict) -> tuple[list[WorkflowStep], dict]:
         """
         Deep analysis of workflow structure.
 
@@ -159,11 +163,11 @@ class WorkflowAnalyzer:
         Returns:
             (steps, metadata) where metadata includes prerequisites, complexity, etc.
         """
-        code = workflow.get('code', '')
-        language = workflow.get('language', 'python').lower()
+        code = workflow.get("code", "")
+        language = workflow.get("language", "python").lower()
 
         # Extract steps based on language
-        if language == 'python':
+        if language == "python":
             steps = self._extract_steps_python(code, workflow)
         else:
             steps = self._extract_steps_heuristic(code, workflow)
@@ -180,12 +184,12 @@ class WorkflowAnalyzer:
                 step.verification = verifications[i]
 
         # Calculate complexity
-        metadata['complexity_level'] = self._calculate_complexity(steps, workflow)
-        metadata['estimated_time'] = self._estimate_time(steps)
+        metadata["complexity_level"] = self._calculate_complexity(steps, workflow)
+        metadata["estimated_time"] = self._estimate_time(steps)
 
         return steps, metadata
 
-    def _extract_steps_python(self, code: str, workflow: Dict) -> List[WorkflowStep]:
+    def _extract_steps_python(self, code: str, workflow: dict) -> list[WorkflowStep]:
         """Extract steps from Python code using AST"""
         steps = []
 
@@ -218,12 +222,11 @@ class WorkflowAnalyzer:
                 if idx + 1 < len(statements) and isinstance(statements[idx + 1], ast.Assert):
                     verification = ast.get_source_segment(code, statements[idx + 1])
 
-                steps.append(WorkflowStep(
-                    step_number=step_num,
-                    code=step_code,
-                    description=description,
-                    verification=verification
-                ))
+                steps.append(
+                    WorkflowStep(
+                        step_number=step_num, code=step_code, description=description, verification=verification
+                    )
+                )
                 step_num += 1
 
         except SyntaxError:
@@ -232,10 +235,10 @@ class WorkflowAnalyzer:
 
         return steps
 
-    def _extract_steps_heuristic(self, code: str, workflow: Dict) -> List[WorkflowStep]:
+    def _extract_steps_heuristic(self, code: str, workflow: dict) -> list[WorkflowStep]:
         """Extract steps using heuristics (for non-Python or invalid syntax)"""
         steps = []
-        lines = code.split('\n')
+        lines = code.split("\n")
 
         current_step = []
         step_num = 1
@@ -244,17 +247,13 @@ class WorkflowAnalyzer:
             line_stripped = line.strip()
 
             # Skip empty lines and comments
-            if not line_stripped or line_stripped.startswith('#'):
+            if not line_stripped or line_stripped.startswith("#"):
                 if current_step:
                     # End of current step
-                    step_code = '\n'.join(current_step)
+                    step_code = "\n".join(current_step)
                     description = self._infer_description_from_code(step_code)
 
-                    steps.append(WorkflowStep(
-                        step_number=step_num,
-                        code=step_code,
-                        description=description
-                    ))
+                    steps.append(WorkflowStep(step_number=step_num, code=step_code, description=description))
                     step_num += 1
                     current_step = []
                 continue
@@ -263,13 +262,9 @@ class WorkflowAnalyzer:
 
         # Add final step
         if current_step:
-            step_code = '\n'.join(current_step)
+            step_code = "\n".join(current_step)
             description = self._infer_description_from_code(step_code)
-            steps.append(WorkflowStep(
-                step_number=step_num,
-                code=step_code,
-                description=description
-            ))
+            steps.append(WorkflowStep(step_number=step_num, code=step_code, description=description))
 
         return steps
 
@@ -285,7 +280,7 @@ class WorkflowAnalyzer:
                 func_name = self._get_name(node.value.func)
                 return f"Call {func_name}()"
 
-        return code.split('\n')[0]  # First line as fallback
+        return code.split("\n")[0]  # First line as fallback
 
     def _describe_value(self, node: ast.AST) -> str:
         """Describe AST value node"""
@@ -313,71 +308,67 @@ class WorkflowAnalyzer:
         code = code.strip()
 
         # Method call patterns
-        if '(' in code and ')' in code:
-            match = re.search(r'(\w+)\s*\(', code)
+        if "(" in code and ")" in code:
+            match = re.search(r"(\w+)\s*\(", code)
             if match:
                 return f"Call {match.group(1)}()"
 
         # Assignment patterns
-        if '=' in code and not code.startswith('assert'):
-            parts = code.split('=', 1)
+        if "=" in code and not code.startswith("assert"):
+            parts = code.split("=", 1)
             var_name = parts[0].strip()
             return f"Create {var_name}"
 
         # Assertion patterns
-        if code.startswith('assert'):
+        if code.startswith("assert"):
             return "Verify result"
 
-        return code.split('\n')[0]  # First line
+        return code.split("\n")[0]  # First line
 
-    def _detect_prerequisites(self, workflow: Dict) -> Dict:
+    def _detect_prerequisites(self, workflow: dict) -> dict:
         """Detect prerequisites from workflow"""
-        metadata = {
-            'prerequisites': [],
-            'required_imports': [],
-            'required_fixtures': []
-        }
+        metadata = {"prerequisites": [], "required_imports": [], "required_fixtures": []}
 
         # Get dependencies from workflow
-        dependencies = workflow.get('dependencies', [])
-        metadata['required_imports'] = dependencies
+        dependencies = workflow.get("dependencies", [])
+        metadata["required_imports"] = dependencies
 
         # Get setup code
-        setup_code = workflow.get('setup_code')
+        setup_code = workflow.get("setup_code")
         if setup_code:
-            metadata['prerequisites'].append("Setup code must be executed first")
+            metadata["prerequisites"].append("Setup code must be executed first")
 
         # Check for common fixtures in test name or setup
-        test_name = workflow.get('test_name', '').lower()
-        if 'database' in test_name or (setup_code and 'database' in setup_code.lower()):
-            metadata['required_fixtures'].append('database')
-        if 'api' in test_name or (setup_code and 'api' in setup_code.lower()):
-            metadata['required_fixtures'].append('api_client')
+        test_name = workflow.get("test_name", "").lower()
+        if "database" in test_name or (setup_code and "database" in setup_code.lower()):
+            metadata["required_fixtures"].append("database")
+        if "api" in test_name or (setup_code and "api" in setup_code.lower()):
+            metadata["required_fixtures"].append("api_client")
 
         return metadata
 
-    def _find_verification_points(self, code: str) -> List[str]:
+    def _find_verification_points(self, code: str) -> list[str]:
         """Find assertion statements in code"""
         verifications = []
 
-        for line in code.split('\n'):
+        for line in code.split("\n"):
             line_stripped = line.strip()
-            if line_stripped.startswith('assert'):
+            if line_stripped.startswith("assert"):
                 verifications.append(line_stripped)
 
         return verifications
 
-    def _calculate_complexity(self, steps: List[WorkflowStep], workflow: Dict) -> str:
+    def _calculate_complexity(self, steps: list[WorkflowStep], workflow: dict) -> str:
         """Calculate complexity level"""
         num_steps = len(steps)
 
         # Check for advanced patterns
-        code = workflow.get('code', '')
-        has_async = 'async' in code or 'await' in code
-        has_mock = 'mock' in code.lower() or 'patch' in code.lower()
-        has_error_handling = 'try' in code or 'except' in code
+        code = workflow.get("code", "")
+        has_async = "async" in code or "await" in code
+        has_mock = "mock" in code.lower() or "patch" in code.lower()
+        has_error_handling = "try" in code or "except" in code
 
-        complexity_score = workflow.get('complexity_score', 0.5)
+        complexity_score = workflow.get("complexity_score", 0.5)
 
         # Determine level
         if num_steps <= 3 and not has_async and not has_mock:
@@ -387,7 +378,7 @@ class WorkflowAnalyzer:
         else:
             return "intermediate"
 
-    def _estimate_time(self, steps: List[WorkflowStep]) -> str:
+    def _estimate_time(self, steps: list[WorkflowStep]) -> str:
         """Estimate time to complete guide"""
         num_steps = len(steps)
 
@@ -405,14 +396,11 @@ class WorkflowAnalyzer:
 # WORKFLOW GROUPER
 # ============================================================================
 
+
 class WorkflowGrouper:
     """Group related workflows into coherent guides"""
 
-    def group_workflows(
-        self,
-        workflows: List[Dict],
-        strategy: str = "ai-tutorial-group"
-    ) -> Dict[str, List[Dict]]:
+    def group_workflows(self, workflows: list[dict], strategy: str = "ai-tutorial-group") -> dict[str, list[dict]]:
         """
         Group workflows using specified strategy.
 
@@ -439,14 +427,14 @@ class WorkflowGrouper:
                 groups = self._group_by_file_path(workflows)
             return groups
 
-    def _group_by_ai_tutorial_group(self, workflows: List[Dict]) -> Dict[str, List[Dict]]:
+    def _group_by_ai_tutorial_group(self, workflows: list[dict]) -> dict[str, list[dict]]:
         """Group by AI-generated tutorial_group (from C3.6 enhancement)"""
         groups = defaultdict(list)
         ungrouped = []
 
         for workflow in workflows:
-            ai_analysis = workflow.get('ai_analysis', {})
-            tutorial_group = ai_analysis.get('tutorial_group')
+            ai_analysis = workflow.get("ai_analysis", {})
+            tutorial_group = ai_analysis.get("tutorial_group")
 
             if tutorial_group:
                 groups[tutorial_group].append(workflow)
@@ -455,56 +443,52 @@ class WorkflowGrouper:
 
         # Put ungrouped workflows in individual guides
         for workflow in ungrouped:
-            test_name = workflow.get('test_name', 'Unknown')
+            test_name = workflow.get("test_name", "Unknown")
             # Clean test name for title
             title = self._clean_test_name(test_name)
             groups[title] = [workflow]
 
         return dict(groups)
 
-    def _group_by_file_path(self, workflows: List[Dict]) -> Dict[str, List[Dict]]:
+    def _group_by_file_path(self, workflows: list[dict]) -> dict[str, list[dict]]:
         """Group workflows from same test file"""
         groups = defaultdict(list)
 
         for workflow in workflows:
-            file_path = workflow.get('file_path', '')
+            file_path = workflow.get("file_path", "")
             # Extract meaningful name from file path
-            file_name = Path(file_path).stem if file_path else 'Unknown'
+            file_name = Path(file_path).stem if file_path else "Unknown"
             # Remove test_ prefix
-            group_name = file_name.replace('test_', '').replace('_', ' ').title()
+            group_name = file_name.replace("test_", "").replace("_", " ").title()
             groups[group_name].append(workflow)
 
         return dict(groups)
 
-    def _group_by_test_name(self, workflows: List[Dict]) -> Dict[str, List[Dict]]:
+    def _group_by_test_name(self, workflows: list[dict]) -> dict[str, list[dict]]:
         """Group by common test name prefixes"""
         groups = defaultdict(list)
 
         for workflow in workflows:
-            test_name = workflow.get('test_name', '')
+            test_name = workflow.get("test_name", "")
             # Extract prefix (e.g., test_auth_login → auth)
             prefix = self._extract_prefix(test_name)
             groups[prefix].append(workflow)
 
         return dict(groups)
 
-    def _group_by_complexity(self, workflows: List[Dict]) -> Dict[str, List[Dict]]:
+    def _group_by_complexity(self, workflows: list[dict]) -> dict[str, list[dict]]:
         """Group by complexity level"""
-        groups = {
-            'Beginner': [],
-            'Intermediate': [],
-            'Advanced': []
-        }
+        groups = {"Beginner": [], "Intermediate": [], "Advanced": []}
 
         for workflow in workflows:
-            complexity_score = workflow.get('complexity_score', 0.5)
+            complexity_score = workflow.get("complexity_score", 0.5)
 
             if complexity_score < 0.4:
-                groups['Beginner'].append(workflow)
+                groups["Beginner"].append(workflow)
             elif complexity_score < 0.7:
-                groups['Intermediate'].append(workflow)
+                groups["Intermediate"].append(workflow)
             else:
-                groups['Advanced'].append(workflow)
+                groups["Advanced"].append(workflow)
 
         # Remove empty groups
         return {k: v for k, v in groups.items() if v}
@@ -512,18 +496,18 @@ class WorkflowGrouper:
     def _clean_test_name(self, test_name: str) -> str:
         """Clean test name to readable title"""
         # Remove test_ prefix
-        name = test_name.replace('test_', '')
+        name = test_name.replace("test_", "")
         # Replace underscores with spaces
-        name = name.replace('_', ' ')
+        name = name.replace("_", " ")
         # Title case
         return name.title()
 
     def _extract_prefix(self, test_name: str) -> str:
         """Extract prefix from test name"""
         # Remove test_ prefix
-        name = test_name.replace('test_', '')
+        name = test_name.replace("test_", "")
         # Get first part before underscore
-        parts = name.split('_')
+        parts = name.split("_")
         if len(parts) > 1:
             return parts[0].title()
         return self._clean_test_name(test_name)
@@ -533,6 +517,7 @@ class WorkflowGrouper:
 # GUIDE GENERATOR
 # ============================================================================
 
+
 class GuideGenerator:
     """Generate markdown guides from workflow data"""
 
@@ -574,7 +559,7 @@ class GuideGenerator:
         # Footer
         sections.append(self._create_footer(guide))
 
-        return '\n\n'.join(sections)
+        return "\n\n".join(sections)
 
     def _create_header(self, guide: HowToGuide) -> str:
         """Create guide header with metadata"""
@@ -586,7 +571,7 @@ class GuideGenerator:
         if guide.tags:
             lines.append(f"**Tags**: {', '.join(guide.tags)}")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
     def _create_overview(self, guide: HowToGuide) -> str:
         """Create overview section"""
@@ -618,16 +603,16 @@ class GuideGenerator:
             lines.append("")
 
         # Setup code if available
-        if guide.workflows and guide.workflows[0].get('setup_code'):
-            setup_code = guide.workflows[0]['setup_code']
+        if guide.workflows and guide.workflows[0].get("setup_code"):
+            setup_code = guide.workflows[0]["setup_code"]
             lines.append("**Setup Required:**")
             lines.append("```python")
             lines.append(setup_code)
             lines.append("```")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def _create_steps_section(self, steps: List[WorkflowStep]) -> str:
+    def _create_steps_section(self, steps: list[WorkflowStep]) -> str:
         """Create step-by-step guide section"""
         lines = ["## Step-by-Step Guide"]
         lines.append("")
@@ -654,7 +639,7 @@ class GuideGenerator:
 
             # Verification checkpoint
             if step.verification:
-                lines.append(f"**Verification:**")
+                lines.append("**Verification:**")
                 lines.append("```python")
                 lines.append(step.verification)
                 lines.append("```")
@@ -665,7 +650,7 @@ class GuideGenerator:
                 lines.append(f"⚠️ **Common Pitfall:** {step.common_pitfall}")
                 lines.append("")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
     def _create_complete_example(self, guide: HowToGuide) -> str:
         """Create complete working example"""
@@ -678,14 +663,14 @@ class GuideGenerator:
             workflow = guide.workflows[0]
 
             # Add setup code if present
-            if workflow.get('setup_code'):
+            if workflow.get("setup_code"):
                 lines.append("# Setup")
-                lines.append(workflow['setup_code'])
+                lines.append(workflow["setup_code"])
                 lines.append("")
 
             # Add main workflow code
             lines.append("# Workflow")
-            lines.append(workflow.get('code', ''))
+            lines.append(workflow.get("code", ""))
         else:
             # Combine all steps
             for step in guide.steps:
@@ -696,7 +681,7 @@ class GuideGenerator:
                 lines.append("")
 
         lines.append("```")
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
     def _create_troubleshooting(self, guide: HowToGuide) -> str:
         """Create troubleshooting section"""
@@ -719,7 +704,7 @@ class GuideGenerator:
                 lines.append(f"**Solution:** {solution}")
                 lines.append("")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
     def _create_next_steps(self, guide: HowToGuide) -> str:
         """Create next steps and related guides"""
@@ -741,7 +726,7 @@ class GuideGenerator:
                 lines.append(f"- [{related}]")
             lines.append("")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
     def _create_footer(self, guide: HowToGuide) -> str:
         """Create guide footer with metadata"""
@@ -753,7 +738,7 @@ class GuideGenerator:
 
         return f"---\n\n*{' | '.join(source_info)}*"
 
-    def generate_index(self, guides: List[HowToGuide]) -> str:
+    def generate_index(self, guides: list[HowToGuide]) -> str:
         """
         Generate index/TOC markdown.
 
@@ -783,8 +768,10 @@ class GuideGenerator:
             lines.append(f"### {use_case} ({len(case_guides)} guides)")
             for guide in sorted(case_guides, key=lambda g: g.complexity_level):
                 # Create filename from guide title
-                filename = guide.title.lower().replace(' ', '-').replace(':', '')
-                lines.append(f"- [How To: {guide.title}]({use_case.lower()}/{filename}.md) - {guide.complexity_level.title()}")
+                filename = guide.title.lower().replace(" ", "-").replace(":", "")
+                lines.append(
+                    f"- [How To: {guide.title}]({use_case.lower()}/{filename}.md) - {guide.complexity_level.title()}"
+                )
             lines.append("")
 
         # Group by difficulty
@@ -795,7 +782,7 @@ class GuideGenerator:
         lines.append("## By Difficulty Level")
         lines.append("")
 
-        for level in ['beginner', 'intermediate', 'advanced']:
+        for level in ["beginner", "intermediate", "advanced"]:
             if level in by_complexity:
                 level_guides = by_complexity[level]
                 lines.append(f"### {level.title()} ({len(level_guides)} guides)")
@@ -803,13 +790,14 @@ class GuideGenerator:
                     lines.append(f"- {guide.title}")
                 lines.append("")
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
 
 # ============================================================================
 # HOW-TO GUIDE BUILDER (Main Orchestrator)
 # ============================================================================
 
+
 class HowToGuideBuilder:
     """Main orchestrator for building how-to guides from workflow examples"""
 
@@ -827,11 +815,11 @@ class HowToGuideBuilder:
 
     def build_guides_from_examples(
         self,
-        examples: List[Dict],
+        examples: list[dict],
         grouping_strategy: str = "ai-tutorial-group",
-        output_dir: Optional[Path] = None,
+        output_dir: Path | None = None,
         enhance_with_ai: bool = True,
-        ai_mode: str = "auto"
+        ai_mode: str = "auto",
     ) -> GuideCollection:
         """
         Main entry point - build guides from workflow examples.
@@ -853,6 +841,7 @@ class HowToGuideBuilder:
         if enhance_with_ai and ai_mode != "none":
             try:
                 from .guide_enhancer import GuideEnhancer
+
                 enhancer = GuideEnhancer(mode=ai_mode)
                 logger.info(f"✨ AI enhancement enabled (mode: {enhancer.mode})")
             except Exception as e:
@@ -865,12 +854,7 @@ class HowToGuideBuilder:
 
         if not workflows:
             logger.warning("No workflow examples found!")
-            return GuideCollection(
-                total_guides=0,
-                guides_by_complexity={},
-                guides_by_use_case={},
-                guides=[]
-            )
+            return GuideCollection(total_guides=0, guides_by_complexity={}, guides_by_use_case={}, guides=[])
 
         # Group workflows
         grouped_workflows = self.grouper.group_workflows(workflows, grouping_strategy)
@@ -892,11 +876,11 @@ class HowToGuideBuilder:
         logger.info(f"✅ Generated {len(guides)} how-to guides")
         return collection
 
-    def _extract_workflow_examples(self, examples: List[Dict]) -> List[Dict]:
+    def _extract_workflow_examples(self, examples: list[dict]) -> list[dict]:
         """Filter to workflow category only"""
-        return [ex for ex in examples if ex.get('category') == 'workflow']
+        return [ex for ex in examples if ex.get("category") == "workflow"]
 
-    def _create_guide(self, title: str, workflows: List[Dict], enhancer=None) -> HowToGuide:
+    def _create_guide(self, title: str, workflows: list[dict], enhancer=None) -> HowToGuide:
         """
         Generate single guide from workflow(s).
 
@@ -919,17 +903,17 @@ class HowToGuideBuilder:
 
         # Extract use case from AI analysis or title
         use_case = title
-        if primary_workflow.get('ai_analysis'):
-            use_case = primary_workflow['ai_analysis'].get('tutorial_group', title)
+        if primary_workflow.get("ai_analysis"):
+            use_case = primary_workflow["ai_analysis"].get("tutorial_group", title)
 
         # Determine overview
         overview = self._generate_overview(primary_workflow, workflows)
 
         # Extract tags
-        tags = primary_workflow.get('tags', [])
+        tags = primary_workflow.get("tags", [])
 
         # Extract source files
-        source_files = [w.get('file_path', '') for w in workflows]
+        source_files = [w.get("file_path", "") for w in workflows]
         source_files = [f"{Path(f).name}:{w.get('line_start', 0)}" for f, w in zip(source_files, workflows)]
 
         # Create guide
@@ -937,44 +921,44 @@ class HowToGuideBuilder:
             guide_id=guide_id,
             title=title,
             overview=overview,
-            complexity_level=metadata.get('complexity_level', 'intermediate'),
-            prerequisites=metadata.get('prerequisites', []),
-            required_imports=metadata.get('required_imports', []),
-            required_fixtures=metadata.get('required_fixtures', []),
+            complexity_level=metadata.get("complexity_level", "intermediate"),
+            prerequisites=metadata.get("prerequisites", []),
+            required_imports=metadata.get("required_imports", []),
+            required_fixtures=metadata.get("required_fixtures", []),
             workflows=workflows,
             steps=steps,
             use_case=use_case,
             tags=tags,
-            estimated_time=metadata.get('estimated_time', '10 minutes'),
-            source_files=source_files
+            estimated_time=metadata.get("estimated_time", "10 minutes"),
+            source_files=source_files,
         )
 
         # Add AI enhancements if enhancer is available
         if enhancer:
-            self._enhance_guide_with_ai(guide, primary_workflow.get('ai_analysis', {}), enhancer)
-        elif self.enhance_with_ai and primary_workflow.get('ai_analysis'):
+            self._enhance_guide_with_ai(guide, primary_workflow.get("ai_analysis", {}), enhancer)
+        elif self.enhance_with_ai and primary_workflow.get("ai_analysis"):
             # Fallback to old enhancement method (basic)
-            self._enhance_guide_with_ai_basic(guide, primary_workflow['ai_analysis'])
+            self._enhance_guide_with_ai_basic(guide, primary_workflow["ai_analysis"])
 
         return guide
 
-    def _generate_overview(self, primary_workflow: Dict, all_workflows: List[Dict]) -> str:
+    def _generate_overview(self, primary_workflow: dict, all_workflows: list[dict]) -> str:
         """Generate guide overview"""
         # Try to get explanation from AI analysis
-        if primary_workflow.get('ai_analysis'):
-            explanation = primary_workflow['ai_analysis'].get('explanation')
+        if primary_workflow.get("ai_analysis"):
+            explanation = primary_workflow["ai_analysis"].get("explanation")
             if explanation:
                 return explanation
 
         # Fallback to description
-        description = primary_workflow.get('description', '')
+        description = primary_workflow.get("description", "")
         if description:
             return description
 
         # Final fallback
         return f"Learn how to use {primary_workflow.get('test_name', 'this feature')} in your code."
 
-    def _enhance_guide_with_ai(self, guide: HowToGuide, ai_analysis: Dict, enhancer):
+    def _enhance_guide_with_ai(self, guide: HowToGuide, ai_analysis: dict, enhancer):
         """
         Comprehensively enhance guide with AI using GuideEnhancer.
 
@@ -991,49 +975,43 @@ class HowToGuideBuilder:
         """
         # Prepare guide data for enhancer
         guide_data = {
-            'title': guide.title,
-            'steps': [
-                {
-                    'description': step.description,
-                    'code': step.code
-                }
-                for step in guide.steps
-            ],
-            'language': 'python',  # TODO: Detect from code
-            'prerequisites': guide.prerequisites,
-            'description': guide.overview
+            "title": guide.title,
+            "steps": [{"description": step.description, "code": step.code} for step in guide.steps],
+            "language": "python",  # TODO: Detect from code
+            "prerequisites": guide.prerequisites,
+            "description": guide.overview,
         }
 
         # Call enhancer to get all 5 enhancements
         enhanced_data = enhancer.enhance_guide(guide_data)
 
         # Apply step enhancements
-        if 'step_enhancements' in enhanced_data:
-            for enhancement in enhanced_data['step_enhancements']:
+        if "step_enhancements" in enhanced_data:
+            for enhancement in enhanced_data["step_enhancements"]:
                 idx = enhancement.step_index
                 if 0 <= idx < len(guide.steps):
                     guide.steps[idx].explanation = enhancement.explanation
                     guide.steps[idx].common_variations = enhancement.variations
 
         # Apply detailed prerequisites
-        if 'prerequisites_detailed' in enhanced_data:
-            guide.prerequisites_detailed = enhanced_data['prerequisites_detailed']
+        if "prerequisites_detailed" in enhanced_data:
+            guide.prerequisites_detailed = enhanced_data["prerequisites_detailed"]
 
         # Apply troubleshooting
-        if 'troubleshooting_detailed' in enhanced_data:
-            guide.troubleshooting_detailed = enhanced_data['troubleshooting_detailed']
+        if "troubleshooting_detailed" in enhanced_data:
+            guide.troubleshooting_detailed = enhanced_data["troubleshooting_detailed"]
 
         # Apply next steps
-        if 'next_steps_detailed' in enhanced_data:
-            guide.next_steps_detailed = enhanced_data['next_steps_detailed']
+        if "next_steps_detailed" in enhanced_data:
+            guide.next_steps_detailed = enhanced_data["next_steps_detailed"]
 
         # Apply use cases
-        if 'use_cases' in enhanced_data:
-            guide.use_cases = enhanced_data['use_cases']
+        if "use_cases" in enhanced_data:
+            guide.use_cases = enhanced_data["use_cases"]
 
         logger.info(f"✨ Enhanced guide '{guide.title}' with comprehensive AI improvements")
 
-    def _enhance_guide_with_ai_basic(self, guide: HowToGuide, ai_analysis: Dict):
+    def _enhance_guide_with_ai_basic(self, guide: HowToGuide, ai_analysis: dict):
         """
         Basic enhancement using pre-computed AI analysis from C3.6.
 
@@ -1044,15 +1022,15 @@ class HowToGuideBuilder:
             ai_analysis: AI analysis data from C3.6
         """
         # Add best practices as variations
-        best_practices = ai_analysis.get('best_practices', [])
+        best_practices = ai_analysis.get("best_practices", [])
         guide.variations = best_practices
 
         # Add common mistakes as pitfalls
-        common_mistakes = ai_analysis.get('common_mistakes', [])
+        common_mistakes = ai_analysis.get("common_mistakes", [])
         guide.common_pitfalls = common_mistakes
 
         # Add related examples as related guides
-        related_examples = ai_analysis.get('related_examples', [])
+        related_examples = ai_analysis.get("related_examples", [])
         guide.related_guides = [f"How To: {ex}" for ex in related_examples]
 
         # Enhance step explanations
@@ -1061,7 +1039,7 @@ class HowToGuideBuilder:
             if best_practices and step.step_number <= len(best_practices):
                 step.explanation = best_practices[step.step_number - 1]
 
-    def _create_collection(self, guides: List[HowToGuide]) -> GuideCollection:
+    def _create_collection(self, guides: list[HowToGuide]) -> GuideCollection:
         """Create GuideCollection from guides"""
         # Count by complexity
         by_complexity = defaultdict(int)
@@ -1078,7 +1056,7 @@ class HowToGuideBuilder:
             total_guides=len(guides),
             guides_by_complexity=dict(by_complexity),
             guides_by_use_case=dict(by_use_case),
-            guides=guides
+            guides=guides,
         )
 
     def _save_guides_to_files(self, collection: GuideCollection, output_dir: Path):
@@ -1091,21 +1069,21 @@ class HowToGuideBuilder:
         # Save individual guides
         for use_case, guides in collection.guides_by_use_case.items():
             # Create use case directory
-            use_case_dir = output_dir / use_case.lower().replace(' ', '-')
+            use_case_dir = output_dir / use_case.lower().replace(" ", "-")
             use_case_dir.mkdir(parents=True, exist_ok=True)
 
             for guide in guides:
                 # Generate filename from title
-                filename = guide.title.lower().replace(' ', '-').replace(':', '') + '.md'
+                filename = guide.title.lower().replace(" ", "-").replace(":", "") + ".md"
                 file_path = use_case_dir / filename
 
                 # Generate and save markdown
                 markdown = self.generator.generate_guide_markdown(guide)
-                file_path.write_text(markdown, encoding='utf-8')
+                file_path.write_text(markdown, encoding="utf-8")
 
         # Save index
         index_markdown = self.generator.generate_index(collection.guides)
-        (output_dir / 'index.md').write_text(index_markdown, encoding='utf-8')
+        (output_dir / "index.md").write_text(index_markdown, encoding="utf-8")
 
         logger.info(f"✅ Saved {collection.total_guides} guides + index to {output_dir}")
 
@@ -1114,6 +1092,7 @@ class HowToGuideBuilder:
 # CLI INTERFACE
 # ============================================================================
 
+
 def main():
     """CLI entry point for how-to guide builder"""
     import argparse
@@ -1144,45 +1123,29 @@ Grouping Strategies:
   - file-path: Group by source test file
   - test-name: Group by test name patterns
   - complexity: Group by difficulty level
-"""
+""",
+    )
+
+    parser.add_argument("input", nargs="?", help="Input: directory with test files OR test_examples.json file")
+
+    parser.add_argument("--input", dest="input_file", help="Input JSON file with test examples (from C3.2)")
+
+    parser.add_argument(
+        "--output",
+        default="output/codebase/tutorials",
+        help="Output directory for generated guides (default: output/codebase/tutorials)",
     )
 
     parser.add_argument(
-        'input',
-        nargs='?',
-        help='Input: directory with test files OR test_examples.json file'
+        "--group-by",
+        choices=["ai-tutorial-group", "file-path", "test-name", "complexity"],
+        default="ai-tutorial-group",
+        help="Grouping strategy (default: ai-tutorial-group)",
     )
 
-    parser.add_argument(
-        '--input',
-        dest='input_file',
-        help='Input JSON file with test examples (from C3.2)'
-    )
+    parser.add_argument("--no-ai", action="store_true", help="Disable AI enhancement")
 
-    parser.add_argument(
-        '--output',
-        default='output/codebase/tutorials',
-        help='Output directory for generated guides (default: output/codebase/tutorials)'
-    )
-
-    parser.add_argument(
-        '--group-by',
-        choices=['ai-tutorial-group', 'file-path', 'test-name', 'complexity'],
-        default='ai-tutorial-group',
-        help='Grouping strategy (default: ai-tutorial-group)'
-    )
-
-    parser.add_argument(
-        '--no-ai',
-        action='store_true',
-        help='Disable AI enhancement'
-    )
-
-    parser.add_argument(
-        '--json-output',
-        action='store_true',
-        help='Output JSON summary instead of markdown files'
-    )
+    parser.add_argument("--json-output", action="store_true", help="Output JSON summary instead of markdown files")
 
     args = parser.parse_args()
 
@@ -1200,13 +1163,13 @@ Grouping Strategies:
     # Load examples
     examples = []
 
-    if input_path.is_file() and input_path.suffix == '.json':
+    if input_path.is_file() and input_path.suffix == ".json":
         # Load from JSON file
         logger.info(f"Loading examples from {input_path}...")
-        with open(input_path, 'r') as f:
+        with open(input_path) as f:
             data = json.load(f)
-            if isinstance(data, dict) and 'examples' in data:
-                examples = data['examples']
+            if isinstance(data, dict) and "examples" in data:
+                examples = data["examples"]
             elif isinstance(data, list):
                 examples = data
             else:
@@ -1228,11 +1191,7 @@ Grouping Strategies:
     builder = HowToGuideBuilder(enhance_with_ai=not args.no_ai)
     output_dir = Path(args.output) if not args.json_output else None
 
-    collection = builder.build_guides_from_examples(
-        examples,
-        grouping_strategy=args.group_by,
-        output_dir=output_dir
-    )
+    collection = builder.build_guides_from_examples(examples, grouping_strategy=args.group_by, output_dir=output_dir)
 
     # Output results
     if args.json_output:
@@ -1241,9 +1200,9 @@ Grouping Strategies:
     else:
         # Summary
         print()
-        print("="*60)
+        print("=" * 60)
         print("HOW-TO GUIDES GENERATED")
-        print("="*60)
+        print("=" * 60)
         print()
         print(f"Total Guides: {collection.total_guides}")
         print()
diff --git a/src/skill_seekers/cli/install_agent.py b/src/skill_seekers/cli/install_agent.py
index 1a93a54..9fda18d 100644
--- a/src/skill_seekers/cli/install_agent.py
+++ b/src/skill_seekers/cli/install_agent.py
@@ -26,30 +26,28 @@ Examples:
 import argparse
 import shutil
 import sys
-from pathlib import Path
-from typing import Dict, Optional, Tuple, Union
 from difflib import get_close_matches
-
+from pathlib import Path
 
 # Agent installation paths
 # Global paths (install to home directory): Use ~/.{agent}/skills/
 # Project paths (install to current directory): Use .{agent}/skills/
 AGENT_PATHS = {
-    'claude': '~/.claude/skills/',           # Global (home)
-    'cursor': '.cursor/skills/',             # Project-relative
-    'vscode': '.github/skills/',             # Project-relative
-    'copilot': '.github/skills/',            # Same as VSCode
-    'amp': '~/.amp/skills/',                 # Global
-    'goose': '~/.config/goose/skills/',      # Global
-    'opencode': '~/.opencode/skills/',       # Global
-    'letta': '~/.letta/skills/',             # Global
-    'aide': '~/.aide/skills/',               # Global
-    'windsurf': '~/.windsurf/skills/',       # Global
-    'neovate': '~/.neovate/skills/',         # Global
+    "claude": "~/.claude/skills/",  # Global (home)
+    "cursor": ".cursor/skills/",  # Project-relative
+    "vscode": ".github/skills/",  # Project-relative
+    "copilot": ".github/skills/",  # Same as VSCode
+    "amp": "~/.amp/skills/",  # Global
+    "goose": "~/.config/goose/skills/",  # Global
+    "opencode": "~/.opencode/skills/",  # Global
+    "letta": "~/.letta/skills/",  # Global
+    "aide": "~/.aide/skills/",  # Global
+    "windsurf": "~/.windsurf/skills/",  # Global
+    "neovate": "~/.neovate/skills/",  # Global
 }
 
 
-def get_agent_path(agent_name: str, project_root: Optional[Path] = None) -> Path:
+def get_agent_path(agent_name: str, project_root: Path | None = None) -> Path:
     """
     Resolve the installation path for a given agent.
 
@@ -75,7 +73,7 @@ def get_agent_path(agent_name: str, project_root: Optional[Path] = None) -> Path
     path_template = AGENT_PATHS[agent_name]
 
     # Handle home directory expansion (~)
-    if path_template.startswith('~'):
+    if path_template.startswith("~"):
         return Path(path_template).expanduser()
 
     # Handle project-relative paths
@@ -95,7 +93,7 @@ def get_available_agents() -> list:
     return sorted(AGENT_PATHS.keys())
 
 
-def validate_agent_name(agent_name: str) -> Tuple[bool, Optional[str]]:
+def validate_agent_name(agent_name: str) -> tuple[bool, str | None]:
     """
     Validate an agent name and provide suggestions if invalid.
 
@@ -111,7 +109,7 @@ def validate_agent_name(agent_name: str) -> Tuple[bool, Optional[str]]:
         - error_message: None if valid, error message with suggestions if invalid
     """
     # Special case: 'all' is valid for installing to all agents
-    if agent_name.lower() == 'all':
+    if agent_name.lower() == "all":
         return True, None
 
     # Case-insensitive check
@@ -130,13 +128,13 @@ def validate_agent_name(agent_name: str) -> Tuple[bool, Optional[str]]:
         error_msg += f"Did you mean: {suggestions[0]}?\n\n"
 
     error_msg += "Available agents:\n  "
-    error_msg += ", ".join(available + ['all'])
+    error_msg += ", ".join(available + ["all"])
     error_msg += f"\n\nUsage:\n  skill-seekers install-agent <skill_directory> --agent {suggestions[0] if suggestions else 'claude'}"
 
     return False, error_msg
 
 
-def validate_skill_directory(skill_dir: Path) -> Tuple[bool, Optional[str]]:
+def validate_skill_directory(skill_dir: Path) -> tuple[bool, str | None]:
     """
     Validate that a directory is a valid skill directory.
 
@@ -165,11 +163,8 @@ def validate_skill_directory(skill_dir: Path) -> Tuple[bool, Optional[str]]:
 
 
 def install_to_agent(
-    skill_dir: Union[str, Path],
-    agent_name: str,
-    force: bool = False,
-    dry_run: bool = False
-) -> Tuple[bool, str]:
+    skill_dir: str | Path, agent_name: str, force: bool = False, dry_run: bool = False
+) -> tuple[bool, str]:
     """
     Install a skill to a specific agent's directory.
 
@@ -212,7 +207,7 @@ def install_to_agent(
 
     # Check if already exists
     if target_path.exists() and not force:
-        error_msg = f"❌ Skill already installed\n\n"
+        error_msg = "❌ Skill already installed\n\n"
         error_msg += f"Location: {target_path}\n\n"
         error_msg += "Options:\n"
         error_msg += f"  1. Overwrite: skill-seekers install-agent {skill_dir} --agent {agent_name} --force\n"
@@ -222,34 +217,34 @@ def install_to_agent(
 
     # Dry run mode - just preview
     if dry_run:
-        msg = f"🔍 DRY RUN - No changes will be made\n\n"
+        msg = "🔍 DRY RUN - No changes will be made\n\n"
         msg += f"Would install skill: {skill_name}\n"
         msg += f"   Source: {skill_dir}\n"
         msg += f"   Target: {target_path}\n\n"
 
         # Calculate total size
-        total_size = sum(f.stat().st_size for f in skill_dir.rglob('*') if f.is_file())
+        total_size = sum(f.stat().st_size for f in skill_dir.rglob("*") if f.is_file())
 
-        msg += f"Files to copy:\n"
+        msg += "Files to copy:\n"
         msg += f"   SKILL.md ({(skill_dir / 'SKILL.md').stat().st_size / 1024:.1f} KB)\n"
 
-        references_dir = skill_dir / 'references'
+        references_dir = skill_dir / "references"
         if references_dir.exists():
-            ref_files = list(references_dir.rglob('*.md'))
+            ref_files = list(references_dir.rglob("*.md"))
             ref_size = sum(f.stat().st_size for f in ref_files)
             msg += f"   references/ ({len(ref_files)} files, {ref_size / 1024:.1f} KB)\n"
 
-        for subdir in ['scripts', 'assets']:
+        for subdir in ["scripts", "assets"]:
             subdir_path = skill_dir / subdir
             if subdir_path.exists():
-                files = list(subdir_path.rglob('*'))
+                files = list(subdir_path.rglob("*"))
                 if files:
                     msg += f"   {subdir}/ ({len(files)} files)\n"
                 else:
                     msg += f"   {subdir}/ (empty)\n"
 
         msg += f"\nTotal size: {total_size / 1024:.1f} KB\n\n"
-        msg += f"To actually install, run:\n"
+        msg += "To actually install, run:\n"
         msg += f"  skill-seekers install-agent {skill_dir} --agent {agent_name}"
 
         return True, msg
@@ -258,7 +253,10 @@ def install_to_agent(
     try:
         agent_base_path.mkdir(parents=True, exist_ok=True)
     except PermissionError:
-        return False, f"❌ Permission denied: {agent_base_path}\n\nTry: sudo mkdir -p {agent_base_path} && sudo chown -R $USER {agent_base_path}"
+        return (
+            False,
+            f"❌ Permission denied: {agent_base_path}\n\nTry: sudo mkdir -p {agent_base_path} && sudo chown -R $USER {agent_base_path}",
+        )
 
     # Copy skill directory
     def ignore_files(directory, files):
@@ -266,16 +264,13 @@ def install_to_agent(
         ignored = []
         for f in files:
             # Exclude backup files
-            if f.endswith('.backup'):
-                ignored.append(f)
-            # Exclude Python cache
-            elif f == '__pycache__':
-                ignored.append(f)
-            # Exclude macOS metadata
-            elif f == '.DS_Store':
-                ignored.append(f)
-            # Exclude hidden files (except .github for vscode)
-            elif f.startswith('.') and f not in ['.github', '.cursor']:
+            if (
+                f.endswith(".backup")
+                or f == "__pycache__"
+                or f == ".DS_Store"
+                or f.startswith(".")
+                and f not in [".github", ".cursor"]
+            ):
                 ignored.append(f)
         return ignored
 
@@ -288,16 +283,16 @@ def install_to_agent(
         shutil.copytree(skill_dir, target_path, ignore=ignore_files)
 
         # Success message
-        msg = f"✅ Installation complete!\n\n"
+        msg = "✅ Installation complete!\n\n"
         msg += f"Skill '{skill_name}' installed to {agent_name}\n"
         msg += f"Location: {target_path}\n\n"
 
         # Agent-specific restart instructions
-        if agent_name.lower() == 'claude':
+        if agent_name.lower() == "claude":
             msg += "Restart Claude Code to load the new skill."
-        elif agent_name.lower() == 'cursor':
+        elif agent_name.lower() == "cursor":
             msg += "Restart Cursor to load the new skill."
-        elif agent_name.lower() in ['vscode', 'copilot']:
+        elif agent_name.lower() in ["vscode", "copilot"]:
             msg += "Restart VS Code to load the new skill."
         else:
             msg += f"Restart {agent_name.capitalize()} to load the new skill."
@@ -305,16 +300,17 @@ def install_to_agent(
         return True, msg
 
     except PermissionError as e:
-        return False, f"❌ Permission denied: {e}\n\nTry: sudo mkdir -p {agent_base_path} && sudo chown -R $USER {agent_base_path}"
+        return (
+            False,
+            f"❌ Permission denied: {e}\n\nTry: sudo mkdir -p {agent_base_path} && sudo chown -R $USER {agent_base_path}",
+        )
     except Exception as e:
         return False, f"❌ Installation failed: {e}"
 
 
 def install_to_all_agents(
-    skill_dir: Union[str, Path],
-    force: bool = False,
-    dry_run: bool = False
-) -> Dict[str, Tuple[bool, str]]:
+    skill_dir: str | Path, force: bool = False, dry_run: bool = False
+) -> dict[str, tuple[bool, str]]:
     """
     Install a skill to all available agents.
 
@@ -365,31 +361,16 @@ Examples:
 
 Supported agents:
   claude, cursor, vscode, copilot, amp, goose, opencode, letta, aide, windsurf, neovate, all
-        """
+        """,
     )
 
-    parser.add_argument(
-        "skill_directory",
-        help="Path to skill directory (e.g., output/react/)"
-    )
+    parser.add_argument("skill_directory", help="Path to skill directory (e.g., output/react/)")
 
-    parser.add_argument(
-        "--agent",
-        required=True,
-        help="Agent name (use 'all' to install to all agents)"
-    )
+    parser.add_argument("--agent", required=True, help="Agent name (use 'all' to install to all agents)")
 
-    parser.add_argument(
-        "--force",
-        action="store_true",
-        help="Overwrite existing installation without asking"
-    )
+    parser.add_argument("--force", action="store_true", help="Overwrite existing installation without asking")
 
-    parser.add_argument(
-        "--dry-run",
-        action="store_true",
-        help="Preview installation without making changes"
-    )
+    parser.add_argument("--dry-run", action="store_true", help="Preview installation without making changes")
 
     args = parser.parse_args()
 
@@ -398,7 +379,7 @@ Supported agents:
     skill_name = skill_dir.name
 
     # Handle 'all' agent
-    if args.agent.lower() == 'all':
+    if args.agent.lower() == "all":
         print(f"\n📋 Installing skill to all agents: {skill_name}\n")
 
         if args.dry_run:
@@ -433,7 +414,7 @@ Supported agents:
                     skipped_count += 1
 
         # Summary
-        print(f"\n📊 Summary:")
+        print("\n📊 Summary:")
         if args.dry_run:
             print(f"   Would install: {installed_count} agents")
         else:
diff --git a/src/skill_seekers/cli/install_skill.py b/src/skill_seekers/cli/install_skill.py
index 0a49a48..f02e2cc 100644
--- a/src/skill_seekers/cli/install_skill.py
+++ b/src/skill_seekers/cli/install_skill.py
@@ -26,8 +26,8 @@ Examples:
     skill-seekers install --config react --dry-run
 """
 
-import asyncio
 import argparse
+import asyncio
 import sys
 from pathlib import Path
 
@@ -78,51 +78,35 @@ Phases:
   3. AI Enhancement (MANDATORY - no skip option)
   4. Package for target platform (ZIP or tar.gz)
   5. Upload to target platform (optional)
-"""
+""",
     )
 
     parser.add_argument(
-        "--config",
-        required=True,
-        help="Config name (e.g., 'react') or path (e.g., 'configs/custom.json')"
+        "--config", required=True, help="Config name (e.g., 'react') or path (e.g., 'configs/custom.json')"
     )
 
-    parser.add_argument(
-        "--destination",
-        default="output",
-        help="Output directory for skill files (default: output/)"
-    )
+    parser.add_argument("--destination", default="output", help="Output directory for skill files (default: output/)")
+
+    parser.add_argument("--no-upload", action="store_true", help="Skip automatic upload to Claude")
 
     parser.add_argument(
-        "--no-upload",
-        action="store_true",
-        help="Skip automatic upload to Claude"
+        "--unlimited", action="store_true", help="Remove page limits during scraping (WARNING: Can take hours)"
     )
 
-    parser.add_argument(
-        "--unlimited",
-        action="store_true",
-        help="Remove page limits during scraping (WARNING: Can take hours)"
-    )
-
-    parser.add_argument(
-        "--dry-run",
-        action="store_true",
-        help="Preview workflow without executing"
-    )
+    parser.add_argument("--dry-run", action="store_true", help="Preview workflow without executing")
 
     parser.add_argument(
         "--target",
-        choices=['claude', 'gemini', 'openai', 'markdown'],
-        default='claude',
-        help="Target LLM platform (default: claude)"
+        choices=["claude", "gemini", "openai", "markdown"],
+        default="claude",
+        help="Target LLM platform (default: claude)",
     )
 
     args = parser.parse_args()
 
     # Determine if config is a name or path
     config_arg = args.config
-    if config_arg.endswith('.json') or '/' in config_arg or '\\' in config_arg:
+    if config_arg.endswith(".json") or "/" in config_arg or "\\" in config_arg:
         # It's a path
         config_path = config_arg
         config_name = None
@@ -139,7 +123,7 @@ Phases:
         "auto_upload": not args.no_upload,
         "unlimited": args.unlimited,
         "dry_run": args.dry_run,
-        "target": args.target
+        "target": args.target,
     }
 
     # Run async tool
diff --git a/src/skill_seekers/cli/language_detector.py b/src/skill_seekers/cli/language_detector.py
index 2992c55..0d526e8 100644
--- a/src/skill_seekers/cli/language_detector.py
+++ b/src/skill_seekers/cli/language_detector.py
@@ -8,9 +8,8 @@ Supports 20+ programming languages with weighted pattern matching.
 Author: Skill Seekers Project
 """
 
-import re
 import logging
-from typing import Optional, Tuple, Dict, List
+import re
 
 logger = logging.getLogger(__name__)
 
@@ -18,19 +17,11 @@ logger = logging.getLogger(__name__)
 try:
     from skill_seekers.cli.swift_patterns import SWIFT_PATTERNS
 except ImportError as e:
-    logger.warning(
-        "Swift language detection patterns unavailable. "
-        "Swift code detection will be disabled. Error: %s",
-        e
-    )
-    SWIFT_PATTERNS: Dict[str, List[Tuple[str, int]]] = {}
+    logger.warning("Swift language detection patterns unavailable. Swift code detection will be disabled. Error: %s", e)
+    SWIFT_PATTERNS: dict[str, list[tuple[str, int]]] = {}
 except Exception as e:
-    logger.error(
-        "Failed to load Swift patterns due to unexpected error: %s. "
-        "Swift detection disabled.",
-        e
-    )
-    SWIFT_PATTERNS: Dict[str, List[Tuple[str, int]]] = {}
+    logger.error("Failed to load Swift patterns due to unexpected error: %s. Swift detection disabled.", e)
+    SWIFT_PATTERNS: dict[str, list[tuple[str, int]]] = {}
 
 # Verify Swift patterns were loaded correctly
 if not SWIFT_PATTERNS:
@@ -38,15 +29,13 @@ if not SWIFT_PATTERNS:
         "Swift pattern dictionary is empty. Swift detection is disabled. "
         "This may indicate swift_patterns.py has no patterns defined."
     )
-elif 'swift' not in SWIFT_PATTERNS:
+elif "swift" not in SWIFT_PATTERNS:
     logger.error(
-        "Swift patterns loaded but 'swift' key is missing. "
-        "Swift detection is broken. Please file a bug report."
+        "Swift patterns loaded but 'swift' key is missing. Swift detection is broken. Please file a bug report."
     )
 else:
     logger.info(
-        "Swift patterns loaded successfully: %d patterns for language detection",
-        len(SWIFT_PATTERNS.get('swift', []))
+        "Swift patterns loaded successfully: %d patterns for language detection", len(SWIFT_PATTERNS.get("swift", []))
     )
 
 # Comprehensive language patterns with weighted confidence scoring
@@ -56,355 +45,325 @@ else:
 # Weight 2: Moderate indicators
 # Weight 1: Weak indicators
 
-LANGUAGE_PATTERNS: Dict[str, List[Tuple[str, int]]] = {
+LANGUAGE_PATTERNS: dict[str, list[tuple[str, int]]] = {
     # ===== PRIORITY 1: Unity C# (Critical - User's Primary Issue) =====
-    'csharp': [
+    "csharp": [
         # Unity-specific patterns (weight 4-5, CRITICAL)
-        (r'\busing\s+UnityEngine', 5),
-        (r'\bMonoBehaviour\b', 5),
-        (r'\bGameObject\b', 4),
-        (r'\bTransform\b', 4),
-        (r'\bVector[23]\b', 3),
-        (r'\bQuaternion\b', 3),
-        (r'\bvoid\s+Start\s*\(\)', 4),
-        (r'\bvoid\s+Update\s*\(\)', 4),
-        (r'\bvoid\s+Awake\s*\(\)', 4),
-        (r'\bvoid\s+OnEnable\s*\(\)', 3),
-        (r'\bvoid\s+OnDisable\s*\(\)', 3),
-        (r'\bvoid\s+FixedUpdate\s*\(\)', 4),
-        (r'\bvoid\s+LateUpdate\s*\(\)', 4),
-        (r'\bvoid\s+OnCollisionEnter', 4),
-        (r'\bvoid\s+OnTriggerEnter', 4),
-        (r'\bIEnumerator\b', 4),
-        (r'\bStartCoroutine\s*\(', 4),
-        (r'\byield\s+return\s+new\s+WaitForSeconds', 4),
-        (r'\byield\s+return\s+null', 3),
-        (r'\byield\s+return', 4),
-        (r'\[SerializeField\]', 4),
-        (r'\[RequireComponent', 4),
-        (r'\[Header\(', 3),
-        (r'\[Range\(', 3),
-        (r'\bTime\.deltaTime\b', 4),
-        (r'\bInput\.Get', 4),
-        (r'\bRigidbody\b', 3),
-        (r'\bCollider\b', 3),
-        (r'\bRenderer\b', 3),
-        (r'\bGetComponent<', 3),
-
+        (r"\busing\s+UnityEngine", 5),
+        (r"\bMonoBehaviour\b", 5),
+        (r"\bGameObject\b", 4),
+        (r"\bTransform\b", 4),
+        (r"\bVector[23]\b", 3),
+        (r"\bQuaternion\b", 3),
+        (r"\bvoid\s+Start\s*\(\)", 4),
+        (r"\bvoid\s+Update\s*\(\)", 4),
+        (r"\bvoid\s+Awake\s*\(\)", 4),
+        (r"\bvoid\s+OnEnable\s*\(\)", 3),
+        (r"\bvoid\s+OnDisable\s*\(\)", 3),
+        (r"\bvoid\s+FixedUpdate\s*\(\)", 4),
+        (r"\bvoid\s+LateUpdate\s*\(\)", 4),
+        (r"\bvoid\s+OnCollisionEnter", 4),
+        (r"\bvoid\s+OnTriggerEnter", 4),
+        (r"\bIEnumerator\b", 4),
+        (r"\bStartCoroutine\s*\(", 4),
+        (r"\byield\s+return\s+new\s+WaitForSeconds", 4),
+        (r"\byield\s+return\s+null", 3),
+        (r"\byield\s+return", 4),
+        (r"\[SerializeField\]", 4),
+        (r"\[RequireComponent", 4),
+        (r"\[Header\(", 3),
+        (r"\[Range\(", 3),
+        (r"\bTime\.deltaTime\b", 4),
+        (r"\bInput\.Get", 4),
+        (r"\bRigidbody\b", 3),
+        (r"\bCollider\b", 3),
+        (r"\bRenderer\b", 3),
+        (r"\bGetComponent<", 3),
         # Basic C# patterns (weight 2-4)
-        (r'\bnamespace\s+\w+', 3),
-        (r'\busing\s+System', 3),
-        (r'\bConsole\.WriteLine', 4),  # C#-specific output
-        (r'\bConsole\.Write', 3),
-        (r'\bpublic\s+class\s+\w+', 4),  # Increased to match Java weight
-        (r'\bprivate\s+class\s+\w+', 3),
-        (r'\binternal\s+class\s+\w+', 4),  # C#-specific modifier
-        (r'\bstring\s+\w+\s*[;=]', 2),  # C#-specific lowercase string
-        (r'\bprivate\s+\w+\s+\w+\s*;', 2),  # Private fields (common in both C# and Java)
-        (r'\{\s*get;\s*set;\s*\}', 3),  # Auto properties
-        (r'\{\s*get;\s*private\s+set;\s*\}', 3),
-        (r'\{\s*get\s*=>\s*', 2),  # Expression properties
-        (r'\bpublic\s+static\s+void\s+', 2),
-
+        (r"\bnamespace\s+\w+", 3),
+        (r"\busing\s+System", 3),
+        (r"\bConsole\.WriteLine", 4),  # C#-specific output
+        (r"\bConsole\.Write", 3),
+        (r"\bpublic\s+class\s+\w+", 4),  # Increased to match Java weight
+        (r"\bprivate\s+class\s+\w+", 3),
+        (r"\binternal\s+class\s+\w+", 4),  # C#-specific modifier
+        (r"\bstring\s+\w+\s*[;=]", 2),  # C#-specific lowercase string
+        (r"\bprivate\s+\w+\s+\w+\s*;", 2),  # Private fields (common in both C# and Java)
+        (r"\{\s*get;\s*set;\s*\}", 3),  # Auto properties
+        (r"\{\s*get;\s*private\s+set;\s*\}", 3),
+        (r"\{\s*get\s*=>\s*", 2),  # Expression properties
+        (r"\bpublic\s+static\s+void\s+", 2),
         # Modern C# patterns (weight 2)
-        (r'\bfrom\s+\w+\s+in\s+', 2),  # LINQ
-        (r'\.Where\s*\(', 2),
-        (r'\.Select\s*\(', 2),
-        (r'\basync\s+Task', 2),
-        (r'\bawait\s+', 2),
-        (r'\bvar\s+\w+\s*=', 1),
+        (r"\bfrom\s+\w+\s+in\s+", 2),  # LINQ
+        (r"\.Where\s*\(", 2),
+        (r"\.Select\s*\(", 2),
+        (r"\basync\s+Task", 2),
+        (r"\bawait\s+", 2),
+        (r"\bvar\s+\w+\s*=", 1),
     ],
-
     # ===== PRIORITY 2: Frontend Languages =====
-    'typescript': [
+    "typescript": [
         # TypeScript-specific (weight 4-5)
-        (r'\binterface\s+\w+\s*\{', 5),
-        (r'\btype\s+\w+\s*=', 4),
-        (r':\s*\w+\s*=', 3),  # Type annotation
-        (r':\s*\w+\[\]', 3),  # Array type
-        (r'<[\w,\s]+>', 2),  # Generic type
-        (r'\bas\s+\w+', 2),  # Type assertion
-        (r'\benum\s+\w+\s*\{', 4),
-        (r'\bimplements\s+\w+', 3),
-        (r'\bexport\s+interface', 4),
-        (r'\bexport\s+type', 4),
-
+        (r"\binterface\s+\w+\s*\{", 5),
+        (r"\btype\s+\w+\s*=", 4),
+        (r":\s*\w+\s*=", 3),  # Type annotation
+        (r":\s*\w+\[\]", 3),  # Array type
+        (r"<[\w,\s]+>", 2),  # Generic type
+        (r"\bas\s+\w+", 2),  # Type assertion
+        (r"\benum\s+\w+\s*\{", 4),
+        (r"\bimplements\s+\w+", 3),
+        (r"\bexport\s+interface", 4),
+        (r"\bexport\s+type", 4),
         # Also has JS patterns (weight 1)
-        (r'\bconst\s+\w+\s*=', 1),
-        (r'\blet\s+\w+\s*=', 1),
-        (r'=>', 1),
+        (r"\bconst\s+\w+\s*=", 1),
+        (r"\blet\s+\w+\s*=", 1),
+        (r"=>", 1),
     ],
-
-    'javascript': [
-        (r'\bfunction\s+\w+\s*\(', 3),
-        (r'\bconst\s+\w+\s*=', 2),
-        (r'\blet\s+\w+\s*=', 2),
-        (r'=>', 2),  # Arrow function
-        (r'\bconsole\.log', 2),
-        (r'\bvar\s+\w+\s*=', 1),
-        (r'\.then\s*\(', 2),  # Promise
-        (r'\.catch\s*\(', 2),  # Promise
-        (r'\basync\s+function', 3),
-        (r'\bawait\s+', 2),
-        (r'require\s*\(', 2),  # CommonJS
-        (r'\bexport\s+default', 2),  # ES6
-        (r'\bexport\s+const', 2),
+    "javascript": [
+        (r"\bfunction\s+\w+\s*\(", 3),
+        (r"\bconst\s+\w+\s*=", 2),
+        (r"\blet\s+\w+\s*=", 2),
+        (r"=>", 2),  # Arrow function
+        (r"\bconsole\.log", 2),
+        (r"\bvar\s+\w+\s*=", 1),
+        (r"\.then\s*\(", 2),  # Promise
+        (r"\.catch\s*\(", 2),  # Promise
+        (r"\basync\s+function", 3),
+        (r"\bawait\s+", 2),
+        (r"require\s*\(", 2),  # CommonJS
+        (r"\bexport\s+default", 2),  # ES6
+        (r"\bexport\s+const", 2),
     ],
-
-    'jsx': [
+    "jsx": [
         # JSX patterns (weight 4-5)
-        (r'<\w+\s+[^>]*>', 4),  # JSX tag with attributes
-        (r'<\w+\s*/>', 4),  # Self-closing tag
-        (r'className=', 3),  # React className
-        (r'onClick=', 3),  # React event
-        (r'\brender\s*\(\s*\)\s*\{', 4),  # React render
-        (r'\buseState\s*\(', 4),  # React hook
-        (r'\buseEffect\s*\(', 4),  # React hook
-        (r'\buseRef\s*\(', 3),
-        (r'\buseCallback\s*\(', 3),
-        (r'\buseMemo\s*\(', 3),
-
+        (r"<\w+\s+[^>]*>", 4),  # JSX tag with attributes
+        (r"<\w+\s*/>", 4),  # Self-closing tag
+        (r"className=", 3),  # React className
+        (r"onClick=", 3),  # React event
+        (r"\brender\s*\(\s*\)\s*\{", 4),  # React render
+        (r"\buseState\s*\(", 4),  # React hook
+        (r"\buseEffect\s*\(", 4),  # React hook
+        (r"\buseRef\s*\(", 3),
+        (r"\buseCallback\s*\(", 3),
+        (r"\buseMemo\s*\(", 3),
         # Also has JS patterns
-        (r'\bconst\s+\w+\s*=', 1),
-        (r'=>', 1),
+        (r"\bconst\s+\w+\s*=", 1),
+        (r"=>", 1),
     ],
-
-    'tsx': [
+    "tsx": [
         # TSX = TypeScript + JSX (weight 5)
-        (r'<\w+\s+[^>]*>', 3),  # JSX tag
-        (r':\s*React\.\w+', 5),  # React types
-        (r'interface\s+\w+Props', 5),  # Props interface
-        (r'\bFunctionComponent<', 4),
-        (r'\bReact\.FC<', 4),
-        (r'\buseState<', 4),  # Typed hook
-        (r'\buseRef<', 3),
-
+        (r"<\w+\s+[^>]*>", 3),  # JSX tag
+        (r":\s*React\.\w+", 5),  # React types
+        (r"interface\s+\w+Props", 5),  # Props interface
+        (r"\bFunctionComponent<", 4),
+        (r"\bReact\.FC<", 4),
+        (r"\buseState<", 4),  # Typed hook
+        (r"\buseRef<", 3),
         # Also has TS patterns
-        (r'\binterface\s+\w+', 2),
-        (r'\btype\s+\w+\s*=', 2),
+        (r"\binterface\s+\w+", 2),
+        (r"\btype\s+\w+\s*=", 2),
     ],
-
-    'vue': [
+    "vue": [
         # Vue SFC patterns (weight 4-5)
-        (r'<template>', 5),
-        (r'<script>', 3),
-        (r'<style\s+scoped>', 4),
-        (r'\bexport\s+default\s*\{', 3),
-        (r'\bdata\s*\(\s*\)\s*\{', 4),  # Vue 2
-        (r'\bcomputed\s*:', 3),
-        (r'\bmethods\s*:', 3),
-        (r'\bsetup\s*\(', 4),  # Vue 3 Composition
-        (r'\bref\s*\(', 4),  # Vue 3
-        (r'\breactive\s*\(', 4),  # Vue 3
-        (r'v-bind:', 3),
-        (r'v-for=', 3),
-        (r'v-if=', 3),
-        (r'v-model=', 3),
+        (r"<template>", 5),
+        (r"<script>", 3),
+        (r"<style\s+scoped>", 4),
+        (r"\bexport\s+default\s*\{", 3),
+        (r"\bdata\s*\(\s*\)\s*\{", 4),  # Vue 2
+        (r"\bcomputed\s*:", 3),
+        (r"\bmethods\s*:", 3),
+        (r"\bsetup\s*\(", 4),  # Vue 3 Composition
+        (r"\bref\s*\(", 4),  # Vue 3
+        (r"\breactive\s*\(", 4),  # Vue 3
+        (r"v-bind:", 3),
+        (r"v-for=", 3),
+        (r"v-if=", 3),
+        (r"v-model=", 3),
     ],
-
     # ===== PRIORITY 3: Backend Languages =====
-    'java': [
-        (r'\bpublic\s+class\s+\w+', 4),
-        (r'\bprivate\s+\w+\s+\w+', 2),
-        (r'\bSystem\.out\.println', 3),
-        (r'\bpublic\s+static\s+void\s+main', 4),
-        (r'\bpublic\s+\w+\s+\w+\s*\(', 2),
-        (r'@Override', 3),
-        (r'@Autowired', 3),  # Spring
-        (r'@Service', 3),  # Spring
-        (r'@RestController', 3),  # Spring
-        (r'@GetMapping', 3),  # Spring
-        (r'@PostMapping', 3),  # Spring
-        (r'\bimport\s+java\.', 2),
-        (r'\bextends\s+\w+', 2),
+    "java": [
+        (r"\bpublic\s+class\s+\w+", 4),
+        (r"\bprivate\s+\w+\s+\w+", 2),
+        (r"\bSystem\.out\.println", 3),
+        (r"\bpublic\s+static\s+void\s+main", 4),
+        (r"\bpublic\s+\w+\s+\w+\s*\(", 2),
+        (r"@Override", 3),
+        (r"@Autowired", 3),  # Spring
+        (r"@Service", 3),  # Spring
+        (r"@RestController", 3),  # Spring
+        (r"@GetMapping", 3),  # Spring
+        (r"@PostMapping", 3),  # Spring
+        (r"\bimport\s+java\.", 2),
+        (r"\bextends\s+\w+", 2),
     ],
-
-    'go': [
-        (r'\bfunc\s+\w+\s*\(', 3),
-        (r'\bpackage\s+\w+', 4),
-        (r':=', 3),  # Short declaration
-        (r'\bfmt\.Print', 2),
-        (r'\bfunc\s+\(.*\)\s+\w+\s*\(', 4),  # Method
-        (r'\bdefer\s+', 3),
-        (r'\bgo\s+\w+\s*\(', 3),  # Goroutine
-        (r'\bchan\s+', 3),  # Channel
-        (r'\binterface\{\}', 2),  # Empty interface
-        (r'\bfunc\s+main\s*\(\)', 4),
+    "go": [
+        (r"\bfunc\s+\w+\s*\(", 3),
+        (r"\bpackage\s+\w+", 4),
+        (r":=", 3),  # Short declaration
+        (r"\bfmt\.Print", 2),
+        (r"\bfunc\s+\(.*\)\s+\w+\s*\(", 4),  # Method
+        (r"\bdefer\s+", 3),
+        (r"\bgo\s+\w+\s*\(", 3),  # Goroutine
+        (r"\bchan\s+", 3),  # Channel
+        (r"\binterface\{\}", 2),  # Empty interface
+        (r"\bfunc\s+main\s*\(\)", 4),
     ],
-
-    'rust': [
-        (r'\bfn\s+\w+\s*\(', 4),
-        (r'\blet\s+mut\s+\w+', 3),
-        (r'\bprintln!', 3),
-        (r'\bimpl\s+\w+', 3),
-        (r'\buse\s+\w+::', 3),
-        (r'\bpub\s+fn\s+', 3),
-        (r'\bmatch\s+\w+\s*\{', 3),
-        (r'\bSome\(', 2),
-        (r'\bNone\b', 2),
-        (r'\bResult<', 3),
-        (r'\bOption<', 3),
-        (r'&str\b', 2),
-        (r'\bfn\s+main\s*\(\)', 4),
+    "rust": [
+        (r"\bfn\s+\w+\s*\(", 4),
+        (r"\blet\s+mut\s+\w+", 3),
+        (r"\bprintln!", 3),
+        (r"\bimpl\s+\w+", 3),
+        (r"\buse\s+\w+::", 3),
+        (r"\bpub\s+fn\s+", 3),
+        (r"\bmatch\s+\w+\s*\{", 3),
+        (r"\bSome\(", 2),
+        (r"\bNone\b", 2),
+        (r"\bResult<", 3),
+        (r"\bOption<", 3),
+        (r"&str\b", 2),
+        (r"\bfn\s+main\s*\(\)", 4),
     ],
-
-    'php': [
-        (r'<\?php', 5),
-        (r'\$\w+\s*=', 2),
-        (r'\bfunction\s+\w+\s*\(', 2),
-        (r'\bpublic\s+function', 3),
-        (r'\bprivate\s+function', 3),
-        (r'\bclass\s+\w+', 3),
-        (r'\bnamespace\s+\w+', 3),
-        (r'\buse\s+\w+\\', 2),
-        (r'->', 2),  # Object operator
-        (r'::', 1),  # Static operator
+    "php": [
+        (r"<\?php", 5),
+        (r"\$\w+\s*=", 2),
+        (r"\bfunction\s+\w+\s*\(", 2),
+        (r"\bpublic\s+function", 3),
+        (r"\bprivate\s+function", 3),
+        (r"\bclass\s+\w+", 3),
+        (r"\bnamespace\s+\w+", 3),
+        (r"\buse\s+\w+\\", 2),
+        (r"->", 2),  # Object operator
+        (r"::", 1),  # Static operator
     ],
-
     # ===== PRIORITY 4: System/Data Languages =====
-    'python': [
-        (r'\bdef\s+\w+\s*\(', 3),
-        (r'\bimport\s+\w+', 2),
-        (r'\bclass\s+\w+:', 3),
-        (r'\bfrom\s+\w+\s+import', 2),
-        (r':\s*$', 1),  # Lines ending with :
-        (r'@\w+', 2),  # Decorator
-        (r'\bself\.\w+', 2),
-        (r'\b__init__\s*\(', 3),
-        (r'\basync\s+def\s+', 3),
-        (r'\bawait\s+', 2),
-        (r'\bprint\s*\(', 1),
+    "python": [
+        (r"\bdef\s+\w+\s*\(", 3),
+        (r"\bimport\s+\w+", 2),
+        (r"\bclass\s+\w+:", 3),
+        (r"\bfrom\s+\w+\s+import", 2),
+        (r":\s*$", 1),  # Lines ending with :
+        (r"@\w+", 2),  # Decorator
+        (r"\bself\.\w+", 2),
+        (r"\b__init__\s*\(", 3),
+        (r"\basync\s+def\s+", 3),
+        (r"\bawait\s+", 2),
+        (r"\bprint\s*\(", 1),
     ],
-
-    'r': [
-        (r'<-', 4),  # Assignment operator
-        (r'\bfunction\s*\(', 2),
-        (r'\blibrary\s*\(', 3),
-        (r'\bggplot\s*\(', 4),  # ggplot2
-        (r'\bdata\.frame\s*\(', 3),
-        (r'\%>\%', 4),  # Pipe operator
-        (r'\bsummary\s*\(', 2),
-        (r'\bread\.csv\s*\(', 3),
+    "r": [
+        (r"<-", 4),  # Assignment operator
+        (r"\bfunction\s*\(", 2),
+        (r"\blibrary\s*\(", 3),
+        (r"\bggplot\s*\(", 4),  # ggplot2
+        (r"\bdata\.frame\s*\(", 3),
+        (r"\%>\%", 4),  # Pipe operator
+        (r"\bsummary\s*\(", 2),
+        (r"\bread\.csv\s*\(", 3),
     ],
-
-    'julia': [
-        (r'\bfunction\s+\w+\s*\(', 3),
-        (r'\bend\b', 2),
-        (r'\busing\s+\w+', 3),
-        (r'::', 2),  # Type annotation
-        (r'\bmodule\s+\w+', 3),
-        (r'\babstract\s+type', 3),
-        (r'\bstruct\s+\w+', 3),
+    "julia": [
+        (r"\bfunction\s+\w+\s*\(", 3),
+        (r"\bend\b", 2),
+        (r"\busing\s+\w+", 3),
+        (r"::", 2),  # Type annotation
+        (r"\bmodule\s+\w+", 3),
+        (r"\babstract\s+type", 3),
+        (r"\bstruct\s+\w+", 3),
     ],
-
-    'sql': [
-        (r'\bSELECT\s+', 4),
-        (r'\bFROM\s+', 3),
-        (r'\bWHERE\s+', 2),
-        (r'\bINSERT\s+INTO', 4),
-        (r'\bCREATE\s+TABLE', 4),
-        (r'\bJOIN\s+', 3),
-        (r'\bGROUP\s+BY', 3),
-        (r'\bORDER\s+BY', 3),
-        (r'\bUPDATE\s+', 3),
-        (r'\bDELETE\s+FROM', 3),
+    "sql": [
+        (r"\bSELECT\s+", 4),
+        (r"\bFROM\s+", 3),
+        (r"\bWHERE\s+", 2),
+        (r"\bINSERT\s+INTO", 4),
+        (r"\bCREATE\s+TABLE", 4),
+        (r"\bJOIN\s+", 3),
+        (r"\bGROUP\s+BY", 3),
+        (r"\bORDER\s+BY", 3),
+        (r"\bUPDATE\s+", 3),
+        (r"\bDELETE\s+FROM", 3),
     ],
-
     # ===== Additional Languages =====
-    'cpp': [
-        (r'#include\s*<', 4),
-        (r'\bstd::', 3),
-        (r'\bnamespace\s+\w+', 3),
-        (r'\bcout\s*<<', 3),
-        (r'\bvoid\s+\w+\s*\(', 2),
-        (r'\bint\s+main\s*\(', 4),
-        (r'->', 2),  # Pointer
+    "cpp": [
+        (r"#include\s*<", 4),
+        (r"\bstd::", 3),
+        (r"\bnamespace\s+\w+", 3),
+        (r"\bcout\s*<<", 3),
+        (r"\bvoid\s+\w+\s*\(", 2),
+        (r"\bint\s+main\s*\(", 4),
+        (r"->", 2),  # Pointer
     ],
-
-    'c': [
-        (r'#include\s*<', 4),
-        (r'\bprintf\s*\(', 3),
-        (r'\bint\s+main\s*\(', 4),
-        (r'\bvoid\s+\w+\s*\(', 2),
-        (r'\bstruct\s+\w+', 3),
+    "c": [
+        (r"#include\s*<", 4),
+        (r"\bprintf\s*\(", 3),
+        (r"\bint\s+main\s*\(", 4),
+        (r"\bvoid\s+\w+\s*\(", 2),
+        (r"\bstruct\s+\w+", 3),
     ],
-
-    'gdscript': [
-        (r'\bfunc\s+\w+\s*\(', 3),
-        (r'\bvar\s+\w+\s*=', 3),
-        (r'\bextends\s+\w+', 4),
-        (r'\b_ready\s*\(', 4),
-        (r'\b_process\s*\(', 4),
+    "gdscript": [
+        (r"\bfunc\s+\w+\s*\(", 3),
+        (r"\bvar\s+\w+\s*=", 3),
+        (r"\bextends\s+\w+", 4),
+        (r"\b_ready\s*\(", 4),
+        (r"\b_process\s*\(", 4),
     ],
-
     # ===== Markup/Config Languages =====
-    'html': [
-        (r'<!DOCTYPE\s+html>', 5),
-        (r'<html', 4),
-        (r'<head>', 3),
-        (r'<body>', 3),
-        (r'<div', 2),
-        (r'<span', 2),
-        (r'<script', 2),
+    "html": [
+        (r"<!DOCTYPE\s+html>", 5),
+        (r"<html", 4),
+        (r"<head>", 3),
+        (r"<body>", 3),
+        (r"<div", 2),
+        (r"<span", 2),
+        (r"<script", 2),
     ],
-
-    'css': [
-        (r'\{\s*[\w-]+\s*:', 3),
-        (r'@media', 3),
-        (r'\.[\w-]+\s*\{', 2),
-        (r'#[\w-]+\s*\{', 2),
-        (r'@import', 2),
+    "css": [
+        (r"\{\s*[\w-]+\s*:", 3),
+        (r"@media", 3),
+        (r"\.[\w-]+\s*\{", 2),
+        (r"#[\w-]+\s*\{", 2),
+        (r"@import", 2),
     ],
-
-    'json': [
-        (r'^\s*\{', 3),
-        (r'^\s*\[', 3),
+    "json": [
+        (r"^\s*\{", 3),
+        (r"^\s*\[", 3),
         (r'"\w+"\s*:', 3),
         (r':\s*["\d\[\{]', 2),
     ],
-
-    'yaml': [
-        (r'^\w+:', 3),
-        (r'^\s+-\s+\w+', 2),
-        (r'---', 2),
-        (r'^\s+\w+:', 2),
+    "yaml": [
+        (r"^\w+:", 3),
+        (r"^\s+-\s+\w+", 2),
+        (r"---", 2),
+        (r"^\s+\w+:", 2),
     ],
-
-    'xml': [
-        (r'<\?xml', 5),
-        (r'<\w+\s+\w+=', 2),
-        (r'<\w+>', 1),
-        (r'</\w+>', 1),
+    "xml": [
+        (r"<\?xml", 5),
+        (r"<\w+\s+\w+=", 2),
+        (r"<\w+>", 1),
+        (r"</\w+>", 1),
     ],
-
-    'markdown': [
-        (r'^#+\s+', 3),
-        (r'^\*\*\w+\*\*', 2),
-        (r'^\s*[-*]\s+', 2),
-        (r'\[.*\]\(.*\)', 2),
+    "markdown": [
+        (r"^#+\s+", 3),
+        (r"^\*\*\w+\*\*", 2),
+        (r"^\s*[-*]\s+", 2),
+        (r"\[.*\]\(.*\)", 2),
     ],
-
-    'bash': [
-        (r'#!/bin/bash', 5),
-        (r'#!/bin/sh', 5),
-        (r'\becho\s+', 2),
-        (r'\$\{?\w+\}?', 2),
-        (r'\bif\s+\[', 2),
-        (r'\bfor\s+\w+\s+in', 2),
+    "bash": [
+        (r"#!/bin/bash", 5),
+        (r"#!/bin/sh", 5),
+        (r"\becho\s+", 2),
+        (r"\$\{?\w+\}?", 2),
+        (r"\bif\s+\[", 2),
+        (r"\bfor\s+\w+\s+in", 2),
     ],
-
-    'shell': [
-        (r'#!/bin/bash', 5),
-        (r'#!/bin/sh', 5),
-        (r'\becho\s+', 2),
-        (r'\$\{?\w+\}?', 2),
+    "shell": [
+        (r"#!/bin/bash", 5),
+        (r"#!/bin/sh", 5),
+        (r"\becho\s+", 2),
+        (r"\$\{?\w+\}?", 2),
     ],
-
-    'powershell': [
-        (r'\$\w+\s*=', 2),
-        (r'Get-\w+', 3),
-        (r'Set-\w+', 3),
-        (r'\bWrite-Host\s+', 2),
+    "powershell": [
+        (r"\$\w+\s*=", 2),
+        (r"Get-\w+", 3),
+        (r"Set-\w+", 3),
+        (r"\bWrite-Host\s+", 2),
     ],
 }
 
@@ -414,11 +373,42 @@ LANGUAGE_PATTERNS.update(SWIFT_PATTERNS)
 
 # Known language list for CSS class detection
 KNOWN_LANGUAGES = [
-    "javascript", "java", "xml", "html", "python", "bash", "cpp", "typescript",
-    "go", "rust", "php", "ruby", "swift", "kotlin", "csharp", "c", "sql",
-    "yaml", "json", "markdown", "css", "scss", "sass", "jsx", "tsx", "vue",
-    "shell", "powershell", "r", "scala", "dart", "perl", "lua", "elixir",
-    "julia", "gdscript",
+    "javascript",
+    "java",
+    "xml",
+    "html",
+    "python",
+    "bash",
+    "cpp",
+    "typescript",
+    "go",
+    "rust",
+    "php",
+    "ruby",
+    "swift",
+    "kotlin",
+    "csharp",
+    "c",
+    "sql",
+    "yaml",
+    "json",
+    "markdown",
+    "css",
+    "scss",
+    "sass",
+    "jsx",
+    "tsx",
+    "vue",
+    "shell",
+    "powershell",
+    "r",
+    "scala",
+    "dart",
+    "perl",
+    "lua",
+    "elixir",
+    "julia",
+    "gdscript",
 ]
 
 
@@ -452,7 +442,7 @@ class LanguageDetector:
                           0.3 = low, 0.5 = medium, 0.7 = high
         """
         self.min_confidence = min_confidence
-        self._pattern_cache: Dict[str, List[Tuple[re.Pattern, int]]] = {}
+        self._pattern_cache: dict[str, list[tuple[re.Pattern, int]]] = {}
         self._compile_patterns()
 
     def _compile_patterns(self) -> None:
@@ -465,27 +455,28 @@ class LanguageDetector:
                     compiled_patterns.append((compiled, weight))
                 except re.error as e:
                     logger.error(
-                        "Invalid regex pattern for language '%s' at index %d: '%s'. "
-                        "Error: %s. Pattern skipped.",
-                        lang, i, pattern[:50], e
+                        "Invalid regex pattern for language '%s' at index %d: '%s'. Error: %s. Pattern skipped.",
+                        lang,
+                        i,
+                        pattern[:50],
+                        e,
                     )
-                except TypeError as e:
+                except TypeError:
                     logger.error(
-                        "Pattern for language '%s' at index %d is not a string: %s. "
-                        "Pattern skipped.",
-                        lang, i, type(pattern).__name__
+                        "Pattern for language '%s' at index %d is not a string: %s. Pattern skipped.",
+                        lang,
+                        i,
+                        type(pattern).__name__,
                     )
 
             if compiled_patterns:
                 self._pattern_cache[lang] = compiled_patterns
             else:
                 logger.warning(
-                    "No valid patterns compiled for language '%s'. "
-                    "Detection for this language is disabled.",
-                    lang
+                    "No valid patterns compiled for language '%s'. Detection for this language is disabled.", lang
                 )
 
-    def detect_from_html(self, elem, code: str) -> Tuple[str, float]:
+    def detect_from_html(self, elem, code: str) -> tuple[str, float]:
         """
         Detect language from HTML element with CSS classes + code content.
 
@@ -498,21 +489,21 @@ class LanguageDetector:
         """
         # Tier 1: CSS classes (confidence 1.0)
         if elem:
-            css_lang = self.extract_language_from_classes(elem.get('class', []))
+            css_lang = self.extract_language_from_classes(elem.get("class", []))
             if css_lang:
                 return css_lang, 1.0
 
             # Check parent pre element
             parent = elem.parent
-            if parent and parent.name == 'pre':
-                css_lang = self.extract_language_from_classes(parent.get('class', []))
+            if parent and parent.name == "pre":
+                css_lang = self.extract_language_from_classes(parent.get("class", []))
                 if css_lang:
                     return css_lang, 1.0
 
         # Tier 2: Pattern matching
         return self.detect_from_code(code)
 
-    def detect_from_code(self, code: str) -> Tuple[str, float]:
+    def detect_from_code(self, code: str) -> tuple[str, float]:
         """
         Detect language from code content only (for PDFs, GitHub files).
 
@@ -524,13 +515,13 @@ class LanguageDetector:
         """
         # Edge case: code too short
         if len(code.strip()) < 10:
-            return 'unknown', 0.0
+            return "unknown", 0.0
 
         # Calculate confidence scores for all languages
         scores = self._calculate_confidence(code)
 
         if not scores:
-            return 'unknown', 0.0
+            return "unknown", 0.0
 
         # Get language with highest score
         best_lang = max(scores.items(), key=lambda x: x[1])
@@ -538,11 +529,11 @@ class LanguageDetector:
 
         # Apply minimum confidence threshold
         if confidence < self.min_confidence:
-            return 'unknown', 0.0
+            return "unknown", 0.0
 
         return lang, confidence
 
-    def extract_language_from_classes(self, classes: List[str]) -> Optional[str]:
+    def extract_language_from_classes(self, classes: list[str]) -> str | None:
         """
         Extract language from CSS class list.
 
@@ -563,21 +554,21 @@ class LanguageDetector:
 
         for cls in classes:
             # Handle brush: pattern
-            if 'brush:' in cls:
-                parts = cls.split('brush:')
+            if "brush:" in cls:
+                parts = cls.split("brush:")
                 if len(parts) > 1:
                     lang = parts[1].strip().lower()
                     if lang in KNOWN_LANGUAGES:
                         return lang
 
             # Handle language- prefix
-            if cls.startswith('language-'):
+            if cls.startswith("language-"):
                 lang = cls[9:].lower()
                 if lang in KNOWN_LANGUAGES:
                     return lang
 
             # Handle lang- prefix
-            if cls.startswith('lang-'):
+            if cls.startswith("lang-"):
                 lang = cls[5:].lower()
                 if lang in KNOWN_LANGUAGES:
                     return lang
@@ -588,7 +579,7 @@ class LanguageDetector:
 
         return None
 
-    def _calculate_confidence(self, code: str) -> Dict[str, float]:
+    def _calculate_confidence(self, code: str) -> dict[str, float]:
         """
         Calculate weighted confidence scores for all languages.
 
@@ -598,7 +589,7 @@ class LanguageDetector:
         Returns:
             Dictionary mapping language names to confidence scores (0.0-1.0)
         """
-        scores: Dict[str, float] = {}
+        scores: dict[str, float] = {}
 
         for lang, compiled_patterns in self._pattern_cache.items():
             total_score = 0
diff --git a/src/skill_seekers/cli/llms_txt_detector.py b/src/skill_seekers/cli/llms_txt_detector.py
index 688fdb7..359b4ae 100644
--- a/src/skill_seekers/cli/llms_txt_detector.py
+++ b/src/skill_seekers/cli/llms_txt_detector.py
@@ -1,23 +1,20 @@
 # ABOUTME: Detects and validates llms.txt file availability at documentation URLs
 # ABOUTME: Supports llms-full.txt, llms.txt, and llms-small.txt variants
 
-import requests
-from typing import Optional, Dict, List
 from urllib.parse import urlparse
 
+import requests
+
+
 class LlmsTxtDetector:
     """Detect llms.txt files at documentation URLs"""
 
-    VARIANTS = [
-        ('llms-full.txt', 'full'),
-        ('llms.txt', 'standard'),
-        ('llms-small.txt', 'small')
-    ]
+    VARIANTS = [("llms-full.txt", "full"), ("llms.txt", "standard"), ("llms-small.txt", "small")]
 
     def __init__(self, base_url: str):
-        self.base_url = base_url.rstrip('/')
+        self.base_url = base_url.rstrip("/")
 
-    def detect(self) -> Optional[Dict[str, str]]:
+    def detect(self) -> dict[str, str] | None:
         """
         Detect available llms.txt variant.
 
@@ -31,11 +28,11 @@ class LlmsTxtDetector:
             url = f"{root_url}/{filename}"
 
             if self._check_url_exists(url):
-                return {'url': url, 'variant': variant}
+                return {"url": url, "variant": variant}
 
         return None
 
-    def detect_all(self) -> List[Dict[str, str]]:
+    def detect_all(self) -> list[dict[str, str]]:
         """
         Detect all available llms.txt variants.
 
@@ -50,10 +47,7 @@ class LlmsTxtDetector:
             url = f"{root_url}/{filename}"
 
             if self._check_url_exists(url):
-                found_variants.append({
-                    'url': url,
-                    'variant': variant
-                })
+                found_variants.append({"url": url, "variant": variant})
 
         return found_variants
 
diff --git a/src/skill_seekers/cli/llms_txt_downloader.py b/src/skill_seekers/cli/llms_txt_downloader.py
index 76ec740..6a8e86a 100644
--- a/src/skill_seekers/cli/llms_txt_downloader.py
+++ b/src/skill_seekers/cli/llms_txt_downloader.py
@@ -1,9 +1,11 @@
 """ABOUTME: Downloads llms.txt files from documentation URLs with retry logic"""
+
 """ABOUTME: Validates markdown content and handles timeouts with exponential backoff"""
 
-import requests
 import time
-from typing import Optional
+
+import requests
+
 
 class LlmsTxtDownloader:
     """Download llms.txt content from URLs with retry logic"""
@@ -27,12 +29,13 @@ class LlmsTxtDownloader:
         """
         # Extract filename from URL
         from urllib.parse import urlparse
+
         parsed = urlparse(self.url)
-        filename = parsed.path.split('/')[-1]
+        filename = parsed.path.split("/")[-1]
 
         # Replace .txt with .md
-        if filename.endswith('.txt'):
-            filename = filename[:-4] + '.md'
+        if filename.endswith(".txt"):
+            filename = filename[:-4] + ".md"
 
         return filename
 
@@ -46,37 +49,31 @@ class LlmsTxtDownloader:
         # First, reject HTML content (common redirect trap)
         content_start = content.strip()[:500].lower()
         html_indicators = [
-            '<!doctype html',
-            '<html',
-            '<!doctype',
-            '<head>',
-            '<meta charset',
+            "<!doctype html",
+            "<html",
+            "<!doctype",
+            "<head>",
+            "<meta charset",
         ]
         if any(indicator in content_start for indicator in html_indicators):
             return False
 
         # Then check for markdown patterns
-        markdown_patterns = ['# ', '## ', '```', '- ', '* ', '`']
+        markdown_patterns = ["# ", "## ", "```", "- ", "* ", "`"]
         return any(pattern in content for pattern in markdown_patterns)
 
-    def download(self) -> Optional[str]:
+    def download(self) -> str | None:
         """
         Download llms.txt content with retry logic.
 
         Returns:
             String content or None if download fails
         """
-        headers = {
-            'User-Agent': 'Skill-Seekers-llms.txt-Reader/1.0'
-        }
+        headers = {"User-Agent": "Skill-Seekers-llms.txt-Reader/1.0"}
 
         for attempt in range(self.max_retries):
             try:
-                response = requests.get(
-                    self.url,
-                    headers=headers,
-                    timeout=self.timeout
-                )
+                response = requests.get(self.url, headers=headers, timeout=self.timeout)
                 response.raise_for_status()
 
                 content = response.text
@@ -88,7 +85,7 @@ class LlmsTxtDownloader:
 
                 # Validate content looks like markdown
                 if not self._is_markdown(content):
-                    print(f"⚠️  Content doesn't look like markdown")
+                    print("⚠️  Content doesn't look like markdown")
                     return None
 
                 return content
@@ -96,7 +93,7 @@ class LlmsTxtDownloader:
             except requests.RequestException as e:
                 if attempt < self.max_retries - 1:
                     # Calculate exponential backoff delay: 1s, 2s, 4s, etc.
-                    delay = 2 ** attempt
+                    delay = 2**attempt
                     print(f"⚠️  Attempt {attempt + 1}/{self.max_retries} failed: {e}")
                     print(f"   Retrying in {delay}s...")
                     time.sleep(delay)
diff --git a/src/skill_seekers/cli/llms_txt_parser.py b/src/skill_seekers/cli/llms_txt_parser.py
index ae11410..16878c6 100644
--- a/src/skill_seekers/cli/llms_txt_parser.py
+++ b/src/skill_seekers/cli/llms_txt_parser.py
@@ -1,10 +1,11 @@
 """ABOUTME: Parses llms.txt markdown content into structured page data"""
+
 """ABOUTME: Extracts titles, content, code samples, and headings from markdown"""
 
 import re
-from typing import List, Dict
 from urllib.parse import urljoin
 
+
 class LlmsTxtParser:
     """Parse llms.txt markdown content into page structures"""
 
@@ -12,7 +13,7 @@ class LlmsTxtParser:
         self.content = content
         self.base_url = base_url
 
-    def extract_urls(self) -> List[str]:
+    def extract_urls(self) -> list[str]:
         """
         Extract all URLs from the llms.txt content.
 
@@ -33,13 +34,13 @@ class LlmsTxtParser:
         urls = set()
 
         # Match markdown links: [text](url)
-        md_links = re.findall(r'\[([^\]]*)\]\(([^)]+)\)', self.content)
+        md_links = re.findall(r"\[([^\]]*)\]\(([^)]+)\)", self.content)
         for _, url in md_links:
-            if url.startswith('http'):
+            if url.startswith("http"):
                 clean_url = self._clean_url(url)
                 if clean_url:
                     urls.add(clean_url)
-            elif self.base_url and not url.startswith('#'):
+            elif self.base_url and not url.startswith("#"):
                 clean_url = self._clean_url(urljoin(self.base_url, url))
                 if clean_url:
                     urls.add(clean_url)
@@ -48,7 +49,7 @@ class LlmsTxtParser:
         bare_urls = re.findall(r'https?://[^\s\)\]<>"\']+', self.content)
         for url in bare_urls:
             # Clean trailing punctuation
-            url = url.rstrip('.,;:')
+            url = url.rstrip(".,;:")
             clean_url = self._clean_url(url)
             if clean_url:
                 urls.add(clean_url)
@@ -79,16 +80,16 @@ class LlmsTxtParser:
         """
         # Skip URLs with path after anchor (e.g., #section/index.html.md)
         # These are malformed and return duplicate HTML content
-        if '#' in url:
-            anchor_pos = url.index('#')
-            after_anchor = url[anchor_pos + 1:]
+        if "#" in url:
+            anchor_pos = url.index("#")
+            after_anchor = url[anchor_pos + 1 :]
             # If there's a path separator after anchor, it's invalid
-            if '/' in after_anchor:
+            if "/" in after_anchor:
                 # Extract the base URL without the malformed anchor
                 return url[:anchor_pos]
         return url
 
-    def parse(self) -> List[Dict]:
+    def parse(self) -> list[dict]:
         """
         Parse markdown content into page structures.
 
@@ -98,55 +99,50 @@ class LlmsTxtParser:
         pages = []
 
         # Split by h1 headers (# Title)
-        sections = re.split(r'\n# ', self.content)
+        sections = re.split(r"\n# ", self.content)
 
         for section in sections:
             if not section.strip():
                 continue
 
             # First line is title
-            lines = section.split('\n')
-            title = lines[0].strip('#').strip()
+            lines = section.split("\n")
+            title = lines[0].strip("#").strip()
 
             # Parse content
-            page = self._parse_section('\n'.join(lines[1:]), title)
+            page = self._parse_section("\n".join(lines[1:]), title)
             pages.append(page)
 
         return pages
 
-    def _parse_section(self, content: str, title: str) -> Dict:
+    def _parse_section(self, content: str, title: str) -> dict:
         """Parse a single section into page structure"""
         page = {
-            'title': title,
-            'content': '',
-            'code_samples': [],
-            'headings': [],
-            'url': f'llms-txt#{title.lower().replace(" ", "-")}',
-            'links': []
+            "title": title,
+            "content": "",
+            "code_samples": [],
+            "headings": [],
+            "url": f"llms-txt#{title.lower().replace(' ', '-')}",
+            "links": [],
         }
 
         # Extract code blocks
-        code_blocks = re.findall(r'```(\w+)?\n(.*?)```', content, re.DOTALL)
+        code_blocks = re.findall(r"```(\w+)?\n(.*?)```", content, re.DOTALL)
         for lang, code in code_blocks:
-            page['code_samples'].append({
-                'code': code.strip(),
-                'language': lang or 'unknown'
-            })
+            page["code_samples"].append({"code": code.strip(), "language": lang or "unknown"})
 
         # Extract h2/h3 headings
-        headings = re.findall(r'^(#{2,3})\s+(.+)$', content, re.MULTILINE)
+        headings = re.findall(r"^(#{2,3})\s+(.+)$", content, re.MULTILINE)
         for level_markers, text in headings:
-            page['headings'].append({
-                'level': f'h{len(level_markers)}',
-                'text': text.strip(),
-                'id': text.lower().replace(' ', '-')
-            })
+            page["headings"].append(
+                {"level": f"h{len(level_markers)}", "text": text.strip(), "id": text.lower().replace(" ", "-")}
+            )
 
         # Remove code blocks from content for plain text
-        content_no_code = re.sub(r'```.*?```', '', content, flags=re.DOTALL)
+        content_no_code = re.sub(r"```.*?```", "", content, flags=re.DOTALL)
 
         # Extract paragraphs
-        paragraphs = [p.strip() for p in content_no_code.split('\n\n') if len(p.strip()) > 20]
-        page['content'] = '\n\n'.join(paragraphs)
+        paragraphs = [p.strip() for p in content_no_code.split("\n\n") if len(p.strip()) > 20]
+        page["content"] = "\n\n".join(paragraphs)
 
         return page
diff --git a/src/skill_seekers/cli/main.py b/src/skill_seekers/cli/main.py
index 8d064de..e814357 100644
--- a/src/skill_seekers/cli/main.py
+++ b/src/skill_seekers/cli/main.py
@@ -31,9 +31,8 @@ Examples:
     skill-seekers install-agent output/react/ --agent cursor
 """
 
-import sys
 import argparse
-from typing import List, Optional
+import sys
 
 
 def create_parser() -> argparse.ArgumentParser:
@@ -61,54 +60,27 @@ Examples:
   skill-seekers upload output/react.zip
 
 For more information: https://github.com/yusufkaraaslan/Skill_Seekers
-        """
+        """,
     )
 
-    parser.add_argument(
-        "--version",
-        action="version",
-        version="%(prog)s 2.7.0"
-    )
+    parser.add_argument("--version", action="version", version="%(prog)s 2.7.0")
 
     subparsers = parser.add_subparsers(
-        dest="command",
-        title="commands",
-        description="Available Skill Seekers commands",
-        help="Command to run"
+        dest="command", title="commands", description="Available Skill Seekers commands", help="Command to run"
     )
 
     # === config subcommand ===
     config_parser = subparsers.add_parser(
-        "config",
-        help="Configure GitHub tokens, API keys, and settings",
-        description="Interactive configuration wizard"
-    )
-    config_parser.add_argument(
-        "--github",
-        action="store_true",
-        help="Go directly to GitHub token setup"
-    )
-    config_parser.add_argument(
-        "--api-keys",
-        action="store_true",
-        help="Go directly to API keys setup"
-    )
-    config_parser.add_argument(
-        "--show",
-        action="store_true",
-        help="Show current configuration and exit"
-    )
-    config_parser.add_argument(
-        "--test",
-        action="store_true",
-        help="Test connections and exit"
+        "config", help="Configure GitHub tokens, API keys, and settings", description="Interactive configuration wizard"
     )
+    config_parser.add_argument("--github", action="store_true", help="Go directly to GitHub token setup")
+    config_parser.add_argument("--api-keys", action="store_true", help="Go directly to API keys setup")
+    config_parser.add_argument("--show", action="store_true", help="Show current configuration and exit")
+    config_parser.add_argument("--test", action="store_true", help="Test connections and exit")
 
     # === scrape subcommand ===
     scrape_parser = subparsers.add_parser(
-        "scrape",
-        help="Scrape documentation website",
-        description="Scrape documentation website and generate skill"
+        "scrape", help="Scrape documentation website", description="Scrape documentation website and generate skill"
     )
     scrape_parser.add_argument("--config", help="Config JSON file")
     scrape_parser.add_argument("--name", help="Skill name")
@@ -123,9 +95,7 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
 
     # === github subcommand ===
     github_parser = subparsers.add_parser(
-        "github",
-        help="Scrape GitHub repository",
-        description="Scrape GitHub repository and generate skill"
+        "github", help="Scrape GitHub repository", description="Scrape GitHub repository and generate skill"
     )
     github_parser.add_argument("--config", help="Config JSON file")
     github_parser.add_argument("--repo", help="GitHub repo (owner/repo)")
@@ -134,14 +104,14 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
     github_parser.add_argument("--enhance", action="store_true", help="AI enhancement (API)")
     github_parser.add_argument("--enhance-local", action="store_true", help="AI enhancement (local)")
     github_parser.add_argument("--api-key", type=str, help="Anthropic API key for --enhance")
-    github_parser.add_argument("--non-interactive", action="store_true", help="Non-interactive mode (fail fast on rate limits)")
+    github_parser.add_argument(
+        "--non-interactive", action="store_true", help="Non-interactive mode (fail fast on rate limits)"
+    )
     github_parser.add_argument("--profile", type=str, help="GitHub profile name from config")
 
     # === pdf subcommand ===
     pdf_parser = subparsers.add_parser(
-        "pdf",
-        help="Extract from PDF file",
-        description="Extract content from PDF and generate skill"
+        "pdf", help="Extract from PDF file", description="Extract content from PDF and generate skill"
     )
     pdf_parser.add_argument("--config", help="Config JSON file")
     pdf_parser.add_argument("--pdf", help="PDF file path")
@@ -153,7 +123,7 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
     unified_parser = subparsers.add_parser(
         "unified",
         help="Multi-source scraping (docs + GitHub + PDF)",
-        description="Combine multiple sources into one skill"
+        description="Combine multiple sources into one skill",
     )
     unified_parser.add_argument("--config", required=True, help="Unified config JSON file")
     unified_parser.add_argument("--merge-mode", help="Merge mode (rule-based, claude-enhanced)")
@@ -163,7 +133,7 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
     enhance_parser = subparsers.add_parser(
         "enhance",
         help="AI-powered enhancement (local, no API key)",
-        description="Enhance SKILL.md using Claude Code (local)"
+        description="Enhance SKILL.md using Claude Code (local)",
     )
     enhance_parser.add_argument("skill_directory", help="Skill directory path")
     enhance_parser.add_argument("--background", action="store_true", help="Run in background")
@@ -175,7 +145,7 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
     enhance_status_parser = subparsers.add_parser(
         "enhance-status",
         help="Check enhancement status (for background/daemon modes)",
-        description="Monitor background enhancement processes"
+        description="Monitor background enhancement processes",
     )
     enhance_status_parser.add_argument("skill_directory", help="Skill directory path")
     enhance_status_parser.add_argument("--watch", "-w", action="store_true", help="Watch in real-time")
@@ -184,9 +154,7 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
 
     # === package subcommand ===
     package_parser = subparsers.add_parser(
-        "package",
-        help="Package skill into .zip file",
-        description="Package skill directory into uploadable .zip"
+        "package", help="Package skill into .zip file", description="Package skill directory into uploadable .zip"
     )
     package_parser.add_argument("skill_directory", help="Skill directory path")
     package_parser.add_argument("--no-open", action="store_true", help="Don't open output folder")
@@ -194,9 +162,7 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
 
     # === upload subcommand ===
     upload_parser = subparsers.add_parser(
-        "upload",
-        help="Upload skill to Claude",
-        description="Upload .zip file to Claude via Anthropic API"
+        "upload", help="Upload skill to Claude", description="Upload .zip file to Claude via Anthropic API"
     )
     upload_parser.add_argument("zip_file", help=".zip file to upload")
     upload_parser.add_argument("--api-key", help="Anthropic API key")
@@ -205,7 +171,7 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
     estimate_parser = subparsers.add_parser(
         "estimate",
         help="Estimate page count before scraping",
-        description="Estimate total pages for documentation scraping"
+        description="Estimate total pages for documentation scraping",
     )
     estimate_parser.add_argument("config", nargs="?", help="Config JSON file")
     estimate_parser.add_argument("--all", action="store_true", help="List all available configs")
@@ -215,128 +181,63 @@ For more information: https://github.com/yusufkaraaslan/Skill_Seekers
     test_examples_parser = subparsers.add_parser(
         "extract-test-examples",
         help="Extract usage examples from test files",
-        description="Analyze test files to extract real API usage patterns"
+        description="Analyze test files to extract real API usage patterns",
+    )
+    test_examples_parser.add_argument("directory", nargs="?", help="Directory containing test files")
+    test_examples_parser.add_argument("--file", help="Single test file to analyze")
+    test_examples_parser.add_argument("--language", help="Filter by programming language (python, javascript, etc.)")
+    test_examples_parser.add_argument(
+        "--min-confidence", type=float, default=0.5, help="Minimum confidence threshold (0.0-1.0, default: 0.5)"
     )
     test_examples_parser.add_argument(
-        "directory",
-        nargs="?",
-        help="Directory containing test files"
-    )
-    test_examples_parser.add_argument(
-        "--file",
-        help="Single test file to analyze"
-    )
-    test_examples_parser.add_argument(
-        "--language",
-        help="Filter by programming language (python, javascript, etc.)"
-    )
-    test_examples_parser.add_argument(
-        "--min-confidence",
-        type=float,
-        default=0.5,
-        help="Minimum confidence threshold (0.0-1.0, default: 0.5)"
-    )
-    test_examples_parser.add_argument(
-        "--max-per-file",
-        type=int,
-        default=10,
-        help="Maximum examples per file (default: 10)"
-    )
-    test_examples_parser.add_argument(
-        "--json",
-        action="store_true",
-        help="Output JSON format"
-    )
-    test_examples_parser.add_argument(
-        "--markdown",
-        action="store_true",
-        help="Output Markdown format"
+        "--max-per-file", type=int, default=10, help="Maximum examples per file (default: 10)"
     )
+    test_examples_parser.add_argument("--json", action="store_true", help="Output JSON format")
+    test_examples_parser.add_argument("--markdown", action="store_true", help="Output Markdown format")
 
     # === install-agent subcommand ===
     install_agent_parser = subparsers.add_parser(
         "install-agent",
         help="Install skill to AI agent directories",
-        description="Copy skill to agent-specific installation directories"
+        description="Copy skill to agent-specific installation directories",
+    )
+    install_agent_parser.add_argument("skill_directory", help="Skill directory path (e.g., output/react/)")
+    install_agent_parser.add_argument(
+        "--agent", required=True, help="Agent name (claude, cursor, vscode, amp, goose, opencode, all)"
     )
     install_agent_parser.add_argument(
-        "skill_directory",
-        help="Skill directory path (e.g., output/react/)"
+        "--force", action="store_true", help="Overwrite existing installation without asking"
     )
     install_agent_parser.add_argument(
-        "--agent",
-        required=True,
-        help="Agent name (claude, cursor, vscode, amp, goose, opencode, all)"
-    )
-    install_agent_parser.add_argument(
-        "--force",
-        action="store_true",
-        help="Overwrite existing installation without asking"
-    )
-    install_agent_parser.add_argument(
-        "--dry-run",
-        action="store_true",
-        help="Preview installation without making changes"
+        "--dry-run", action="store_true", help="Preview installation without making changes"
     )
 
     # === install subcommand ===
     install_parser = subparsers.add_parser(
         "install",
         help="Complete workflow: fetch → scrape → enhance → package → upload",
-        description="One-command skill installation (AI enhancement MANDATORY)"
+        description="One-command skill installation (AI enhancement MANDATORY)",
     )
     install_parser.add_argument(
-        "--config",
-        required=True,
-        help="Config name (e.g., 'react') or path (e.g., 'configs/custom.json')"
-    )
-    install_parser.add_argument(
-        "--destination",
-        default="output",
-        help="Output directory (default: output/)"
-    )
-    install_parser.add_argument(
-        "--no-upload",
-        action="store_true",
-        help="Skip automatic upload to Claude"
-    )
-    install_parser.add_argument(
-        "--unlimited",
-        action="store_true",
-        help="Remove page limits during scraping"
-    )
-    install_parser.add_argument(
-        "--dry-run",
-        action="store_true",
-        help="Preview workflow without executing"
+        "--config", required=True, help="Config name (e.g., 'react') or path (e.g., 'configs/custom.json')"
     )
+    install_parser.add_argument("--destination", default="output", help="Output directory (default: output/)")
+    install_parser.add_argument("--no-upload", action="store_true", help="Skip automatic upload to Claude")
+    install_parser.add_argument("--unlimited", action="store_true", help="Remove page limits during scraping")
+    install_parser.add_argument("--dry-run", action="store_true", help="Preview workflow without executing")
 
     # === resume subcommand ===
     resume_parser = subparsers.add_parser(
-        "resume",
-        help="Resume interrupted scraping job",
-        description="Continue from saved progress checkpoint"
-    )
-    resume_parser.add_argument(
-        "job_id",
-        nargs="?",
-        help="Job ID to resume (or use --list to see available jobs)"
-    )
-    resume_parser.add_argument(
-        "--list",
-        action="store_true",
-        help="List all resumable jobs"
-    )
-    resume_parser.add_argument(
-        "--clean",
-        action="store_true",
-        help="Clean up old progress files"
+        "resume", help="Resume interrupted scraping job", description="Continue from saved progress checkpoint"
     )
+    resume_parser.add_argument("job_id", nargs="?", help="Job ID to resume (or use --list to see available jobs)")
+    resume_parser.add_argument("--list", action="store_true", help="List all resumable jobs")
+    resume_parser.add_argument("--clean", action="store_true", help="Clean up old progress files")
 
     return parser
 
 
-def main(argv: Optional[List[str]] = None) -> int:
+def main(argv: list[str] | None = None) -> int:
     """Main entry point for the unified CLI.
 
     Args:
@@ -356,6 +257,7 @@ def main(argv: Optional[List[str]] = None) -> int:
     try:
         if args.command == "config":
             from skill_seekers.cli.config_command import main as config_main
+
             sys.argv = ["config_command.py"]
             if args.github:
                 sys.argv.append("--github")
@@ -369,6 +271,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "scrape":
             from skill_seekers.cli.doc_scraper import main as scrape_main
+
             # Convert args namespace to sys.argv format for doc_scraper
             sys.argv = ["doc_scraper.py"]
             if args.config:
@@ -395,6 +298,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "github":
             from skill_seekers.cli.github_scraper import main as github_main
+
             sys.argv = ["github_scraper.py"]
             if args.config:
                 sys.argv.extend(["--config", args.config])
@@ -418,6 +322,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "pdf":
             from skill_seekers.cli.pdf_scraper import main as pdf_main
+
             sys.argv = ["pdf_scraper.py"]
             if args.config:
                 sys.argv.extend(["--config", args.config])
@@ -433,6 +338,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "unified":
             from skill_seekers.cli.unified_scraper import main as unified_main
+
             sys.argv = ["unified_scraper.py", "--config", args.config]
             if args.merge_mode:
                 sys.argv.extend(["--merge-mode", args.merge_mode])
@@ -442,6 +348,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "enhance":
             from skill_seekers.cli.enhance_skill_local import main as enhance_main
+
             sys.argv = ["enhance_skill_local.py", args.skill_directory]
             if args.background:
                 sys.argv.append("--background")
@@ -455,6 +362,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "enhance-status":
             from skill_seekers.cli.enhance_status import main as enhance_status_main
+
             sys.argv = ["enhance_status.py", args.skill_directory]
             if args.watch:
                 sys.argv.append("--watch")
@@ -466,6 +374,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "package":
             from skill_seekers.cli.package_skill import main as package_main
+
             sys.argv = ["package_skill.py", args.skill_directory]
             if args.no_open:
                 sys.argv.append("--no-open")
@@ -475,6 +384,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "upload":
             from skill_seekers.cli.upload_skill import main as upload_main
+
             sys.argv = ["upload_skill.py", args.zip_file]
             if args.api_key:
                 sys.argv.extend(["--api-key", args.api_key])
@@ -482,6 +392,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "estimate":
             from skill_seekers.cli.estimate_pages import main as estimate_main
+
             sys.argv = ["estimate_pages.py"]
             if args.all:
                 sys.argv.append("--all")
@@ -493,6 +404,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "extract-test-examples":
             from skill_seekers.cli.test_example_extractor import main as test_examples_main
+
             sys.argv = ["test_example_extractor.py"]
             if args.directory:
                 sys.argv.append(args.directory)
@@ -512,6 +424,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "install-agent":
             from skill_seekers.cli.install_agent import main as install_agent_main
+
             sys.argv = ["install_agent.py", args.skill_directory, "--agent", args.agent]
             if args.force:
                 sys.argv.append("--force")
@@ -521,6 +434,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "install":
             from skill_seekers.cli.install_skill import main as install_main
+
             sys.argv = ["install_skill.py"]
             if args.config:
                 sys.argv.extend(["--config", args.config])
@@ -536,6 +450,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
         elif args.command == "resume":
             from skill_seekers.cli.resume_command import main as resume_main
+
             sys.argv = ["resume_command.py"]
             if args.job_id:
                 sys.argv.append(args.job_id)
diff --git a/src/skill_seekers/cli/markdown_cleaner.py b/src/skill_seekers/cli/markdown_cleaner.py
index f2803db..da1b69b 100644
--- a/src/skill_seekers/cli/markdown_cleaner.py
+++ b/src/skill_seekers/cli/markdown_cleaner.py
@@ -24,13 +24,13 @@ class MarkdownCleaner:
             Cleaned markdown with HTML tags removed
         """
         # Remove HTML comments
-        text = re.sub(r'<!--.*?-->', '', text, flags=re.DOTALL)
+        text = re.sub(r"<!--.*?-->", "", text, flags=re.DOTALL)
 
         # Remove HTML tags but keep content
-        text = re.sub(r'<[^>]+>', '', text)
+        text = re.sub(r"<[^>]+>", "", text)
 
         # Remove empty lines created by HTML removal
-        text = re.sub(r'\n\s*\n\s*\n+', '\n\n', text)
+        text = re.sub(r"\n\s*\n\s*\n+", "\n\n", text)
 
         return text.strip()
 
@@ -58,7 +58,7 @@ class MarkdownCleaner:
             return text.strip()
 
         # For longer text, extract smartly
-        lines = text.split('\n')
+        lines = text.split("\n")
         content_lines = []
         char_count = 0
         section_count = 0
@@ -66,11 +66,11 @@ class MarkdownCleaner:
 
         for line in lines:
             # Check for code fence (```)
-            if line.strip().startswith('```'):
+            if line.strip().startswith("```"):
                 in_code_block = not in_code_block
 
             # Check for any heading (H1-H6)
-            is_heading = re.match(r'^#{1,6}\s+', line)
+            is_heading = re.match(r"^#{1,6}\s+", line)
 
             if is_heading:
                 section_count += 1
@@ -91,7 +91,7 @@ class MarkdownCleaner:
             if char_count >= max_chars and not in_code_block:
                 break
 
-        result = '\n'.join(content_lines).strip()
+        result = "\n".join(content_lines).strip()
 
         # If we truncated, ensure we don't break markdown (only if not in code block)
         if char_count >= max_chars and not in_code_block:
@@ -119,17 +119,13 @@ class MarkdownCleaner:
         truncated = text[:max_chars]
 
         # Look for last period, exclamation, or question mark
-        last_sentence = max(
-            truncated.rfind('. '),
-            truncated.rfind('! '),
-            truncated.rfind('? ')
-        )
+        last_sentence = max(truncated.rfind(". "), truncated.rfind("! "), truncated.rfind("? "))
 
         if last_sentence > max_chars // 2:  # At least half the content
-            return truncated[:last_sentence + 1]
+            return truncated[: last_sentence + 1]
 
         # Fall back to word boundary
-        last_space = truncated.rfind(' ')
+        last_space = truncated.rfind(" ")
         if last_space > 0:
             return truncated[:last_space] + "..."
 
diff --git a/src/skill_seekers/cli/merge_sources.py b/src/skill_seekers/cli/merge_sources.py
index 2aec7bf..fadd9c6 100644
--- a/src/skill_seekers/cli/merge_sources.py
+++ b/src/skill_seekers/cli/merge_sources.py
@@ -17,16 +17,16 @@ Multi-layer architecture (Phase 3):
 
 import json
 import logging
+import os
 import subprocess
 import tempfile
-import os
-from pathlib import Path
-from typing import Dict, List, Any, Optional
+from typing import Any, Optional
+
 from .conflict_detector import Conflict, ConflictDetector
 
 # Import three-stream data classes (Phase 1)
 try:
-    from .github_fetcher import ThreeStreamData, CodeStream, DocsStream, InsightsStream
+    from .github_fetcher import CodeStream, DocsStream, InsightsStream, ThreeStreamData
 except ImportError:
     # Fallback if github_fetcher not available
     ThreeStreamData = None
@@ -38,11 +38,7 @@ logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
 
-def categorize_issues_by_topic(
-    problems: List[Dict],
-    solutions: List[Dict],
-    topics: List[str]
-) -> Dict[str, List[Dict]]:
+def categorize_issues_by_topic(problems: list[dict], solutions: list[dict], topics: list[str]) -> dict[str, list[dict]]:
     """
     Categorize GitHub issues by topic keywords.
 
@@ -55,14 +51,14 @@ def categorize_issues_by_topic(
         Dict mapping topic to relevant issues
     """
     categorized = {topic: [] for topic in topics}
-    categorized['other'] = []
+    categorized["other"] = []
 
     all_issues = problems + solutions
 
     for issue in all_issues:
         # Get searchable text
-        title = issue.get('title', '').lower()
-        labels = [label.lower() for label in issue.get('labels', [])]
+        title = issue.get("title", "").lower()
+        labels = [label.lower() for label in issue.get("labels", [])]
         text = f"{title} {' '.join(labels)}"
 
         # Find best matching topic
@@ -82,18 +78,15 @@ def categorize_issues_by_topic(
         if matched_topic and max_matches > 0:
             categorized[matched_topic].append(issue)
         else:
-            categorized['other'].append(issue)
+            categorized["other"].append(issue)
 
     # Remove empty categories
     return {k: v for k, v in categorized.items() if v}
 
 
 def generate_hybrid_content(
-    api_data: Dict,
-    github_docs: Optional[Dict],
-    github_insights: Optional[Dict],
-    conflicts: List[Conflict]
-) -> Dict[str, Any]:
+    api_data: dict, github_docs: dict | None, github_insights: dict | None, conflicts: list[Conflict]
+) -> dict[str, Any]:
     """
     Generate hybrid content combining API data with GitHub context.
 
@@ -106,76 +99,67 @@ def generate_hybrid_content(
     Returns:
         Hybrid content dict with enriched API reference
     """
-    hybrid = {
-        'api_reference': api_data,
-        'github_context': {}
-    }
+    hybrid = {"api_reference": api_data, "github_context": {}}
 
     # Add GitHub documentation layer
     if github_docs:
-        hybrid['github_context']['docs'] = {
-            'readme': github_docs.get('readme'),
-            'contributing': github_docs.get('contributing'),
-            'docs_files_count': len(github_docs.get('docs_files', []))
+        hybrid["github_context"]["docs"] = {
+            "readme": github_docs.get("readme"),
+            "contributing": github_docs.get("contributing"),
+            "docs_files_count": len(github_docs.get("docs_files", [])),
         }
 
     # Add GitHub insights layer
     if github_insights:
-        metadata = github_insights.get('metadata', {})
-        hybrid['github_context']['metadata'] = {
-            'stars': metadata.get('stars', 0),
-            'forks': metadata.get('forks', 0),
-            'language': metadata.get('language', 'Unknown'),
-            'description': metadata.get('description', '')
+        metadata = github_insights.get("metadata", {})
+        hybrid["github_context"]["metadata"] = {
+            "stars": metadata.get("stars", 0),
+            "forks": metadata.get("forks", 0),
+            "language": metadata.get("language", "Unknown"),
+            "description": metadata.get("description", ""),
         }
 
         # Add issue insights
-        common_problems = github_insights.get('common_problems', [])
-        known_solutions = github_insights.get('known_solutions', [])
+        common_problems = github_insights.get("common_problems", [])
+        known_solutions = github_insights.get("known_solutions", [])
 
-        hybrid['github_context']['issues'] = {
-            'common_problems_count': len(common_problems),
-            'known_solutions_count': len(known_solutions),
-            'top_problems': common_problems[:5],  # Top 5 most-discussed
-            'top_solutions': known_solutions[:5]
+        hybrid["github_context"]["issues"] = {
+            "common_problems_count": len(common_problems),
+            "known_solutions_count": len(known_solutions),
+            "top_problems": common_problems[:5],  # Top 5 most-discussed
+            "top_solutions": known_solutions[:5],
         }
 
-        hybrid['github_context']['top_labels'] = github_insights.get('top_labels', [])
+        hybrid["github_context"]["top_labels"] = github_insights.get("top_labels", [])
 
     # Add conflict summary
-    hybrid['conflict_summary'] = {
-        'total_conflicts': len(conflicts),
-        'by_type': {},
-        'by_severity': {}
-    }
+    hybrid["conflict_summary"] = {"total_conflicts": len(conflicts), "by_type": {}, "by_severity": {}}
 
     for conflict in conflicts:
         # Count by type
         conflict_type = conflict.type
-        hybrid['conflict_summary']['by_type'][conflict_type] = \
-            hybrid['conflict_summary']['by_type'].get(conflict_type, 0) + 1
+        hybrid["conflict_summary"]["by_type"][conflict_type] = (
+            hybrid["conflict_summary"]["by_type"].get(conflict_type, 0) + 1
+        )
 
         # Count by severity
         severity = conflict.severity
-        hybrid['conflict_summary']['by_severity'][severity] = \
-            hybrid['conflict_summary']['by_severity'].get(severity, 0) + 1
+        hybrid["conflict_summary"]["by_severity"][severity] = (
+            hybrid["conflict_summary"]["by_severity"].get(severity, 0) + 1
+        )
 
     # Add GitHub issue links for relevant APIs
     if github_insights:
-        hybrid['issue_links'] = _match_issues_to_apis(
-            api_data.get('apis', {}),
-            github_insights.get('common_problems', []),
-            github_insights.get('known_solutions', [])
+        hybrid["issue_links"] = _match_issues_to_apis(
+            api_data.get("apis", {}),
+            github_insights.get("common_problems", []),
+            github_insights.get("known_solutions", []),
         )
 
     return hybrid
 
 
-def _match_issues_to_apis(
-    apis: Dict[str, Dict],
-    problems: List[Dict],
-    solutions: List[Dict]
-) -> Dict[str, List[Dict]]:
+def _match_issues_to_apis(apis: dict[str, dict], problems: list[dict], solutions: list[dict]) -> dict[str, list[dict]]:
     """
     Match GitHub issues to specific APIs by keyword matching.
 
@@ -190,24 +174,26 @@ def _match_issues_to_apis(
     issue_links = {}
     all_issues = problems + solutions
 
-    for api_name in apis.keys():
+    for api_name in apis:
         # Extract searchable keywords from API name
-        api_keywords = api_name.lower().replace('_', ' ').split('.')
+        api_keywords = api_name.lower().replace("_", " ").split(".")
 
         matched_issues = []
         for issue in all_issues:
-            title = issue.get('title', '').lower()
-            labels = [label.lower() for label in issue.get('labels', [])]
+            title = issue.get("title", "").lower()
+            labels = [label.lower() for label in issue.get("labels", [])]
             text = f"{title} {' '.join(labels)}"
 
             # Check if any API keyword appears in issue
             if any(keyword in text for keyword in api_keywords):
-                matched_issues.append({
-                    'number': issue.get('number'),
-                    'title': issue.get('title'),
-                    'state': issue.get('state'),
-                    'comments': issue.get('comments')
-                })
+                matched_issues.append(
+                    {
+                        "number": issue.get("number"),
+                        "title": issue.get("title"),
+                        "state": issue.get("state"),
+                        "comments": issue.get("comments"),
+                    }
+                )
 
         if matched_issues:
             issue_links[api_name] = matched_issues
@@ -232,11 +218,13 @@ class RuleBasedMerger:
     4. If conflict → Include both versions with [CONFLICT] tag, prefer code signature
     """
 
-    def __init__(self,
-                 docs_data: Dict,
-                 github_data: Dict,
-                 conflicts: List[Conflict],
-                 github_streams: Optional['ThreeStreamData'] = None):
+    def __init__(
+        self,
+        docs_data: dict,
+        github_data: dict,
+        conflicts: list[Conflict],
+        github_streams: Optional["ThreeStreamData"] = None,
+    ):
         """
         Initialize rule-based merger with GitHub streams support.
 
@@ -266,21 +254,21 @@ class RuleBasedMerger:
             # Layer 3: GitHub docs
             if github_streams.docs_stream:
                 self.github_docs = {
-                    'readme': github_streams.docs_stream.readme,
-                    'contributing': github_streams.docs_stream.contributing,
-                    'docs_files': github_streams.docs_stream.docs_files
+                    "readme": github_streams.docs_stream.readme,
+                    "contributing": github_streams.docs_stream.contributing,
+                    "docs_files": github_streams.docs_stream.docs_files,
                 }
 
             # Layer 4: GitHub insights
             if github_streams.insights_stream:
                 self.github_insights = {
-                    'metadata': github_streams.insights_stream.metadata,
-                    'common_problems': github_streams.insights_stream.common_problems,
-                    'known_solutions': github_streams.insights_stream.known_solutions,
-                    'top_labels': github_streams.insights_stream.top_labels
+                    "metadata": github_streams.insights_stream.metadata,
+                    "common_problems": github_streams.insights_stream.common_problems,
+                    "known_solutions": github_streams.insights_stream.known_solutions,
+                    "top_labels": github_streams.insights_stream.top_labels,
                 }
 
-    def merge_all(self) -> Dict[str, Any]:
+    def merge_all(self) -> dict[str, Any]:
         """
         Merge all APIs using rule-based logic with GitHub insights (Phase 3).
 
@@ -302,15 +290,15 @@ class RuleBasedMerger:
 
         # Build base result
         merged_data = {
-            'merge_mode': 'rule-based',
-            'apis': merged_apis,
-            'summary': {
-                'total_apis': len(merged_apis),
-                'docs_only': sum(1 for api in merged_apis.values() if api['status'] == 'docs_only'),
-                'code_only': sum(1 for api in merged_apis.values() if api['status'] == 'code_only'),
-                'matched': sum(1 for api in merged_apis.values() if api['status'] == 'matched'),
-                'conflict': sum(1 for api in merged_apis.values() if api['status'] == 'conflict')
-            }
+            "merge_mode": "rule-based",
+            "apis": merged_apis,
+            "summary": {
+                "total_apis": len(merged_apis),
+                "docs_only": sum(1 for api in merged_apis.values() if api["status"] == "docs_only"),
+                "code_only": sum(1 for api in merged_apis.values() if api["status"] == "code_only"),
+                "matched": sum(1 for api in merged_apis.values() if api["status"] == "matched"),
+                "conflict": sum(1 for api in merged_apis.values() if api["status"] == "conflict"),
+            },
         }
 
         # Generate hybrid content if GitHub streams available (Phase 3)
@@ -320,20 +308,22 @@ class RuleBasedMerger:
                 api_data=merged_data,
                 github_docs=self.github_docs,
                 github_insights=self.github_insights,
-                conflicts=self.conflicts
+                conflicts=self.conflicts,
             )
 
             # Merge hybrid content into result
-            merged_data['github_context'] = hybrid_content.get('github_context', {})
-            merged_data['conflict_summary'] = hybrid_content.get('conflict_summary', {})
-            merged_data['issue_links'] = hybrid_content.get('issue_links', {})
+            merged_data["github_context"] = hybrid_content.get("github_context", {})
+            merged_data["conflict_summary"] = hybrid_content.get("conflict_summary", {})
+            merged_data["issue_links"] = hybrid_content.get("issue_links", {})
 
-            logger.info(f"Added GitHub context: {len(self.github_insights.get('common_problems', []))} problems, "
-                       f"{len(self.github_insights.get('known_solutions', []))} solutions")
+            logger.info(
+                f"Added GitHub context: {len(self.github_insights.get('common_problems', []))} problems, "
+                f"{len(self.github_insights.get('known_solutions', []))} solutions"
+            )
 
         return merged_data
 
-    def _merge_single_api(self, api_name: str) -> Dict[str, Any]:
+    def _merge_single_api(self, api_name: str) -> dict[str, Any]:
         """
         Merge a single API using rules.
 
@@ -351,25 +341,27 @@ class RuleBasedMerger:
         if in_docs and not in_code:
             conflict = self.conflict_index.get(api_name)
             return {
-                'name': api_name,
-                'status': 'docs_only',
-                'source': 'documentation',
-                'data': self.docs_apis[api_name],
-                'warning': 'This API is documented but not found in codebase',
-                'conflict': conflict.__dict__ if conflict else None
+                "name": api_name,
+                "status": "docs_only",
+                "source": "documentation",
+                "data": self.docs_apis[api_name],
+                "warning": "This API is documented but not found in codebase",
+                "conflict": conflict.__dict__ if conflict else None,
             }
 
         # Rule 2: Only in code
         if in_code and not in_docs:
-            is_private = api_name.startswith('_')
+            is_private = api_name.startswith("_")
             conflict = self.conflict_index.get(api_name)
             return {
-                'name': api_name,
-                'status': 'code_only',
-                'source': 'code',
-                'data': self.code_apis[api_name],
-                'warning': 'This API exists in code but is not documented' if not is_private else 'Internal/private API',
-                'conflict': conflict.__dict__ if conflict else None
+                "name": api_name,
+                "status": "code_only",
+                "source": "code",
+                "data": self.code_apis[api_name],
+                "warning": "This API exists in code but is not documented"
+                if not is_private
+                else "Internal/private API",
+                "conflict": conflict.__dict__ if conflict else None,
             }
 
         # Both exist - check for conflicts
@@ -379,32 +371,32 @@ class RuleBasedMerger:
         # Rule 3: Both match perfectly (no conflict)
         if not has_conflict:
             return {
-                'name': api_name,
-                'status': 'matched',
-                'source': 'both',
-                'docs_data': docs_info,
-                'code_data': code_info,
-                'merged_signature': self._create_merged_signature(code_info, docs_info),
-                'merged_description': docs_info.get('docstring') or code_info.get('docstring')
+                "name": api_name,
+                "status": "matched",
+                "source": "both",
+                "docs_data": docs_info,
+                "code_data": code_info,
+                "merged_signature": self._create_merged_signature(code_info, docs_info),
+                "merged_description": docs_info.get("docstring") or code_info.get("docstring"),
             }
 
         # Rule 4: Conflict exists - prefer code signature, keep docs description
         conflict = self.conflict_index[api_name]
 
         return {
-            'name': api_name,
-            'status': 'conflict',
-            'source': 'both',
-            'docs_data': docs_info,
-            'code_data': code_info,
-            'conflict': conflict.__dict__,
-            'resolution': 'prefer_code_signature',
-            'merged_signature': self._create_merged_signature(code_info, docs_info),
-            'merged_description': docs_info.get('docstring') or code_info.get('docstring'),
-            'warning': conflict.difference
+            "name": api_name,
+            "status": "conflict",
+            "source": "both",
+            "docs_data": docs_info,
+            "code_data": code_info,
+            "conflict": conflict.__dict__,
+            "resolution": "prefer_code_signature",
+            "merged_signature": self._create_merged_signature(code_info, docs_info),
+            "merged_description": docs_info.get("docstring") or code_info.get("docstring"),
+            "warning": conflict.difference,
         }
 
-    def _create_merged_signature(self, code_info: Dict, docs_info: Dict) -> str:
+    def _create_merged_signature(self, code_info: dict, docs_info: dict) -> str:
         """
         Create merged signature preferring code data.
 
@@ -415,17 +407,17 @@ class RuleBasedMerger:
         Returns:
             Merged signature string
         """
-        name = code_info.get('name', docs_info.get('name'))
-        params = code_info.get('parameters', docs_info.get('parameters', []))
-        return_type = code_info.get('return_type', docs_info.get('return_type'))
+        name = code_info.get("name", docs_info.get("name"))
+        params = code_info.get("parameters", docs_info.get("parameters", []))
+        return_type = code_info.get("return_type", docs_info.get("return_type"))
 
         # Build parameter string
         param_strs = []
         for param in params:
-            param_str = param['name']
-            if param.get('type_hint'):
+            param_str = param["name"]
+            if param.get("type_hint"):
                 param_str += f": {param['type_hint']}"
-            if param.get('default'):
+            if param.get("default"):
                 param_str += f" = {param['default']}"
             param_strs.append(param_str)
 
@@ -451,11 +443,13 @@ class ClaudeEnhancedMerger:
     - Layer 4: GitHub insights (issues)
     """
 
-    def __init__(self,
-                 docs_data: Dict,
-                 github_data: Dict,
-                 conflicts: List[Conflict],
-                 github_streams: Optional['ThreeStreamData'] = None):
+    def __init__(
+        self,
+        docs_data: dict,
+        github_data: dict,
+        conflicts: list[Conflict],
+        github_streams: Optional["ThreeStreamData"] = None,
+    ):
         """
         Initialize Claude-enhanced merger with GitHub streams support.
 
@@ -473,7 +467,7 @@ class ClaudeEnhancedMerger:
         # First do rule-based merge as baseline
         self.rule_merger = RuleBasedMerger(docs_data, github_data, conflicts, github_streams)
 
-    def merge_all(self) -> Dict[str, Any]:
+    def merge_all(self) -> dict[str, Any]:
         """
         Merge all APIs using Claude enhancement.
 
@@ -510,7 +504,7 @@ class ClaudeEnhancedMerger:
         Returns:
             Path to workspace directory
         """
-        workspace = tempfile.mkdtemp(prefix='skill_merge_')
+        workspace = tempfile.mkdtemp(prefix="skill_merge_")
         logger.info(f"Created merge workspace: {workspace}")
 
         # Write context files for Claude
@@ -522,26 +516,30 @@ class ClaudeEnhancedMerger:
         """Write context files for Claude to analyze."""
 
         # 1. Write conflicts summary
-        conflicts_file = os.path.join(workspace, 'conflicts.json')
-        with open(conflicts_file, 'w') as f:
-            json.dump({
-                'conflicts': [c.__dict__ for c in self.conflicts],
-                'summary': {
-                    'total': len(self.conflicts),
-                    'by_type': self._count_by_field('type'),
-                    'by_severity': self._count_by_field('severity')
-                }
-            }, f, indent=2)
+        conflicts_file = os.path.join(workspace, "conflicts.json")
+        with open(conflicts_file, "w") as f:
+            json.dump(
+                {
+                    "conflicts": [c.__dict__ for c in self.conflicts],
+                    "summary": {
+                        "total": len(self.conflicts),
+                        "by_type": self._count_by_field("type"),
+                        "by_severity": self._count_by_field("severity"),
+                    },
+                },
+                f,
+                indent=2,
+            )
 
         # 2. Write documentation APIs
-        docs_apis_file = os.path.join(workspace, 'docs_apis.json')
+        docs_apis_file = os.path.join(workspace, "docs_apis.json")
         detector = ConflictDetector(self.docs_data, self.github_data)
-        with open(docs_apis_file, 'w') as f:
+        with open(docs_apis_file, "w") as f:
             json.dump(detector.docs_apis, f, indent=2)
 
         # 3. Write code APIs
-        code_apis_file = os.path.join(workspace, 'code_apis.json')
-        with open(code_apis_file, 'w') as f:
+        code_apis_file = os.path.join(workspace, "code_apis.json")
+        with open(code_apis_file, "w") as f:
             json.dump(detector.code_apis, f, indent=2)
 
         # 4. Write merge instructions for Claude
@@ -602,13 +600,13 @@ Create `merged_apis.json` with this structure:
 Take your time to analyze each conflict carefully. The goal is to create the most accurate and helpful API reference possible.
 """
 
-        instructions_file = os.path.join(workspace, 'MERGE_INSTRUCTIONS.md')
-        with open(instructions_file, 'w') as f:
+        instructions_file = os.path.join(workspace, "MERGE_INSTRUCTIONS.md")
+        with open(instructions_file, "w") as f:
             f.write(instructions)
 
         logger.info(f"Wrote context files to {workspace}")
 
-    def _count_by_field(self, field: str) -> Dict[str, int]:
+    def _count_by_field(self, field: str) -> dict[str, int]:
         """Count conflicts by a specific field."""
         counts = {}
         for conflict in self.conflicts:
@@ -623,7 +621,7 @@ Take your time to analyze each conflict carefully. The goal is to create the mos
         Similar to enhance_skill_local.py approach.
         """
         # Create a script that Claude will execute
-        script_path = os.path.join(workspace, 'merge_script.sh')
+        script_path = os.path.join(workspace, "merge_script.sh")
 
         script_content = f"""#!/bin/bash
 # Automatic merge script for Claude Code
@@ -646,23 +644,18 @@ echo "When done, save merged_apis.json and close this terminal."
 read -p "Press Enter when merge is complete..."
 """
 
-        with open(script_path, 'w') as f:
+        with open(script_path, "w") as f:
             f.write(script_content)
 
         os.chmod(script_path, 0o755)
 
         # Open new terminal with Claude Code
         # Try different terminal emulators
-        terminals = [
-            ['x-terminal-emulator', '-e'],
-            ['gnome-terminal', '--'],
-            ['xterm', '-e'],
-            ['konsole', '-e']
-        ]
+        terminals = [["x-terminal-emulator", "-e"], ["gnome-terminal", "--"], ["xterm", "-e"], ["konsole", "-e"]]
 
         for terminal_cmd in terminals:
             try:
-                cmd = terminal_cmd + ['bash', script_path]
+                cmd = terminal_cmd + ["bash", script_path]
                 subprocess.Popen(cmd)
                 logger.info(f"Opened terminal with {terminal_cmd[0]}")
                 break
@@ -670,12 +663,13 @@ read -p "Press Enter when merge is complete..."
                 continue
 
         # Wait for merge to complete
-        merged_file = os.path.join(workspace, 'merged_apis.json')
+        merged_file = os.path.join(workspace, "merged_apis.json")
         logger.info(f"Waiting for merged results at: {merged_file}")
         logger.info("Close the terminal when done to continue...")
 
         # Poll for file existence
         import time
+
         timeout = 3600  # 1 hour max
         elapsed = 0
         while not os.path.exists(merged_file) and elapsed < timeout:
@@ -685,27 +679,26 @@ read -p "Press Enter when merge is complete..."
         if not os.path.exists(merged_file):
             raise TimeoutError("Claude merge timed out after 1 hour")
 
-    def _read_merged_results(self, workspace: str) -> Dict[str, Any]:
+    def _read_merged_results(self, workspace: str) -> dict[str, Any]:
         """Read merged results from workspace."""
-        merged_file = os.path.join(workspace, 'merged_apis.json')
+        merged_file = os.path.join(workspace, "merged_apis.json")
 
         if not os.path.exists(merged_file):
             raise FileNotFoundError(f"Merged results not found: {merged_file}")
 
-        with open(merged_file, 'r') as f:
+        with open(merged_file) as f:
             merged_data = json.load(f)
 
-        return {
-            'merge_mode': 'claude-enhanced',
-            **merged_data
-        }
+        return {"merge_mode": "claude-enhanced", **merged_data}
 
 
-def merge_sources(docs_data_path: str,
-                  github_data_path: str,
-                  output_path: str,
-                  mode: str = 'rule-based',
-                  github_streams: Optional['ThreeStreamData'] = None) -> Dict[str, Any]:
+def merge_sources(
+    docs_data_path: str,
+    github_data_path: str,
+    output_path: str,
+    mode: str = "rule-based",
+    github_streams: Optional["ThreeStreamData"] = None,
+) -> dict[str, Any]:
     """
     Merge documentation and GitHub data with optional GitHub streams (Phase 3).
 
@@ -726,10 +719,10 @@ def merge_sources(docs_data_path: str,
         Merged data dict with hybrid content
     """
     # Load data
-    with open(docs_data_path, 'r') as f:
+    with open(docs_data_path) as f:
         docs_data = json.load(f)
 
-    with open(github_data_path, 'r') as f:
+    with open(github_data_path) as f:
         github_data = json.load(f)
 
     # Detect conflicts
@@ -749,7 +742,7 @@ def merge_sources(docs_data_path: str,
             logger.info(f"  - Insights stream: {problems} problems, {solutions} solutions")
 
     # Merge based on mode
-    if mode == 'claude-enhanced':
+    if mode == "claude-enhanced":
         merger = ClaudeEnhancedMerger(docs_data, github_data, conflicts, github_streams)
     else:
         merger = RuleBasedMerger(docs_data, github_data, conflicts, github_streams)
@@ -757,7 +750,7 @@ def merge_sources(docs_data_path: str,
     merged_data = merger.merge_all()
 
     # Save merged data
-    with open(output_path, 'w') as f:
+    with open(output_path, "w") as f:
         json.dump(merged_data, f, indent=2, ensure_ascii=False)
 
     logger.info(f"Merged data saved to: {output_path}")
@@ -765,22 +758,23 @@ def merge_sources(docs_data_path: str,
     return merged_data
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     import argparse
 
-    parser = argparse.ArgumentParser(description='Merge documentation and code sources')
-    parser.add_argument('docs_data', help='Path to documentation data JSON')
-    parser.add_argument('github_data', help='Path to GitHub data JSON')
-    parser.add_argument('--output', '-o', default='merged_data.json', help='Output file path')
-    parser.add_argument('--mode', '-m', choices=['rule-based', 'claude-enhanced'],
-                       default='rule-based', help='Merge mode')
+    parser = argparse.ArgumentParser(description="Merge documentation and code sources")
+    parser.add_argument("docs_data", help="Path to documentation data JSON")
+    parser.add_argument("github_data", help="Path to GitHub data JSON")
+    parser.add_argument("--output", "-o", default="merged_data.json", help="Output file path")
+    parser.add_argument(
+        "--mode", "-m", choices=["rule-based", "claude-enhanced"], default="rule-based", help="Merge mode"
+    )
 
     args = parser.parse_args()
 
     merged = merge_sources(args.docs_data, args.github_data, args.output, args.mode)
 
     # Print summary
-    summary = merged.get('summary', {})
+    summary = merged.get("summary", {})
     print(f"\n✅ Merge complete ({merged.get('merge_mode')})")
     print(f"   Total APIs: {summary.get('total_apis', 0)}")
     print(f"   Matched: {summary.get('matched', 0)}")
diff --git a/src/skill_seekers/cli/package_multi.py b/src/skill_seekers/cli/package_multi.py
index bffdb9c..a44b8f7 100644
--- a/src/skill_seekers/cli/package_multi.py
+++ b/src/skill_seekers/cli/package_multi.py
@@ -5,10 +5,10 @@ Multi-Skill Packager
 Package multiple skills at once. Useful for packaging router + sub-skills together.
 """
 
-import sys
 import argparse
-from pathlib import Path
 import subprocess
+import sys
+from pathlib import Path
 
 
 def package_skill(skill_dir: Path) -> bool:
@@ -17,7 +17,7 @@ def package_skill(skill_dir: Path) -> bool:
         result = subprocess.run(
             [sys.executable, str(Path(__file__).parent / "package_skill.py"), str(skill_dir)],
             capture_output=True,
-            text=True
+            text=True,
         )
         return result.returncode == 0
     except Exception as e:
@@ -36,20 +36,16 @@ Examples:
 
   # Package specific skills
   python3 package_multi.py output/godot-2d/ output/godot-3d/ output/godot-scripting/
-        """
+        """,
     )
 
-    parser.add_argument(
-        'skill_dirs',
-        nargs='+',
-        help='Skill directories to package'
-    )
+    parser.add_argument("skill_dirs", nargs="+", help="Skill directories to package")
 
     args = parser.parse_args()
 
-    print(f"\n{'='*60}")
-    print(f"MULTI-SKILL PACKAGER")
-    print(f"{'='*60}\n")
+    print(f"\n{'=' * 60}")
+    print("MULTI-SKILL PACKAGER")
+    print(f"{'=' * 60}\n")
 
     skill_dirs = [Path(d) for d in args.skill_dirs]
     success_count = 0
@@ -67,14 +63,14 @@ Examples:
         print(f"📦 Packaging: {skill_dir.name}")
         if package_skill(skill_dir):
             success_count += 1
-            print(f"   ✅ Success")
+            print("   ✅ Success")
         else:
-            print(f"   ❌ Failed")
+            print("   ❌ Failed")
         print("")
 
-    print(f"{'='*60}")
+    print(f"{'=' * 60}")
     print(f"SUMMARY: {success_count}/{total_count} skills packaged")
-    print(f"{'='*60}\n")
+    print(f"{'=' * 60}\n")
 
 
 if __name__ == "__main__":
diff --git a/src/skill_seekers/cli/package_skill.py b/src/skill_seekers/cli/package_skill.py
index 6cceb79..114b3d4 100644
--- a/src/skill_seekers/cli/package_skill.py
+++ b/src/skill_seekers/cli/package_skill.py
@@ -9,34 +9,23 @@ Usage:
     skill-seekers package output/react/ --no-open  # Don't open folder
 """
 
+import argparse
 import os
 import sys
-import zipfile
-import argparse
 from pathlib import Path
 
 # Import utilities
 try:
-    from utils import (
-        open_folder,
-        print_upload_instructions,
-        format_file_size,
-        validate_skill_directory
-    )
     from quality_checker import SkillQualityChecker, print_report
+    from utils import format_file_size, open_folder, print_upload_instructions, validate_skill_directory
 except ImportError:
     # If running from different directory, add cli to path
     sys.path.insert(0, str(Path(__file__).parent))
-    from utils import (
-        open_folder,
-        print_upload_instructions,
-        format_file_size,
-        validate_skill_directory
-    )
     from quality_checker import SkillQualityChecker, print_report
+    from utils import format_file_size, open_folder, print_upload_instructions, validate_skill_directory
 
 
-def package_skill(skill_dir, open_folder_after=True, skip_quality_check=False, target='claude'):
+def package_skill(skill_dir, open_folder_after=True, skip_quality_check=False, target="claude"):
     """
     Package a skill directory into platform-specific format
 
@@ -73,7 +62,7 @@ def package_skill(skill_dir, open_folder_after=True, skip_quality_check=False, t
         if report.has_errors or report.has_warnings:
             print("=" * 60)
             response = input("\nContinue with packaging? (y/n): ").strip().lower()
-            if response != 'y':
+            if response != "y":
                 print("\n❌ Packaging cancelled by user")
                 return False, None
             print()
@@ -84,6 +73,7 @@ def package_skill(skill_dir, open_folder_after=True, skip_quality_check=False, t
     # Get platform-specific adaptor
     try:
         from skill_seekers.cli.adaptors import get_adaptor
+
         adaptor = get_adaptor(target)
     except (ImportError, ValueError) as e:
         print(f"❌ Error: {e}")
@@ -140,37 +130,24 @@ Examples:
 
   # Get help
   skill-seekers package --help
-        """
+        """,
+    )
+
+    parser.add_argument("skill_dir", help="Path to skill directory (e.g., output/react/)")
+
+    parser.add_argument("--no-open", action="store_true", help="Do not open the output folder after packaging")
+
+    parser.add_argument("--skip-quality-check", action="store_true", help="Skip quality checks before packaging")
+
+    parser.add_argument(
+        "--target",
+        choices=["claude", "gemini", "openai", "markdown"],
+        default="claude",
+        help="Target LLM platform (default: claude)",
     )
 
     parser.add_argument(
-        'skill_dir',
-        help='Path to skill directory (e.g., output/react/)'
-    )
-
-    parser.add_argument(
-        '--no-open',
-        action='store_true',
-        help='Do not open the output folder after packaging'
-    )
-
-    parser.add_argument(
-        '--skip-quality-check',
-        action='store_true',
-        help='Skip quality checks before packaging'
-    )
-
-    parser.add_argument(
-        '--target',
-        choices=['claude', 'gemini', 'openai', 'markdown'],
-        default='claude',
-        help='Target LLM platform (default: claude)'
-    )
-
-    parser.add_argument(
-        '--upload',
-        action='store_true',
-        help='Automatically upload after packaging (requires platform API key)'
+        "--upload", action="store_true", help="Automatically upload after packaging (requires platform API key)"
     )
 
     args = parser.parse_args()
@@ -179,7 +156,7 @@ Examples:
         args.skill_dir,
         open_folder_after=not args.no_open,
         skip_quality_check=args.skip_quality_check,
-        target=args.target
+        target=args.target,
     )
 
     if not success:
@@ -194,42 +171,42 @@ Examples:
             adaptor = get_adaptor(args.target)
 
             # Get API key from environment
-            api_key = os.environ.get(adaptor.get_env_var_name(), '').strip()
+            api_key = os.environ.get(adaptor.get_env_var_name(), "").strip()
 
             if not api_key:
                 # No API key - show helpful message but DON'T fail
-                print("\n" + "="*60)
+                print("\n" + "=" * 60)
                 print("💡 Automatic Upload")
-                print("="*60)
+                print("=" * 60)
                 print()
                 print(f"To enable automatic upload to {adaptor.PLATFORM_NAME}:")
-                print(f"  1. Get API key from the platform")
+                print("  1. Get API key from the platform")
                 print(f"  2. Set: export {adaptor.get_env_var_name()}=...")
-                print(f"  3. Run package command with --upload flag")
+                print("  3. Run package command with --upload flag")
                 print()
                 print("For now, use manual upload (instructions above) ☝️")
-                print("="*60)
+                print("=" * 60)
                 # Exit successfully - packaging worked!
                 sys.exit(0)
 
             # API key exists - try upload
-            print("\n" + "="*60)
+            print("\n" + "=" * 60)
             print(f"📤 Uploading to {adaptor.PLATFORM_NAME}...")
-            print("="*60)
+            print("=" * 60)
 
             result = adaptor.upload(package_path, api_key)
 
-            if result['success']:
+            if result["success"]:
                 print(f"\n✅ {result['message']}")
-                if result['url']:
+                if result["url"]:
                     print(f"   View at: {result['url']}")
-                print("="*60)
+                print("=" * 60)
                 sys.exit(0)
             else:
                 print(f"\n❌ Upload failed: {result['message']}")
                 print()
                 print("💡 Try manual upload instead (instructions above) ☝️")
-                print("="*60)
+                print("=" * 60)
                 # Exit successfully - packaging worked even if upload failed
                 sys.exit(0)
 
diff --git a/src/skill_seekers/cli/pattern_recognizer.py b/src/skill_seekers/cli/pattern_recognizer.py
index 6b90e7d..827bf38 100644
--- a/src/skill_seekers/cli/pattern_recognizer.py
+++ b/src/skill_seekers/cli/pattern_recognizer.py
@@ -19,13 +19,12 @@ Credits:
 - Detection heuristics: Inspired by academic research on pattern mining
 """
 
-from dataclasses import dataclass, field
-from typing import List, Dict, Optional
-from pathlib import Path
-import logging
 import argparse
 import json
+import logging
 import sys
+from dataclasses import dataclass, field
+from pathlib import Path
 
 logger = logging.getLogger(__name__)
 
@@ -33,58 +32,60 @@ logger = logging.getLogger(__name__)
 @dataclass
 class PatternInstance:
     """Single detected pattern instance"""
+
     pattern_type: str  # e.g., 'Singleton', 'Factory'
     category: str  # 'Creational', 'Structural', 'Behavioral'
     confidence: float  # 0.0-1.0
     location: str  # File path
-    class_name: Optional[str] = None
-    method_name: Optional[str] = None
-    line_number: Optional[int] = None
-    evidence: List[str] = field(default_factory=list)  # Evidence for detection
-    related_classes: List[str] = field(default_factory=list)  # Related pattern classes
-    ai_analysis: Optional[Dict] = None  # AI-generated analysis (C3.6)
+    class_name: str | None = None
+    method_name: str | None = None
+    line_number: int | None = None
+    evidence: list[str] = field(default_factory=list)  # Evidence for detection
+    related_classes: list[str] = field(default_factory=list)  # Related pattern classes
+    ai_analysis: dict | None = None  # AI-generated analysis (C3.6)
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Export to dictionary"""
         result = {
-            'pattern_type': self.pattern_type,
-            'category': self.category,
-            'confidence': self.confidence,
-            'location': self.location,
-            'class_name': self.class_name,
-            'method_name': self.method_name,
-            'line_number': self.line_number,
-            'evidence': self.evidence,
-            'related_classes': self.related_classes
+            "pattern_type": self.pattern_type,
+            "category": self.category,
+            "confidence": self.confidence,
+            "location": self.location,
+            "class_name": self.class_name,
+            "method_name": self.method_name,
+            "line_number": self.line_number,
+            "evidence": self.evidence,
+            "related_classes": self.related_classes,
         }
         if self.ai_analysis:
-            result['ai_analysis'] = self.ai_analysis
+            result["ai_analysis"] = self.ai_analysis
         return result
 
 
 @dataclass
 class PatternReport:
     """Complete pattern detection report"""
+
     file_path: str
     language: str
-    patterns: List[PatternInstance]
+    patterns: list[PatternInstance]
     total_classes: int
     total_functions: int
     analysis_depth: str  # 'surface', 'deep', 'full'
 
-    def to_dict(self) -> Dict:
+    def to_dict(self) -> dict:
         """Export to dictionary"""
         return {
-            'file_path': self.file_path,
-            'language': self.language,
-            'patterns': [p.to_dict() for p in self.patterns],
-            'total_classes': self.total_classes,
-            'total_functions': self.total_functions,
-            'analysis_depth': self.analysis_depth,
-            'pattern_summary': self.get_summary()
+            "file_path": self.file_path,
+            "language": self.language,
+            "patterns": [p.to_dict() for p in self.patterns],
+            "total_classes": self.total_classes,
+            "total_functions": self.total_functions,
+            "analysis_depth": self.analysis_depth,
+            "pattern_summary": self.get_summary(),
         }
 
-    def get_summary(self) -> Dict[str, int]:
+    def get_summary(self) -> dict[str, int]:
         """Get pattern count summary"""
         summary = {}
         for pattern in self.patterns:
@@ -95,7 +96,7 @@ class PatternReport:
 class BasePatternDetector:
     """Base class for all pattern detectors"""
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         """
         Initialize detector.
 
@@ -106,11 +107,7 @@ class BasePatternDetector:
         self.pattern_type = "BasePattern"
         self.category = "Unknown"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """
         Surface-level detection using naming conventions.
 
@@ -124,11 +121,7 @@ class BasePatternDetector:
         # Default: no surface detection
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """
         Deep detection using structural analysis.
 
@@ -142,12 +135,7 @@ class BasePatternDetector:
         # Default: no deep detection
         return None
 
-    def detect_full(
-        self,
-        class_sig,
-        all_classes: List,
-        file_content: str
-    ) -> Optional[PatternInstance]:
+    def detect_full(self, class_sig, all_classes: list, file_content: str) -> PatternInstance | None:
         """
         Full detection using behavioral analysis.
 
@@ -162,12 +150,7 @@ class BasePatternDetector:
         # Default: no full detection
         return None
 
-    def detect(
-        self,
-        class_sig,
-        all_classes: List,
-        file_content: Optional[str] = None
-    ) -> Optional[PatternInstance]:
+    def detect(self, class_sig, all_classes: list, file_content: str | None = None) -> PatternInstance | None:
         """
         Detect pattern based on configured depth.
 
@@ -179,15 +162,15 @@ class BasePatternDetector:
         Returns:
             PatternInstance if pattern detected, None otherwise
         """
-        if self.depth == 'surface':
+        if self.depth == "surface":
             return self.detect_surface(class_sig, all_classes)
-        elif self.depth == 'deep':
+        elif self.depth == "deep":
             # Try deep first, fallback to surface
             result = self.detect_deep(class_sig, all_classes)
             if result:
                 return result
             return self.detect_surface(class_sig, all_classes)
-        elif self.depth == 'full':
+        elif self.depth == "full":
             # Try full, fallback to deep, then surface
             if file_content:
                 result = self.detect_full(class_sig, all_classes, file_content)
@@ -208,7 +191,7 @@ class PatternRecognizer:
     Coordinates multiple pattern detectors to analyze code.
     """
 
-    def __init__(self, depth: str = 'deep', enhance_with_ai: bool = True):
+    def __init__(self, depth: str = "deep", enhance_with_ai: bool = True):
         """
         Initialize pattern recognizer.
 
@@ -218,7 +201,7 @@ class PatternRecognizer:
         """
         self.depth = depth
         self.enhance_with_ai = enhance_with_ai
-        self.detectors: List[BasePatternDetector] = []
+        self.detectors: list[BasePatternDetector] = []
         self._register_detectors()
 
         # Initialize AI enhancer if enabled (C3.6)
@@ -226,6 +209,7 @@ class PatternRecognizer:
         if self.enhance_with_ai:
             try:
                 from skill_seekers.cli.ai_enhancer import PatternEnhancer
+
                 self.ai_enhancer = PatternEnhancer()
             except Exception as e:
                 logger.warning(f"⚠️  Failed to initialize AI enhancer: {e}")
@@ -249,12 +233,7 @@ class PatternRecognizer:
         self.detectors.append(TemplateMethodDetector(self.depth))
         self.detectors.append(ChainOfResponsibilityDetector(self.depth))
 
-    def analyze_file(
-        self,
-        file_path: str,
-        content: str,
-        language: str
-    ) -> PatternReport:
+    def analyze_file(self, file_path: str, content: str, language: str) -> PatternReport:
         """
         Analyze a single file for design patterns.
 
@@ -269,7 +248,7 @@ class PatternRecognizer:
         # Step 1: Analyze code structure using CodeAnalyzer
         from skill_seekers.cli.code_analyzer import CodeAnalyzer
 
-        analyzer = CodeAnalyzer(depth='deep')
+        analyzer = CodeAnalyzer(depth="deep")
         analysis = analyzer.analyze_file(file_path, content, language)
 
         if not analysis:
@@ -279,11 +258,11 @@ class PatternRecognizer:
                 patterns=[],
                 total_classes=0,
                 total_functions=0,
-                analysis_depth=self.depth
+                analysis_depth=self.depth,
             )
 
-        classes = analysis.get('classes', [])
-        functions = analysis.get('functions', [])
+        classes = analysis.get("classes", [])
+        functions = analysis.get("functions", [])
 
         # Convert to class signature objects
         class_sigs = self._convert_to_signatures(classes)
@@ -294,9 +273,7 @@ class PatternRecognizer:
         for class_sig in class_sigs:
             for detector in self.detectors:
                 pattern = detector.detect(
-                    class_sig=class_sig,
-                    all_classes=class_sigs,
-                    file_content=content if self.depth == 'full' else None
+                    class_sig=class_sig, all_classes=class_sigs, file_content=content if self.depth == "full" else None
                 )
 
                 if pattern:
@@ -316,11 +293,11 @@ class PatternRecognizer:
 
             # Update patterns with AI analysis
             for i, pattern in enumerate(detected_patterns):
-                if i < len(enhanced_dicts) and 'ai_analysis' in enhanced_dicts[i]:
-                    pattern.ai_analysis = enhanced_dicts[i]['ai_analysis']
+                if i < len(enhanced_dicts) and "ai_analysis" in enhanced_dicts[i]:
+                    pattern.ai_analysis = enhanced_dicts[i]["ai_analysis"]
                     # Apply confidence boost if provided
-                    if 'confidence' in enhanced_dicts[i]:
-                        pattern.confidence = enhanced_dicts[i]['confidence']
+                    if "confidence" in enhanced_dicts[i]:
+                        pattern.confidence = enhanced_dicts[i]["confidence"]
 
         return PatternReport(
             file_path=file_path,
@@ -328,10 +305,10 @@ class PatternRecognizer:
             patterns=detected_patterns,
             total_classes=len(classes),
             total_functions=len(functions),
-            analysis_depth=self.depth
+            analysis_depth=self.depth,
         )
 
-    def _convert_to_signatures(self, classes: List[Dict]):
+    def _convert_to_signatures(self, classes: list[dict]):
         """
         Convert dict-based class analysis to signature objects.
 
@@ -345,35 +322,33 @@ class PatternRecognizer:
         for cls in classes:
             # Convert methods
             methods = []
-            for method in cls.get('methods', []):
+            for method in cls.get("methods", []):
                 # Convert parameters
                 params = []
-                for param in method.get('parameters', []):
+                for param in method.get("parameters", []):
                     param_obj = SimpleNamespace(
-                        name=param.get('name', ''),
-                        type_hint=param.get('type_hint'),
-                        default=param.get('default')
+                        name=param.get("name", ""), type_hint=param.get("type_hint"), default=param.get("default")
                     )
                     params.append(param_obj)
 
                 method_obj = SimpleNamespace(
-                    name=method.get('name', ''),
+                    name=method.get("name", ""),
                     parameters=params,
-                    return_type=method.get('return_type'),
-                    docstring=method.get('docstring'),
-                    line_number=method.get('line_number'),
-                    is_async=method.get('is_async', False),
+                    return_type=method.get("return_type"),
+                    docstring=method.get("docstring"),
+                    line_number=method.get("line_number"),
+                    is_async=method.get("is_async", False),
                     is_method=True,
-                    decorators=method.get('decorators', [])
+                    decorators=method.get("decorators", []),
                 )
                 methods.append(method_obj)
 
             class_obj = SimpleNamespace(
-                name=cls.get('name', ''),
-                base_classes=cls.get('base_classes', []),
+                name=cls.get("name", ""),
+                base_classes=cls.get("base_classes", []),
                 methods=methods,
-                docstring=cls.get('docstring'),
-                line_number=cls.get('line_number')
+                docstring=cls.get("docstring"),
+                line_number=cls.get("line_number"),
             )
             signatures.append(class_obj)
 
@@ -397,48 +372,37 @@ class SingletonDetector(BasePatternDetector):
     - Java: Private constructor + synchronized getInstance()
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Singleton"
         self.category = "Creational"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check if class name suggests Singleton"""
-        if 'singleton' in class_sig.name.lower():
+        if "singleton" in class_sig.name.lower():
             return PatternInstance(
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.6,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=['Class name contains "Singleton"']
+                evidence=['Class name contains "Singleton"'],
             )
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check structural characteristics of Singleton"""
         evidence = []
         confidence = 0.0
 
         # Check for instance method (getInstance, instance, get_instance, etc.)
-        instance_methods = [
-            'getInstance', 'instance', 'get_instance',
-            'Instance', 'GetInstance', 'INSTANCE'
-        ]
+        instance_methods = ["getInstance", "instance", "get_instance", "Instance", "GetInstance", "INSTANCE"]
 
         has_instance_method = False
         for method in class_sig.methods:
             if method.name in instance_methods:
-                evidence.append(f'Has instance method: {method.name}')
+                evidence.append(f"Has instance method: {method.name}")
                 confidence += 0.4
                 has_instance_method = True
                 break
@@ -448,10 +412,10 @@ class SingletonDetector(BasePatternDetector):
         for method in class_sig.methods:
             # Python: __init__ or __new__
             # Java/C#: private constructor (detected by naming)
-            if method.name in ['__new__', '__init__', 'constructor']:
+            if method.name in ["__new__", "__init__", "constructor"]:
                 # Check if it has logic (not just pass)
                 if method.docstring or len(method.parameters) > 1:
-                    evidence.append(f'Controlled initialization: {method.name}')
+                    evidence.append(f"Controlled initialization: {method.name}")
                     confidence += 0.3
                     has_init_control = True
                     break
@@ -465,21 +429,16 @@ class SingletonDetector(BasePatternDetector):
                     pattern_type=self.pattern_type,
                     category=self.category,
                     confidence=min(confidence, 0.9),
-                    location='',
+                    location="",
                     class_name=class_sig.name,
                     line_number=class_sig.line_number,
-                    evidence=evidence
+                    evidence=evidence,
                 )
 
         # Fallback to surface detection
         return self.detect_surface(class_sig, all_classes)
 
-    def detect_full(
-        self,
-        class_sig,
-        all_classes: List,
-        file_content: str
-    ) -> Optional[PatternInstance]:
+    def detect_full(self, class_sig, all_classes: list, file_content: str) -> PatternInstance | None:
         """
         Full behavioral analysis for Singleton.
 
@@ -498,15 +457,20 @@ class SingletonDetector(BasePatternDetector):
 
         # Check for instance caching patterns in code
         caching_patterns = [
-            '_instance', '__instance', 'instance',
-            'if not', 'if self._instance is None',
-            'synchronized', 'Lock()', 'threading'
+            "_instance",
+            "__instance",
+            "instance",
+            "if not",
+            "if self._instance is None",
+            "synchronized",
+            "Lock()",
+            "threading",
         ]
 
         for pattern in caching_patterns:
             if pattern in file_content:
-                if pattern not in ' '.join(evidence):
-                    evidence.append(f'Instance caching detected: {pattern}')
+                if pattern not in " ".join(evidence):
+                    evidence.append(f"Instance caching detected: {pattern}")
                     confidence += 0.1
 
         # Cap confidence at 0.95 (never 100% certain without runtime analysis)
@@ -533,61 +497,53 @@ class FactoryDetector(BasePatternDetector):
     - ProductFactory with createProductA(), createProductB()
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Factory"
         self.category = "Creational"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming conventions for Factory"""
         # Check class name
-        if 'factory' in class_sig.name.lower():
+        if "factory" in class_sig.name.lower():
             return PatternInstance(
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.7,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=['Class name contains "Factory"']
+                evidence=['Class name contains "Factory"'],
             )
 
         # Check for factory methods
-        factory_method_names = ['create', 'make', 'build', 'new', 'get']
+        factory_method_names = ["create", "make", "build", "new", "get"]
         for method in class_sig.methods:
             method_lower = method.name.lower()
             if any(name in method_lower for name in factory_method_names):
                 # Check if method returns something (has return type or is not void)
-                if method.return_type or 'create' in method_lower:
+                if method.return_type or "create" in method_lower:
                     return PatternInstance(
                         pattern_type=self.pattern_type,
                         category=self.category,
                         confidence=0.6,
-                        location='',
+                        location="",
                         class_name=class_sig.name,
                         method_name=method.name,
                         line_number=method.line_number,
-                        evidence=[f'Factory method detected: {method.name}']
+                        evidence=[f"Factory method detected: {method.name}"],
                     )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Factory"""
         evidence = []
         confidence = 0.0
         factory_methods = []
 
         # Look for methods that create objects
-        creation_keywords = ['create', 'make', 'build', 'new', 'construct', 'get']
+        creation_keywords = ["create", "make", "build", "new", "construct", "get"]
 
         for method in class_sig.methods:
             method_lower = method.name.lower()
@@ -599,19 +555,19 @@ class FactoryDetector(BasePatternDetector):
 
                 # Check if it takes parameters (suggests different object types)
                 if len(method.parameters) > 1:  # >1 because 'self' counts
-                    evidence.append(f'Parameterized factory method: {method.name}')
+                    evidence.append(f"Parameterized factory method: {method.name}")
                     confidence += 0.2
                 else:
-                    evidence.append(f'Factory method: {method.name}')
+                    evidence.append(f"Factory method: {method.name}")
 
         # Check if multiple factory methods exist (Abstract Factory pattern)
         if len(factory_methods) >= 2:
-            evidence.append(f'Multiple factory methods: {", ".join(factory_methods[:3])}')
+            evidence.append(f"Multiple factory methods: {', '.join(factory_methods[:3])}")
             confidence += 0.2
 
         # Check for inheritance (factory hierarchy)
         if class_sig.base_classes:
-            evidence.append(f'Inherits from: {", ".join(class_sig.base_classes)}')
+            evidence.append(f"Inherits from: {', '.join(class_sig.base_classes)}")
             confidence += 0.1
 
         if confidence >= 0.5:
@@ -619,11 +575,11 @@ class FactoryDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.9),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
                 evidence=evidence,
-                related_classes=class_sig.base_classes
+                related_classes=class_sig.base_classes,
             )
 
         # Fallback to surface
@@ -648,18 +604,14 @@ class ObserverDetector(BasePatternDetector):
     - subscribe(), unsubscribe(), publish()
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Observer"
         self.category = "Behavioral"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Observer pattern"""
-        observer_keywords = ['observer', 'listener', 'subscriber', 'watcher']
+        observer_keywords = ["observer", "listener", "subscriber", "watcher"]
 
         # Check class name
         class_lower = class_sig.name.lower()
@@ -668,41 +620,45 @@ class ObserverDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.6,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=[f'Class name suggests Observer: {class_sig.name}']
+                evidence=[f"Class name suggests Observer: {class_sig.name}"],
             )
 
         # Check method names
         observer_methods = [
-            'subscribe', 'unsubscribe', 'publish',
-            'addobserver', 'removeobserver', 'notify',
-            'addeventlistener', 'removeeventlistener', 'emit',
-            'attach', 'detach', 'update'
+            "subscribe",
+            "unsubscribe",
+            "publish",
+            "addobserver",
+            "removeobserver",
+            "notify",
+            "addeventlistener",
+            "removeeventlistener",
+            "emit",
+            "attach",
+            "detach",
+            "update",
         ]
 
         for method in class_sig.methods:
-            method_lower = method.name.lower().replace('_', '')
+            method_lower = method.name.lower().replace("_", "")
             if any(obs_method in method_lower for obs_method in observer_methods):
                 return PatternInstance(
                     pattern_type=self.pattern_type,
                     category=self.category,
                     confidence=0.65,
-                    location='',
+                    location="",
                     class_name=class_sig.name,
                     method_name=method.name,
                     line_number=method.line_number,
-                    evidence=[f'Observer method detected: {method.name}']
+                    evidence=[f"Observer method detected: {method.name}"],
                 )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Observer"""
         evidence = []
         confidence = 0.0
@@ -712,26 +668,26 @@ class ObserverDetector(BasePatternDetector):
         has_detach = False
         has_notify = False
 
-        attach_names = ['attach', 'add', 'subscribe', 'register', 'addeventlistener']
-        detach_names = ['detach', 'remove', 'unsubscribe', 'unregister', 'removeeventlistener']
-        notify_names = ['notify', 'update', 'emit', 'publish', 'fire', 'trigger']
+        attach_names = ["attach", "add", "subscribe", "register", "addeventlistener"]
+        detach_names = ["detach", "remove", "unsubscribe", "unregister", "removeeventlistener"]
+        notify_names = ["notify", "update", "emit", "publish", "fire", "trigger"]
 
         for method in class_sig.methods:
-            method_lower = method.name.lower().replace('_', '')
+            method_lower = method.name.lower().replace("_", "")
 
             if any(name in method_lower for name in attach_names):
                 has_attach = True
-                evidence.append(f'Attach method: {method.name}')
+                evidence.append(f"Attach method: {method.name}")
                 confidence += 0.3
 
             if any(name in method_lower for name in detach_names):
                 has_detach = True
-                evidence.append(f'Detach method: {method.name}')
+                evidence.append(f"Detach method: {method.name}")
                 confidence += 0.3
 
             if any(name in method_lower for name in notify_names):
                 has_notify = True
-                evidence.append(f'Notify method: {method.name}')
+                evidence.append(f"Notify method: {method.name}")
                 confidence += 0.3
 
         # Strong signal if has all three
@@ -743,10 +699,10 @@ class ObserverDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.95),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=evidence
+                evidence=evidence,
             )
 
         # Fallback to surface
@@ -771,18 +727,14 @@ class StrategyDetector(BasePatternDetector):
     - CompressionStrategy with compress() method
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Strategy"
         self.category = "Behavioral"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Strategy"""
-        strategy_keywords = ['strategy', 'policy', 'algorithm']
+        strategy_keywords = ["strategy", "policy", "algorithm"]
 
         class_lower = class_sig.name.lower()
         if any(keyword in class_lower for keyword in strategy_keywords):
@@ -790,19 +742,15 @@ class StrategyDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.7,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=[f'Class name suggests Strategy: {class_sig.name}']
+                evidence=[f"Class name suggests Strategy: {class_sig.name}"],
             )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Strategy"""
         evidence = []
         confidence = 0.0
@@ -817,35 +765,33 @@ class StrategyDetector(BasePatternDetector):
 
             # Look for siblings (other strategies with same base)
             siblings = [
-                cls.name for cls in all_classes
+                cls.name
+                for cls in all_classes
                 if cls.base_classes and base_class in cls.base_classes and cls.name != class_sig.name
             ]
 
             if siblings:
-                evidence.append(f'Part of strategy family with: {", ".join(siblings[:3])}')
+                evidence.append(f"Part of strategy family with: {', '.join(siblings[:3])}")
                 confidence += 0.5
 
-            if base_class and ('strategy' in base_class.lower() or 'policy' in base_class.lower()):
-                evidence.append(f'Inherits from strategy base: {base_class}')
+            if base_class and ("strategy" in base_class.lower() or "policy" in base_class.lower()):
+                evidence.append(f"Inherits from strategy base: {base_class}")
                 confidence += 0.3
 
         # Check if this is a strategy base class
         # (has subclasses in same file)
-        subclasses = [
-            cls.name for cls in all_classes
-            if class_sig.name in cls.base_classes
-        ]
+        subclasses = [cls.name for cls in all_classes if class_sig.name in cls.base_classes]
 
         if len(subclasses) >= 2:
-            evidence.append(f'Strategy base with implementations: {", ".join(subclasses[:3])}')
+            evidence.append(f"Strategy base with implementations: {', '.join(subclasses[:3])}")
             confidence += 0.6
 
         # Check for single dominant method (strategy interface)
         if len(class_sig.methods) == 1 or len(class_sig.methods) == 2:
             # Single method or method + __init__
-            main_method = [m for m in class_sig.methods if m.name not in ['__init__', '__new__']]
+            main_method = [m for m in class_sig.methods if m.name not in ["__init__", "__new__"]]
             if main_method:
-                evidence.append(f'Strategy interface method: {main_method[0].name}')
+                evidence.append(f"Strategy interface method: {main_method[0].name}")
                 confidence += 0.2
 
         if confidence >= 0.5:
@@ -853,11 +799,11 @@ class StrategyDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.9),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
                 evidence=evidence,
-                related_classes=class_sig.base_classes + subclasses
+                related_classes=class_sig.base_classes + subclasses,
             )
 
         # Fallback to surface
@@ -882,18 +828,14 @@ class DecoratorDetector(BasePatternDetector):
     - Python @decorator syntax
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Decorator"
         self.category = "Structural"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Decorator"""
-        decorator_keywords = ['decorator', 'wrapper', 'proxy']
+        decorator_keywords = ["decorator", "wrapper", "proxy"]
 
         class_lower = class_sig.name.lower()
         if any(keyword in class_lower for keyword in decorator_keywords):
@@ -901,10 +843,10 @@ class DecoratorDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.65,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=[f'Class name suggests Decorator: {class_sig.name}']
+                evidence=[f"Class name suggests Decorator: {class_sig.name}"],
             )
 
         # Check for Python decorator syntax
@@ -916,20 +858,16 @@ class DecoratorDetector(BasePatternDetector):
                     pattern_type=self.pattern_type,
                     category=self.category,
                     confidence=0.3,
-                    location='',
+                    location="",
                     class_name=class_sig.name,
                     method_name=method.name,
                     line_number=method.line_number,
-                    evidence=[f'Method uses decorators: {method.decorators}']
+                    evidence=[f"Method uses decorators: {method.decorators}"],
                 )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Decorator"""
         evidence = []
         confidence = 0.0
@@ -945,22 +883,23 @@ class DecoratorDetector(BasePatternDetector):
 
             # Find other classes with same base
             siblings = [
-                cls.name for cls in all_classes
+                cls.name
+                for cls in all_classes
                 if cls.base_classes and base_class in cls.base_classes and cls.name != class_sig.name
             ]
 
             if siblings:
-                evidence.append(f'Shares interface with: {", ".join(siblings[:2])}')
+                evidence.append(f"Shares interface with: {', '.join(siblings[:2])}")
                 confidence += 0.3
 
         # Check __init__ for composition (takes object parameter)
-        init_method = next((m for m in class_sig.methods if m.name == '__init__'), None)
+        init_method = next((m for m in class_sig.methods if m.name == "__init__"), None)
         if init_method:
             # Check if takes object parameter (not just self)
             if len(init_method.parameters) > 1:  # More than just 'self'
-                param_names = [p.name for p in init_method.parameters if p.name != 'self']
-                if any(name in ['wrapped', 'component', 'inner', 'obj', 'target'] for name in param_names):
-                    evidence.append(f'Takes wrapped object in constructor: {param_names}')
+                param_names = [p.name for p in init_method.parameters if p.name != "self"]
+                if any(name in ["wrapped", "component", "inner", "obj", "target"] for name in param_names):
+                    evidence.append(f"Takes wrapped object in constructor: {param_names}")
                     confidence += 0.4
 
         if confidence >= 0.5:
@@ -968,11 +907,11 @@ class DecoratorDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.85),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
                 evidence=evidence,
-                related_classes=class_sig.base_classes
+                related_classes=class_sig.base_classes,
             )
 
         # Fallback to surface
@@ -997,35 +936,27 @@ class BuilderDetector(BasePatternDetector):
     - StringBuilder pattern
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Builder"
         self.category = "Creational"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Builder"""
-        if 'builder' in class_sig.name.lower():
+        if "builder" in class_sig.name.lower():
             return PatternInstance(
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.7,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=[f'Class name contains "Builder": {class_sig.name}']
+                evidence=[f'Class name contains "Builder": {class_sig.name}'],
             )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Builder"""
         evidence = []
         confidence = 0.0
@@ -1036,25 +967,23 @@ class BuilderDetector(BasePatternDetector):
         # 3. Fluent interface (methods return self/this)
 
         # Check for build/create terminal method
-        terminal_methods = ['build', 'create', 'execute', 'construct', 'make']
+        terminal_methods = ["build", "create", "execute", "construct", "make"]
         has_terminal = any(
-            m.name.lower() in terminal_methods or m.name.lower().startswith('build')
-            for m in class_sig.methods
+            m.name.lower() in terminal_methods or m.name.lower().startswith("build") for m in class_sig.methods
         )
 
         if has_terminal:
-            evidence.append('Has terminal build/create method')
+            evidence.append("Has terminal build/create method")
             confidence += 0.4
 
         # Check for setter methods (with_, set_, add_)
-        setter_prefixes = ['with', 'set', 'add', 'configure']
+        setter_prefixes = ["with", "set", "add", "configure"]
         setter_count = sum(
-            1 for m in class_sig.methods
-            if any(m.name.lower().startswith(prefix) for prefix in setter_prefixes)
+            1 for m in class_sig.methods if any(m.name.lower().startswith(prefix) for prefix in setter_prefixes)
         )
 
         if setter_count >= 3:
-            evidence.append(f'Has {setter_count} configuration methods')
+            evidence.append(f"Has {setter_count} configuration methods")
             confidence += 0.4
         elif setter_count >= 1:
             confidence += 0.2
@@ -1068,21 +997,16 @@ class BuilderDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.9),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=evidence
+                evidence=evidence,
             )
 
         # Fallback to surface
         return self.detect_surface(class_sig, all_classes)
 
-    def detect_full(
-        self,
-        class_sig,
-        all_classes: List,
-        file_content: str
-    ) -> Optional[PatternInstance]:
+    def detect_full(self, class_sig, all_classes: list, file_content: str) -> PatternInstance | None:
         """Full behavioral analysis for Builder"""
         # Start with deep detection
         pattern = self.detect_deep(class_sig, all_classes)
@@ -1094,15 +1018,15 @@ class BuilderDetector(BasePatternDetector):
 
         # Look for fluent interface pattern (return self/this)
         class_content = file_content.lower()
-        fluent_indicators = ['return self', 'return this']
+        fluent_indicators = ["return self", "return this"]
 
         if any(indicator in class_content for indicator in fluent_indicators):
-            evidence.append('Uses fluent interface (return self)')
+            evidence.append("Uses fluent interface (return self)")
             confidence += 0.1
 
         # Check for complex object construction (multiple fields)
-        if 'self.' in class_content and class_content.count('self.') >= 5:
-            evidence.append('Builds complex object with multiple fields')
+        if "self." in class_content and class_content.count("self.") >= 5:
+            evidence.append("Builds complex object with multiple fields")
             confidence += 0.05
 
         if confidence >= 0.5:
@@ -1110,10 +1034,10 @@ class BuilderDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.95),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=evidence
+                evidence=evidence,
             )
 
         # Fallback to deep
@@ -1138,18 +1062,14 @@ class AdapterDetector(BasePatternDetector):
     - FileSystemAdapter wraps OS file operations
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Adapter"
         self.category = "Structural"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Adapter"""
-        adapter_keywords = ['adapter', 'wrapper', 'bridge']
+        adapter_keywords = ["adapter", "wrapper", "bridge"]
 
         class_lower = class_sig.name.lower()
         if any(keyword in class_lower for keyword in adapter_keywords):
@@ -1157,19 +1077,15 @@ class AdapterDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.7,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=[f'Class name suggests Adapter: {class_sig.name}']
+                evidence=[f"Class name suggests Adapter: {class_sig.name}"],
             )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Adapter"""
         evidence = []
         confidence = 0.0
@@ -1180,23 +1096,23 @@ class AdapterDetector(BasePatternDetector):
         # 3. Delegates to adaptee with translation
 
         # Check __init__ for composition (takes adaptee)
-        init_method = next((m for m in class_sig.methods if m.name == '__init__'), None)
+        init_method = next((m for m in class_sig.methods if m.name == "__init__"), None)
         if init_method:
             if len(init_method.parameters) > 1:  # More than just 'self'
-                param_names = [p.name for p in init_method.parameters if p.name != 'self']
-                adaptee_names = ['adaptee', 'wrapped', 'client', 'service', 'api', 'source']
+                param_names = [p.name for p in init_method.parameters if p.name != "self"]
+                adaptee_names = ["adaptee", "wrapped", "client", "service", "api", "source"]
                 if any(name in param_names for name in adaptee_names):
-                    evidence.append(f'Takes adaptee in constructor: {param_names}')
+                    evidence.append(f"Takes adaptee in constructor: {param_names}")
                     confidence += 0.4
 
         # Check if implements interface (has base class)
         if class_sig.base_classes:
-            evidence.append(f'Implements interface: {class_sig.base_classes[0]}')
+            evidence.append(f"Implements interface: {class_sig.base_classes[0]}")
             confidence += 0.3
 
         # Check for delegation methods (methods that likely call adaptee)
         if len(class_sig.methods) >= 3:  # Multiple interface methods
-            evidence.append(f'Has {len(class_sig.methods)} interface methods')
+            evidence.append(f"Has {len(class_sig.methods)} interface methods")
             confidence += 0.2
 
         if confidence >= 0.5:
@@ -1204,10 +1120,10 @@ class AdapterDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.85),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=evidence
+                evidence=evidence,
             )
 
         # Fallback to surface
@@ -1232,18 +1148,14 @@ class CommandDetector(BasePatternDetector):
     - TaskCommand in task queue
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "Command"
         self.category = "Behavioral"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Command"""
-        command_keywords = ['command', 'action', 'task', 'operation']
+        command_keywords = ["command", "action", "task", "operation"]
 
         class_lower = class_sig.name.lower()
         if any(keyword in class_lower for keyword in command_keywords):
@@ -1251,19 +1163,15 @@ class CommandDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.65,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=[f'Class name suggests Command: {class_sig.name}']
+                evidence=[f"Class name suggests Command: {class_sig.name}"],
             )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Command"""
         evidence = []
         confidence = 0.0
@@ -1274,32 +1182,26 @@ class CommandDetector(BasePatternDetector):
         # 3. Encapsulates receiver and parameters
 
         # Check for execute/run method
-        execute_methods = ['execute', 'run', 'call', 'do', 'perform', '__call__']
-        has_execute = any(
-            m.name.lower() in execute_methods
-            for m in class_sig.methods
-        )
+        execute_methods = ["execute", "run", "call", "do", "perform", "__call__"]
+        has_execute = any(m.name.lower() in execute_methods for m in class_sig.methods)
 
         if has_execute:
             method_name = next(m.name for m in class_sig.methods if m.name.lower() in execute_methods)
-            evidence.append(f'Has execute method: {method_name}()')
+            evidence.append(f"Has execute method: {method_name}()")
             confidence += 0.5
 
         # Check for undo/redo support
-        undo_methods = ['undo', 'rollback', 'revert', 'redo']
-        has_undo = any(
-            m.name.lower() in undo_methods
-            for m in class_sig.methods
-        )
+        undo_methods = ["undo", "rollback", "revert", "redo"]
+        has_undo = any(m.name.lower() in undo_methods for m in class_sig.methods)
 
         if has_undo:
-            evidence.append('Supports undo/redo operations')
+            evidence.append("Supports undo/redo operations")
             confidence += 0.3
 
         # Check for receiver (takes object in __init__)
-        init_method = next((m for m in class_sig.methods if m.name == '__init__'), None)
+        init_method = next((m for m in class_sig.methods if m.name == "__init__"), None)
         if init_method and len(init_method.parameters) > 1:
-            evidence.append('Encapsulates receiver/parameters')
+            evidence.append("Encapsulates receiver/parameters")
             confidence += 0.2
 
         if confidence >= 0.5:
@@ -1307,10 +1209,10 @@ class CommandDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.9),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=evidence
+                evidence=evidence,
             )
 
         # Fallback to surface
@@ -1335,46 +1237,35 @@ class TemplateMethodDetector(BasePatternDetector):
     - Framework base classes with lifecycle hooks
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "TemplateMethod"
         self.category = "Behavioral"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Template Method"""
-        template_keywords = ['abstract', 'base', 'template']
+        template_keywords = ["abstract", "base", "template"]
 
         class_lower = class_sig.name.lower()
         if any(keyword in class_lower for keyword in template_keywords):
             # Check if has subclasses
-            subclasses = [
-                cls.name for cls in all_classes
-                if class_sig.name in cls.base_classes
-            ]
+            subclasses = [cls.name for cls in all_classes if class_sig.name in cls.base_classes]
 
             if subclasses:
                 return PatternInstance(
                     pattern_type=self.pattern_type,
                     category=self.category,
                     confidence=0.6,
-                    location='',
+                    location="",
                     class_name=class_sig.name,
                     line_number=class_sig.line_number,
-                    evidence=[f'Abstract base with subclasses: {", ".join(subclasses[:2])}'],
-                    related_classes=subclasses
+                    evidence=[f"Abstract base with subclasses: {', '.join(subclasses[:2])}"],
+                    related_classes=subclasses,
                 )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Template Method"""
         evidence = []
         confidence = 0.0
@@ -1385,36 +1276,41 @@ class TemplateMethodDetector(BasePatternDetector):
         # 3. Has template method that orchestrates
 
         # Check for subclasses
-        subclasses = [
-            cls.name for cls in all_classes
-            if class_sig.name in cls.base_classes
-        ]
+        subclasses = [cls.name for cls in all_classes if class_sig.name in cls.base_classes]
 
         if len(subclasses) >= 1:
-            evidence.append(f'Base class with {len(subclasses)} implementations')
+            evidence.append(f"Base class with {len(subclasses)} implementations")
             confidence += 0.4
 
         # Check for hook-like method names
-        hook_keywords = ['prepare', 'initialize', 'validate', 'process', 'finalize',
-                        'setup', 'teardown', 'before', 'after', 'pre', 'post', 'hook']
+        hook_keywords = [
+            "prepare",
+            "initialize",
+            "validate",
+            "process",
+            "finalize",
+            "setup",
+            "teardown",
+            "before",
+            "after",
+            "pre",
+            "post",
+            "hook",
+        ]
 
         hook_methods = [
-            m.name for m in class_sig.methods
-            if any(keyword in m.name.lower() for keyword in hook_keywords)
+            m.name for m in class_sig.methods if any(keyword in m.name.lower() for keyword in hook_keywords)
         ]
 
         if len(hook_methods) >= 2:
-            evidence.append(f'Has hook methods: {", ".join(hook_methods[:3])}')
+            evidence.append(f"Has hook methods: {', '.join(hook_methods[:3])}")
             confidence += 0.3
 
         # Check for abstract methods (no implementation or pass/raise)
-        abstract_methods = [
-            m.name for m in class_sig.methods
-            if m.name.startswith('_') or 'abstract' in m.name.lower()
-        ]
+        abstract_methods = [m.name for m in class_sig.methods if m.name.startswith("_") or "abstract" in m.name.lower()]
 
         if abstract_methods:
-            evidence.append(f'Has abstract methods: {", ".join(abstract_methods[:2])}')
+            evidence.append(f"Has abstract methods: {', '.join(abstract_methods[:2])}")
             confidence += 0.2
 
         if confidence >= 0.5:
@@ -1422,11 +1318,11 @@ class TemplateMethodDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.85),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
                 evidence=evidence,
-                related_classes=subclasses
+                related_classes=subclasses,
             )
 
         # Fallback to surface
@@ -1451,18 +1347,14 @@ class ChainOfResponsibilityDetector(BasePatternDetector):
     - EventHandler chain
     """
 
-    def __init__(self, depth: str = 'deep'):
+    def __init__(self, depth: str = "deep"):
         super().__init__(depth)
         self.pattern_type = "ChainOfResponsibility"
         self.category = "Behavioral"
 
-    def detect_surface(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_surface(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Check naming for Chain of Responsibility"""
-        chain_keywords = ['handler', 'chain', 'middleware', 'filter', 'processor']
+        chain_keywords = ["handler", "chain", "middleware", "filter", "processor"]
 
         class_lower = class_sig.name.lower()
         if any(keyword in class_lower for keyword in chain_keywords):
@@ -1470,19 +1362,15 @@ class ChainOfResponsibilityDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=0.6,
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=[f'Class name suggests handler chain: {class_sig.name}']
+                evidence=[f"Class name suggests handler chain: {class_sig.name}"],
             )
 
         return None
 
-    def detect_deep(
-        self,
-        class_sig,
-        all_classes: List
-    ) -> Optional[PatternInstance]:
+    def detect_deep(self, class_sig, all_classes: list) -> PatternInstance | None:
         """Structural analysis for Chain of Responsibility"""
         evidence = []
         confidence = 0.0
@@ -1493,37 +1381,35 @@ class ChainOfResponsibilityDetector(BasePatternDetector):
         # 3. May have set_next() method
 
         # Check for handle/process method
-        handle_methods = ['handle', 'process', 'execute', 'filter', 'middleware']
+        handle_methods = ["handle", "process", "execute", "filter", "middleware"]
         has_handle = any(
-            m.name.lower() in handle_methods or m.name.lower().startswith('handle')
-            for m in class_sig.methods
+            m.name.lower() in handle_methods or m.name.lower().startswith("handle") for m in class_sig.methods
         )
 
         if has_handle:
-            evidence.append('Has handle/process method')
+            evidence.append("Has handle/process method")
             confidence += 0.4
 
         # Check for next/successor methods or parameters
-        init_method = next((m for m in class_sig.methods if m.name == '__init__'), None)
+        init_method = next((m for m in class_sig.methods if m.name == "__init__"), None)
         has_next_ref = False
 
         if init_method:
-            param_names = [p.name for p in init_method.parameters if p.name != 'self']
-            next_names = ['next', 'successor', 'next_handler', 'next_middleware']
+            param_names = [p.name for p in init_method.parameters if p.name != "self"]
+            next_names = ["next", "successor", "next_handler", "next_middleware"]
 
             if any(name in param_names for name in next_names):
-                evidence.append('Takes next handler in chain')
+                evidence.append("Takes next handler in chain")
                 confidence += 0.3
                 has_next_ref = True
 
         # Check for set_next() method
         has_set_next = any(
-            'next' in m.name.lower() and ('set' in m.name.lower() or 'add' in m.name.lower())
-            for m in class_sig.methods
+            "next" in m.name.lower() and ("set" in m.name.lower() or "add" in m.name.lower()) for m in class_sig.methods
         )
 
         if has_set_next:
-            evidence.append('Has set_next() method')
+            evidence.append("Has set_next() method")
             confidence += 0.3
             has_next_ref = True
 
@@ -1531,12 +1417,13 @@ class ChainOfResponsibilityDetector(BasePatternDetector):
         if class_sig.base_classes:
             base_class = class_sig.base_classes[0]
             siblings = [
-                cls.name for cls in all_classes
+                cls.name
+                for cls in all_classes
                 if cls.base_classes and base_class in cls.base_classes and cls.name != class_sig.name
             ]
 
             if siblings and has_next_ref:
-                evidence.append(f'Part of handler chain with: {", ".join(siblings[:2])}')
+                evidence.append(f"Part of handler chain with: {', '.join(siblings[:2])}")
                 confidence += 0.2
 
         if confidence >= 0.5:
@@ -1544,10 +1431,10 @@ class ChainOfResponsibilityDetector(BasePatternDetector):
                 pattern_type=self.pattern_type,
                 category=self.category,
                 confidence=min(confidence, 0.9),
-                location='',
+                location="",
                 class_name=class_sig.name,
                 line_number=class_sig.line_number,
-                evidence=evidence
+                evidence=evidence,
             )
 
         # Fallback to surface
@@ -1563,10 +1450,7 @@ class LanguageAdapter:
     """
 
     @staticmethod
-    def adapt_for_language(
-        pattern: PatternInstance,
-        language: str
-    ) -> PatternInstance:
+    def adapt_for_language(pattern: PatternInstance, language: str) -> PatternInstance:
         """
         Adjust confidence based on language-specific idioms.
 
@@ -1580,129 +1464,129 @@ class LanguageAdapter:
         if not pattern:
             return pattern
 
-        evidence_str = ' '.join(pattern.evidence).lower()
+        evidence_str = " ".join(pattern.evidence).lower()
 
         # Python-specific adaptations
-        if language == 'Python':
+        if language == "Python":
             # Decorator pattern: Python has native @ syntax
-            if pattern.pattern_type == 'Decorator':
-                if '@' in ' '.join(pattern.evidence):
+            if pattern.pattern_type == "Decorator":
+                if "@" in " ".join(pattern.evidence):
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
-                    pattern.evidence.append('Python @decorator syntax detected')
+                    pattern.evidence.append("Python @decorator syntax detected")
 
             # Singleton: __new__ method is Python idiom
-            elif pattern.pattern_type == 'Singleton':
-                if '__new__' in evidence_str:
+            elif pattern.pattern_type == "Singleton":
+                if "__new__" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
 
             # Strategy: Duck typing common in Python
-            elif pattern.pattern_type == 'Strategy':
-                if 'duck typing' in evidence_str or 'protocol' in evidence_str:
+            elif pattern.pattern_type == "Strategy":
+                if "duck typing" in evidence_str or "protocol" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.05, 1.0)
 
         # JavaScript/TypeScript adaptations
-        elif language in ['JavaScript', 'TypeScript']:
+        elif language in ["JavaScript", "TypeScript"]:
             # Singleton: Module pattern is common
-            if pattern.pattern_type == 'Singleton':
-                if 'module' in evidence_str or 'export default' in evidence_str:
+            if pattern.pattern_type == "Singleton":
+                if "module" in evidence_str or "export default" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
-                    pattern.evidence.append('JavaScript module pattern')
+                    pattern.evidence.append("JavaScript module pattern")
 
             # Factory: Factory functions are idiomatic
-            elif pattern.pattern_type == 'Factory':
-                if 'create' in evidence_str or 'make' in evidence_str:
+            elif pattern.pattern_type == "Factory":
+                if "create" in evidence_str or "make" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.05, 1.0)
 
             # Observer: Event emitters are built-in
-            elif pattern.pattern_type == 'Observer':
-                if 'eventemitter' in evidence_str or 'event' in evidence_str:
+            elif pattern.pattern_type == "Observer":
+                if "eventemitter" in evidence_str or "event" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
-                    pattern.evidence.append('EventEmitter pattern detected')
+                    pattern.evidence.append("EventEmitter pattern detected")
 
         # Java/C# adaptations (interface-heavy languages)
-        elif language in ['Java', 'C#']:
+        elif language in ["Java", "C#"]:
             # All patterns: Interfaces are explicit
-            if 'interface' in evidence_str:
+            if "interface" in evidence_str:
                 pattern.confidence = min(pattern.confidence + 0.05, 1.0)
 
             # Factory: Abstract Factory common
-            if pattern.pattern_type == 'Factory':
-                if 'abstract' in evidence_str:
+            if pattern.pattern_type == "Factory":
+                if "abstract" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
-                    pattern.evidence.append('Abstract Factory pattern')
+                    pattern.evidence.append("Abstract Factory pattern")
 
             # Template Method: Abstract classes common
-            elif pattern.pattern_type == 'TemplateMethod':
-                if 'abstract' in evidence_str:
+            elif pattern.pattern_type == "TemplateMethod":
+                if "abstract" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
 
         # Go adaptations
-        elif language == 'Go':
+        elif language == "Go":
             # Singleton: sync.Once is idiomatic
-            if pattern.pattern_type == 'Singleton':
-                if 'sync.once' in evidence_str or 'once.do' in evidence_str:
+            if pattern.pattern_type == "Singleton":
+                if "sync.once" in evidence_str or "once.do" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.15, 1.0)
-                    pattern.evidence.append('Go sync.Once idiom')
+                    pattern.evidence.append("Go sync.Once idiom")
 
             # Strategy: Interfaces are implicit
-            elif pattern.pattern_type == 'Strategy':
-                if 'interface{}' in evidence_str:
+            elif pattern.pattern_type == "Strategy":
+                if "interface{}" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.05, 1.0)
 
         # Rust adaptations
-        elif language == 'Rust':
+        elif language == "Rust":
             # Singleton: Lazy static is common
-            if pattern.pattern_type == 'Singleton':
-                if 'lazy_static' in evidence_str or 'oncecell' in evidence_str:
+            if pattern.pattern_type == "Singleton":
+                if "lazy_static" in evidence_str or "oncecell" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.15, 1.0)
-                    pattern.evidence.append('Rust lazy_static/OnceCell')
+                    pattern.evidence.append("Rust lazy_static/OnceCell")
 
             # Builder: Derive builder is idiomatic
-            elif pattern.pattern_type == 'Builder':
-                if 'derive' in evidence_str and 'builder' in evidence_str:
+            elif pattern.pattern_type == "Builder":
+                if "derive" in evidence_str and "builder" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
 
             # Adapter: Trait adapters are common
-            elif pattern.pattern_type == 'Adapter':
-                if 'trait' in evidence_str:
+            elif pattern.pattern_type == "Adapter":
+                if "trait" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
 
         # C++ adaptations
-        elif language == 'C++':
+        elif language == "C++":
             # Singleton: Meyer's Singleton is idiomatic
-            if pattern.pattern_type == 'Singleton':
-                if 'static' in evidence_str and 'local' in evidence_str:
+            if pattern.pattern_type == "Singleton":
+                if "static" in evidence_str and "local" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
                     pattern.evidence.append("Meyer's Singleton (static local)")
 
             # Factory: Template-based factories
-            elif pattern.pattern_type == 'Factory':
-                if 'template' in evidence_str:
+            elif pattern.pattern_type == "Factory":
+                if "template" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.05, 1.0)
 
         # Ruby adaptations
-        elif language == 'Ruby':
+        elif language == "Ruby":
             # Singleton: Ruby has Singleton module
-            if pattern.pattern_type == 'Singleton':
-                if 'include singleton' in evidence_str:
+            if pattern.pattern_type == "Singleton":
+                if "include singleton" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.2, 1.0)
-                    pattern.evidence.append('Ruby Singleton module')
+                    pattern.evidence.append("Ruby Singleton module")
 
             # Builder: Method chaining is idiomatic
-            elif pattern.pattern_type == 'Builder':
-                if 'method chaining' in evidence_str:
+            elif pattern.pattern_type == "Builder":
+                if "method chaining" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.05, 1.0)
 
         # PHP adaptations
-        elif language == 'PHP':
+        elif language == "PHP":
             # Singleton: Private constructor is common
-            if pattern.pattern_type == 'Singleton':
-                if 'private' in evidence_str and '__construct' in evidence_str:
+            if pattern.pattern_type == "Singleton":
+                if "private" in evidence_str and "__construct" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.1, 1.0)
 
             # Factory: Static factory methods
-            elif pattern.pattern_type == 'Factory':
-                if 'static' in evidence_str:
+            elif pattern.pattern_type == "Factory":
+                if "static" in evidence_str:
                     pattern.confidence = min(pattern.confidence + 0.05, 1.0)
 
         return pattern
@@ -1717,13 +1601,10 @@ def main():
         skill-seekers-patterns --directory src/ --output patterns/
         skill-seekers-patterns --file app.py --depth full --json
     """
-    import argparse
     import sys
-    import json
-    from pathlib import Path
 
     parser = argparse.ArgumentParser(
-        description='Detect design patterns in source code',
+        description="Detect design patterns in source code",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -1741,38 +1622,20 @@ Examples:
 
 Supported Languages:
   Python, JavaScript, TypeScript, C++, C, C#, Go, Rust, Java, Ruby, PHP
-"""
+""",
     )
 
+    parser.add_argument("--file", action="append", help="Source file to analyze (can be specified multiple times)")
+    parser.add_argument("--directory", help="Directory to analyze (analyzes all source files)")
+    parser.add_argument("--output", help="Output directory for results (default: current directory)")
     parser.add_argument(
-        '--file',
-        action='append',
-        help='Source file to analyze (can be specified multiple times)'
-    )
-    parser.add_argument(
-        '--directory',
-        help='Directory to analyze (analyzes all source files)'
-    )
-    parser.add_argument(
-        '--output',
-        help='Output directory for results (default: current directory)'
-    )
-    parser.add_argument(
-        '--depth',
-        choices=['surface', 'deep', 'full'],
-        default='deep',
-        help='Detection depth: surface (fast), deep (default), full (thorough)'
-    )
-    parser.add_argument(
-        '--json',
-        action='store_true',
-        help='Output JSON format instead of human-readable'
-    )
-    parser.add_argument(
-        '--verbose',
-        action='store_true',
-        help='Enable verbose output'
+        "--depth",
+        choices=["surface", "deep", "full"],
+        default="deep",
+        help="Detection depth: surface (fast), deep (default), full (thorough)",
     )
+    parser.add_argument("--json", action="store_true", help="Output JSON format instead of human-readable")
+    parser.add_argument("--verbose", action="store_true", help="Enable verbose output")
 
     args = parser.parse_args()
 
@@ -1795,7 +1658,8 @@ Supported Languages:
             files_to_analyze.append(path)
 
     if args.directory:
-        from skill_seekers.cli.codebase_scraper import walk_directory, detect_language
+        from skill_seekers.cli.codebase_scraper import detect_language, walk_directory
+
         directory = Path(args.directory)
         if not directory.exists():
             print(f"Error: Directory not found: {args.directory}", file=sys.stderr)
@@ -1816,10 +1680,10 @@ Supported Languages:
         try:
             from skill_seekers.cli.codebase_scraper import detect_language
 
-            content = file_path.read_text(encoding='utf-8', errors='ignore')
+            content = file_path.read_text(encoding="utf-8", errors="ignore")
             language = detect_language(file_path)
 
-            if language == 'Unknown':
+            if language == "Unknown":
                 if args.verbose:
                     print(f"Skipping {file_path}: Unknown language")
                 continue
@@ -1844,16 +1708,16 @@ Supported Languages:
     if args.json:
         # JSON output
         output_data = {
-            'total_files_analyzed': len(files_to_analyze),
-            'files_with_patterns': len(all_reports),
-            'total_patterns_detected': total_patterns,
-            'reports': [report.to_dict() for report in all_reports]
+            "total_files_analyzed": len(files_to_analyze),
+            "files_with_patterns": len(all_reports),
+            "total_patterns_detected": total_patterns,
+            "reports": [report.to_dict() for report in all_reports],
         }
 
         if args.output:
-            output_path = Path(args.output) / 'detected_patterns.json'
+            output_path = Path(args.output) / "detected_patterns.json"
             output_path.parent.mkdir(parents=True, exist_ok=True)
-            with open(output_path, 'w', encoding='utf-8') as f:
+            with open(output_path, "w", encoding="utf-8") as f:
                 json.dump(output_data, f, indent=2)
             print(f"Results saved to: {output_path}")
         else:
@@ -1861,13 +1725,13 @@ Supported Languages:
 
     else:
         # Human-readable output
-        print(f"\n{'='*60}")
-        print(f"PATTERN DETECTION RESULTS")
-        print(f"{'='*60}")
+        print(f"\n{'=' * 60}")
+        print("PATTERN DETECTION RESULTS")
+        print(f"{'=' * 60}")
         print(f"Files analyzed: {len(files_to_analyze)}")
         print(f"Files with patterns: {len(all_reports)}")
         print(f"Total patterns detected: {total_patterns}")
-        print(f"{'='*60}\n")
+        print(f"{'=' * 60}\n")
 
         # Pattern summary by type
         pattern_counts = {}
@@ -1897,5 +1761,5 @@ Supported Languages:
     return 0
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(main())
diff --git a/src/skill_seekers/cli/pdf_extractor_poc.py b/src/skill_seekers/cli/pdf_extractor_poc.py
index 75a8a89..d5bdefc 100755
--- a/src/skill_seekers/cli/pdf_extractor_poc.py
+++ b/src/skill_seekers/cli/pdf_extractor_poc.py
@@ -48,11 +48,11 @@ Example:
         --extract-tables --parallel
 """
 
-import os
-import sys
-import json
-import re
 import argparse
+import json
+import os
+import re
+import sys
 from pathlib import Path
 
 # Import unified language detector
@@ -70,12 +70,14 @@ except ImportError:
 try:
     import pytesseract
     from PIL import Image
+
     TESSERACT_AVAILABLE = True
 except ImportError:
     TESSERACT_AVAILABLE = False
 
 try:
     import concurrent.futures
+
     CONCURRENT_AVAILABLE = True
 except ImportError:
     CONCURRENT_AVAILABLE = False
@@ -84,10 +86,22 @@ except ImportError:
 class PDFExtractor:
     """Extract text and code from PDF documentation"""
 
-    def __init__(self, pdf_path, verbose=False, chunk_size=10, min_quality=0.0,
-                 extract_images=False, image_dir=None, min_image_size=100,
-                 use_ocr=False, password=None, extract_tables=False,
-                 parallel=False, max_workers=None, use_cache=True):
+    def __init__(
+        self,
+        pdf_path,
+        verbose=False,
+        chunk_size=10,
+        min_quality=0.0,
+        extract_images=False,
+        image_dir=None,
+        min_image_size=100,
+        use_ocr=False,
+        password=None,
+        extract_tables=False,
+        parallel=False,
+        max_workers=None,
+        use_cache=True,
+    ):
         self.pdf_path = pdf_path
         self.verbose = verbose
         self.chunk_size = chunk_size  # Pages per chunk (0 = no chunking)
@@ -175,11 +189,11 @@ class PDFExtractor:
             tabs = page.find_tables()
             for idx, tab in enumerate(tabs.tables):
                 table_data = {
-                    'table_index': idx,
-                    'rows': tab.extract(),
-                    'bbox': tab.bbox,
-                    'row_count': len(tab.extract()),
-                    'col_count': len(tab.extract()[0]) if tab.extract() else 0
+                    "table_index": idx,
+                    "rows": tab.extract(),
+                    "bbox": tab.bbox,
+                    "row_count": len(tab.extract()),
+                    "col_count": len(tab.extract()[0]) if tab.extract() else 0,
                 }
                 tables.append(table_data)
                 self.log(f"   Found table {idx}: {table_data['row_count']}x{table_data['col_count']}")
@@ -236,54 +250,54 @@ class PDFExtractor:
 
         # Common syntax checks
         if not code.strip():
-            return False, ['Empty code block']
+            return False, ["Empty code block"]
 
         # Language-specific validation
-        if language == 'python':
+        if language == "python":
             # Check indentation consistency
-            lines = code.split('\n')
+            lines = code.split("\n")
             indent_chars = set()
             for line in lines:
-                if line.startswith(' '):
-                    indent_chars.add('space')
-                elif line.startswith('\t'):
-                    indent_chars.add('tab')
+                if line.startswith(" "):
+                    indent_chars.add("space")
+                elif line.startswith("\t"):
+                    indent_chars.add("tab")
 
             if len(indent_chars) > 1:
-                issues.append('Mixed tabs and spaces')
+                issues.append("Mixed tabs and spaces")
 
             # Check for unclosed brackets/parens
-            open_count = code.count('(') + code.count('[') + code.count('{')
-            close_count = code.count(')') + code.count(']') + code.count('}')
+            open_count = code.count("(") + code.count("[") + code.count("{")
+            close_count = code.count(")") + code.count("]") + code.count("}")
             if abs(open_count - close_count) > 2:  # Allow small mismatch
-                issues.append('Unbalanced brackets')
+                issues.append("Unbalanced brackets")
 
-        elif language in ['javascript', 'java', 'cpp', 'c', 'csharp', 'go']:
+        elif language in ["javascript", "java", "cpp", "c", "csharp", "go"]:
             # Check for balanced braces
-            open_braces = code.count('{')
-            close_braces = code.count('}')
+            open_braces = code.count("{")
+            close_braces = code.count("}")
             if abs(open_braces - close_braces) > 1:
-                issues.append('Unbalanced braces')
+                issues.append("Unbalanced braces")
 
-        elif language == 'json':
+        elif language == "json":
             # Try to parse JSON
             try:
                 json.loads(code)
             except (json.JSONDecodeError, ValueError) as e:
-                issues.append(f'Invalid JSON syntax: {str(e)[:50]}')
+                issues.append(f"Invalid JSON syntax: {str(e)[:50]}")
 
         # General checks
         # Check if code looks like natural language (too many common words)
-        common_words = ['the', 'and', 'for', 'with', 'this', 'that', 'have', 'from']
+        common_words = ["the", "and", "for", "with", "this", "that", "have", "from"]
         word_count = sum(1 for word in common_words if word in code.lower())
         if word_count > 5 and len(code.split()) < 50:
-            issues.append('May be natural language, not code')
+            issues.append("May be natural language, not code")
 
         # Check code/comment ratio
-        comment_lines = sum(1 for line in code.split('\n') if line.strip().startswith(('#', '//', '/*', '*', '--')))
-        total_lines = len([l for l in code.split('\n') if l.strip()])
+        comment_lines = sum(1 for line in code.split("\n") if line.strip().startswith(("#", "//", "/*", "*", "--")))
+        total_lines = len([l for l in code.split("\n") if l.strip()])
         if total_lines > 0 and comment_lines / total_lines > 0.7:
-            issues.append('Mostly comments')
+            issues.append("Mostly comments")
 
         return len(issues) == 0, issues
 
@@ -309,18 +323,18 @@ class PDFExtractor:
             score -= 2.0
 
         # Factor 3: Number of lines
-        lines = [l for l in code.split('\n') if l.strip()]
+        lines = [l for l in code.split("\n") if l.strip()]
         if 2 <= len(lines) <= 50:
             score += 1.0
         elif len(lines) > 100:
             score -= 1.0
 
         # Factor 4: Has function/class definitions
-        if re.search(r'\b(def|function|class|func|fn|public class)\b', code):
+        if re.search(r"\b(def|function|class|func|fn|public class)\b", code):
             score += 1.5
 
         # Factor 5: Has meaningful variable names (not just x, y, i)
-        meaningful_vars = re.findall(r'\b[a-z_][a-z0-9_]{3,}\b', code.lower())
+        meaningful_vars = re.findall(r"\b[a-z_][a-z0-9_]{3,}\b", code.lower())
         if len(meaningful_vars) >= 2:
             score += 1.0
 
@@ -344,19 +358,19 @@ class PDFExtractor:
         code_blocks = []
         blocks = page.get_text("dict")["blocks"]
 
-        monospace_fonts = ['courier', 'mono', 'consolas', 'menlo', 'monaco', 'dejavu']
+        monospace_fonts = ["courier", "mono", "consolas", "menlo", "monaco", "dejavu"]
 
         current_code = []
         current_font = None
 
         for block in blocks:
-            if 'lines' not in block:
+            if "lines" not in block:
                 continue
 
-            for line in block['lines']:
-                for span in line['spans']:
-                    font = span['font'].lower()
-                    text = span['text']
+            for line in block["lines"]:
+                for span in line["spans"]:
+                    font = span["font"].lower()
+                    text = span["text"]
 
                     # Check if font is monospace
                     is_monospace = any(mf in font for mf in monospace_fonts)
@@ -364,47 +378,51 @@ class PDFExtractor:
                     if is_monospace:
                         # Accumulate code text
                         current_code.append(text)
-                        current_font = span['font']
+                        current_font = span["font"]
                     else:
                         # End of code block
                         if current_code:
-                            code_text = ''.join(current_code).strip()
+                            code_text = "".join(current_code).strip()
                             if len(code_text) > 10:  # Minimum code length
                                 lang, confidence = self.detect_language_from_code(code_text)
                                 quality = self.score_code_quality(code_text, lang, confidence)
                                 is_valid, issues = self.validate_code_syntax(code_text, lang)
 
-                                code_blocks.append({
-                                    'code': code_text,
-                                    'language': lang,
-                                    'confidence': confidence,
-                                    'quality_score': quality,
-                                    'is_valid': is_valid,
-                                    'validation_issues': issues if not is_valid else [],
-                                    'font': current_font,
-                                    'detection_method': 'font'
-                                })
+                                code_blocks.append(
+                                    {
+                                        "code": code_text,
+                                        "language": lang,
+                                        "confidence": confidence,
+                                        "quality_score": quality,
+                                        "is_valid": is_valid,
+                                        "validation_issues": issues if not is_valid else [],
+                                        "font": current_font,
+                                        "detection_method": "font",
+                                    }
+                                )
                             current_code = []
                             current_font = None
 
         # Handle final code block
         if current_code:
-            code_text = ''.join(current_code).strip()
+            code_text = "".join(current_code).strip()
             if len(code_text) > 10:
                 lang, confidence = self.detect_language_from_code(code_text)
                 quality = self.score_code_quality(code_text, lang, confidence)
                 is_valid, issues = self.validate_code_syntax(code_text, lang)
 
-                code_blocks.append({
-                    'code': code_text,
-                    'language': lang,
-                    'confidence': confidence,
-                    'quality_score': quality,
-                    'is_valid': is_valid,
-                    'validation_issues': issues if not is_valid else [],
-                    'font': current_font,
-                    'detection_method': 'font'
-                })
+                code_blocks.append(
+                    {
+                        "code": code_text,
+                        "language": lang,
+                        "confidence": confidence,
+                        "quality_score": quality,
+                        "is_valid": is_valid,
+                        "validation_issues": issues if not is_valid else [],
+                        "font": current_font,
+                        "detection_method": "font",
+                    }
+                )
 
         return code_blocks
 
@@ -416,55 +434,59 @@ class PDFExtractor:
         Returns list of detected code blocks.
         """
         code_blocks = []
-        lines = text.split('\n')
+        lines = text.split("\n")
         current_block = []
         indent_pattern = None
 
         for line in lines:
             # Check for indentation (4 spaces or tab)
-            if line.startswith('    ') or line.startswith('\t'):
+            if line.startswith("    ") or line.startswith("\t"):
                 # Start or continue code block
                 if not indent_pattern:
-                    indent_pattern = line[:4] if line.startswith('    ') else '\t'
+                    indent_pattern = line[:4] if line.startswith("    ") else "\t"
                 current_block.append(line)
             else:
                 # End of code block
                 if current_block and len(current_block) >= 2:  # At least 2 lines
-                    code_text = '\n'.join(current_block).strip()
+                    code_text = "\n".join(current_block).strip()
                     if len(code_text) > 20:  # Minimum code length
                         lang, confidence = self.detect_language_from_code(code_text)
                         quality = self.score_code_quality(code_text, lang, confidence)
                         is_valid, issues = self.validate_code_syntax(code_text, lang)
 
-                        code_blocks.append({
-                            'code': code_text,
-                            'language': lang,
-                            'confidence': confidence,
-                            'quality_score': quality,
-                            'is_valid': is_valid,
-                            'validation_issues': issues if not is_valid else [],
-                            'detection_method': 'indent'
-                        })
+                        code_blocks.append(
+                            {
+                                "code": code_text,
+                                "language": lang,
+                                "confidence": confidence,
+                                "quality_score": quality,
+                                "is_valid": is_valid,
+                                "validation_issues": issues if not is_valid else [],
+                                "detection_method": "indent",
+                            }
+                        )
                 current_block = []
                 indent_pattern = None
 
         # Handle final block
         if current_block and len(current_block) >= 2:
-            code_text = '\n'.join(current_block).strip()
+            code_text = "\n".join(current_block).strip()
             if len(code_text) > 20:
                 lang, confidence = self.detect_language_from_code(code_text)
                 quality = self.score_code_quality(code_text, lang, confidence)
                 is_valid, issues = self.validate_code_syntax(code_text, lang)
 
-                code_blocks.append({
-                    'code': code_text,
-                    'language': lang,
-                    'confidence': confidence,
-                    'quality_score': quality,
-                    'is_valid': is_valid,
-                    'validation_issues': issues if not is_valid else [],
-                    'detection_method': 'indent'
-                })
+                code_blocks.append(
+                    {
+                        "code": code_text,
+                        "language": lang,
+                        "confidence": confidence,
+                        "quality_score": quality,
+                        "is_valid": is_valid,
+                        "validation_issues": issues if not is_valid else [],
+                        "detection_method": "indent",
+                    }
+                )
 
         return code_blocks
 
@@ -479,11 +501,11 @@ class PDFExtractor:
         # Common code patterns that span multiple lines
         patterns = [
             # Function definitions
-            (r'((?:def|function|func|fn|public|private)\s+\w+\s*\([^)]*\)\s*[{:]?[^}]*[}]?)', 'function'),
+            (r"((?:def|function|func|fn|public|private)\s+\w+\s*\([^)]*\)\s*[{:]?[^}]*[}]?)", "function"),
             # Class definitions
-            (r'(class\s+\w+[^{]*\{[^}]*\})', 'class'),
+            (r"(class\s+\w+[^{]*\{[^}]*\})", "class"),
             # Import statements block
-            (r'((?:import|require|use|include)[^\n]+(?:\n(?:import|require|use|include)[^\n]+)*)', 'imports'),
+            (r"((?:import|require|use|include)[^\n]+(?:\n(?:import|require|use|include)[^\n]+)*)", "imports"),
         ]
 
         for pattern, block_type in patterns:
@@ -495,16 +517,18 @@ class PDFExtractor:
                     quality = self.score_code_quality(code_text, lang, confidence)
                     is_valid, issues = self.validate_code_syntax(code_text, lang)
 
-                    code_blocks.append({
-                        'code': code_text,
-                        'language': lang,
-                        'confidence': confidence,
-                        'quality_score': quality,
-                        'is_valid': is_valid,
-                        'validation_issues': issues if not is_valid else [],
-                        'detection_method': 'pattern',
-                        'pattern_type': block_type
-                    })
+                    code_blocks.append(
+                        {
+                            "code": code_text,
+                            "language": lang,
+                            "confidence": confidence,
+                            "quality_score": quality,
+                            "is_valid": is_valid,
+                            "validation_issues": issues if not is_valid else [],
+                            "detection_method": "pattern",
+                            "pattern_type": block_type,
+                        }
+                    )
 
         return code_blocks
 
@@ -514,24 +538,24 @@ class PDFExtractor:
 
         Returns (is_chapter_start, chapter_title) tuple.
         """
-        headings = page_data.get('headings', [])
+        headings = page_data.get("headings", [])
 
         # Check for h1 or h2 at start of page
         if headings:
             first_heading = headings[0]
             # H1 headings are strong indicators of chapters
-            if first_heading['level'] in ['h1', 'h2']:
-                return True, first_heading['text']
+            if first_heading["level"] in ["h1", "h2"]:
+                return True, first_heading["text"]
 
         # Check for specific chapter markers in text
-        text = page_data.get('text', '')
-        first_line = text.split('\n')[0] if text else ''
+        text = page_data.get("text", "")
+        first_line = text.split("\n")[0] if text else ""
 
         chapter_patterns = [
-            r'^Chapter\s+\d+',
-            r'^Part\s+\d+',
-            r'^Section\s+\d+',
-            r'^\d+\.\s+[A-Z]',  # "1. Introduction"
+            r"^Chapter\s+\d+",
+            r"^Part\s+\d+",
+            r"^Section\s+\d+",
+            r"^\d+\.\s+[A-Z]",  # "1. Introduction"
         ]
 
         for pattern in chapter_patterns:
@@ -552,42 +576,43 @@ class PDFExtractor:
             next_page = pages[i + 1]
 
             # Check if current page has code blocks
-            if not current_page['code_samples']:
+            if not current_page["code_samples"]:
                 continue
 
             # Get last code block of current page
-            last_code = current_page['code_samples'][-1]
+            last_code = current_page["code_samples"][-1]
 
             # Check if next page starts with code
-            if not next_page['code_samples']:
+            if not next_page["code_samples"]:
                 continue
 
-            first_next_code = next_page['code_samples'][0]
+            first_next_code = next_page["code_samples"][0]
 
             # Same language and detection method = likely continuation
-            if (last_code['language'] == first_next_code['language'] and
-                last_code['detection_method'] == first_next_code['detection_method']):
-
+            if (
+                last_code["language"] == first_next_code["language"]
+                and last_code["detection_method"] == first_next_code["detection_method"]
+            ):
                 # Check if last code block looks incomplete (doesn't end with closing brace/etc)
-                last_code_text = last_code['code'].rstrip()
+                last_code_text = last_code["code"].rstrip()
                 continuation_indicators = [
-                    not last_code_text.endswith('}'),
-                    not last_code_text.endswith(';'),
-                    last_code_text.endswith(','),
-                    last_code_text.endswith('\\'),
+                    not last_code_text.endswith("}"),
+                    not last_code_text.endswith(";"),
+                    last_code_text.endswith(","),
+                    last_code_text.endswith("\\"),
                 ]
 
                 if any(continuation_indicators):
                     # Merge the code blocks
-                    merged_code = last_code['code'] + '\n' + first_next_code['code']
-                    last_code['code'] = merged_code
-                    last_code['merged_from_next_page'] = True
+                    merged_code = last_code["code"] + "\n" + first_next_code["code"]
+                    last_code["code"] = merged_code
+                    last_code["merged_from_next_page"] = True
 
                     # Remove the first code block from next page
-                    next_page['code_samples'].pop(0)
-                    next_page['code_blocks_count'] -= 1
+                    next_page["code_samples"].pop(0)
+                    next_page["code_blocks_count"] -= 1
 
-                    self.log(f"  Merged code block from page {i+1} to {i+2}")
+                    self.log(f"  Merged code block from page {i + 1} to {i + 2}")
 
         return pages
 
@@ -603,13 +628,7 @@ class PDFExtractor:
         """
         if self.chunk_size == 0:
             # No chunking - return all pages as one chunk
-            return [{
-                'chunk_number': 1,
-                'start_page': 1,
-                'end_page': len(pages),
-                'pages': pages,
-                'chapter_title': None
-            }]
+            return [{"chunk_number": 1, "start_page": 1, "end_page": len(pages), "pages": pages, "chapter_title": None}]
 
         chunks = []
         current_chunk = []
@@ -622,13 +641,15 @@ class PDFExtractor:
 
             if is_chapter and current_chunk:
                 # Save current chunk before starting new one
-                chunks.append({
-                    'chunk_number': len(chunks) + 1,
-                    'start_page': chunk_start + 1,
-                    'end_page': i,
-                    'pages': current_chunk,
-                    'chapter_title': current_chapter
-                })
+                chunks.append(
+                    {
+                        "chunk_number": len(chunks) + 1,
+                        "start_page": chunk_start + 1,
+                        "end_page": i,
+                        "pages": current_chunk,
+                        "chapter_title": current_chapter,
+                    }
+                )
                 current_chunk = []
                 chunk_start = i
                 current_chapter = chapter_title
@@ -640,26 +661,30 @@ class PDFExtractor:
 
             # Check if chunk size reached (but don't break chapters)
             if not is_chapter and len(current_chunk) >= self.chunk_size:
-                chunks.append({
-                    'chunk_number': len(chunks) + 1,
-                    'start_page': chunk_start + 1,
-                    'end_page': i + 1,
-                    'pages': current_chunk,
-                    'chapter_title': current_chapter
-                })
+                chunks.append(
+                    {
+                        "chunk_number": len(chunks) + 1,
+                        "start_page": chunk_start + 1,
+                        "end_page": i + 1,
+                        "pages": current_chunk,
+                        "chapter_title": current_chapter,
+                    }
+                )
                 current_chunk = []
                 chunk_start = i + 1
                 current_chapter = None
 
         # Add remaining pages as final chunk
         if current_chunk:
-            chunks.append({
-                'chunk_number': len(chunks) + 1,
-                'start_page': chunk_start + 1,
-                'end_page': len(pages),
-                'pages': current_chunk,
-                'chapter_title': current_chapter
-            })
+            chunks.append(
+                {
+                    "chunk_number": len(chunks) + 1,
+                    "start_page": chunk_start + 1,
+                    "end_page": len(pages),
+                    "pages": current_chunk,
+                    "chapter_title": current_chapter,
+                }
+            )
 
         return chunks
 
@@ -696,7 +721,7 @@ class PDFExtractor:
 
                 # Generate filename
                 pdf_basename = Path(self.pdf_path).stem
-                image_filename = f"{pdf_basename}_page{page_num+1}_img{img_index+1}.{image_ext}"
+                image_filename = f"{pdf_basename}_page{page_num + 1}_img{img_index + 1}.{image_ext}"
 
                 # Save image
                 image_path = Path(self.image_dir) / image_filename
@@ -707,14 +732,14 @@ class PDFExtractor:
 
                 # Store metadata
                 image_info = {
-                    'filename': image_filename,
-                    'path': str(image_path),
-                    'page_number': page_num + 1,
-                    'width': width,
-                    'height': height,
-                    'format': image_ext,
-                    'size_bytes': len(image_bytes),
-                    'xref': xref
+                    "filename": image_filename,
+                    "path": str(image_path),
+                    "page_number": page_num + 1,
+                    "width": width,
+                    "height": height,
+                    "format": image_ext,
+                    "size_bytes": len(image_bytes),
+                    "xref": xref,
                 }
 
                 extracted.append(image_info)
@@ -771,12 +796,12 @@ class PDFExtractor:
         # Simple deduplication by code content
         unique_code = {}
         for block in all_code_blocks:
-            code_hash = hash(block['code'])
+            code_hash = hash(block["code"])
             if code_hash not in unique_code:
                 unique_code[code_hash] = block
             else:
                 # Keep the one with higher quality score
-                if block['quality_score'] > unique_code[code_hash]['quality_score']:
+                if block["quality_score"] > unique_code[code_hash]["quality_score"]:
                     unique_code[code_hash] = block
 
         code_samples = list(unique_code.values())
@@ -784,44 +809,43 @@ class PDFExtractor:
         # Filter by minimum quality (NEW in B1.4)
         if self.min_quality > 0:
             code_samples_before = len(code_samples)
-            code_samples = [c for c in code_samples if c['quality_score'] >= self.min_quality]
+            code_samples = [c for c in code_samples if c["quality_score"] >= self.min_quality]
             filtered_count = code_samples_before - len(code_samples)
             if filtered_count > 0:
                 self.log(f"  Filtered out {filtered_count} low-quality code blocks (min_quality={self.min_quality})")
 
         # Sort by quality score (highest first)
-        code_samples.sort(key=lambda x: x['quality_score'], reverse=True)
+        code_samples.sort(key=lambda x: x["quality_score"], reverse=True)
 
         # Extract headings from markdown
         headings = []
-        for line in markdown.split('\n'):
-            if line.startswith('#'):
-                level = len(line) - len(line.lstrip('#'))
-                text = line.lstrip('#').strip()
+        for line in markdown.split("\n"):
+            if line.startswith("#"):
+                level = len(line) - len(line.lstrip("#"))
+                text = line.lstrip("#").strip()
                 if text:
-                    headings.append({
-                        'level': f'h{level}',
-                        'text': text
-                    })
+                    headings.append({"level": f"h{level}", "text": text})
 
         page_data = {
-            'page_number': page_num + 1,  # 1-indexed for humans
-            'text': text.strip(),
-            'markdown': markdown.strip(),
-            'headings': headings,
-            'code_samples': code_samples,
-            'images_count': len(images),
-            'extracted_images': extracted_images,  # NEW in B1.5
-            'tables': tables,  # NEW in Priority 2
-            'char_count': len(text),
-            'code_blocks_count': len(code_samples),
-            'tables_count': len(tables)  # NEW in Priority 2
+            "page_number": page_num + 1,  # 1-indexed for humans
+            "text": text.strip(),
+            "markdown": markdown.strip(),
+            "headings": headings,
+            "code_samples": code_samples,
+            "images_count": len(images),
+            "extracted_images": extracted_images,  # NEW in B1.5
+            "tables": tables,  # NEW in Priority 2
+            "char_count": len(text),
+            "code_blocks_count": len(code_samples),
+            "tables_count": len(tables),  # NEW in Priority 2
         }
 
         # Cache the result (Priority 3)
         self.set_cached(cache_key, page_data)
 
-        self.log(f"  Page {page_num + 1}: {len(text)} chars, {len(code_samples)} code blocks, {len(headings)} headings, {len(extracted_images)} images, {len(tables)} tables")
+        self.log(
+            f"  Page {page_num + 1}: {len(text)} chars, {len(code_samples)} code blocks, {len(headings)} headings, {len(extracted_images)} images, {len(tables)} tables"
+        )
 
         return page_data
 
@@ -841,15 +865,15 @@ class PDFExtractor:
             # Handle encrypted PDFs (Priority 2)
             if self.doc.is_encrypted:
                 if self.password:
-                    print(f"   🔐 PDF is encrypted, trying password...")
+                    print("   🔐 PDF is encrypted, trying password...")
                     if self.doc.authenticate(self.password):
-                        print(f"   ✅ Password accepted")
+                        print("   ✅ Password accepted")
                     else:
-                        print(f"   ❌ Invalid password")
+                        print("   ❌ Invalid password")
                         return None
                 else:
-                    print(f"   ❌ PDF is encrypted but no password provided")
-                    print(f"   Use --password option to provide password")
+                    print("   ❌ PDF is encrypted but no password provided")
+                    print("   Use --password option to provide password")
                     return None
 
         except Exception as e:
@@ -870,12 +894,12 @@ class PDFExtractor:
             status = "✅ enabled" if TESSERACT_AVAILABLE else "⚠️  not available (install pytesseract)"
             print(f"   OCR: {status}")
         if self.extract_tables:
-            print(f"   Table extraction: ✅ enabled")
+            print("   Table extraction: ✅ enabled")
         if self.parallel:
             status = "✅ enabled" if CONCURRENT_AVAILABLE else "⚠️  not available"
             print(f"   Parallel processing: {status} ({self.max_workers} workers)")
         if self.use_cache:
-            print(f"   Caching: ✅ enabled")
+            print("   Caching: ✅ enabled")
 
         print("")
 
@@ -900,73 +924,71 @@ class PDFExtractor:
         chunks = self.create_chunks(self.pages)
 
         # Build summary
-        total_chars = sum(p['char_count'] for p in self.pages)
-        total_code_blocks = sum(p['code_blocks_count'] for p in self.pages)
-        total_headings = sum(len(p['headings']) for p in self.pages)
-        total_images = sum(p['images_count'] for p in self.pages)
-        total_tables = sum(p['tables_count'] for p in self.pages)  # NEW in Priority 2
+        total_chars = sum(p["char_count"] for p in self.pages)
+        total_code_blocks = sum(p["code_blocks_count"] for p in self.pages)
+        total_headings = sum(len(p["headings"]) for p in self.pages)
+        total_images = sum(p["images_count"] for p in self.pages)
+        total_tables = sum(p["tables_count"] for p in self.pages)  # NEW in Priority 2
 
         # Detect languages used
         languages = {}
         all_code_blocks_list = []
         for page in self.pages:
-            for code in page['code_samples']:
-                lang = code['language']
+            for code in page["code_samples"]:
+                lang = code["language"]
                 languages[lang] = languages.get(lang, 0) + 1
                 all_code_blocks_list.append(code)
 
         # Calculate quality statistics (NEW in B1.4)
         quality_stats = {}
         if all_code_blocks_list:
-            quality_scores = [c['quality_score'] for c in all_code_blocks_list]
-            confidences = [c['confidence'] for c in all_code_blocks_list]
-            valid_count = sum(1 for c in all_code_blocks_list if c['is_valid'])
+            quality_scores = [c["quality_score"] for c in all_code_blocks_list]
+            confidences = [c["confidence"] for c in all_code_blocks_list]
+            valid_count = sum(1 for c in all_code_blocks_list if c["is_valid"])
 
             quality_stats = {
-                'average_quality': sum(quality_scores) / len(quality_scores),
-                'average_confidence': sum(confidences) / len(confidences),
-                'valid_code_blocks': valid_count,
-                'invalid_code_blocks': total_code_blocks - valid_count,
-                'validation_rate': valid_count / total_code_blocks if total_code_blocks > 0 else 0,
-                'high_quality_blocks': sum(1 for s in quality_scores if s >= 7.0),
-                'medium_quality_blocks': sum(1 for s in quality_scores if 4.0 <= s < 7.0),
-                'low_quality_blocks': sum(1 for s in quality_scores if s < 4.0),
+                "average_quality": sum(quality_scores) / len(quality_scores),
+                "average_confidence": sum(confidences) / len(confidences),
+                "valid_code_blocks": valid_count,
+                "invalid_code_blocks": total_code_blocks - valid_count,
+                "validation_rate": valid_count / total_code_blocks if total_code_blocks > 0 else 0,
+                "high_quality_blocks": sum(1 for s in quality_scores if s >= 7.0),
+                "medium_quality_blocks": sum(1 for s in quality_scores if 4.0 <= s < 7.0),
+                "low_quality_blocks": sum(1 for s in quality_scores if s < 4.0),
             }
 
         # Extract chapter information
         chapters = []
         for chunk in chunks:
-            if chunk['chapter_title']:
-                chapters.append({
-                    'title': chunk['chapter_title'],
-                    'start_page': chunk['start_page'],
-                    'end_page': chunk['end_page']
-                })
+            if chunk["chapter_title"]:
+                chapters.append(
+                    {"title": chunk["chapter_title"], "start_page": chunk["start_page"], "end_page": chunk["end_page"]}
+                )
 
         result = {
-            'source_file': self.pdf_path,
-            'metadata': self.doc.metadata,
-            'total_pages': len(self.doc),
-            'total_chars': total_chars,
-            'total_code_blocks': total_code_blocks,
-            'total_headings': total_headings,
-            'total_images': total_images,
-            'total_extracted_images': len(self.extracted_images),  # NEW in B1.5
-            'total_tables': total_tables,  # NEW in Priority 2
-            'image_directory': self.image_dir if self.extract_images else None,  # NEW in B1.5
-            'extracted_images': self.extracted_images,  # NEW in B1.5
-            'total_chunks': len(chunks),
-            'chapters': chapters,
-            'languages_detected': languages,
-            'quality_statistics': quality_stats,  # NEW in B1.4
-            'chunks': chunks,
-            'pages': self.pages  # Still include all pages for compatibility
+            "source_file": self.pdf_path,
+            "metadata": self.doc.metadata,
+            "total_pages": len(self.doc),
+            "total_chars": total_chars,
+            "total_code_blocks": total_code_blocks,
+            "total_headings": total_headings,
+            "total_images": total_images,
+            "total_extracted_images": len(self.extracted_images),  # NEW in B1.5
+            "total_tables": total_tables,  # NEW in Priority 2
+            "image_directory": self.image_dir if self.extract_images else None,  # NEW in B1.5
+            "extracted_images": self.extracted_images,  # NEW in B1.5
+            "total_chunks": len(chunks),
+            "chapters": chapters,
+            "languages_detected": languages,
+            "quality_statistics": quality_stats,  # NEW in B1.4
+            "chunks": chunks,
+            "pages": self.pages,  # Still include all pages for compatibility
         }
 
         # Close document
         self.doc.close()
 
-        print(f"\n✅ Extraction complete:")
+        print("\n✅ Extraction complete:")
         print(f"   Total characters: {total_chars:,}")
         print(f"   Code blocks found: {total_code_blocks}")
         print(f"   Headings found: {total_headings}")
@@ -983,10 +1005,12 @@ class PDFExtractor:
 
         # Print quality statistics (NEW in B1.4)
         if quality_stats:
-            print(f"\n📊 Code Quality Statistics:")
+            print("\n📊 Code Quality Statistics:")
             print(f"   Average quality: {quality_stats['average_quality']:.1f}/10")
             print(f"   Average confidence: {quality_stats['average_confidence']:.1%}")
-            print(f"   Valid code blocks: {quality_stats['valid_code_blocks']}/{total_code_blocks} ({quality_stats['validation_rate']:.1%})")
+            print(
+                f"   Valid code blocks: {quality_stats['valid_code_blocks']}/{total_code_blocks} ({quality_stats['validation_rate']:.1%})"
+            )
             print(f"   High quality (7+): {quality_stats['high_quality_blocks']}")
             print(f"   Medium quality (4-7): {quality_stats['medium_quality_blocks']}")
             print(f"   Low quality (<4): {quality_stats['low_quality_blocks']}")
@@ -996,7 +1020,7 @@ class PDFExtractor:
 
 def main():
     parser = argparse.ArgumentParser(
-        description='Extract text and code blocks from PDF documentation',
+        description="Extract text and code blocks from PDF documentation",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -1011,39 +1035,39 @@ Examples:
 
   # Extract and save
   python3 pdf_extractor_poc.py docs/python.pdf -o python_extracted.json -v
-        """
+        """,
     )
 
-    parser.add_argument('pdf_file', help='Path to PDF file to extract')
-    parser.add_argument('-o', '--output', help='Output JSON file path (default: print to stdout)')
-    parser.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
-    parser.add_argument('--pretty', action='store_true', help='Pretty-print JSON output')
-    parser.add_argument('--chunk-size', type=int, default=10,
-                        help='Pages per chunk (0 = no chunking, default: 10)')
-    parser.add_argument('--no-merge', action='store_true',
-                        help='Disable merging code blocks across pages')
-    parser.add_argument('--min-quality', type=float, default=0.0,
-                        help='Minimum code quality score (0-10, default: 0 = no filtering)')
-    parser.add_argument('--extract-images', action='store_true',
-                        help='Extract images to files (NEW in B1.5)')
-    parser.add_argument('--image-dir', type=str, default=None,
-                        help='Directory to save extracted images (default: output/{pdf_name}_images)')
-    parser.add_argument('--min-image-size', type=int, default=100,
-                        help='Minimum image dimension in pixels (filters icons, default: 100)')
+    parser.add_argument("pdf_file", help="Path to PDF file to extract")
+    parser.add_argument("-o", "--output", help="Output JSON file path (default: print to stdout)")
+    parser.add_argument("-v", "--verbose", action="store_true", help="Verbose output")
+    parser.add_argument("--pretty", action="store_true", help="Pretty-print JSON output")
+    parser.add_argument("--chunk-size", type=int, default=10, help="Pages per chunk (0 = no chunking, default: 10)")
+    parser.add_argument("--no-merge", action="store_true", help="Disable merging code blocks across pages")
+    parser.add_argument(
+        "--min-quality", type=float, default=0.0, help="Minimum code quality score (0-10, default: 0 = no filtering)"
+    )
+    parser.add_argument("--extract-images", action="store_true", help="Extract images to files (NEW in B1.5)")
+    parser.add_argument(
+        "--image-dir",
+        type=str,
+        default=None,
+        help="Directory to save extracted images (default: output/{pdf_name}_images)",
+    )
+    parser.add_argument(
+        "--min-image-size",
+        type=int,
+        default=100,
+        help="Minimum image dimension in pixels (filters icons, default: 100)",
+    )
 
     # Advanced features (Priority 2 & 3)
-    parser.add_argument('--ocr', action='store_true',
-                        help='Use OCR for scanned PDFs (requires pytesseract)')
-    parser.add_argument('--password', type=str, default=None,
-                        help='Password for encrypted PDF')
-    parser.add_argument('--extract-tables', action='store_true',
-                        help='Extract tables from PDF (Priority 2)')
-    parser.add_argument('--parallel', action='store_true',
-                        help='Process pages in parallel (Priority 3)')
-    parser.add_argument('--workers', type=int, default=None,
-                        help='Number of parallel workers (default: CPU count)')
-    parser.add_argument('--no-cache', action='store_true',
-                        help='Disable caching of expensive operations')
+    parser.add_argument("--ocr", action="store_true", help="Use OCR for scanned PDFs (requires pytesseract)")
+    parser.add_argument("--password", type=str, default=None, help="Password for encrypted PDF")
+    parser.add_argument("--extract-tables", action="store_true", help="Extract tables from PDF (Priority 2)")
+    parser.add_argument("--parallel", action="store_true", help="Process pages in parallel (Priority 3)")
+    parser.add_argument("--workers", type=int, default=None, help="Number of parallel workers (default: CPU count)")
+    parser.add_argument("--no-cache", action="store_true", help="Disable caching of expensive operations")
 
     args = parser.parse_args()
 
@@ -1052,8 +1076,8 @@ Examples:
         print(f"❌ Error: File not found: {args.pdf_file}")
         sys.exit(1)
 
-    if not args.pdf_file.lower().endswith('.pdf'):
-        print(f"⚠️  Warning: File does not have .pdf extension")
+    if not args.pdf_file.lower().endswith(".pdf"):
+        print("⚠️  Warning: File does not have .pdf extension")
 
     # Extract
     extractor = PDFExtractor(
@@ -1070,7 +1094,7 @@ Examples:
         extract_tables=args.extract_tables,
         parallel=args.parallel,
         max_workers=args.workers,
-        use_cache=not args.no_cache
+        use_cache=not args.no_cache,
     )
     result = extractor.extract_all()
 
@@ -1080,7 +1104,7 @@ Examples:
     # Output
     if args.output:
         # Save to file
-        with open(args.output, 'w', encoding='utf-8') as f:
+        with open(args.output, "w", encoding="utf-8") as f:
             if args.pretty:
                 json.dump(result, f, indent=2, ensure_ascii=False)
             else:
@@ -1094,5 +1118,5 @@ Examples:
             print(json.dumps(result, ensure_ascii=False))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
diff --git a/src/skill_seekers/cli/pdf_scraper.py b/src/skill_seekers/cli/pdf_scraper.py
index 3d82377..0ae5e99 100644
--- a/src/skill_seekers/cli/pdf_scraper.py
+++ b/src/skill_seekers/cli/pdf_scraper.py
@@ -11,18 +11,18 @@ Usage:
     python3 pdf_scraper.py --from-json manual_extracted.json
 """
 
-import os
-import sys
-import json
-import re
 import argparse
+import json
+import os
+import re
+import sys
 from pathlib import Path
 
 # Import the PDF extractor
 from .pdf_extractor_poc import PDFExtractor
 
 
-def infer_description_from_pdf(pdf_metadata: dict = None, name: str = '') -> str:
+def infer_description_from_pdf(pdf_metadata: dict = None, name: str = "") -> str:
     """
     Infer skill description from PDF metadata or document properties.
 
@@ -39,22 +39,22 @@ def infer_description_from_pdf(pdf_metadata: dict = None, name: str = '') -> str
     """
     if pdf_metadata:
         # Try to use subject field (often contains description)
-        if 'subject' in pdf_metadata and pdf_metadata['subject']:
-            desc = str(pdf_metadata['subject']).strip()
+        if "subject" in pdf_metadata and pdf_metadata["subject"]:
+            desc = str(pdf_metadata["subject"]).strip()
             if len(desc) > 20:
                 if len(desc) > 150:
-                    desc = desc[:147] + '...'
-                return f'Use when {desc.lower()}'
+                    desc = desc[:147] + "..."
+                return f"Use when {desc.lower()}"
 
         # Try title field if meaningful
-        if 'title' in pdf_metadata and pdf_metadata['title']:
-            title = str(pdf_metadata['title']).strip()
+        if "title" in pdf_metadata and pdf_metadata["title"]:
+            title = str(pdf_metadata["title"]).strip()
             # Skip if it's just the filename
-            if len(title) > 10 and not title.endswith('.pdf'):
-                return f'Use when working with {title.lower()}'
+            if len(title) > 10 and not title.endswith(".pdf"):
+                return f"Use when working with {title.lower()}"
 
     # Improved fallback
-    return f'Use when referencing {name} documentation' if name else 'Use when referencing this documentation'
+    return f"Use when referencing {name} documentation" if name else "Use when referencing this documentation"
 
 
 class PDFToSkillConverter:
@@ -62,20 +62,20 @@ class PDFToSkillConverter:
 
     def __init__(self, config):
         self.config = config
-        self.name = config['name']
-        self.pdf_path = config.get('pdf_path', '')
+        self.name = config["name"]
+        self.pdf_path = config.get("pdf_path", "")
         # Set initial description (will be improved after extraction if metadata available)
-        self.description = config.get('description', f'Use when referencing {self.name} documentation')
+        self.description = config.get("description", f"Use when referencing {self.name} documentation")
 
         # Paths
         self.skill_dir = f"output/{self.name}"
         self.data_file = f"output/{self.name}_extracted.json"
 
         # Extraction options
-        self.extract_options = config.get('extract_options', {})
+        self.extract_options = config.get("extract_options", {})
 
         # Categories
-        self.categories = config.get('categories', {})
+        self.categories = config.get("categories", {})
 
         # Extracted data
         self.extracted_data = None
@@ -88,11 +88,11 @@ class PDFToSkillConverter:
         extractor = PDFExtractor(
             self.pdf_path,
             verbose=True,
-            chunk_size=self.extract_options.get('chunk_size', 10),
-            min_quality=self.extract_options.get('min_quality', 5.0),
-            extract_images=self.extract_options.get('extract_images', True),
+            chunk_size=self.extract_options.get("chunk_size", 10),
+            min_quality=self.extract_options.get("min_quality", 5.0),
+            extract_images=self.extract_options.get("extract_images", True),
             image_dir=f"{self.skill_dir}/assets/images",
-            min_image_size=self.extract_options.get('min_image_size', 100)
+            min_image_size=self.extract_options.get("min_image_size", 100),
         )
 
         # Extract
@@ -103,7 +103,7 @@ class PDFToSkillConverter:
             raise RuntimeError(f"Failed to extract PDF: {self.pdf_path}")
 
         # Save extracted data
-        with open(self.data_file, 'w', encoding='utf-8') as f:
+        with open(self.data_file, "w", encoding="utf-8") as f:
             json.dump(result, f, indent=2, ensure_ascii=False)
 
         print(f"\n💾 Saved extracted data to: {self.data_file}")
@@ -114,7 +114,7 @@ class PDFToSkillConverter:
         """Load previously extracted data from JSON"""
         print(f"\n📂 Loading extracted data from: {json_path}")
 
-        with open(json_path, 'r', encoding='utf-8') as f:
+        with open(json_path, encoding="utf-8") as f:
             self.extracted_data = json.load(f)
 
         print(f"✅ Loaded {self.extracted_data['total_pages']} pages")
@@ -122,28 +122,25 @@ class PDFToSkillConverter:
 
     def categorize_content(self):
         """Categorize pages based on chapters or keywords"""
-        print(f"\n📋 Categorizing content...")
+        print("\n📋 Categorizing content...")
 
         categorized = {}
 
         # Use chapters if available
-        if self.extracted_data.get('chapters'):
-            for chapter in self.extracted_data['chapters']:
-                category_key = self._sanitize_filename(chapter['title'])
-                categorized[category_key] = {
-                    'title': chapter['title'],
-                    'pages': []
-                }
+        if self.extracted_data.get("chapters"):
+            for chapter in self.extracted_data["chapters"]:
+                category_key = self._sanitize_filename(chapter["title"])
+                categorized[category_key] = {"title": chapter["title"], "pages": []}
 
             # Assign pages to chapters
-            for page in self.extracted_data['pages']:
-                page_num = page['page_number']
+            for page in self.extracted_data["pages"]:
+                page_num = page["page_number"]
 
                 # Find which chapter this page belongs to
-                for chapter in self.extracted_data['chapters']:
-                    if chapter['start_page'] <= page_num <= chapter['end_page']:
-                        category_key = self._sanitize_filename(chapter['title'])
-                        categorized[category_key]['pages'].append(page)
+                for chapter in self.extracted_data["chapters"]:
+                    if chapter["start_page"] <= page_num <= chapter["end_page"]:
+                        category_key = self._sanitize_filename(chapter["title"])
+                        categorized[category_key]["pages"].append(page)
                         break
 
         # Fall back to keyword-based categorization
@@ -154,31 +151,28 @@ class PDFToSkillConverter:
             if isinstance(first_value, list) and first_value and isinstance(first_value[0], dict):
                 # Already categorized - convert to expected format
                 for cat_key, pages in self.categories.items():
-                    categorized[cat_key] = {
-                        'title': cat_key.replace('_', ' ').title(),
-                        'pages': pages
-                    }
+                    categorized[cat_key] = {"title": cat_key.replace("_", " ").title(), "pages": pages}
             else:
                 # Keyword-based categorization
                 # Initialize categories
                 for cat_key, keywords in self.categories.items():
-                    categorized[cat_key] = {
-                        'title': cat_key.replace('_', ' ').title(),
-                        'pages': []
-                    }
+                    categorized[cat_key] = {"title": cat_key.replace("_", " ").title(), "pages": []}
 
                 # Categorize by keywords
-                for page in self.extracted_data['pages']:
-                    text = page.get('text', '').lower()
-                    headings_text = ' '.join([h['text'] for h in page.get('headings', [])]).lower()
+                for page in self.extracted_data["pages"]:
+                    text = page.get("text", "").lower()
+                    headings_text = " ".join([h["text"] for h in page.get("headings", [])]).lower()
 
                     # Score against each category
                     scores = {}
                     for cat_key, keywords in self.categories.items():
                         # Handle both string keywords and dict keywords (shouldn't happen, but be safe)
                         if isinstance(keywords, list):
-                            score = sum(1 for kw in keywords
-                                      if isinstance(kw, str) and (kw.lower() in text or kw.lower() in headings_text))
+                            score = sum(
+                                1
+                                for kw in keywords
+                                if isinstance(kw, str) and (kw.lower() in text or kw.lower() in headings_text)
+                            )
                         else:
                             score = 0
                         if score > 0:
@@ -187,19 +181,16 @@ class PDFToSkillConverter:
                     # Assign to highest scoring category
                     if scores:
                         best_cat = max(scores, key=scores.get)
-                        categorized[best_cat]['pages'].append(page)
+                        categorized[best_cat]["pages"].append(page)
                     else:
                         # Default category
-                        if 'other' not in categorized:
-                            categorized['other'] = {'title': 'Other', 'pages': []}
-                        categorized['other']['pages'].append(page)
+                        if "other" not in categorized:
+                            categorized["other"] = {"title": "Other", "pages": []}
+                        categorized["other"]["pages"].append(page)
 
         else:
             # No categorization - use single category
-            categorized['content'] = {
-                'title': 'Content',
-                'pages': self.extracted_data['pages']
-            }
+            categorized["content"] = {"title": "Content", "pages": self.extracted_data["pages"]}
 
         print(f"✅ Created {len(categorized)} categories")
         for cat_key, cat_data in categorized.items():
@@ -220,7 +211,7 @@ class PDFToSkillConverter:
         categorized = self.categorize_content()
 
         # Generate reference files
-        print(f"\n📝 Generating reference files...")
+        print("\n📝 Generating reference files...")
         for cat_key, cat_data in categorized.items():
             self._generate_reference_file(cat_key, cat_data)
 
@@ -237,42 +228,42 @@ class PDFToSkillConverter:
         """Generate a reference markdown file for a category"""
         filename = f"{self.skill_dir}/references/{cat_key}.md"
 
-        with open(filename, 'w', encoding='utf-8') as f:
+        with open(filename, "w", encoding="utf-8") as f:
             f.write(f"# {cat_data['title']}\n\n")
 
-            for page in cat_data['pages']:
+            for page in cat_data["pages"]:
                 # Add headings as section markers
-                if page.get('headings'):
+                if page.get("headings"):
                     f.write(f"## {page['headings'][0]['text']}\n\n")
 
                 # Add text content
-                if page.get('text'):
+                if page.get("text"):
                     # Limit to first 1000 chars per page to avoid huge files
-                    text = page['text'][:1000]
+                    text = page["text"][:1000]
                     f.write(f"{text}\n\n")
 
                 # Add code samples (check both 'code_samples' and 'code_blocks' for compatibility)
-                code_list = page.get('code_samples') or page.get('code_blocks')
+                code_list = page.get("code_samples") or page.get("code_blocks")
                 if code_list:
                     f.write("### Code Examples\n\n")
                     for code in code_list[:3]:  # Limit to top 3
-                        lang = code.get('language', '')
+                        lang = code.get("language", "")
                         f.write(f"```{lang}\n{code['code']}\n```\n\n")
 
                 # Add images
-                if page.get('images'):
+                if page.get("images"):
                     # Create assets directory if needed
-                    assets_dir = os.path.join(self.skill_dir, 'assets')
+                    assets_dir = os.path.join(self.skill_dir, "assets")
                     os.makedirs(assets_dir, exist_ok=True)
 
                     f.write("### Images\n\n")
-                    for img in page['images']:
+                    for img in page["images"]:
                         # Save image to assets
                         img_filename = f"page_{page['page_number']}_img_{img['index']}.png"
                         img_path = os.path.join(assets_dir, img_filename)
 
-                        with open(img_path, 'wb') as img_file:
-                            img_file.write(img['data'])
+                        with open(img_path, "wb") as img_file:
+                            img_file.write(img["data"])
 
                         # Add markdown image reference
                         f.write(f"![Image {img['index']}](../assets/{img_filename})\n\n")
@@ -285,16 +276,16 @@ class PDFToSkillConverter:
         """Generate reference index"""
         filename = f"{self.skill_dir}/references/index.md"
 
-        with open(filename, 'w', encoding='utf-8') as f:
+        with open(filename, "w", encoding="utf-8") as f:
             f.write(f"# {self.name.title()} Documentation Reference\n\n")
             f.write("## Categories\n\n")
 
             for cat_key, cat_data in categorized.items():
-                page_count = len(cat_data['pages'])
+                page_count = len(cat_data["pages"])
                 f.write(f"- [{cat_data['title']}]({cat_key}.md) ({page_count} pages)\n")
 
             f.write("\n## Statistics\n\n")
-            stats = self.extracted_data.get('quality_statistics', {})
+            stats = self.extracted_data.get("quality_statistics", {})
             f.write(f"- Total pages: {self.extracted_data.get('total_pages', 0)}\n")
             f.write(f"- Code blocks: {self.extracted_data.get('total_code_blocks', 0)}\n")
             f.write(f"- Images: {self.extracted_data.get('total_images', 0)}\n")
@@ -309,37 +300,37 @@ class PDFToSkillConverter:
         filename = f"{self.skill_dir}/SKILL.md"
 
         # Generate skill name (lowercase, hyphens only, max 64 chars)
-        skill_name = self.name.lower().replace('_', '-').replace(' ', '-')[:64]
+        skill_name = self.name.lower().replace("_", "-").replace(" ", "-")[:64]
 
         # Truncate description to 1024 chars if needed
         desc = self.description[:1024] if len(self.description) > 1024 else self.description
 
-        with open(filename, 'w', encoding='utf-8') as f:
+        with open(filename, "w", encoding="utf-8") as f:
             # Write YAML frontmatter
-            f.write(f"---\n")
+            f.write("---\n")
             f.write(f"name: {skill_name}\n")
             f.write(f"description: {desc}\n")
-            f.write(f"---\n\n")
+            f.write("---\n\n")
 
             f.write(f"# {self.name.title()} Documentation Skill\n\n")
             f.write(f"{self.description}\n\n")
 
             # Enhanced "When to Use" section
             f.write("## 💡 When to Use This Skill\n\n")
-            f.write(f"Use this skill when you need to:\n")
+            f.write("Use this skill when you need to:\n")
             f.write(f"- Understand {self.name} concepts and fundamentals\n")
-            f.write(f"- Look up API references and technical specifications\n")
-            f.write(f"- Find code examples and implementation patterns\n")
-            f.write(f"- Review tutorials, guides, and best practices\n")
-            f.write(f"- Explore the complete documentation structure\n\n")
+            f.write("- Look up API references and technical specifications\n")
+            f.write("- Find code examples and implementation patterns\n")
+            f.write("- Review tutorials, guides, and best practices\n")
+            f.write("- Explore the complete documentation structure\n\n")
 
             # Chapter Overview (PDF structure)
             f.write("## 📖 Chapter Overview\n\n")
-            total_pages = self.extracted_data.get('total_pages', 0)
+            total_pages = self.extracted_data.get("total_pages", 0)
             f.write(f"**Total Pages:** {total_pages}\n\n")
             f.write("**Content Breakdown:**\n\n")
             for cat_key, cat_data in categorized.items():
-                page_count = len(cat_data['pages'])
+                page_count = len(cat_data["pages"])
                 f.write(f"- **{cat_data['title']}**: {page_count} pages\n")
             f.write("\n")
 
@@ -352,11 +343,11 @@ class PDFToSkillConverter:
 
             # Enhanced code examples section (top 15, grouped by language)
             all_code = []
-            for page in self.extracted_data['pages']:
-                all_code.extend(page.get('code_samples', []))
+            for page in self.extracted_data["pages"]:
+                all_code.extend(page.get("code_samples", []))
 
             # Sort by quality and get top 15
-            all_code.sort(key=lambda x: x.get('quality_score', 0), reverse=True)
+            all_code.sort(key=lambda x: x.get("quality_score", 0), reverse=True)
             top_code = all_code[:15]
 
             if top_code:
@@ -366,7 +357,7 @@ class PDFToSkillConverter:
                 # Group by language
                 by_lang = {}
                 for code in top_code:
-                    lang = code.get('language', 'unknown')
+                    lang = code.get("language", "unknown")
                     if lang not in by_lang:
                         by_lang[lang] = []
                     by_lang[lang].append(code)
@@ -377,8 +368,8 @@ class PDFToSkillConverter:
                     f.write(f"### {lang.title()} Examples ({len(examples)})\n\n")
 
                     for i, code in enumerate(examples[:5], 1):  # Top 5 per language
-                        quality = code.get('quality_score', 0)
-                        code_text = code.get('code', '')
+                        quality = code.get("quality_score", 0)
+                        code_text = code.get("code", "")
 
                         f.write(f"**Example {i}** (Quality: {quality:.1f}/10):\n\n")
                         f.write(f"```{lang}\n")
@@ -394,13 +385,13 @@ class PDFToSkillConverter:
             # Statistics
             f.write("## 📊 Documentation Statistics\n\n")
             f.write(f"- **Total Pages**: {total_pages}\n")
-            total_code_blocks = self.extracted_data.get('total_code_blocks', 0)
+            total_code_blocks = self.extracted_data.get("total_code_blocks", 0)
             f.write(f"- **Code Blocks**: {total_code_blocks}\n")
-            total_images = self.extracted_data.get('total_images', 0)
+            total_images = self.extracted_data.get("total_images", 0)
             f.write(f"- **Images/Diagrams**: {total_images}\n")
 
             # Language statistics
-            langs = self.extracted_data.get('languages_detected', {})
+            langs = self.extracted_data.get("languages_detected", {})
             if langs:
                 f.write(f"- **Programming Languages**: {len(langs)}\n\n")
                 f.write("**Language Breakdown:**\n\n")
@@ -409,11 +400,11 @@ class PDFToSkillConverter:
                 f.write("\n")
 
             # Quality metrics
-            quality_stats = self.extracted_data.get('quality_statistics', {})
+            quality_stats = self.extracted_data.get("quality_statistics", {})
             if quality_stats:
-                avg_quality = quality_stats.get('average_quality', 0)
-                valid_blocks = quality_stats.get('valid_code_blocks', 0)
-                f.write(f"**Code Quality:**\n\n")
+                avg_quality = quality_stats.get("average_quality", 0)
+                valid_blocks = quality_stats.get("valid_code_blocks", 0)
+                f.write("**Code Quality:**\n\n")
                 f.write(f"- Average Quality Score: {avg_quality:.1f}/10\n")
                 f.write(f"- Valid Code Blocks: {valid_blocks}\n\n")
 
@@ -421,7 +412,7 @@ class PDFToSkillConverter:
             f.write("## 🗺️ Navigation\n\n")
             f.write("**Reference Files:**\n\n")
             for cat_key, cat_data in categorized.items():
-                cat_file = self._sanitize_filename(cat_data['title'])
+                cat_file = self._sanitize_filename(cat_data["title"])
                 f.write(f"- `references/{cat_file}.md` - {cat_data['title']}\n")
             f.write("\n")
             f.write("See `references/index.md` for complete documentation structure.\n\n")
@@ -430,18 +421,18 @@ class PDFToSkillConverter:
             f.write("---\n\n")
             f.write("**Generated by Skill Seeker** | PDF Documentation Scraper\n")
 
-        line_count = len(open(filename, 'r', encoding='utf-8').read().split('\n'))
+        line_count = len(open(filename, encoding="utf-8").read().split("\n"))
         print(f"   Generated: {filename} ({line_count} lines)")
 
     def _format_key_concepts(self) -> str:
         """Extract key concepts from headings across all pages."""
         all_headings = []
 
-        for page in self.extracted_data.get('pages', []):
-            headings = page.get('headings', [])
+        for page in self.extracted_data.get("pages", []):
+            headings = page.get("headings", [])
             for heading in headings:
-                text = heading.get('text', '').strip()
-                level = heading.get('level', 'h1')
+                text = heading.get("text", "").strip()
+                level = heading.get("level", "h1")
                 if text and len(text) > 3:  # Skip very short headings
                     all_headings.append((level, text))
 
@@ -452,8 +443,8 @@ class PDFToSkillConverter:
         content += "*Main topics covered in this documentation*\n\n"
 
         # Group by level and show top concepts
-        h1_headings = [text for level, text in all_headings if level == 'h1']
-        h2_headings = [text for level, text in all_headings if level == 'h2']
+        h1_headings = [text for level, text in all_headings if level == "h1"]
+        h2_headings = [text for level, text in all_headings if level == "h2"]
 
         if h1_headings:
             content += "**Major Topics:**\n\n"
@@ -475,27 +466,31 @@ class PDFToSkillConverter:
         patterns = []
 
         # Simple pattern extraction from headings and emphasized text
-        for page in self.extracted_data.get('pages', []):
-            text = page.get('text', '')
-            headings = page.get('headings', [])
+        for page in self.extracted_data.get("pages", []):
+            text = page.get("text", "")
+            headings = page.get("headings", [])
 
             # Look for common pattern keywords in headings
             pattern_keywords = [
-                'getting started', 'installation', 'configuration',
-                'usage', 'api', 'examples', 'tutorial', 'guide',
-                'best practices', 'troubleshooting', 'faq'
+                "getting started",
+                "installation",
+                "configuration",
+                "usage",
+                "api",
+                "examples",
+                "tutorial",
+                "guide",
+                "best practices",
+                "troubleshooting",
+                "faq",
             ]
 
             for heading in headings:
-                heading_text = heading.get('text', '').lower()
+                heading_text = heading.get("text", "").lower()
                 for keyword in pattern_keywords:
                     if keyword in heading_text:
-                        page_num = page.get('page_number', 0)
-                        patterns.append({
-                            'type': keyword.title(),
-                            'heading': heading.get('text', ''),
-                            'page': page_num
-                        })
+                        page_num = page.get("page_number", 0)
+                        patterns.append({"type": keyword.title(), "heading": heading.get("text", ""), "page": page_num})
                         break  # Only add once per heading
 
         if not patterns:
@@ -506,7 +501,7 @@ class PDFToSkillConverter:
         # Group by type
         by_type = {}
         for pattern in patterns:
-            ptype = pattern['type']
+            ptype = pattern["type"]
             if ptype not in by_type:
                 by_type[ptype] = []
             by_type[ptype].append(pattern)
@@ -524,22 +519,21 @@ class PDFToSkillConverter:
     def _sanitize_filename(self, name):
         """Convert string to safe filename"""
         # Remove special chars, replace spaces with underscores
-        safe = re.sub(r'[^\w\s-]', '', name.lower())
-        safe = re.sub(r'[-\s]+', '_', safe)
+        safe = re.sub(r"[^\w\s-]", "", name.lower())
+        safe = re.sub(r"[-\s]+", "_", safe)
         return safe
 
 
 def main():
     parser = argparse.ArgumentParser(
-        description='Convert PDF documentation to Claude skill',
-        formatter_class=argparse.RawDescriptionHelpFormatter
+        description="Convert PDF documentation to Claude skill", formatter_class=argparse.RawDescriptionHelpFormatter
     )
 
-    parser.add_argument('--config', help='PDF config JSON file')
-    parser.add_argument('--pdf', help='Direct PDF file path')
-    parser.add_argument('--name', help='Skill name (with --pdf)')
-    parser.add_argument('--from-json', help='Build skill from extracted JSON')
-    parser.add_argument('--description', help='Skill description')
+    parser.add_argument("--config", help="PDF config JSON file")
+    parser.add_argument("--pdf", help="Direct PDF file path")
+    parser.add_argument("--name", help="Skill name (with --pdf)")
+    parser.add_argument("--from-json", help="Build skill from extracted JSON")
+    parser.add_argument("--description", help="Skill description")
 
     args = parser.parse_args()
 
@@ -549,15 +543,12 @@ def main():
 
     # Load or create config
     if args.config:
-        with open(args.config, 'r') as f:
+        with open(args.config) as f:
             config = json.load(f)
     elif args.from_json:
         # Build from extracted JSON
-        name = Path(args.from_json).stem.replace('_extracted', '')
-        config = {
-            'name': name,
-            'description': args.description or f'Use when referencing {name} documentation'
-        }
+        name = Path(args.from_json).stem.replace("_extracted", "")
+        config = {"name": name, "description": args.description or f"Use when referencing {name} documentation"}
         converter = PDFToSkillConverter(config)
         converter.load_extracted_data(args.from_json)
         converter.build_skill()
@@ -567,22 +558,17 @@ def main():
         if not args.name:
             parser.error("Must specify --name with --pdf")
         config = {
-            'name': args.name,
-            'pdf_path': args.pdf,
-            'description': args.description or f'Use when referencing {args.name} documentation',
-            'extract_options': {
-                'chunk_size': 10,
-                'min_quality': 5.0,
-                'extract_images': True,
-                'min_image_size': 100
-            }
+            "name": args.name,
+            "pdf_path": args.pdf,
+            "description": args.description or f"Use when referencing {args.name} documentation",
+            "extract_options": {"chunk_size": 10, "min_quality": 5.0, "extract_images": True, "min_image_size": 100},
         }
 
     # Create converter
     converter = PDFToSkillConverter(config)
 
     # Extract if needed
-    if config.get('pdf_path'):
+    if config.get("pdf_path"):
         if not converter.extract_pdf():
             sys.exit(1)
 
@@ -590,5 +576,5 @@ def main():
     converter.build_skill()
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
diff --git a/src/skill_seekers/cli/quality_checker.py b/src/skill_seekers/cli/quality_checker.py
index 96dc779..4987d4d 100644
--- a/src/skill_seekers/cli/quality_checker.py
+++ b/src/skill_seekers/cli/quality_checker.py
@@ -8,44 +8,44 @@ Usage:
     python3 quality_checker.py output/godot/ --verbose
 """
 
-import os
 import re
 import sys
-from pathlib import Path
-from typing import Dict, List, Tuple, Optional
 from dataclasses import dataclass, field
+from pathlib import Path
 
 
 @dataclass
 class QualityIssue:
     """Represents a quality issue found during validation."""
+
     level: str  # 'error', 'warning', 'info'
     category: str  # 'enhancement', 'content', 'links', 'structure'
     message: str
-    file: Optional[str] = None
-    line: Optional[int] = None
+    file: str | None = None
+    line: int | None = None
 
 
 @dataclass
 class QualityReport:
     """Complete quality report for a skill."""
+
     skill_name: str
     skill_path: Path
-    errors: List[QualityIssue] = field(default_factory=list)
-    warnings: List[QualityIssue] = field(default_factory=list)
-    info: List[QualityIssue] = field(default_factory=list)
+    errors: list[QualityIssue] = field(default_factory=list)
+    warnings: list[QualityIssue] = field(default_factory=list)
+    info: list[QualityIssue] = field(default_factory=list)
 
     def add_error(self, category: str, message: str, file: str = None, line: int = None):
         """Add an error to the report."""
-        self.errors.append(QualityIssue('error', category, message, file, line))
+        self.errors.append(QualityIssue("error", category, message, file, line))
 
     def add_warning(self, category: str, message: str, file: str = None, line: int = None):
         """Add a warning to the report."""
-        self.warnings.append(QualityIssue('warning', category, message, file, line))
+        self.warnings.append(QualityIssue("warning", category, message, file, line))
 
     def add_info(self, category: str, message: str, file: str = None, line: int = None):
         """Add info to the report."""
-        self.info.append(QualityIssue('info', category, message, file, line))
+        self.info.append(QualityIssue("info", category, message, file, line))
 
     @property
     def has_errors(self) -> bool:
@@ -80,15 +80,15 @@ class QualityReport:
         """Get quality grade (A-F)."""
         score = self.quality_score
         if score >= 90:
-            return 'A'
+            return "A"
         elif score >= 80:
-            return 'B'
+            return "B"
         elif score >= 70:
-            return 'C'
+            return "C"
         elif score >= 60:
-            return 'D'
+            return "D"
         else:
-            return 'F'
+            return "F"
 
 
 class SkillQualityChecker:
@@ -103,10 +103,7 @@ class SkillQualityChecker:
         self.skill_dir = Path(skill_dir)
         self.skill_md_path = self.skill_dir / "SKILL.md"
         self.references_dir = self.skill_dir / "references"
-        self.report = QualityReport(
-            skill_name=self.skill_dir.name,
-            skill_path=self.skill_dir
-        )
+        self.report = QualityReport(skill_name=self.skill_dir.name, skill_path=self.skill_dir)
 
     def check_all(self) -> QualityReport:
         """Run all quality checks and return report.
@@ -135,25 +132,19 @@ class SkillQualityChecker:
         """Check basic skill structure."""
         # Check SKILL.md exists
         if not self.skill_md_path.exists():
-            self.report.add_error(
-                'structure',
-                'SKILL.md file not found',
-                str(self.skill_md_path)
-            )
+            self.report.add_error("structure", "SKILL.md file not found", str(self.skill_md_path))
             return
 
         # Check references directory exists
         if not self.references_dir.exists():
             self.report.add_warning(
-                'structure',
-                'references/ directory not found - skill may be incomplete',
-                str(self.references_dir)
+                "structure", "references/ directory not found - skill may be incomplete", str(self.references_dir)
             )
-        elif not list(self.references_dir.rglob('*.md')):
+        elif not list(self.references_dir.rglob("*.md")):
             self.report.add_warning(
-                'structure',
-                'references/ directory is empty - no reference documentation found',
-                str(self.references_dir)
+                "structure",
+                "references/ directory is empty - no reference documentation found",
+                str(self.references_dir),
             )
 
     def _check_enhancement_quality(self):
@@ -161,7 +152,7 @@ class SkillQualityChecker:
         if not self.skill_md_path.exists():
             return
 
-        content = self.skill_md_path.read_text(encoding='utf-8')
+        content = self.skill_md_path.read_text(encoding="utf-8")
 
         # Check for template indicators (signs it wasn't enhanced)
         template_indicators = [
@@ -174,140 +165,90 @@ class SkillQualityChecker:
         for indicator in template_indicators:
             if indicator.lower() in content.lower():
                 self.report.add_warning(
-                    'enhancement',
+                    "enhancement",
                     f'Found template placeholder: "{indicator}" - SKILL.md may not be enhanced',
-                    'SKILL.md'
+                    "SKILL.md",
                 )
 
         # Check for good signs of enhancement
         enhancement_indicators = {
-            'code_examples': re.compile(r'```[\w-]+\n', re.MULTILINE),
-            'real_examples': re.compile(r'Example:', re.IGNORECASE),
-            'sections': re.compile(r'^## .+', re.MULTILINE),
+            "code_examples": re.compile(r"```[\w-]+\n", re.MULTILINE),
+            "real_examples": re.compile(r"Example:", re.IGNORECASE),
+            "sections": re.compile(r"^## .+", re.MULTILINE),
         }
 
-        code_blocks = len(enhancement_indicators['code_examples'].findall(content))
-        real_examples = len(enhancement_indicators['real_examples'].findall(content))
-        sections = len(enhancement_indicators['sections'].findall(content))
+        code_blocks = len(enhancement_indicators["code_examples"].findall(content))
+        real_examples = len(enhancement_indicators["real_examples"].findall(content))
+        sections = len(enhancement_indicators["sections"].findall(content))
 
         # Quality thresholds
         if code_blocks == 0:
             self.report.add_warning(
-                'enhancement',
-                'No code examples found in SKILL.md - consider enhancing',
-                'SKILL.md'
+                "enhancement", "No code examples found in SKILL.md - consider enhancing", "SKILL.md"
             )
         elif code_blocks < 3:
             self.report.add_info(
-                'enhancement',
-                f'Only {code_blocks} code examples found - more examples would improve quality',
-                'SKILL.md'
+                "enhancement",
+                f"Only {code_blocks} code examples found - more examples would improve quality",
+                "SKILL.md",
             )
         else:
-            self.report.add_info(
-                'enhancement',
-                f'✓ Found {code_blocks} code examples',
-                'SKILL.md'
-            )
+            self.report.add_info("enhancement", f"✓ Found {code_blocks} code examples", "SKILL.md")
 
         if sections < 4:
             self.report.add_warning(
-                'enhancement',
-                f'Only {sections} sections found - SKILL.md may be too basic',
-                'SKILL.md'
+                "enhancement", f"Only {sections} sections found - SKILL.md may be too basic", "SKILL.md"
             )
         else:
-            self.report.add_info(
-                'enhancement',
-                f'✓ Found {sections} sections',
-                'SKILL.md'
-            )
+            self.report.add_info("enhancement", f"✓ Found {sections} sections", "SKILL.md")
 
     def _check_content_quality(self):
         """Check content quality."""
         if not self.skill_md_path.exists():
             return
 
-        content = self.skill_md_path.read_text(encoding='utf-8')
+        content = self.skill_md_path.read_text(encoding="utf-8")
 
         # Check YAML frontmatter
-        if not content.startswith('---'):
-            self.report.add_error(
-                'content',
-                'Missing YAML frontmatter - SKILL.md must start with ---',
-                'SKILL.md',
-                1
-            )
+        if not content.startswith("---"):
+            self.report.add_error("content", "Missing YAML frontmatter - SKILL.md must start with ---", "SKILL.md", 1)
         else:
             # Extract frontmatter
             try:
-                frontmatter_match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+                frontmatter_match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
                 if frontmatter_match:
                     frontmatter = frontmatter_match.group(1)
 
                     # Check for required fields
-                    if 'name:' not in frontmatter:
-                        self.report.add_error(
-                            'content',
-                            'Missing "name:" field in YAML frontmatter',
-                            'SKILL.md',
-                            2
-                        )
+                    if "name:" not in frontmatter:
+                        self.report.add_error("content", 'Missing "name:" field in YAML frontmatter', "SKILL.md", 2)
 
                     # Check for description
-                    if 'description:' in frontmatter:
-                        self.report.add_info(
-                            'content',
-                            '✓ YAML frontmatter includes description',
-                            'SKILL.md'
-                        )
+                    if "description:" in frontmatter:
+                        self.report.add_info("content", "✓ YAML frontmatter includes description", "SKILL.md")
                 else:
-                    self.report.add_error(
-                        'content',
-                        'Invalid YAML frontmatter format',
-                        'SKILL.md',
-                        1
-                    )
+                    self.report.add_error("content", "Invalid YAML frontmatter format", "SKILL.md", 1)
             except Exception as e:
-                self.report.add_error(
-                    'content',
-                    f'Error parsing YAML frontmatter: {e}',
-                    'SKILL.md',
-                    1
-                )
+                self.report.add_error("content", f"Error parsing YAML frontmatter: {e}", "SKILL.md", 1)
 
         # Check code block language tags
-        code_blocks_without_lang = re.findall(r'```\n[^`]', content)
+        code_blocks_without_lang = re.findall(r"```\n[^`]", content)
         if code_blocks_without_lang:
             self.report.add_warning(
-                'content',
-                f'Found {len(code_blocks_without_lang)} code blocks without language tags',
-                'SKILL.md'
+                "content", f"Found {len(code_blocks_without_lang)} code blocks without language tags", "SKILL.md"
             )
 
         # Check for "When to Use" section
-        if 'when to use' not in content.lower():
-            self.report.add_warning(
-                'content',
-                'Missing "When to Use This Skill" section',
-                'SKILL.md'
-            )
+        if "when to use" not in content.lower():
+            self.report.add_warning("content", 'Missing "When to Use This Skill" section', "SKILL.md")
         else:
-            self.report.add_info(
-                'content',
-                '✓ Found "When to Use" section',
-                'SKILL.md'
-            )
+            self.report.add_info("content", '✓ Found "When to Use" section', "SKILL.md")
 
         # Check reference files
         if self.references_dir.exists():
-            ref_files = list(self.references_dir.rglob('*.md'))
+            ref_files = list(self.references_dir.rglob("*.md"))
             if ref_files:
-                self.report.add_info(
-                    'content',
-                    f'✓ Found {len(ref_files)} reference files',
-                    'references/'
-                )
+                self.report.add_info("content", f"✓ Found {len(ref_files)} reference files", "references/")
 
                 # Check if references are mentioned in SKILL.md
                 mentioned_refs = 0
@@ -317,9 +258,7 @@ class SkillQualityChecker:
 
                 if mentioned_refs == 0:
                     self.report.add_warning(
-                        'content',
-                        'Reference files exist but none are mentioned in SKILL.md',
-                        'SKILL.md'
+                        "content", "Reference files exist but none are mentioned in SKILL.md", "SKILL.md"
                     )
 
     def _check_links(self):
@@ -327,21 +266,21 @@ class SkillQualityChecker:
         if not self.skill_md_path.exists():
             return
 
-        content = self.skill_md_path.read_text(encoding='utf-8')
+        content = self.skill_md_path.read_text(encoding="utf-8")
 
         # Find all markdown links [text](path)
-        link_pattern = re.compile(r'\[([^\]]+)\]\(([^)]+)\)')
+        link_pattern = re.compile(r"\[([^\]]+)\]\(([^)]+)\)")
         links = link_pattern.findall(content)
 
         broken_links = []
 
         for text, link in links:
             # Skip external links (http/https)
-            if link.startswith('http://') or link.startswith('https://'):
+            if link.startswith("http://") or link.startswith("https://"):
                 continue
 
             # Skip anchor links
-            if link.startswith('#'):
+            if link.startswith("#"):
                 continue
 
             # Check if file exists (relative to SKILL.md)
@@ -351,20 +290,12 @@ class SkillQualityChecker:
 
         if broken_links:
             for text, link in broken_links:
-                self.report.add_warning(
-                    'links',
-                    f'Broken link: [{text}]({link})',
-                    'SKILL.md'
-                )
+                self.report.add_warning("links", f"Broken link: [{text}]({link})", "SKILL.md")
         else:
             if links:
-                internal_links = [l for t, l in links if not l.startswith('http')]
+                internal_links = [l for t, l in links if not l.startswith("http")]
                 if internal_links:
-                    self.report.add_info(
-                        'links',
-                        f'✓ All {len(internal_links)} internal links are valid',
-                        'SKILL.md'
-                    )
+                    self.report.add_info("links", f"✓ All {len(internal_links)} internal links are valid", "SKILL.md")
 
     def _check_skill_completeness(self):
         """Check skill completeness based on best practices.
@@ -375,83 +306,61 @@ class SkillQualityChecker:
         if not self.skill_md_path.exists():
             return
 
-        content = self.skill_md_path.read_text(encoding='utf-8')
+        content = self.skill_md_path.read_text(encoding="utf-8")
 
         # Check for grounding/verification section (prerequisites)
         grounding_patterns = [
-            r'before\s+(executing|running|proceeding|you\s+start)',
-            r'verify\s+that',
-            r'prerequisites?',
-            r'requirements?:',
-            r'make\s+sure\s+you\s+have',
+            r"before\s+(executing|running|proceeding|you\s+start)",
+            r"verify\s+that",
+            r"prerequisites?",
+            r"requirements?:",
+            r"make\s+sure\s+you\s+have",
         ]
-        has_grounding = any(
-            re.search(pattern, content, re.IGNORECASE)
-            for pattern in grounding_patterns
-        )
+        has_grounding = any(re.search(pattern, content, re.IGNORECASE) for pattern in grounding_patterns)
         if has_grounding:
-            self.report.add_info(
-                'completeness',
-                '✓ Found verification/prerequisites section',
-                'SKILL.md'
-            )
+            self.report.add_info("completeness", "✓ Found verification/prerequisites section", "SKILL.md")
         else:
             self.report.add_info(
-                'completeness',
-                'Consider adding prerequisites section - helps Claude verify conditions first',
-                'SKILL.md'
+                "completeness",
+                "Consider adding prerequisites section - helps Claude verify conditions first",
+                "SKILL.md",
             )
 
         # Check for error handling/troubleshooting guidance
         error_patterns = [
-            r'if\s+.*\s+(fails?|errors?)',
-            r'troubleshoot',
-            r'common\s+(issues?|problems?)',
-            r'error\s+handling',
-            r'when\s+things\s+go\s+wrong',
+            r"if\s+.*\s+(fails?|errors?)",
+            r"troubleshoot",
+            r"common\s+(issues?|problems?)",
+            r"error\s+handling",
+            r"when\s+things\s+go\s+wrong",
         ]
-        has_error_handling = any(
-            re.search(pattern, content, re.IGNORECASE)
-            for pattern in error_patterns
-        )
+        has_error_handling = any(re.search(pattern, content, re.IGNORECASE) for pattern in error_patterns)
         if has_error_handling:
-            self.report.add_info(
-                'completeness',
-                '✓ Found error handling/troubleshooting guidance',
-                'SKILL.md'
-            )
+            self.report.add_info("completeness", "✓ Found error handling/troubleshooting guidance", "SKILL.md")
         else:
             self.report.add_info(
-                'completeness',
-                'Consider adding troubleshooting section for common issues',
-                'SKILL.md'
+                "completeness", "Consider adding troubleshooting section for common issues", "SKILL.md"
             )
 
         # Check for workflow steps (numbered or sequential indicators)
         step_patterns = [
-            r'step\s+\d',
-            r'##\s+\d\.',
-            r'first,?\s+',
-            r'then,?\s+',
-            r'finally,?\s+',
-            r'next,?\s+',
+            r"step\s+\d",
+            r"##\s+\d\.",
+            r"first,?\s+",
+            r"then,?\s+",
+            r"finally,?\s+",
+            r"next,?\s+",
         ]
-        steps_found = sum(
-            1 for pattern in step_patterns
-            if re.search(pattern, content, re.IGNORECASE)
-        )
+        steps_found = sum(1 for pattern in step_patterns if re.search(pattern, content, re.IGNORECASE))
         if steps_found >= 3:
             self.report.add_info(
-                'completeness',
-                f'✓ Found clear workflow indicators ({steps_found} step markers)',
-                'SKILL.md'
+                "completeness", f"✓ Found clear workflow indicators ({steps_found} step markers)", "SKILL.md"
             )
         elif steps_found > 0:
             self.report.add_info(
-                'completeness',
-                f'Some workflow guidance found ({steps_found} markers) - '
-                'consider adding numbered steps for clarity',
-                'SKILL.md'
+                "completeness",
+                f"Some workflow guidance found ({steps_found} markers) - consider adding numbered steps for clarity",
+                "SKILL.md",
             )
 
 
@@ -475,7 +384,13 @@ def print_report(report: QualityReport, verbose: bool = False):
     if report.errors:
         print(f"❌ ERRORS ({len(report.errors)}):")
         for issue in report.errors:
-            location = f" ({issue.file}:{issue.line})" if issue.file and issue.line else f" ({issue.file})" if issue.file else ""
+            location = (
+                f" ({issue.file}:{issue.line})"
+                if issue.file and issue.line
+                else f" ({issue.file})"
+                if issue.file
+                else ""
+            )
             print(f"   [{issue.category}] {issue.message}{location}")
         print()
 
@@ -483,7 +398,13 @@ def print_report(report: QualityReport, verbose: bool = False):
     if report.warnings:
         print(f"⚠️  WARNINGS ({len(report.warnings)}):")
         for issue in report.warnings:
-            location = f" ({issue.file}:{issue.line})" if issue.file and issue.line else f" ({issue.file})" if issue.file else ""
+            location = (
+                f" ({issue.file}:{issue.line})"
+                if issue.file and issue.line
+                else f" ({issue.file})"
+                if issue.file
+                else ""
+            )
             print(f"   [{issue.category}] {issue.message}{location}")
         print()
 
@@ -523,25 +444,14 @@ Examples:
 
   # Exit with error code if issues found
   python3 quality_checker.py output/django/ --strict
-"""
+""",
     )
 
-    parser.add_argument(
-        'skill_directory',
-        help='Path to skill directory (e.g., output/react/)'
-    )
+    parser.add_argument("skill_directory", help="Path to skill directory (e.g., output/react/)")
 
-    parser.add_argument(
-        '--verbose', '-v',
-        action='store_true',
-        help='Show all info messages'
-    )
+    parser.add_argument("--verbose", "-v", action="store_true", help="Show all info messages")
 
-    parser.add_argument(
-        '--strict',
-        action='store_true',
-        help='Exit with error code if any warnings or errors found'
-    )
+    parser.add_argument("--strict", action="store_true", help="Exit with error code if any warnings or errors found")
 
     args = parser.parse_args()
 
@@ -559,9 +469,7 @@ Examples:
     print_report(report, verbose=args.verbose)
 
     # Exit code
-    if args.strict and (report.has_errors or report.has_warnings):
-        sys.exit(1)
-    elif report.has_errors:
+    if args.strict and (report.has_errors or report.has_warnings) or report.has_errors:
         sys.exit(1)
     else:
         sys.exit(0)
diff --git a/src/skill_seekers/cli/rate_limit_handler.py b/src/skill_seekers/cli/rate_limit_handler.py
index c1450c5..c4f7012 100644
--- a/src/skill_seekers/cli/rate_limit_handler.py
+++ b/src/skill_seekers/cli/rate_limit_handler.py
@@ -9,16 +9,19 @@ Handles GitHub API rate limits with smart strategies:
 - Non-interactive mode for CI/CD
 """
 
-import time
 import sys
-from datetime import datetime, timedelta
-from typing import Optional, Dict, Any
+import time
+from datetime import datetime
+from typing import Any
+
 import requests
+
 from .config_manager import get_config_manager
 
 
 class RateLimitError(Exception):
     """Raised when rate limit is exceeded and cannot be handled."""
+
     pass
 
 
@@ -43,10 +46,10 @@ class RateLimitHandler:
 
     def __init__(
         self,
-        token: Optional[str] = None,
+        token: str | None = None,
         interactive: bool = True,
-        profile_name: Optional[str] = None,
-        auto_switch: bool = True
+        profile_name: str | None = None,
+        auto_switch: bool = True,
     ):
         """
         Initialize rate limit handler.
@@ -91,7 +94,7 @@ class RateLimitHandler:
 
             if self.interactive:
                 response = input("Continue without token? [Y/n]: ").strip().lower()
-                if response in ['n', 'no']:
+                if response in ["n", "no"]:
                     print("\n✅ Run 'skill-seekers config --github' to set up a token.\n")
                     return False
 
@@ -100,12 +103,12 @@ class RateLimitHandler:
         # Check current rate limit status
         try:
             rate_info = self.get_rate_limit_info()
-            remaining = rate_info.get('remaining', 0)
-            limit = rate_info.get('limit', 5000)
+            remaining = rate_info.get("remaining", 0)
+            limit = rate_info.get("limit", 5000)
 
             if remaining == 0:
                 print(f"\n⚠️  Warning: GitHub rate limit already exhausted (0/{limit})")
-                reset_time = rate_info.get('reset_time')
+                reset_time = rate_info.get("reset_time")
                 if reset_time:
                     wait_minutes = (reset_time - datetime.now()).total_seconds() / 60
                     print(f"   Resets in {int(wait_minutes)} minutes")
@@ -146,9 +149,9 @@ class RateLimitHandler:
         if response.status_code == 403:
             try:
                 error_data = response.json()
-                message = error_data.get('message', '')
+                message = error_data.get("message", "")
 
-                if 'rate limit' in message.lower() or 'api rate limit exceeded' in message.lower():
+                if "rate limit" in message.lower() or "api rate limit exceeded" in message.lower():
                     # Extract rate limit info from headers
                     rate_info = self.extract_rate_limit_info(response)
                     return self.handle_rate_limit(rate_info)
@@ -158,7 +161,7 @@ class RateLimitHandler:
 
         return True
 
-    def extract_rate_limit_info(self, response: requests.Response) -> Dict[str, Any]:
+    def extract_rate_limit_info(self, response: requests.Response) -> dict[str, Any]:
         """
         Extract rate limit information from response headers.
 
@@ -170,20 +173,15 @@ class RateLimitHandler:
         """
         headers = response.headers
 
-        limit = int(headers.get('X-RateLimit-Limit', 0))
-        remaining = int(headers.get('X-RateLimit-Remaining', 0))
-        reset_timestamp = int(headers.get('X-RateLimit-Reset', 0))
+        limit = int(headers.get("X-RateLimit-Limit", 0))
+        remaining = int(headers.get("X-RateLimit-Remaining", 0))
+        reset_timestamp = int(headers.get("X-RateLimit-Reset", 0))
 
         reset_time = datetime.fromtimestamp(reset_timestamp) if reset_timestamp else None
 
-        return {
-            'limit': limit,
-            'remaining': remaining,
-            'reset_timestamp': reset_timestamp,
-            'reset_time': reset_time
-        }
+        return {"limit": limit, "remaining": remaining, "reset_timestamp": reset_timestamp, "reset_time": reset_time}
 
-    def get_rate_limit_info(self) -> Dict[str, Any]:
+    def get_rate_limit_info(self) -> dict[str, Any]:
         """
         Get current rate limit status from GitHub API.
 
@@ -193,25 +191,25 @@ class RateLimitHandler:
         url = "https://api.github.com/rate_limit"
         headers = {}
         if self.token:
-            headers['Authorization'] = f'token {self.token}'
+            headers["Authorization"] = f"token {self.token}"
 
         response = requests.get(url, headers=headers, timeout=5)
         response.raise_for_status()
 
         data = response.json()
-        core = data.get('rate', {})
+        core = data.get("rate", {})
 
-        reset_timestamp = core.get('reset', 0)
+        reset_timestamp = core.get("reset", 0)
         reset_time = datetime.fromtimestamp(reset_timestamp) if reset_timestamp else None
 
         return {
-            'limit': core.get('limit', 0),
-            'remaining': core.get('remaining', 0),
-            'reset_timestamp': reset_timestamp,
-            'reset_time': reset_time
+            "limit": core.get("limit", 0),
+            "remaining": core.get("remaining", 0),
+            "reset_timestamp": reset_timestamp,
+            "reset_time": reset_time,
         }
 
-    def handle_rate_limit(self, rate_info: Dict[str, Any]) -> bool:
+    def handle_rate_limit(self, rate_info: dict[str, Any]) -> bool:
         """
         Handle rate limit based on strategy.
 
@@ -224,11 +222,11 @@ class RateLimitHandler:
         Raises:
             RateLimitError: If cannot handle in non-interactive mode
         """
-        reset_time = rate_info.get('reset_time')
-        remaining = rate_info.get('remaining', 0)
-        limit = rate_info.get('limit', 0)
+        reset_time = rate_info.get("reset_time")
+        remaining = rate_info.get("remaining", 0)
+        limit = rate_info.get("limit", 0)
 
-        print(f"\n⚠️  GitHub Rate Limit Reached")
+        print("\n⚠️  GitHub Rate Limit Reached")
         print(f"   Profile: {self.profile_name or 'default'}")
         print(f"   Limit: {remaining}/{limit} requests")
 
@@ -294,8 +292,8 @@ class RateLimitHandler:
             self.token = next_token
 
             rate_info = self.get_rate_limit_info()
-            remaining = rate_info.get('remaining', 0)
-            limit = rate_info.get('limit', 0)
+            remaining = rate_info.get("remaining", 0)
+            limit = rate_info.get("limit", 0)
 
             if remaining > 0:
                 print(f"✅ Profile '{next_name}' has {remaining}/{limit} requests available")
@@ -394,24 +392,24 @@ class RateLimitHandler:
         while True:
             choice = input("Select an option [w/s/t/c]: ").strip().lower()
 
-            if choice == 'w':
+            if choice == "w":
                 return self.wait_for_reset(wait_seconds, wait_minutes)
 
-            elif choice == 's':
+            elif choice == "s":
                 if self.try_switch_profile():
                     return True
                 else:
                     print("⚠️  Profile switching failed. Choose another option.")
                     continue
 
-            elif choice == 't':
+            elif choice == "t":
                 print("\n💡 Opening GitHub token setup...")
                 print("   Run this command in another terminal:")
                 print("   $ skill-seekers config --github\n")
                 print("   Then restart your scraping job.\n")
                 return False
 
-            elif choice == 'c':
+            elif choice == "c":
                 print("\n⏸️  Operation cancelled by user\n")
                 return False
 
@@ -419,7 +417,7 @@ class RateLimitHandler:
                 print("❌ Invalid choice. Please enter w, s, t, or c.")
 
 
-def create_github_headers(token: Optional[str] = None) -> Dict[str, str]:
+def create_github_headers(token: str | None = None) -> dict[str, str]:
     """
     Create GitHub API headers with optional token.
 
@@ -431,5 +429,5 @@ def create_github_headers(token: Optional[str] = None) -> Dict[str, str]:
     """
     headers = {}
     if token:
-        headers['Authorization'] = f'token {token}'
+        headers["Authorization"] = f"token {token}"
     return headers
diff --git a/src/skill_seekers/cli/resume_command.py b/src/skill_seekers/cli/resume_command.py
index 837cde3..9047ca2 100644
--- a/src/skill_seekers/cli/resume_command.py
+++ b/src/skill_seekers/cli/resume_command.py
@@ -4,9 +4,9 @@ Resume Command for Skill Seekers
 Allows users to resume interrupted scraping jobs from saved progress.
 """
 
-import sys
 import argparse
-from typing import Optional
+import sys
+
 from .config_manager import get_config_manager
 
 
@@ -132,24 +132,10 @@ def clean_old_jobs():
 
 def main():
     """Main entry point for resume command."""
-    parser = argparse.ArgumentParser(
-        description="Resume interrupted Skill Seekers jobs"
-    )
-    parser.add_argument(
-        "job_id",
-        nargs="?",
-        help="Job ID to resume"
-    )
-    parser.add_argument(
-        "--list",
-        action="store_true",
-        help="List all resumable jobs"
-    )
-    parser.add_argument(
-        "--clean",
-        action="store_true",
-        help="Clean up old progress files"
-    )
+    parser = argparse.ArgumentParser(description="Resume interrupted Skill Seekers jobs")
+    parser.add_argument("job_id", nargs="?", help="Job ID to resume")
+    parser.add_argument("--list", action="store_true", help="List all resumable jobs")
+    parser.add_argument("--clean", action="store_true", help="Clean up old progress files")
 
     args = parser.parse_args()
 
diff --git a/src/skill_seekers/cli/run_tests.py b/src/skill_seekers/cli/run_tests.py
index ab38fcc..f77d939 100755
--- a/src/skill_seekers/cli/run_tests.py
+++ b/src/skill_seekers/cli/run_tests.py
@@ -6,21 +6,18 @@ Runs all test suites and generates a comprehensive test report
 
 import sys
 import unittest
-import os
-from io import StringIO
-from pathlib import Path
 
 
 class ColoredTextTestResult(unittest.TextTestResult):
     """Custom test result class with colored output"""
 
     # ANSI color codes
-    GREEN = '\033[92m'
-    RED = '\033[91m'
-    YELLOW = '\033[93m'
-    BLUE = '\033[94m'
-    RESET = '\033[0m'
-    BOLD = '\033[1m'
+    GREEN = "\033[92m"
+    RED = "\033[91m"
+    YELLOW = "\033[93m"
+    BLUE = "\033[94m"
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
@@ -28,7 +25,7 @@ class ColoredTextTestResult(unittest.TextTestResult):
 
     def addSuccess(self, test):
         super().addSuccess(test)
-        self.test_results.append(('PASS', test))
+        self.test_results.append(("PASS", test))
         if self.showAll:
             self.stream.write(f"{self.GREEN}✓ PASS{self.RESET}\n")
         elif self.dots:
@@ -37,7 +34,7 @@ class ColoredTextTestResult(unittest.TextTestResult):
 
     def addError(self, test, err):
         super().addError(test, err)
-        self.test_results.append(('ERROR', test))
+        self.test_results.append(("ERROR", test))
         if self.showAll:
             self.stream.write(f"{self.RED}✗ ERROR{self.RESET}\n")
         elif self.dots:
@@ -46,7 +43,7 @@ class ColoredTextTestResult(unittest.TextTestResult):
 
     def addFailure(self, test, err):
         super().addFailure(test, err)
-        self.test_results.append(('FAIL', test))
+        self.test_results.append(("FAIL", test))
         if self.showAll:
             self.stream.write(f"{self.RED}✗ FAIL{self.RESET}\n")
         elif self.dots:
@@ -55,7 +52,7 @@ class ColoredTextTestResult(unittest.TextTestResult):
 
     def addSkip(self, test, reason):
         super().addSkip(test, reason)
-        self.test_results.append(('SKIP', test))
+        self.test_results.append(("SKIP", test))
         if self.showAll:
             self.stream.write(f"{self.YELLOW}⊘ SKIP{self.RESET}\n")
         elif self.dots:
@@ -65,14 +62,15 @@ class ColoredTextTestResult(unittest.TextTestResult):
 
 class ColoredTextTestRunner(unittest.TextTestRunner):
     """Custom test runner with colored output"""
+
     resultclass = ColoredTextTestResult
 
 
-def discover_tests(test_dir='tests'):
+def discover_tests(test_dir="tests"):
     """Discover all test files in the tests directory"""
     loader = unittest.TestLoader()
     start_dir = test_dir
-    pattern = 'test_*.py'
+    pattern = "test_*.py"
 
     suite = loader.discover(start_dir, pattern=pattern)
     return suite
@@ -83,9 +81,9 @@ def run_specific_suite(suite_name):
     loader = unittest.TestLoader()
 
     suite_map = {
-        'config': 'tests.test_config_validation',
-        'features': 'tests.test_scraper_features',
-        'integration': 'tests.test_integration'
+        "config": "tests.test_config_validation",
+        "features": "tests.test_scraper_features",
+        "integration": "tests.test_integration",
     }
 
     if suite_name not in suite_map:
@@ -110,9 +108,9 @@ def print_summary(result):
     errors = len(result.errors)
     skipped = len(result.skipped)
 
-    print("\n" + "="*70)
+    print("\n" + "=" * 70)
     print("TEST SUMMARY")
-    print("="*70)
+    print("=" * 70)
 
     # Overall stats
     print(f"\n{ColoredTextTestResult.BOLD}Total Tests:{ColoredTextTestResult.RESET} {total}")
@@ -127,31 +125,35 @@ def print_summary(result):
     # Success rate
     if total > 0:
         success_rate = (passed / total) * 100
-        color = ColoredTextTestResult.GREEN if success_rate == 100 else \
-                ColoredTextTestResult.YELLOW if success_rate >= 80 else \
-                ColoredTextTestResult.RED
+        color = (
+            ColoredTextTestResult.GREEN
+            if success_rate == 100
+            else ColoredTextTestResult.YELLOW
+            if success_rate >= 80
+            else ColoredTextTestResult.RED
+        )
         print(f"\n{color}Success Rate: {success_rate:.1f}%{ColoredTextTestResult.RESET}")
 
     # Category breakdown
-    if hasattr(result, 'test_results'):
+    if hasattr(result, "test_results"):
         print(f"\n{ColoredTextTestResult.BOLD}Test Breakdown by Category:{ColoredTextTestResult.RESET}")
 
         categories = {}
         for status, test in result.test_results:
             test_name = str(test)
             # Extract test class name
-            if '.' in test_name:
-                class_name = test_name.split('.')[0].split()[-1]
+            if "." in test_name:
+                class_name = test_name.split(".")[0].split()[-1]
                 if class_name not in categories:
-                    categories[class_name] = {'PASS': 0, 'FAIL': 0, 'ERROR': 0, 'SKIP': 0}
+                    categories[class_name] = {"PASS": 0, "FAIL": 0, "ERROR": 0, "SKIP": 0}
                 categories[class_name][status] += 1
 
         for category, stats in sorted(categories.items()):
             total_cat = sum(stats.values())
-            passed_cat = stats['PASS']
+            passed_cat = stats["PASS"]
             print(f"  {category}: {passed_cat}/{total_cat} passed")
 
-    print("\n" + "="*70)
+    print("\n" + "=" * 70)
 
     # Return status
     return failed == 0 and errors == 0
@@ -162,20 +164,14 @@ def main():
     import argparse
 
     parser = argparse.ArgumentParser(
-        description='Run tests for Skill Seeker',
-        formatter_class=argparse.RawDescriptionHelpFormatter
+        description="Run tests for Skill Seeker", formatter_class=argparse.RawDescriptionHelpFormatter
     )
 
-    parser.add_argument('--suite', '-s', type=str,
-                       help='Run specific test suite (config, features, integration)')
-    parser.add_argument('--verbose', '-v', action='store_true',
-                       help='Verbose output (show each test)')
-    parser.add_argument('--quiet', '-q', action='store_true',
-                       help='Quiet output (minimal output)')
-    parser.add_argument('--failfast', '-f', action='store_true',
-                       help='Stop on first failure')
-    parser.add_argument('--list', '-l', action='store_true',
-                       help='List all available tests')
+    parser.add_argument("--suite", "-s", type=str, help="Run specific test suite (config, features, integration)")
+    parser.add_argument("--verbose", "-v", action="store_true", help="Verbose output (show each test)")
+    parser.add_argument("--quiet", "-q", action="store_true", help="Quiet output (minimal output)")
+    parser.add_argument("--failfast", "-f", action="store_true", help="Stop on first failure")
+    parser.add_argument("--list", "-l", action="store_true", help="List all available tests")
 
     args = parser.parse_args()
 
@@ -186,9 +182,9 @@ def main():
     elif args.quiet:
         verbosity = 0
 
-    print(f"\n{ColoredTextTestResult.BOLD}{'='*70}{ColoredTextTestResult.RESET}")
+    print(f"\n{ColoredTextTestResult.BOLD}{'=' * 70}{ColoredTextTestResult.RESET}")
     print(f"{ColoredTextTestResult.BOLD}SKILL SEEKER TEST SUITE{ColoredTextTestResult.RESET}")
-    print(f"{ColoredTextTestResult.BOLD}{'='*70}{ColoredTextTestResult.RESET}\n")
+    print(f"{ColoredTextTestResult.BOLD}{'=' * 70}{ColoredTextTestResult.RESET}\n")
 
     # Discover or load specific suite
     if args.suite:
@@ -210,10 +206,7 @@ def main():
         return 0
 
     # Run tests
-    runner = ColoredTextTestRunner(
-        verbosity=verbosity,
-        failfast=args.failfast
-    )
+    runner = ColoredTextTestRunner(verbosity=verbosity, failfast=args.failfast)
 
     result = runner.run(suite)
 
@@ -224,5 +217,5 @@ def main():
     return 0 if success else 1
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(main())
diff --git a/src/skill_seekers/cli/split_config.py b/src/skill_seekers/cli/split_config.py
index c452bb7..eb40283 100644
--- a/src/skill_seekers/cli/split_config.py
+++ b/src/skill_seekers/cli/split_config.py
@@ -6,12 +6,12 @@ Splits large documentation configs into multiple smaller, focused skill configs.
 Supports multiple splitting strategies: category-based, size-based, and automatic.
 """
 
+import argparse
 import json
 import sys
-import argparse
-from pathlib import Path
-from typing import Dict, List, Any, Tuple
 from collections import defaultdict
+from pathlib import Path
+from typing import Any
 
 
 class ConfigSplitter:
@@ -22,12 +22,12 @@ class ConfigSplitter:
         self.strategy = strategy
         self.target_pages = target_pages
         self.config = self.load_config()
-        self.base_name = self.config['name']
+        self.base_name = self.config["name"]
 
-    def load_config(self) -> Dict[str, Any]:
+    def load_config(self) -> dict[str, Any]:
         """Load configuration from file"""
         try:
-            with open(self.config_path, 'r') as f:
+            with open(self.config_path) as f:
                 return json.load(f)
         except FileNotFoundError:
             print(f"❌ Error: Config file not found: {self.config_path}")
@@ -38,45 +38,45 @@ class ConfigSplitter:
 
     def is_unified_config(self) -> bool:
         """Check if this is a unified multi-source config"""
-        return 'sources' in self.config
+        return "sources" in self.config
 
     def get_split_strategy(self) -> str:
         """Determine split strategy"""
         # For unified configs, default to source-based splitting
         if self.is_unified_config():
             if self.strategy == "auto":
-                num_sources = len(self.config.get('sources', []))
+                num_sources = len(self.config.get("sources", []))
                 if num_sources <= 1:
-                    print(f"ℹ️  Single source unified config - no splitting needed")
+                    print("ℹ️  Single source unified config - no splitting needed")
                     return "none"
                 else:
                     print(f"ℹ️  Multi-source unified config ({num_sources} sources) - source split recommended")
                     return "source"
             # For unified configs, only 'source' and 'none' strategies are valid
-            elif self.strategy in ['source', 'none']:
+            elif self.strategy in ["source", "none"]:
                 return self.strategy
             else:
                 print(f"⚠️  Warning: Strategy '{self.strategy}' not supported for unified configs")
-                print(f"ℹ️  Using 'source' strategy instead")
+                print("ℹ️  Using 'source' strategy instead")
                 return "source"
 
         # Check if strategy is defined in config (documentation configs)
-        if 'split_strategy' in self.config:
-            config_strategy = self.config['split_strategy']
+        if "split_strategy" in self.config:
+            config_strategy = self.config["split_strategy"]
             if config_strategy != "none":
                 return config_strategy
 
         # Use provided strategy or auto-detect (documentation configs)
         if self.strategy == "auto":
-            max_pages = self.config.get('max_pages', 500)
+            max_pages = self.config.get("max_pages", 500)
 
             if max_pages < 5000:
                 print(f"ℹ️  Small documentation ({max_pages} pages) - no splitting needed")
                 return "none"
-            elif max_pages < 10000 and 'categories' in self.config:
+            elif max_pages < 10000 and "categories" in self.config:
                 print(f"ℹ️  Medium documentation ({max_pages} pages) - category split recommended")
                 return "category"
-            elif 'categories' in self.config and len(self.config['categories']) >= 3:
+            elif "categories" in self.config and len(self.config["categories"]) >= 3:
                 print(f"ℹ️  Large documentation ({max_pages} pages) - router + categories recommended")
                 return "router"
             else:
@@ -85,14 +85,14 @@ class ConfigSplitter:
 
         return self.strategy
 
-    def split_by_category(self, create_router: bool = False) -> List[Dict[str, Any]]:
+    def split_by_category(self, create_router: bool = False) -> list[dict[str, Any]]:
         """Split config by categories"""
-        if 'categories' not in self.config:
+        if "categories" not in self.config:
             print("❌ Error: No categories defined in config")
             sys.exit(1)
 
-        categories = self.config['categories']
-        split_categories = self.config.get('split_config', {}).get('split_by_categories')
+        categories = self.config["categories"]
+        split_categories = self.config.get("split_config", {}).get("split_by_categories")
 
         # If specific categories specified, use only those
         if split_categories:
@@ -103,34 +103,36 @@ class ConfigSplitter:
         for category_name, keywords in categories.items():
             # Create new config for this category
             new_config = self.config.copy()
-            new_config['name'] = f"{self.base_name}-{category_name}"
-            new_config['description'] = f"{self.base_name.capitalize()} - {category_name.replace('_', ' ').title()}. {self.config.get('description', '')}"
+            new_config["name"] = f"{self.base_name}-{category_name}"
+            new_config["description"] = (
+                f"{self.base_name.capitalize()} - {category_name.replace('_', ' ').title()}. {self.config.get('description', '')}"
+            )
 
             # Update URL patterns to focus on this category
-            url_patterns = new_config.get('url_patterns', {})
+            url_patterns = new_config.get("url_patterns", {})
 
             # Add category keywords to includes
-            includes = url_patterns.get('include', [])
+            includes = url_patterns.get("include", [])
             for keyword in keywords:
-                if keyword.startswith('/'):
+                if keyword.startswith("/"):
                     includes.append(keyword)
 
             if includes:
-                url_patterns['include'] = list(set(includes))
-                new_config['url_patterns'] = url_patterns
+                url_patterns["include"] = list(set(includes))
+                new_config["url_patterns"] = url_patterns
 
             # Keep only this category
-            new_config['categories'] = {category_name: keywords}
+            new_config["categories"] = {category_name: keywords}
 
             # Remove split config from child
-            if 'split_strategy' in new_config:
-                del new_config['split_strategy']
-            if 'split_config' in new_config:
-                del new_config['split_config']
+            if "split_strategy" in new_config:
+                del new_config["split_strategy"]
+            if "split_config" in new_config:
+                del new_config["split_config"]
 
             # Adjust max_pages estimate
-            if 'max_pages' in new_config:
-                new_config['max_pages'] = self.target_pages
+            if "max_pages" in new_config:
+                new_config["max_pages"] = self.target_pages
 
             configs.append(new_config)
 
@@ -144,9 +146,9 @@ class ConfigSplitter:
 
         return configs
 
-    def split_by_size(self) -> List[Dict[str, Any]]:
+    def split_by_size(self) -> list[dict[str, Any]]:
         """Split config by size (page count)"""
-        max_pages = self.config.get('max_pages', 500)
+        max_pages = self.config.get("max_pages", 500)
         num_splits = (max_pages + self.target_pages - 1) // self.target_pages
 
         configs = []
@@ -154,28 +156,30 @@ class ConfigSplitter:
         for i in range(num_splits):
             new_config = self.config.copy()
             part_num = i + 1
-            new_config['name'] = f"{self.base_name}-part{part_num}"
-            new_config['description'] = f"{self.base_name.capitalize()} - Part {part_num}. {self.config.get('description', '')}"
-            new_config['max_pages'] = self.target_pages
+            new_config["name"] = f"{self.base_name}-part{part_num}"
+            new_config["description"] = (
+                f"{self.base_name.capitalize()} - Part {part_num}. {self.config.get('description', '')}"
+            )
+            new_config["max_pages"] = self.target_pages
 
             # Remove split config from child
-            if 'split_strategy' in new_config:
-                del new_config['split_strategy']
-            if 'split_config' in new_config:
-                del new_config['split_config']
+            if "split_strategy" in new_config:
+                del new_config["split_strategy"]
+            if "split_config" in new_config:
+                del new_config["split_config"]
 
             configs.append(new_config)
 
         print(f"✅ Created {len(configs)} size-based configs ({self.target_pages} pages each)")
         return configs
 
-    def split_by_source(self) -> List[Dict[str, Any]]:
+    def split_by_source(self) -> list[dict[str, Any]]:
         """Split unified config by source type"""
         if not self.is_unified_config():
             print("❌ Error: Config is not a unified config (missing 'sources' key)")
             sys.exit(1)
 
-        sources = self.config.get('sources', [])
+        sources = self.config.get("sources", [])
         if not sources:
             print("❌ Error: No sources defined in unified config")
             sys.exit(1)
@@ -184,20 +188,20 @@ class ConfigSplitter:
         source_type_counts = defaultdict(int)
 
         for source in sources:
-            source_type = source.get('type', 'unknown')
+            source_type = source.get("type", "unknown")
             source_type_counts[source_type] += 1
             count = source_type_counts[source_type]
 
             # Create new config for this source
             new_config = {
-                'name': f"{self.base_name}-{source_type}" + (f"-{count}" if count > 1 else ""),
-                'description': f"{self.base_name.capitalize()} - {source_type.title()} source. {self.config.get('description', '')}",
-                'sources': [source]  # Single source per config
+                "name": f"{self.base_name}-{source_type}" + (f"-{count}" if count > 1 else ""),
+                "description": f"{self.base_name.capitalize()} - {source_type.title()} source. {self.config.get('description', '')}",
+                "sources": [source],  # Single source per config
             }
 
             # Copy merge_mode if it exists
-            if 'merge_mode' in self.config:
-                new_config['merge_mode'] = self.config['merge_mode']
+            if "merge_mode" in self.config:
+                new_config["merge_mode"] = self.config["merge_mode"]
 
             configs.append(new_config)
 
@@ -209,36 +213,33 @@ class ConfigSplitter:
 
         return configs
 
-    def create_router_config(self, sub_configs: List[Dict[str, Any]]) -> Dict[str, Any]:
+    def create_router_config(self, sub_configs: list[dict[str, Any]]) -> dict[str, Any]:
         """Create a router config that references sub-skills"""
-        router_name = self.config.get('split_config', {}).get('router_name', self.base_name)
+        router_name = self.config.get("split_config", {}).get("router_name", self.base_name)
 
         router_config = {
             "name": router_name,
-            "description": self.config.get('description', ''),
-            "base_url": self.config['base_url'],
-            "selectors": self.config['selectors'],
-            "url_patterns": self.config.get('url_patterns', {}),
-            "rate_limit": self.config.get('rate_limit', 0.5),
+            "description": self.config.get("description", ""),
+            "base_url": self.config["base_url"],
+            "selectors": self.config["selectors"],
+            "url_patterns": self.config.get("url_patterns", {}),
+            "rate_limit": self.config.get("rate_limit", 0.5),
             "max_pages": 500,  # Router only needs overview pages
             "_router": True,
-            "_sub_skills": [cfg['name'] for cfg in sub_configs],
-            "_routing_keywords": {
-                cfg['name']: list(cfg.get('categories', {}).keys())
-                for cfg in sub_configs
-            }
+            "_sub_skills": [cfg["name"] for cfg in sub_configs],
+            "_routing_keywords": {cfg["name"]: list(cfg.get("categories", {}).keys()) for cfg in sub_configs},
         }
 
         return router_config
 
-    def split(self) -> List[Dict[str, Any]]:
+    def split(self) -> list[dict[str, Any]]:
         """Execute split based on strategy"""
         strategy = self.get_split_strategy()
 
         config_type = "UNIFIED" if self.is_unified_config() else "DOCUMENTATION"
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print(f"CONFIG SPLITTER: {self.base_name} ({config_type})")
-        print(f"{'='*60}")
+        print(f"{'=' * 60}")
         print(f"Strategy: {strategy}")
         if not self.is_unified_config():
             print(f"Target pages per skill: {self.target_pages}")
@@ -255,7 +256,7 @@ class ConfigSplitter:
             return self.split_by_category(create_router=False)
 
         elif strategy == "router":
-            create_router = self.config.get('split_config', {}).get('create_router', True)
+            create_router = self.config.get("split_config", {}).get("create_router", True)
             return self.split_by_category(create_router=create_router)
 
         elif strategy == "size":
@@ -265,7 +266,7 @@ class ConfigSplitter:
             print(f"❌ Error: Unknown strategy: {strategy}")
             sys.exit(1)
 
-    def save_configs(self, configs: List[Dict[str, Any]], output_dir: Path = None) -> List[Path]:
+    def save_configs(self, configs: list[dict[str, Any]], output_dir: Path = None) -> list[Path]:
         """Save configs to files"""
         if output_dir is None:
             output_dir = self.config_path.parent
@@ -279,7 +280,7 @@ class ConfigSplitter:
             filename = f"{config['name']}.json"
             filepath = output_dir / filename
 
-            with open(filepath, 'w') as f:
+            with open(filepath, "w") as f:
                 json.dump(config, f, indent=2)
 
             saved_files.append(filepath)
@@ -320,38 +321,23 @@ Split Strategies:
 Config Types:
   Documentation - Single base_url config (supports: category, router, size)
   Unified       - Multi-source config (supports: source)
-        """
+        """,
     )
 
-    parser.add_argument(
-        'config',
-        help='Path to config file (e.g., configs/godot.json)'
-    )
+    parser.add_argument("config", help="Path to config file (e.g., configs/godot.json)")
 
     parser.add_argument(
-        '--strategy',
-        choices=['auto', 'none', 'source', 'category', 'router', 'size'],
-        default='auto',
-        help='Splitting strategy (default: auto)'
+        "--strategy",
+        choices=["auto", "none", "source", "category", "router", "size"],
+        default="auto",
+        help="Splitting strategy (default: auto)",
     )
 
-    parser.add_argument(
-        '--target-pages',
-        type=int,
-        default=5000,
-        help='Target pages per skill (default: 5000)'
-    )
+    parser.add_argument("--target-pages", type=int, default=5000, help="Target pages per skill (default: 5000)")
 
-    parser.add_argument(
-        '--output-dir',
-        help='Output directory for configs (default: same as input)'
-    )
+    parser.add_argument("--output-dir", help="Output directory for configs (default: same as input)")
 
-    parser.add_argument(
-        '--dry-run',
-        action='store_true',
-        help='Show what would be created without saving files'
-    )
+    parser.add_argument("--dry-run", action="store_true", help="Show what would be created without saving files")
 
     args = parser.parse_args()
 
@@ -362,23 +348,23 @@ Config Types:
     configs = splitter.split()
 
     if args.dry_run:
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print("DRY RUN - No files saved")
-        print(f"{'='*60}")
+        print(f"{'=' * 60}")
         print(f"Would create {len(configs)} config files:")
         for cfg in configs:
-            is_router = cfg.get('_router', False)
+            is_router = cfg.get("_router", False)
             router_marker = " (ROUTER)" if is_router else ""
             print(f"  📄 {cfg['name']}.json{router_marker}")
     else:
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print("SAVING CONFIGS")
-        print(f"{'='*60}")
+        print(f"{'=' * 60}")
         saved_files = splitter.save_configs(configs, args.output_dir)
 
-        print(f"\n{'='*60}")
+        print(f"\n{'=' * 60}")
         print("NEXT STEPS")
-        print(f"{'='*60}")
+        print(f"{'=' * 60}")
         print("1. Review generated configs")
         print("2. Scrape each config:")
         for filepath in saved_files:
diff --git a/src/skill_seekers/cli/swift_patterns.py b/src/skill_seekers/cli/swift_patterns.py
index 7b65318..6692bd4 100644
--- a/src/skill_seekers/cli/swift_patterns.py
+++ b/src/skill_seekers/cli/swift_patterns.py
@@ -22,564 +22,505 @@ Author: iLearn Project (Swift Support Extension)
 """
 
 import logging
-from typing import Dict, List, Tuple
 
 logger = logging.getLogger(__name__)
 
-SWIFT_PATTERNS: Dict[str, List[Tuple[str, int]]] = {
-    'swift': [
+SWIFT_PATTERNS: dict[str, list[tuple[str, int]]] = {
+    "swift": [
         # ===== PURE SWIFT SYNTAX (Weight 4-5) =====
-
         # Function declarations with return type arrow (Swift-specific syntax)
-        (r'\bfunc\s+\w+\s*\([^)]*\)\s*->', 5),       # func foo() -> ReturnType
-        (r'\bfunc\s+\w+\s*\([^)]*\)\s*\{', 4),       # func foo() {
-
+        (r"\bfunc\s+\w+\s*\([^)]*\)\s*->", 5),  # func foo() -> ReturnType
+        (r"\bfunc\s+\w+\s*\([^)]*\)\s*\{", 4),  # func foo() {
         # Struct/class/enum declarations
-        (r'\bstruct\s+\w+\s*:', 5),                   # struct Foo: Protocol
-        (r'\bstruct\s+\w+\s*\{', 4),                  # struct Foo {
-        (r'\bclass\s+\w+\s*:\s*\w+', 4),              # class Foo: SuperClass
-        (r'\benum\s+\w+\s*:\s*\w+', 4),               # enum Foo: String
-        (r'\benum\s+\w+\s*\{', 3),                    # enum Foo {
-
+        (r"\bstruct\s+\w+\s*:", 5),  # struct Foo: Protocol
+        (r"\bstruct\s+\w+\s*\{", 4),  # struct Foo {
+        (r"\bclass\s+\w+\s*:\s*\w+", 4),  # class Foo: SuperClass
+        (r"\benum\s+\w+\s*:\s*\w+", 4),  # enum Foo: String
+        (r"\benum\s+\w+\s*\{", 3),  # enum Foo {
         # Protocol declarations (weight 5 - Swift-specific in this context)
-        (r'\bprotocol\s+\w+\s*\{', 5),                # protocol Foo {
-        (r'\bprotocol\s+\w+\s*:\s*\w+', 5),           # protocol Foo: AnotherProtocol
-
+        (r"\bprotocol\s+\w+\s*\{", 5),  # protocol Foo {
+        (r"\bprotocol\s+\w+\s*:\s*\w+", 5),  # protocol Foo: AnotherProtocol
         # Extension (weight 5 - very Swift-specific syntax)
-        (r'\bextension\s+\w+\s*:', 5),                # extension Foo: Protocol
-        (r'\bextension\s+\w+\s*\{', 5),               # extension Foo {
-        (r'\bextension\s+\w+\s*where\s+', 5),         # extension Foo where T: Equatable
-
+        (r"\bextension\s+\w+\s*:", 5),  # extension Foo: Protocol
+        (r"\bextension\s+\w+\s*\{", 5),  # extension Foo {
+        (r"\bextension\s+\w+\s*where\s+", 5),  # extension Foo where T: Equatable
         # Property wrappers (weight 5 - unique to Swift)
-        (r'@\w+\s+var\s+\w+', 4),                     # @Something var foo
-        (r'@propertyWrapper', 5),                     # @propertyWrapper attribute
-
+        (r"@\w+\s+var\s+\w+", 4),  # @Something var foo
+        (r"@propertyWrapper", 5),  # @propertyWrapper attribute
         # Optionals and unwrapping (weight 5 - unique to Swift)
-        (r'\bguard\s+let\s+\w+\s*=', 5),              # guard let foo =
-        (r'\bguard\s+var\s+\w+\s*=', 5),              # guard var foo =
-        (r'\bif\s+let\s+\w+\s*=', 5),                 # if let foo =
-        (r'\bif\s+var\s+\w+\s*=', 5),                 # if var foo =
-        (r'\bguard\s+.*\s+else\s*\{', 4),             # guard ... else {
-        (r'\w+\?\.', 4),                              # foo?.bar (optional chaining)
-        (r'\w+!\.\w+', 4),                            # foo!.bar (forced unwrap)
-        (r'\?\?', 4),                                 # nil coalescing ??
-
+        (r"\bguard\s+let\s+\w+\s*=", 5),  # guard let foo =
+        (r"\bguard\s+var\s+\w+\s*=", 5),  # guard var foo =
+        (r"\bif\s+let\s+\w+\s*=", 5),  # if let foo =
+        (r"\bif\s+var\s+\w+\s*=", 5),  # if var foo =
+        (r"\bguard\s+.*\s+else\s*\{", 4),  # guard ... else {
+        (r"\w+\?\.", 4),  # foo?.bar (optional chaining)
+        (r"\w+!\.\w+", 4),  # foo!.bar (forced unwrap)
+        (r"\?\?", 4),  # nil coalescing ??
         # Closures (weight 4-5 - Swift closure syntax)
-        (r'\{\s*\([^)]*\)\s*in\b', 5),                # { (params) in
-        (r'\{\s*\$0', 4),                             # { $0 (shorthand argument)
-        (r'\$[0-9]+', 3),                             # $0, $1, etc.
-
+        (r"\{\s*\([^)]*\)\s*in\b", 5),  # { (params) in
+        (r"\{\s*\$0", 4),  # { $0 (shorthand argument)
+        (r"\$[0-9]+", 3),  # $0, $1, etc.
         # Type annotations (weight 3-4)
-        (r':\s*\[\w+\]', 4),                          # : [Type] (array type)
-        (r':\s*\[\w+\s*:\s*\w+\]', 4),                # : [Key: Value] (dictionary type)
-        (r':\s*\w+\?', 4),                            # : Type? (optional type)
-        (r'->\s*\w+\?', 4),                           # -> Type? (optional return)
-
+        (r":\s*\[\w+\]", 4),  # : [Type] (array type)
+        (r":\s*\[\w+\s*:\s*\w+\]", 4),  # : [Key: Value] (dictionary type)
+        (r":\s*\w+\?", 4),  # : Type? (optional type)
+        (r"->\s*\w+\?", 4),  # -> Type? (optional return)
         # Keywords (weight 2-4)
-        (r'\blet\s+\w+\s*:', 3),                      # let foo: Type
-        (r'\bvar\s+\w+\s*:', 3),                      # var foo: Type
-        (r'\blet\s+\w+\s*=', 2),                      # let foo = (also JS const)
-        (r'\bself\.\w+', 3),                          # self.property (also Python)
-        (r'\bSelf\b', 4),                             # Self (Swift-specific)
-
+        (r"\blet\s+\w+\s*:", 3),  # let foo: Type
+        (r"\bvar\s+\w+\s*:", 3),  # var foo: Type
+        (r"\blet\s+\w+\s*=", 2),  # let foo = (also JS const)
+        (r"\bself\.\w+", 3),  # self.property (also Python)
+        (r"\bSelf\b", 4),  # Self (Swift-specific)
         # Imports (weight 2-5 based on specificity)
-        (r'\bimport\s+Foundation', 4),                # import Foundation
-        (r'\bimport\s+\w+', 2),                       # import Something
-
+        (r"\bimport\s+Foundation", 4),  # import Foundation
+        (r"\bimport\s+\w+", 2),  # import Something
         # Access modifiers (weight 3-5)
-        (r'\bprivate\s*\(set\)', 5),                  # private(set) - Swift-specific
-        (r'\bfileprivate\s+', 5),                     # fileprivate - Swift-only keyword
-        (r'\binternal\s+', 2),                        # internal (also C#)
-        (r'\bopen\s+class', 4),                       # open class (Swift-specific)
-
+        (r"\bprivate\s*\(set\)", 5),  # private(set) - Swift-specific
+        (r"\bfileprivate\s+", 5),  # fileprivate - Swift-only keyword
+        (r"\binternal\s+", 2),  # internal (also C#)
+        (r"\bopen\s+class", 4),  # open class (Swift-specific)
         # Error handling (weight 4-5)
-        (r'\bthrows\s*->', 5),                        # throws -> ReturnType
-        (r'\bthrows\s*\{', 4),                        # func foo() throws {
-        (r'\brethrows\b', 5),                         # rethrows keyword (Swift-only)
-        (r'\btry\?\s+', 5),                           # try? (optional try - Swift)
-        (r'\btry!\s+', 5),                            # try! (forced try - Swift)
-        (r'\bdo\s*\{', 3),                            # do { (try block)
-        (r'\bcatch\s+\w+', 3),                        # catch error
-
+        (r"\bthrows\s*->", 5),  # throws -> ReturnType
+        (r"\bthrows\s*\{", 4),  # func foo() throws {
+        (r"\brethrows\b", 5),  # rethrows keyword (Swift-only)
+        (r"\btry\?\s+", 5),  # try? (optional try - Swift)
+        (r"\btry!\s+", 5),  # try! (forced try - Swift)
+        (r"\bdo\s*\{", 3),  # do { (try block)
+        (r"\bcatch\s+\w+", 3),  # catch error
         # Generics (weight 3-4)
-        (r'<\w+:\s*\w+>', 4),                         # <T: Protocol>
-        (r'\bwhere\s+\w+\s*:', 4),                    # where T: Protocol
+        (r"<\w+:\s*\w+>", 4),  # <T: Protocol>
+        (r"\bwhere\s+\w+\s*:", 4),  # where T: Protocol
         # NOTE: 'some' and 'any' require capitalized type names to avoid matching
         # English prose ("some example", "any variable"). Swift types are capitalized
         # by convention (View, Protocol, etc.). The (?-i:[A-Z]) syntax enforces
         # case-sensitive matching for the first letter despite global IGNORECASE flag.
-        (r'\bsome\s+(?-i:[A-Z])\w+', 5),              # some Protocol (opaque type - Swift 5.1+)
-        (r'\bany\s+(?-i:[A-Z])\w+', 4),               # any Protocol (existential type - Swift 5.6+)
-
+        (r"\bsome\s+(?-i:[A-Z])\w+", 5),  # some Protocol (opaque type - Swift 5.1+)
+        (r"\bany\s+(?-i:[A-Z])\w+", 4),  # any Protocol (existential type - Swift 5.6+)
         # Actors and concurrency (weight 5 - Swift 5.5+)
-        (r'\bactor\s+\w+', 5),                        # actor MyActor
-        (r'\basync\s+throws', 5),                     # async throws (Swift-specific combo)
-        (r'\basync\s+func', 5),                       # async func
-        (r'\bawait\s+\w+', 3),                        # await (also JS/Python/C#)
-        (r'\bTask\s*\{', 4),                          # Task { (Swift concurrency)
-        (r'\bTask\.\w+', 4),                          # Task.detached, Task.sleep
-        (r'@MainActor', 5),                           # @MainActor attribute
-        (r'@Sendable', 5),                            # @Sendable attribute
-        (r'\bnonisolated\b', 5),                      # nonisolated keyword
-
+        (r"\bactor\s+\w+", 5),  # actor MyActor
+        (r"\basync\s+throws", 5),  # async throws (Swift-specific combo)
+        (r"\basync\s+func", 5),  # async func
+        (r"\bawait\s+\w+", 3),  # await (also JS/Python/C#)
+        (r"\bTask\s*\{", 4),  # Task { (Swift concurrency)
+        (r"\bTask\.\w+", 4),  # Task.detached, Task.sleep
+        (r"@MainActor", 5),  # @MainActor attribute
+        (r"@Sendable", 5),  # @Sendable attribute
+        (r"\bnonisolated\b", 5),  # nonisolated keyword
         # Result builders (weight 5)
-        (r'@resultBuilder', 5),                       # @resultBuilder attribute
-
+        (r"@resultBuilder", 5),  # @resultBuilder attribute
         # Type aliases and associated types (weight 5)
-        (r'\btypealias\s+\w+\s*=', 5),                # typealias Foo = Bar
-        (r'\bassociatedtype\s+\w+', 5),               # associatedtype Element
-
+        (r"\btypealias\s+\w+\s*=", 5),  # typealias Foo = Bar
+        (r"\bassociatedtype\s+\w+", 5),  # associatedtype Element
         # Print function
-        (r'\bprint\s*\(', 2),                         # print() (also Python)
-
+        (r"\bprint\s*\(", 2),  # print() (also Python)
         # String interpolation (weight 4)
-        (r'\\\(\w+', 4),                              # \(variable) interpolation
-
+        (r"\\\(\w+", 4),  # \(variable) interpolation
         # Memory management (weight 4-5)
-        (r'\bweak\s+var', 5),                         # weak var
-        (r'\bunowned\s+', 5),                         # unowned (Swift-specific)
-        (r'\[weak\s+self\]', 5),                      # [weak self] capture list
-        (r'\[unowned\s+self\]', 5),                   # [unowned self] capture list
-        (r'\blazy\s+var', 4),                         # lazy var
-
+        (r"\bweak\s+var", 5),  # weak var
+        (r"\bunowned\s+", 5),  # unowned (Swift-specific)
+        (r"\[weak\s+self\]", 5),  # [weak self] capture list
+        (r"\[unowned\s+self\]", 5),  # [unowned self] capture list
+        (r"\blazy\s+var", 4),  # lazy var
         # ===== iOS/UIKit PATTERNS (Weight 4-5) =====
-
-        (r'\bimport\s+UIKit', 5),                     # import UIKit
-        (r'\bUIViewController\b', 5),                 # UIViewController class
-        (r'\bUIView\b', 4),                           # UIView class
-        (r'\bUITableView\b', 5),                      # UITableView
-        (r'\bUICollectionView\b', 5),                 # UICollectionView
-        (r'\bUINavigationController\b', 5),           # UINavigationController
-        (r'\bUITabBarController\b', 5),               # UITabBarController
-        (r'\bUIButton\b', 4),                         # UIButton
-        (r'\bUILabel\b', 4),                          # UILabel
-        (r'\bUIImageView\b', 4),                      # UIImageView
-        (r'\bUITextField\b', 4),                      # UITextField
-        (r'\bUITextView\b', 4),                       # UITextView
-        (r'\bUIStackView\b', 4),                      # UIStackView
-        (r'\bUIScrollView\b', 4),                     # UIScrollView
-        (r'\bUIAlertController\b', 5),                # UIAlertController
-        (r'\bUIApplication\b', 5),                    # UIApplication
-        (r'\bUIWindow\b', 4),                         # UIWindow
-        (r'\bUIScreen\b', 4),                         # UIScreen
-        (r'\bUIDevice\b', 5),                         # UIDevice
-
+        (r"\bimport\s+UIKit", 5),  # import UIKit
+        (r"\bUIViewController\b", 5),  # UIViewController class
+        (r"\bUIView\b", 4),  # UIView class
+        (r"\bUITableView\b", 5),  # UITableView
+        (r"\bUICollectionView\b", 5),  # UICollectionView
+        (r"\bUINavigationController\b", 5),  # UINavigationController
+        (r"\bUITabBarController\b", 5),  # UITabBarController
+        (r"\bUIButton\b", 4),  # UIButton
+        (r"\bUILabel\b", 4),  # UILabel
+        (r"\bUIImageView\b", 4),  # UIImageView
+        (r"\bUITextField\b", 4),  # UITextField
+        (r"\bUITextView\b", 4),  # UITextView
+        (r"\bUIStackView\b", 4),  # UIStackView
+        (r"\bUIScrollView\b", 4),  # UIScrollView
+        (r"\bUIAlertController\b", 5),  # UIAlertController
+        (r"\bUIApplication\b", 5),  # UIApplication
+        (r"\bUIWindow\b", 4),  # UIWindow
+        (r"\bUIScreen\b", 4),  # UIScreen
+        (r"\bUIDevice\b", 5),  # UIDevice
         # UIKit Lifecycle methods (weight 5)
-        (r'\bviewDidLoad\s*\(\s*\)', 5),              # viewDidLoad()
-        (r'\bviewWillAppear\s*\(', 5),                # viewWillAppear(_:)
-        (r'\bviewDidAppear\s*\(', 5),                 # viewDidAppear(_:)
-        (r'\bviewWillDisappear\s*\(', 5),             # viewWillDisappear(_:)
-        (r'\bviewDidDisappear\s*\(', 5),              # viewDidDisappear(_:)
-        (r'\bviewWillLayoutSubviews\s*\(\)', 5),      # viewWillLayoutSubviews()
-        (r'\bviewDidLayoutSubviews\s*\(\)', 5),       # viewDidLayoutSubviews()
-
+        (r"\bviewDidLoad\s*\(\s*\)", 5),  # viewDidLoad()
+        (r"\bviewWillAppear\s*\(", 5),  # viewWillAppear(_:)
+        (r"\bviewDidAppear\s*\(", 5),  # viewDidAppear(_:)
+        (r"\bviewWillDisappear\s*\(", 5),  # viewWillDisappear(_:)
+        (r"\bviewDidDisappear\s*\(", 5),  # viewDidDisappear(_:)
+        (r"\bviewWillLayoutSubviews\s*\(\)", 5),  # viewWillLayoutSubviews()
+        (r"\bviewDidLayoutSubviews\s*\(\)", 5),  # viewDidLayoutSubviews()
         # Interface Builder outlets/actions (weight 5)
-        (r'@IBOutlet', 5),                            # @IBOutlet
-        (r'@IBAction', 5),                            # @IBAction
-        (r'@IBDesignable', 5),                        # @IBDesignable
-        (r'@IBInspectable', 5),                       # @IBInspectable
-
+        (r"@IBOutlet", 5),  # @IBOutlet
+        (r"@IBAction", 5),  # @IBAction
+        (r"@IBDesignable", 5),  # @IBDesignable
+        (r"@IBInspectable", 5),  # @IBInspectable
         # UIKit delegates and datasources (weight 5)
-        (r'\bUITableViewDelegate\b', 5),
-        (r'\bUITableViewDataSource\b', 5),
-        (r'\bUICollectionViewDelegate\b', 5),
-        (r'\bUICollectionViewDataSource\b', 5),
-        (r'\bUITextFieldDelegate\b', 5),
-        (r'\bUIScrollViewDelegate\b', 5),
-
+        (r"\bUITableViewDelegate\b", 5),
+        (r"\bUITableViewDataSource\b", 5),
+        (r"\bUICollectionViewDelegate\b", 5),
+        (r"\bUICollectionViewDataSource\b", 5),
+        (r"\bUITextFieldDelegate\b", 5),
+        (r"\bUIScrollViewDelegate\b", 5),
         # Auto Layout (weight 4-5)
-        (r'\bNSLayoutConstraint\b', 5),               # NSLayoutConstraint
-        (r'\.constraint\(', 4),                       # constraint methods
-        (r'\btranslatesAutoresizingMaskIntoConstraints', 5),
-        (r'NSLayoutConstraint\.activate', 5),
-
+        (r"\bNSLayoutConstraint\b", 5),  # NSLayoutConstraint
+        (r"\.constraint\(", 4),  # constraint methods
+        (r"\btranslatesAutoresizingMaskIntoConstraints", 5),
+        (r"NSLayoutConstraint\.activate", 5),
         # GCD / DispatchQueue (weight 5)
-        (r'\bDispatchQueue\b', 5),                    # DispatchQueue
-        (r'\bDispatchQueue\.main', 5),                # DispatchQueue.main
-        (r'\bDispatchQueue\.global', 5),              # DispatchQueue.global
-        (r'\.async\s*\{', 4),                         # .async {
-        (r'\.sync\s*\{', 4),                          # .sync {
-
+        (r"\bDispatchQueue\b", 5),  # DispatchQueue
+        (r"\bDispatchQueue\.main", 5),  # DispatchQueue.main
+        (r"\bDispatchQueue\.global", 5),  # DispatchQueue.global
+        (r"\.async\s*\{", 4),  # .async {
+        (r"\.sync\s*\{", 4),  # .sync {
         # ===== macOS/AppKit PATTERNS (Weight 4-5) =====
-
-        (r'\bimport\s+AppKit', 5),                    # import AppKit
-        (r'\bimport\s+Cocoa', 5),                     # import Cocoa
-        (r'\bNSViewController\b', 5),                 # NSViewController
-        (r'\bNSView\b', 4),                           # NSView
-        (r'\bNSWindow\b', 5),                         # NSWindow
-        (r'\bNSWindowController\b', 5),               # NSWindowController
-        (r'\bNSApplication\b', 5),                    # NSApplication
-        (r'\bNSTableView\b', 5),                      # NSTableView
-        (r'\bNSOutlineView\b', 5),                    # NSOutlineView
-        (r'\bNSCollectionView\b', 5),                 # NSCollectionView
-        (r'\bNSButton\b', 4),                         # NSButton
-        (r'\bNSTextField\b', 4),                      # NSTextField
-        (r'\bNSTextView\b', 4),                       # NSTextView
-        (r'\bNSImageView\b', 4),                      # NSImageView
-        (r'\bNSStackView\b', 4),                      # NSStackView
-        (r'\bNSScrollView\b', 4),                     # NSScrollView
-        (r'\bNSSplitView\b', 5),                      # NSSplitView
-        (r'\bNSTabView\b', 5),                        # NSTabView
-        (r'\bNSMenu\b', 5),                           # NSMenu
-        (r'\bNSMenuItem\b', 5),                       # NSMenuItem
-        (r'\bNSToolbar\b', 5),                        # NSToolbar
-        (r'\bNSAlert\b', 5),                          # NSAlert
-        (r'\bNSPanel\b', 5),                          # NSPanel
-        (r'\bNSOpenPanel\b', 5),                      # NSOpenPanel
-        (r'\bNSSavePanel\b', 5),                      # NSSavePanel
-        (r'\bNSWorkspace\b', 5),                      # NSWorkspace
-        (r'\bNSRunningApplication\b', 5),             # NSRunningApplication
-        (r'\bNSScreen\b', 4),                         # NSScreen
-        (r'\bNSColor\b', 4),                          # NSColor
-        (r'\bNSFont\b', 4),                           # NSFont
-        (r'\bNSImage\b', 4),                          # NSImage
-        (r'\bNSBezierPath\b', 5),                     # NSBezierPath
-        (r'\bNSSound\b', 5),                          # NSSound
-        (r'\bNSEvent\b', 5),                          # NSEvent
-        (r'\bNSResponder\b', 5),                      # NSResponder
-        (r'\bNSPasteboard\b', 5),                     # NSPasteboard
-        (r'\bNSStatusBar\b', 5),                      # NSStatusBar
-        (r'\bNSStatusItem\b', 5),                     # NSStatusItem
-
+        (r"\bimport\s+AppKit", 5),  # import AppKit
+        (r"\bimport\s+Cocoa", 5),  # import Cocoa
+        (r"\bNSViewController\b", 5),  # NSViewController
+        (r"\bNSView\b", 4),  # NSView
+        (r"\bNSWindow\b", 5),  # NSWindow
+        (r"\bNSWindowController\b", 5),  # NSWindowController
+        (r"\bNSApplication\b", 5),  # NSApplication
+        (r"\bNSTableView\b", 5),  # NSTableView
+        (r"\bNSOutlineView\b", 5),  # NSOutlineView
+        (r"\bNSCollectionView\b", 5),  # NSCollectionView
+        (r"\bNSButton\b", 4),  # NSButton
+        (r"\bNSTextField\b", 4),  # NSTextField
+        (r"\bNSTextView\b", 4),  # NSTextView
+        (r"\bNSImageView\b", 4),  # NSImageView
+        (r"\bNSStackView\b", 4),  # NSStackView
+        (r"\bNSScrollView\b", 4),  # NSScrollView
+        (r"\bNSSplitView\b", 5),  # NSSplitView
+        (r"\bNSTabView\b", 5),  # NSTabView
+        (r"\bNSMenu\b", 5),  # NSMenu
+        (r"\bNSMenuItem\b", 5),  # NSMenuItem
+        (r"\bNSToolbar\b", 5),  # NSToolbar
+        (r"\bNSAlert\b", 5),  # NSAlert
+        (r"\bNSPanel\b", 5),  # NSPanel
+        (r"\bNSOpenPanel\b", 5),  # NSOpenPanel
+        (r"\bNSSavePanel\b", 5),  # NSSavePanel
+        (r"\bNSWorkspace\b", 5),  # NSWorkspace
+        (r"\bNSRunningApplication\b", 5),  # NSRunningApplication
+        (r"\bNSScreen\b", 4),  # NSScreen
+        (r"\bNSColor\b", 4),  # NSColor
+        (r"\bNSFont\b", 4),  # NSFont
+        (r"\bNSImage\b", 4),  # NSImage
+        (r"\bNSBezierPath\b", 5),  # NSBezierPath
+        (r"\bNSSound\b", 5),  # NSSound
+        (r"\bNSEvent\b", 5),  # NSEvent
+        (r"\bNSResponder\b", 5),  # NSResponder
+        (r"\bNSPasteboard\b", 5),  # NSPasteboard
+        (r"\bNSStatusBar\b", 5),  # NSStatusBar
+        (r"\bNSStatusItem\b", 5),  # NSStatusItem
         # macOS Lifecycle methods (weight 5)
         # Note: viewDidLoad() is defined in the UIKit section above since it's shared
         # between iOS (UIViewController) and macOS (NSViewController)
-        (r'\bviewWillAppear\s*\(\)', 5),              # NSViewController viewWillAppear
-        (r'\bviewDidAppear\s*\(\)', 5),               # NSViewController viewDidAppear
-        (r'\bawakeFromNib\s*\(\)', 5),                # awakeFromNib()
-        (r'\bapplicationDidFinishLaunching', 5),      # NSApplicationDelegate
-        (r'\bapplicationWillTerminate', 5),           # NSApplicationDelegate
-        (r'\bwindowDidLoad\s*\(\)', 5),               # NSWindowController
-
+        (r"\bviewWillAppear\s*\(\)", 5),  # NSViewController viewWillAppear
+        (r"\bviewDidAppear\s*\(\)", 5),  # NSViewController viewDidAppear
+        (r"\bawakeFromNib\s*\(\)", 5),  # awakeFromNib()
+        (r"\bapplicationDidFinishLaunching", 5),  # NSApplicationDelegate
+        (r"\bapplicationWillTerminate", 5),  # NSApplicationDelegate
+        (r"\bwindowDidLoad\s*\(\)", 5),  # NSWindowController
         # macOS delegates (weight 5)
-        (r'\bNSTableViewDelegate\b', 5),
-        (r'\bNSTableViewDataSource\b', 5),
-        (r'\bNSOutlineViewDelegate\b', 5),
-        (r'\bNSOutlineViewDataSource\b', 5),
-        (r'\bNSWindowDelegate\b', 5),
-        (r'\bNSApplicationDelegate\b', 5),
-        (r'\bNSTextFieldDelegate\b', 5),
-        (r'\bNSTextViewDelegate\b', 5),
-
+        (r"\bNSTableViewDelegate\b", 5),
+        (r"\bNSTableViewDataSource\b", 5),
+        (r"\bNSOutlineViewDelegate\b", 5),
+        (r"\bNSOutlineViewDataSource\b", 5),
+        (r"\bNSWindowDelegate\b", 5),
+        (r"\bNSApplicationDelegate\b", 5),
+        (r"\bNSTextFieldDelegate\b", 5),
+        (r"\bNSTextViewDelegate\b", 5),
         # ===== SwiftUI PATTERNS (Weight 5) =====
-
-        (r'\bimport\s+SwiftUI', 5),                   # import SwiftUI
-        (r'\bstruct\s+\w+\s*:\s*View', 5),            # struct Foo: View
-        (r'\bvar\s+body\s*:\s*some\s+View', 5),       # var body: some View
-        (r':\s*some\s+View', 5),                      # : some View
-
+        (r"\bimport\s+SwiftUI", 5),  # import SwiftUI
+        (r"\bstruct\s+\w+\s*:\s*View", 5),  # struct Foo: View
+        (r"\bvar\s+body\s*:\s*some\s+View", 5),  # var body: some View
+        (r":\s*some\s+View", 5),  # : some View
         # SwiftUI property wrappers (weight 5 - unique to SwiftUI)
-        (r'@State\s+', 5),                            # @State var
-        (r'@Binding\s+', 5),                          # @Binding var
-        (r'@Published\s+', 5),                        # @Published var
-        (r'@ObservedObject\s+', 5),                   # @ObservedObject var
-        (r'@StateObject\s+', 5),                      # @StateObject var
-        (r'@EnvironmentObject\s+', 5),                # @EnvironmentObject var
-        (r'@Environment\s*\(', 5),                    # @Environment(\.keyPath)
-        (r'@FetchRequest\s*\(', 5),                   # @FetchRequest (Core Data)
-        (r'@AppStorage\s*\(', 5),                     # @AppStorage
-        (r'@SceneStorage\s*\(', 5),                   # @SceneStorage
-        (r'@FocusState\s+', 5),                       # @FocusState
-        (r'@FocusedBinding\s*\(', 5),                 # @FocusedBinding
-        (r'@Observable\b', 5),                        # @Observable (Swift 5.9+)
-        (r'@Bindable\s+', 5),                         # @Bindable (Swift 5.9+)
-        (r'@Query\s*\(', 5),                          # @Query (SwiftData)
-        (r'@Model\b', 5),                             # @Model (SwiftData)
-        (r'@ViewBuilder', 5),                         # @ViewBuilder
-
+        (r"@State\s+", 5),  # @State var
+        (r"@Binding\s+", 5),  # @Binding var
+        (r"@Published\s+", 5),  # @Published var
+        (r"@ObservedObject\s+", 5),  # @ObservedObject var
+        (r"@StateObject\s+", 5),  # @StateObject var
+        (r"@EnvironmentObject\s+", 5),  # @EnvironmentObject var
+        (r"@Environment\s*\(", 5),  # @Environment(\.keyPath)
+        (r"@FetchRequest\s*\(", 5),  # @FetchRequest (Core Data)
+        (r"@AppStorage\s*\(", 5),  # @AppStorage
+        (r"@SceneStorage\s*\(", 5),  # @SceneStorage
+        (r"@FocusState\s+", 5),  # @FocusState
+        (r"@FocusedBinding\s*\(", 5),  # @FocusedBinding
+        (r"@Observable\b", 5),  # @Observable (Swift 5.9+)
+        (r"@Bindable\s+", 5),  # @Bindable (Swift 5.9+)
+        (r"@Query\s*\(", 5),  # @Query (SwiftData)
+        (r"@Model\b", 5),  # @Model (SwiftData)
+        (r"@ViewBuilder", 5),  # @ViewBuilder
         # SwiftUI Views (weight 4-5)
-        (r'\bText\s*\(', 4),                          # Text("Hello")
-        (r'\bImage\s*\(', 3),                         # Image(systemName:)
-        (r'\bButton\s*\(', 3),                        # Button("Label") { }
-        (r'\bVStack\s*[\(\{]', 5),                    # VStack { } or VStack(alignment:)
-        (r'\bHStack\s*[\(\{]', 5),                    # HStack { }
-        (r'\bZStack\s*[\(\{]', 5),                    # ZStack { }
-        (r'\bList\s*[\(\{]', 4),                      # List { }
-        (r'\bForEach\s*\(', 4),                       # ForEach(items) { }
-        (r'\bNavigationView\s*\{', 5),                # NavigationView { }
-        (r'\bNavigationStack\s*[\(\{]', 5),           # NavigationStack { } (iOS 16+)
-        (r'\bNavigationSplitView\s*[\(\{]', 5),       # NavigationSplitView (macOS/iPad)
-        (r'\bNavigationLink\s*\(', 5),                # NavigationLink
-        (r'\bTabView\s*[\(\{]', 5),                   # TabView { }
-        (r'\bScrollView\s*[\(\{]', 5),                # ScrollView { }
-        (r'\bLazyVStack\s*[\(\{]', 5),                # LazyVStack { }
-        (r'\bLazyHStack\s*[\(\{]', 5),                # LazyHStack { }
-        (r'\bLazyVGrid\s*\(', 5),                     # LazyVGrid
-        (r'\bLazyHGrid\s*\(', 5),                     # LazyHGrid
-        (r'\bGrid\s*[\(\{]', 4),                      # Grid { } (iOS 16+)
-        (r'\bGridRow\s*[\(\{]', 5),                   # GridRow { }
-        (r'\bGeometryReader\s*\{', 5),                # GeometryReader { }
-        (r'\bSpacer\s*\(\)', 5),                      # Spacer()
-        (r'\bDivider\s*\(\)', 5),                     # Divider()
-        (r'\bForm\s*\{', 4),                          # Form { }
-        (r'\bSection\s*[\(\{]', 4),                   # Section { }
-        (r'\bGroup\s*\{', 4),                         # Group { }
-        (r'\bGroupBox\s*[\(\{]', 5),                  # GroupBox { }
-        (r'\bDisclosureGroup\s*\(', 5),               # DisclosureGroup
-        (r'\bOutlineGroup\s*\(', 5),                  # OutlineGroup
-        (r'\bToggle\s*\(', 4),                        # Toggle
-        (r'\bPicker\s*\(', 4),                        # Picker
-        (r'\bSlider\s*\(', 4),                        # Slider
-        (r'\bStepper\s*\(', 4),                       # Stepper
-        (r'\bDatePicker\s*\(', 5),                    # DatePicker
-        (r'\bColorPicker\s*\(', 5),                   # ColorPicker
-        (r'\bProgressView\s*[\(\{]', 5),              # ProgressView
-        (r'\bLabel\s*\(', 4),                         # Label
-        (r'\bLink\s*\(', 4),                          # Link
-        (r'\bMenu\s*[\(\{]', 4),                      # Menu
-        (r'\bContextMenu\s*\{', 5),                   # ContextMenu
-        (r'\bToolbar\s*\{', 5),                       # Toolbar
-        (r'\bToolbarItem\s*\(', 5),                   # ToolbarItem
-        (r'\bCanvas\s*\{', 5),                        # Canvas
-        (r'\bTimelineView\s*\(', 5),                  # TimelineView
-        (r'\bShareLink\s*\(', 5),                     # ShareLink (iOS 16+)
-        (r'\bPhotosPicker\s*\(', 5),                  # PhotosPicker
-        (r'\bTextField\s*\(', 4),                     # TextField
-        (r'\bSecureField\s*\(', 5),                   # SecureField
-        (r'\bTextEditor\s*\(', 5),                    # TextEditor
-
+        (r"\bText\s*\(", 4),  # Text("Hello")
+        (r"\bImage\s*\(", 3),  # Image(systemName:)
+        (r"\bButton\s*\(", 3),  # Button("Label") { }
+        (r"\bVStack\s*[\(\{]", 5),  # VStack { } or VStack(alignment:)
+        (r"\bHStack\s*[\(\{]", 5),  # HStack { }
+        (r"\bZStack\s*[\(\{]", 5),  # ZStack { }
+        (r"\bList\s*[\(\{]", 4),  # List { }
+        (r"\bForEach\s*\(", 4),  # ForEach(items) { }
+        (r"\bNavigationView\s*\{", 5),  # NavigationView { }
+        (r"\bNavigationStack\s*[\(\{]", 5),  # NavigationStack { } (iOS 16+)
+        (r"\bNavigationSplitView\s*[\(\{]", 5),  # NavigationSplitView (macOS/iPad)
+        (r"\bNavigationLink\s*\(", 5),  # NavigationLink
+        (r"\bTabView\s*[\(\{]", 5),  # TabView { }
+        (r"\bScrollView\s*[\(\{]", 5),  # ScrollView { }
+        (r"\bLazyVStack\s*[\(\{]", 5),  # LazyVStack { }
+        (r"\bLazyHStack\s*[\(\{]", 5),  # LazyHStack { }
+        (r"\bLazyVGrid\s*\(", 5),  # LazyVGrid
+        (r"\bLazyHGrid\s*\(", 5),  # LazyHGrid
+        (r"\bGrid\s*[\(\{]", 4),  # Grid { } (iOS 16+)
+        (r"\bGridRow\s*[\(\{]", 5),  # GridRow { }
+        (r"\bGeometryReader\s*\{", 5),  # GeometryReader { }
+        (r"\bSpacer\s*\(\)", 5),  # Spacer()
+        (r"\bDivider\s*\(\)", 5),  # Divider()
+        (r"\bForm\s*\{", 4),  # Form { }
+        (r"\bSection\s*[\(\{]", 4),  # Section { }
+        (r"\bGroup\s*\{", 4),  # Group { }
+        (r"\bGroupBox\s*[\(\{]", 5),  # GroupBox { }
+        (r"\bDisclosureGroup\s*\(", 5),  # DisclosureGroup
+        (r"\bOutlineGroup\s*\(", 5),  # OutlineGroup
+        (r"\bToggle\s*\(", 4),  # Toggle
+        (r"\bPicker\s*\(", 4),  # Picker
+        (r"\bSlider\s*\(", 4),  # Slider
+        (r"\bStepper\s*\(", 4),  # Stepper
+        (r"\bDatePicker\s*\(", 5),  # DatePicker
+        (r"\bColorPicker\s*\(", 5),  # ColorPicker
+        (r"\bProgressView\s*[\(\{]", 5),  # ProgressView
+        (r"\bLabel\s*\(", 4),  # Label
+        (r"\bLink\s*\(", 4),  # Link
+        (r"\bMenu\s*[\(\{]", 4),  # Menu
+        (r"\bContextMenu\s*\{", 5),  # ContextMenu
+        (r"\bToolbar\s*\{", 5),  # Toolbar
+        (r"\bToolbarItem\s*\(", 5),  # ToolbarItem
+        (r"\bCanvas\s*\{", 5),  # Canvas
+        (r"\bTimelineView\s*\(", 5),  # TimelineView
+        (r"\bShareLink\s*\(", 5),  # ShareLink (iOS 16+)
+        (r"\bPhotosPicker\s*\(", 5),  # PhotosPicker
+        (r"\bTextField\s*\(", 4),  # TextField
+        (r"\bSecureField\s*\(", 5),  # SecureField
+        (r"\bTextEditor\s*\(", 5),  # TextEditor
         # SwiftUI Modifiers (weight 4-5)
-        (r'\.padding\s*\(', 4),                       # .padding()
-        (r'\.frame\s*\(', 4),                         # .frame(width:height:)
-        (r'\.foregroundColor\s*\(', 5),               # .foregroundColor(.red)
-        (r'\.foregroundStyle\s*\(', 5),               # .foregroundStyle (iOS 15+)
-        (r'\.background\s*\(', 3),                    # .background()
-        (r'\.cornerRadius\s*\(', 4),                  # .cornerRadius()
-        (r'\.clipShape\s*\(', 5),                     # .clipShape()
-        (r'\.shadow\s*\(', 3),                        # .shadow()
-        (r'\.font\s*\(', 3),                          # .font(.title)
-        (r'\.fontWeight\s*\(', 4),                    # .fontWeight()
-        (r'\.bold\s*\(\)', 4),                        # .bold()
-        (r'\.italic\s*\(\)', 4),                      # .italic()
-        (r'\.onAppear\s*\{', 5),                      # .onAppear { }
-        (r'\.onDisappear\s*\{', 5),                   # .onDisappear { }
-        (r'\.onTapGesture\s*\{', 5),                  # .onTapGesture { }
-        (r'\.gesture\s*\(', 4),                       # .gesture()
-        (r'\.sheet\s*\(', 5),                         # .sheet(isPresented:)
-        (r'\.fullScreenCover\s*\(', 5),               # .fullScreenCover()
-        (r'\.popover\s*\(', 5),                       # .popover()
-        (r'\.alert\s*\(', 4),                         # .alert()
-        (r'\.confirmationDialog\s*\(', 5),            # .confirmationDialog()
-        (r'\.navigationTitle\s*\(', 5),               # .navigationTitle()
-        (r'\.navigationBarTitleDisplayMode', 5),      # .navigationBarTitleDisplayMode
-        (r'\.toolbar\s*\{', 5),                       # .toolbar { }
-        (r'\.toolbarBackground\s*\(', 5),             # .toolbarBackground()
-        (r'\.environmentObject\s*\(', 5),             # .environmentObject()
-        (r'\.environment\s*\(', 4),                   # .environment()
-        (r'\.task\s*\{', 5),                          # .task { } (async)
-        (r'\.refreshable\s*\{', 5),                   # .refreshable { }
-        (r'\.searchable\s*\(', 5),                    # .searchable()
-        (r'\.onChange\s*\(', 5),                      # .onChange(of:)
-        (r'\.onSubmit\s*\{', 5),                      # .onSubmit { }
-        (r'\.focused\s*\(', 5),                       # .focused()
-        (r'\.disabled\s*\(', 4),                      # .disabled()
-        (r'\.opacity\s*\(', 3),                       # .opacity()
-        (r'\.offset\s*\(', 4),                        # .offset()
-        (r'\.rotationEffect\s*\(', 5),                # .rotationEffect()
-        (r'\.scaleEffect\s*\(', 5),                   # .scaleEffect()
-        (r'\.animation\s*\(', 4),                     # .animation()
-        (r'\.transition\s*\(', 5),                    # .transition()
-        (r'\.withAnimation\s*\{', 5),                 # withAnimation { }
-        (r'\.matchedGeometryEffect\s*\(', 5),         # .matchedGeometryEffect()
-        (r'\.contentShape\s*\(', 5),                  # .contentShape()
-        (r'\.allowsHitTesting\s*\(', 5),              # .allowsHitTesting()
-        (r'\.overlay\s*\(', 4),                       # .overlay()
-        (r'\.mask\s*\(', 4),                          # .mask()
-        (r'\.zIndex\s*\(', 4),                        # .zIndex()
-        (r'\.layoutPriority\s*\(', 5),                # .layoutPriority()
-        (r'\.preference\s*\(', 5),                    # .preference()
-        (r'\.onPreferenceChange\s*\(', 5),            # .onPreferenceChange()
-        (r'\.coordinateSpace\s*\(', 5),               # .coordinateSpace()
-        (r'\.ignoresSafeArea\s*\(', 5),               # .ignoresSafeArea()
-        (r'\.safeAreaInset\s*\(', 5),                 # .safeAreaInset()
-        (r'\.listStyle\s*\(', 5),                     # .listStyle()
-        (r'\.buttonStyle\s*\(', 5),                   # .buttonStyle()
-        (r'\.textFieldStyle\s*\(', 5),                # .textFieldStyle()
-        (r'\.pickerStyle\s*\(', 5),                   # .pickerStyle()
-        (r'\.labelStyle\s*\(', 5),                    # .labelStyle()
-        (r'\.toggleStyle\s*\(', 5),                   # .toggleStyle()
-        (r'\.presentationDetents\s*\(', 5),           # .presentationDetents() (iOS 16+)
-        (r'\.interactiveDismissDisabled\s*\(', 5),    # .interactiveDismissDisabled()
-
+        (r"\.padding\s*\(", 4),  # .padding()
+        (r"\.frame\s*\(", 4),  # .frame(width:height:)
+        (r"\.foregroundColor\s*\(", 5),  # .foregroundColor(.red)
+        (r"\.foregroundStyle\s*\(", 5),  # .foregroundStyle (iOS 15+)
+        (r"\.background\s*\(", 3),  # .background()
+        (r"\.cornerRadius\s*\(", 4),  # .cornerRadius()
+        (r"\.clipShape\s*\(", 5),  # .clipShape()
+        (r"\.shadow\s*\(", 3),  # .shadow()
+        (r"\.font\s*\(", 3),  # .font(.title)
+        (r"\.fontWeight\s*\(", 4),  # .fontWeight()
+        (r"\.bold\s*\(\)", 4),  # .bold()
+        (r"\.italic\s*\(\)", 4),  # .italic()
+        (r"\.onAppear\s*\{", 5),  # .onAppear { }
+        (r"\.onDisappear\s*\{", 5),  # .onDisappear { }
+        (r"\.onTapGesture\s*\{", 5),  # .onTapGesture { }
+        (r"\.gesture\s*\(", 4),  # .gesture()
+        (r"\.sheet\s*\(", 5),  # .sheet(isPresented:)
+        (r"\.fullScreenCover\s*\(", 5),  # .fullScreenCover()
+        (r"\.popover\s*\(", 5),  # .popover()
+        (r"\.alert\s*\(", 4),  # .alert()
+        (r"\.confirmationDialog\s*\(", 5),  # .confirmationDialog()
+        (r"\.navigationTitle\s*\(", 5),  # .navigationTitle()
+        (r"\.navigationBarTitleDisplayMode", 5),  # .navigationBarTitleDisplayMode
+        (r"\.toolbar\s*\{", 5),  # .toolbar { }
+        (r"\.toolbarBackground\s*\(", 5),  # .toolbarBackground()
+        (r"\.environmentObject\s*\(", 5),  # .environmentObject()
+        (r"\.environment\s*\(", 4),  # .environment()
+        (r"\.task\s*\{", 5),  # .task { } (async)
+        (r"\.refreshable\s*\{", 5),  # .refreshable { }
+        (r"\.searchable\s*\(", 5),  # .searchable()
+        (r"\.onChange\s*\(", 5),  # .onChange(of:)
+        (r"\.onSubmit\s*\{", 5),  # .onSubmit { }
+        (r"\.focused\s*\(", 5),  # .focused()
+        (r"\.disabled\s*\(", 4),  # .disabled()
+        (r"\.opacity\s*\(", 3),  # .opacity()
+        (r"\.offset\s*\(", 4),  # .offset()
+        (r"\.rotationEffect\s*\(", 5),  # .rotationEffect()
+        (r"\.scaleEffect\s*\(", 5),  # .scaleEffect()
+        (r"\.animation\s*\(", 4),  # .animation()
+        (r"\.transition\s*\(", 5),  # .transition()
+        (r"\.withAnimation\s*\{", 5),  # withAnimation { }
+        (r"\.matchedGeometryEffect\s*\(", 5),  # .matchedGeometryEffect()
+        (r"\.contentShape\s*\(", 5),  # .contentShape()
+        (r"\.allowsHitTesting\s*\(", 5),  # .allowsHitTesting()
+        (r"\.overlay\s*\(", 4),  # .overlay()
+        (r"\.mask\s*\(", 4),  # .mask()
+        (r"\.zIndex\s*\(", 4),  # .zIndex()
+        (r"\.layoutPriority\s*\(", 5),  # .layoutPriority()
+        (r"\.preference\s*\(", 5),  # .preference()
+        (r"\.onPreferenceChange\s*\(", 5),  # .onPreferenceChange()
+        (r"\.coordinateSpace\s*\(", 5),  # .coordinateSpace()
+        (r"\.ignoresSafeArea\s*\(", 5),  # .ignoresSafeArea()
+        (r"\.safeAreaInset\s*\(", 5),  # .safeAreaInset()
+        (r"\.listStyle\s*\(", 5),  # .listStyle()
+        (r"\.buttonStyle\s*\(", 5),  # .buttonStyle()
+        (r"\.textFieldStyle\s*\(", 5),  # .textFieldStyle()
+        (r"\.pickerStyle\s*\(", 5),  # .pickerStyle()
+        (r"\.labelStyle\s*\(", 5),  # .labelStyle()
+        (r"\.toggleStyle\s*\(", 5),  # .toggleStyle()
+        (r"\.presentationDetents\s*\(", 5),  # .presentationDetents() (iOS 16+)
+        (r"\.interactiveDismissDisabled\s*\(", 5),  # .interactiveDismissDisabled()
         # SwiftUI Scene types (macOS/multi-window)
-        (r'\bWindowGroup\s*\{', 5),                   # WindowGroup { }
-        (r'\bWindow\s*\(', 5),                        # Window (macOS)
-        (r'\bSettings\s*\{', 5),                      # Settings { } (macOS)
-        (r'\bMenuBarExtra\s*\(', 5),                  # MenuBarExtra (macOS)
-        (r'\bDocumentGroup\s*\(', 5),                 # DocumentGroup
-        (r':\s*App\s*\{', 5),                         # : App {
-        (r'@main\b', 5),                              # @main
-        (r'var\s+body:\s*some\s+Scene', 5),           # var body: some Scene
-
+        (r"\bWindowGroup\s*\{", 5),  # WindowGroup { }
+        (r"\bWindow\s*\(", 5),  # Window (macOS)
+        (r"\bSettings\s*\{", 5),  # Settings { } (macOS)
+        (r"\bMenuBarExtra\s*\(", 5),  # MenuBarExtra (macOS)
+        (r"\bDocumentGroup\s*\(", 5),  # DocumentGroup
+        (r":\s*App\s*\{", 5),  # : App {
+        (r"@main\b", 5),  # @main
+        (r"var\s+body:\s*some\s+Scene", 5),  # var body: some Scene
         # ===== Combine Framework (Weight 5) =====
-
-        (r'\bimport\s+Combine', 5),                   # import Combine
-        (r'\bAnyPublisher\b', 5),                     # AnyPublisher
-        (r'\bPassthroughSubject\b', 5),               # PassthroughSubject
-        (r'\bCurrentValueSubject\b', 5),              # CurrentValueSubject
-        (r'\bPublisher\b', 4),                        # Publisher protocol
-        (r'\bSubscriber\b', 4),                       # Subscriber protocol
-        (r'\.sink\s*\{', 5),                          # .sink { }
-        (r'\.receive\s*\(on:\s*', 5),                 # .receive(on: RunLoop.main)
-        (r'\bAnyCancellable\b', 5),                   # AnyCancellable
-        (r'\.store\s*\(in:\s*&', 5),                  # .store(in: &cancellables)
-        (r'\.eraseToAnyPublisher\s*\(\)', 5),         # .eraseToAnyPublisher()
-        (r'\.map\s*\{\s*\$0', 5),                     # .map { $0 (Combine map)
-        (r'\.flatMap\s*\{', 4),                       # .flatMap {
-        (r'\.compactMap\s*\{', 4),                    # .compactMap {
-        (r'\.filter\s*\{', 3),                        # .filter {
-        (r'\.debounce\s*\(', 5),                      # .debounce()
-        (r'\.throttle\s*\(', 5),                      # .throttle()
-        (r'\.removeDuplicates\s*\(', 5),              # .removeDuplicates()
-        (r'\.combineLatest\s*\(', 5),                 # .combineLatest()
-        (r'\.merge\s*\(', 4),                         # .merge()
-        (r'\.zip\s*\(', 3),                           # .zip()
-        (r'@Published\s+var', 5),                     # @Published var
-
+        (r"\bimport\s+Combine", 5),  # import Combine
+        (r"\bAnyPublisher\b", 5),  # AnyPublisher
+        (r"\bPassthroughSubject\b", 5),  # PassthroughSubject
+        (r"\bCurrentValueSubject\b", 5),  # CurrentValueSubject
+        (r"\bPublisher\b", 4),  # Publisher protocol
+        (r"\bSubscriber\b", 4),  # Subscriber protocol
+        (r"\.sink\s*\{", 5),  # .sink { }
+        (r"\.receive\s*\(on:\s*", 5),  # .receive(on: RunLoop.main)
+        (r"\bAnyCancellable\b", 5),  # AnyCancellable
+        (r"\.store\s*\(in:\s*&", 5),  # .store(in: &cancellables)
+        (r"\.eraseToAnyPublisher\s*\(\)", 5),  # .eraseToAnyPublisher()
+        (r"\.map\s*\{\s*\$0", 5),  # .map { $0 (Combine map)
+        (r"\.flatMap\s*\{", 4),  # .flatMap {
+        (r"\.compactMap\s*\{", 4),  # .compactMap {
+        (r"\.filter\s*\{", 3),  # .filter {
+        (r"\.debounce\s*\(", 5),  # .debounce()
+        (r"\.throttle\s*\(", 5),  # .throttle()
+        (r"\.removeDuplicates\s*\(", 5),  # .removeDuplicates()
+        (r"\.combineLatest\s*\(", 5),  # .combineLatest()
+        (r"\.merge\s*\(", 4),  # .merge()
+        (r"\.zip\s*\(", 3),  # .zip()
+        (r"@Published\s+var", 5),  # @Published var
         # ===== Codable/JSON (Weight 5) =====
-
-        (r'\bCodable\b', 5),                          # Codable protocol
-        (r'\bEncodable\b', 4),                        # Encodable protocol
-        (r'\bDecodable\b', 4),                        # Decodable protocol
-        (r'\bJSONDecoder\s*\(\)', 5),                 # JSONDecoder()
-        (r'\bJSONEncoder\s*\(\)', 5),                 # JSONEncoder()
-        (r'\bCodingKeys\b', 5),                       # CodingKeys enum
-        (r'\bPropertyListDecoder\b', 5),              # PropertyListDecoder
-        (r'\bPropertyListEncoder\b', 5),              # PropertyListEncoder
-
+        (r"\bCodable\b", 5),  # Codable protocol
+        (r"\bEncodable\b", 4),  # Encodable protocol
+        (r"\bDecodable\b", 4),  # Decodable protocol
+        (r"\bJSONDecoder\s*\(\)", 5),  # JSONDecoder()
+        (r"\bJSONEncoder\s*\(\)", 5),  # JSONEncoder()
+        (r"\bCodingKeys\b", 5),  # CodingKeys enum
+        (r"\bPropertyListDecoder\b", 5),  # PropertyListDecoder
+        (r"\bPropertyListEncoder\b", 5),  # PropertyListEncoder
         # ===== Core Data (Weight 5) =====
-
-        (r'\bimport\s+CoreData', 5),                  # import CoreData
-        (r'\bNSManagedObject\b', 5),                  # NSManagedObject
-        (r'\bNSManagedObjectContext\b', 5),           # NSManagedObjectContext
-        (r'\bNSPersistentContainer\b', 5),            # NSPersistentContainer
-        (r'\bNSFetchRequest\b', 5),                   # NSFetchRequest
-        (r'\b@FetchRequest\b', 5),                    # @FetchRequest property wrapper
-        (r'\bNSPredicate\b', 5),                      # NSPredicate
-        (r'\bNSSortDescriptor\b', 5),                 # NSSortDescriptor
-
+        (r"\bimport\s+CoreData", 5),  # import CoreData
+        (r"\bNSManagedObject\b", 5),  # NSManagedObject
+        (r"\bNSManagedObjectContext\b", 5),  # NSManagedObjectContext
+        (r"\bNSPersistentContainer\b", 5),  # NSPersistentContainer
+        (r"\bNSFetchRequest\b", 5),  # NSFetchRequest
+        (r"\b@FetchRequest\b", 5),  # @FetchRequest property wrapper
+        (r"\bNSPredicate\b", 5),  # NSPredicate
+        (r"\bNSSortDescriptor\b", 5),  # NSSortDescriptor
         # ===== SwiftData (Weight 5 - iOS 17+) =====
-
-        (r'\bimport\s+SwiftData', 5),                 # import SwiftData
-        (r'@Model\s+', 5),                            # @Model class
-        (r'@Attribute\s*\(', 5),                      # @Attribute
-        (r'@Relationship\s*\(', 5),                   # @Relationship
-        (r'\bModelContext\b', 5),                     # ModelContext
-        (r'\bModelContainer\b', 5),                   # ModelContainer
-
+        (r"\bimport\s+SwiftData", 5),  # import SwiftData
+        (r"@Model\s+", 5),  # @Model class
+        (r"@Attribute\s*\(", 5),  # @Attribute
+        (r"@Relationship\s*\(", 5),  # @Relationship
+        (r"\bModelContext\b", 5),  # ModelContext
+        (r"\bModelContainer\b", 5),  # ModelContainer
         # ===== Common Apple Frameworks (Weight 4-5) =====
-
-        (r'\bimport\s+MapKit', 5),                    # import MapKit
-        (r'\bimport\s+CoreLocation', 5),              # import CoreLocation
-        (r'\bimport\s+AVFoundation', 5),              # import AVFoundation
-        (r'\bimport\s+Photos', 5),                    # import Photos
-        (r'\bimport\s+PhotosUI', 5),                  # import PhotosUI
-        (r'\bimport\s+HealthKit', 5),                 # import HealthKit
-        (r'\bimport\s+StoreKit', 5),                  # import StoreKit
-        (r'\bimport\s+CloudKit', 5),                  # import CloudKit
-        (r'\bimport\s+UserNotifications', 5),         # import UserNotifications
-        (r'\bimport\s+EventKit', 5),                  # import EventKit
-        (r'\bimport\s+Contacts', 5),                  # import Contacts
-        (r'\bimport\s+MessageUI', 5),                 # import MessageUI
-        (r'\bimport\s+SafariServices', 5),            # import SafariServices
-        (r'\bimport\s+WebKit', 5),                    # import WebKit
-        (r'\bimport\s+PDFKit', 5),                    # import PDFKit
-        (r'\bimport\s+QuickLook', 5),                 # import QuickLook
-        (r'\bimport\s+AuthenticationServices', 5),    # import AuthenticationServices
-        (r'\bimport\s+LocalAuthentication', 5),       # import LocalAuthentication
-        (r'\bimport\s+GameKit', 5),                   # import GameKit
-        (r'\bimport\s+SpriteKit', 5),                 # import SpriteKit
-        (r'\bimport\s+SceneKit', 5),                  # import SceneKit
-        (r'\bimport\s+RealityKit', 5),                # import RealityKit
-        (r'\bimport\s+ARKit', 5),                     # import ARKit
-        (r'\bimport\s+Metal', 5),                     # import Metal
-        (r'\bimport\s+CoreML', 5),                    # import CoreML
-        (r'\bimport\s+Vision', 5),                    # import Vision
-        (r'\bimport\s+NaturalLanguage', 5),           # import NaturalLanguage
-        (r'\bimport\s+Speech', 5),                    # import Speech
-        (r'\bimport\s+CoreBluetooth', 5),             # import CoreBluetooth
-        (r'\bimport\s+NetworkExtension', 5),          # import NetworkExtension
-        (r'\bimport\s+WidgetKit', 5),                 # import WidgetKit
-        (r'\bimport\s+ActivityKit', 5),               # import ActivityKit
-        (r'\bimport\s+AppIntents', 5),                # import AppIntents
-
+        (r"\bimport\s+MapKit", 5),  # import MapKit
+        (r"\bimport\s+CoreLocation", 5),  # import CoreLocation
+        (r"\bimport\s+AVFoundation", 5),  # import AVFoundation
+        (r"\bimport\s+Photos", 5),  # import Photos
+        (r"\bimport\s+PhotosUI", 5),  # import PhotosUI
+        (r"\bimport\s+HealthKit", 5),  # import HealthKit
+        (r"\bimport\s+StoreKit", 5),  # import StoreKit
+        (r"\bimport\s+CloudKit", 5),  # import CloudKit
+        (r"\bimport\s+UserNotifications", 5),  # import UserNotifications
+        (r"\bimport\s+EventKit", 5),  # import EventKit
+        (r"\bimport\s+Contacts", 5),  # import Contacts
+        (r"\bimport\s+MessageUI", 5),  # import MessageUI
+        (r"\bimport\s+SafariServices", 5),  # import SafariServices
+        (r"\bimport\s+WebKit", 5),  # import WebKit
+        (r"\bimport\s+PDFKit", 5),  # import PDFKit
+        (r"\bimport\s+QuickLook", 5),  # import QuickLook
+        (r"\bimport\s+AuthenticationServices", 5),  # import AuthenticationServices
+        (r"\bimport\s+LocalAuthentication", 5),  # import LocalAuthentication
+        (r"\bimport\s+GameKit", 5),  # import GameKit
+        (r"\bimport\s+SpriteKit", 5),  # import SpriteKit
+        (r"\bimport\s+SceneKit", 5),  # import SceneKit
+        (r"\bimport\s+RealityKit", 5),  # import RealityKit
+        (r"\bimport\s+ARKit", 5),  # import ARKit
+        (r"\bimport\s+Metal", 5),  # import Metal
+        (r"\bimport\s+CoreML", 5),  # import CoreML
+        (r"\bimport\s+Vision", 5),  # import Vision
+        (r"\bimport\s+NaturalLanguage", 5),  # import NaturalLanguage
+        (r"\bimport\s+Speech", 5),  # import Speech
+        (r"\bimport\s+CoreBluetooth", 5),  # import CoreBluetooth
+        (r"\bimport\s+NetworkExtension", 5),  # import NetworkExtension
+        (r"\bimport\s+WidgetKit", 5),  # import WidgetKit
+        (r"\bimport\s+ActivityKit", 5),  # import ActivityKit
+        (r"\bimport\s+AppIntents", 5),  # import AppIntents
         # ===== Foundation Models Framework (iOS/macOS/visionOS 26+) =====
         # Apple's on-device AI/ML framework for language model interactions
-
         # Import statement
-        (r'\bimport\s+FoundationModels', 5),          # import FoundationModels
-
+        (r"\bimport\s+FoundationModels", 5),  # import FoundationModels
         # Core classes
-        (r'\bSystemLanguageModel\b', 5),              # Main model class
-        (r'\bLanguageModelSession\b', 5),             # Session for interactions
-        (r'\bLanguageModelFeedback\b', 5),            # Feedback reporting
-
+        (r"\bSystemLanguageModel\b", 5),  # Main model class
+        (r"\bLanguageModelSession\b", 5),  # Session for interactions
+        (r"\bLanguageModelFeedback\b", 5),  # Feedback reporting
         # Key structs
-        (r'\bInstructionsBuilder\b', 5),              # Result builder for instructions
-        (r'\bPromptBuilder\b', 5),                    # Result builder for prompts
-        (r'\bGenerationOptions\b', 5),                # Controls generation behavior
-        (r'\bGeneratedContent\b', 5),                 # Structured output type
-        (r'\bGenerationID\b', 5),                     # Unique generation identifier
-        (r'\bGenerationSchema\b', 5),                 # Schema for guided generation
-        (r'\bDynamicGenerationSchema\b', 5),          # Runtime schema definition
-        (r'\bGenerationGuide\b', 5),                  # Value constraint guides
-
+        (r"\bInstructionsBuilder\b", 5),  # Result builder for instructions
+        (r"\bPromptBuilder\b", 5),  # Result builder for prompts
+        (r"\bGenerationOptions\b", 5),  # Controls generation behavior
+        (r"\bGeneratedContent\b", 5),  # Structured output type
+        (r"\bGenerationID\b", 5),  # Unique generation identifier
+        (r"\bGenerationSchema\b", 5),  # Schema for guided generation
+        (r"\bDynamicGenerationSchema\b", 5),  # Runtime schema definition
+        (r"\bGenerationGuide\b", 5),  # Value constraint guides
         # Macros (unique to FoundationModels)
-        (r'@Generable\b', 5),                         # Guided generation macro
-        (r'@Generable\s*\(\s*description:', 5),       # @Generable with description
-        (r'@Guide\b', 5),                             # Property constraint macro
-        (r'@Guide\s*\(\s*description:', 5),           # @Guide with description
-
+        (r"@Generable\b", 5),  # Guided generation macro
+        (r"@Generable\s*\(\s*description:", 5),  # @Generable with description
+        (r"@Guide\b", 5),  # Property constraint macro
+        (r"@Guide\s*\(\s*description:", 5),  # @Guide with description
         # Key protocols
-        (r'\bGenerable\b', 4),                        # Core protocol (also common word)
-        (r'\bInstructionsRepresentable\b', 5),        # Instructions protocol
-        (r'\bPromptRepresentable\b', 5),              # Prompt protocol
-        (r'\bConvertibleFromGeneratedContent\b', 5),  # Content conversion
-        (r'\bConvertibleToGeneratedContent\b', 5),    # Content conversion
-
+        (r"\bGenerable\b", 4),  # Core protocol (also common word)
+        (r"\bInstructionsRepresentable\b", 5),  # Instructions protocol
+        (r"\bPromptRepresentable\b", 5),  # Prompt protocol
+        (r"\bConvertibleFromGeneratedContent\b", 5),  # Content conversion
+        (r"\bConvertibleToGeneratedContent\b", 5),  # Content conversion
         # Nested types (SystemLanguageModel.*)
-        (r'\bSystemLanguageModel\.default\b', 5),     # Default model access
-        (r'\bSystemLanguageModel\.UseCase\b', 5),     # Use case type
-        (r'\bSystemLanguageModel\.Guardrails\b', 5),  # Safety guardrails
-        (r'\bSystemLanguageModel\.Adapter\b', 5),     # Custom adapters
-        (r'\bSystemLanguageModel\.Availability\b', 5), # Availability enum
-
+        (r"\bSystemLanguageModel\.default\b", 5),  # Default model access
+        (r"\bSystemLanguageModel\.UseCase\b", 5),  # Use case type
+        (r"\bSystemLanguageModel\.Guardrails\b", 5),  # Safety guardrails
+        (r"\bSystemLanguageModel\.Adapter\b", 5),  # Custom adapters
+        (r"\bSystemLanguageModel\.Availability\b", 5),  # Availability enum
         # Key methods
-        (r'\.respond\s*\(to:', 4),                    # Primary response method
-        (r'\.respond\s*\([^)]*generating:', 5),       # Guided generation response
-        (r'\.streamResponse\s*\(', 4),                # Streaming response
-        (r'\.prewarm\s*\(', 5),                       # Session prewarming
-        (r'\.logFeedbackAttachment\s*\(', 5),         # Feedback logging
-
+        (r"\.respond\s*\(to:", 4),  # Primary response method
+        (r"\.respond\s*\([^)]*generating:", 5),  # Guided generation response
+        (r"\.streamResponse\s*\(", 4),  # Streaming response
+        (r"\.prewarm\s*\(", 5),  # Session prewarming
+        (r"\.logFeedbackAttachment\s*\(", 5),  # Feedback logging
         # Transcript types
-        (r'\bTranscript\.Entry\b', 5),                # Transcript entry
-        (r'\bTranscript\.Segment\b', 5),              # Transcript segment
-        (r'\bTranscript\.ToolCall\b', 5),             # Tool call record
-        (r'\bTranscript\.ToolOutput\b', 5),           # Tool output record
-        (r'\bTranscript\.Response\b', 5),             # Response record
-
+        (r"\bTranscript\.Entry\b", 5),  # Transcript entry
+        (r"\bTranscript\.Segment\b", 5),  # Transcript segment
+        (r"\bTranscript\.ToolCall\b", 5),  # Tool call record
+        (r"\bTranscript\.ToolOutput\b", 5),  # Tool output record
+        (r"\bTranscript\.Response\b", 5),  # Response record
         # Error types and availability
-        (r'\bGenerationError\b', 4),                  # Generation error type
-        (r'\bToolCallError\b', 5),                    # Tool execution error
-        (r'\.exceededContextWindowSize\b', 5),        # Context window error
-        (r'\.guardrailViolation\b', 5),               # Safety guardrail error
-        (r'\.appleIntelligenceNotEnabled\b', 5),      # Availability reason
-        (r'\.deviceNotEligible\b', 5),                # Device eligibility
-        (r'\.modelNotReady\b', 5),                    # Model readiness
-
+        (r"\bGenerationError\b", 4),  # Generation error type
+        (r"\bToolCallError\b", 5),  # Tool execution error
+        (r"\.exceededContextWindowSize\b", 5),  # Context window error
+        (r"\.guardrailViolation\b", 5),  # Safety guardrail error
+        (r"\.appleIntelligenceNotEnabled\b", 5),  # Availability reason
+        (r"\.deviceNotEligible\b", 5),  # Device eligibility
+        (r"\.modelNotReady\b", 5),  # Model readiness
         # Use cases and guardrails
-        (r'\.contentTagging\b', 5),                   # Content tagging use case
-        (r'\.permissiveContentTransformations\b', 5), # Guardrail setting
-
+        (r"\.contentTagging\b", 5),  # Content tagging use case
+        (r"\.permissiveContentTransformations\b", 5),  # Guardrail setting
         # Common usage patterns
-        (r'LanguageModelSession\s*\(\s*instructions:', 5),  # Session init
-        (r'for\s+try\s+await.*streamResponse', 5),    # Streaming iteration
-        (r'\.PartiallyGenerated\b', 5),               # Partial generation type
+        (r"LanguageModelSession\s*\(\s*instructions:", 5),  # Session init
+        (r"for\s+try\s+await.*streamResponse", 5),  # Streaming iteration
+        (r"\.PartiallyGenerated\b", 5),  # Partial generation type
     ],
 }
 
 
-def _validate_patterns(patterns: Dict[str, List[Tuple[str, int]]]) -> None:
+def _validate_patterns(patterns: dict[str, list[tuple[str, int]]]) -> None:
     """
     Validate pattern structure at module load time.
 
@@ -594,18 +535,12 @@ def _validate_patterns(patterns: Dict[str, List[Tuple[str, int]]]) -> None:
     for lang, pattern_list in patterns.items():
         for i, item in enumerate(pattern_list):
             if not isinstance(item, tuple) or len(item) != 2:
-                raise ValueError(
-                    f"Pattern {i} for '{lang}' is not a (regex, weight) tuple: {item}"
-                )
+                raise ValueError(f"Pattern {i} for '{lang}' is not a (regex, weight) tuple: {item}")
             pattern, weight = item
             if not isinstance(pattern, str):
-                raise ValueError(
-                    f"Pattern {i} for '{lang}': regex must be a string, got {type(pattern).__name__}"
-                )
+                raise ValueError(f"Pattern {i} for '{lang}': regex must be a string, got {type(pattern).__name__}")
             if not isinstance(weight, int) or weight < 1 or weight > 5:
-                raise ValueError(
-                    f"Pattern {i} for '{lang}': weight must be int 1-5, got {weight!r}"
-                )
+                raise ValueError(f"Pattern {i} for '{lang}': weight must be int 1-5, got {weight!r}")
 
 
 # Validate patterns at module load time
@@ -615,7 +550,7 @@ except ValueError as e:
     logger.error(
         "Swift pattern validation failed: %s. Swift detection will be disabled. "
         "This indicates a bug in swift_patterns.py - please file an issue.",
-        e
+        e,
     )
     # Clear patterns to prevent broken detection with invalid data
     SWIFT_PATTERNS = {}
diff --git a/src/skill_seekers/cli/test_example_extractor.py b/src/skill_seekers/cli/test_example_extractor.py
index 2fd7efa..7c40bd4 100644
--- a/src/skill_seekers/cli/test_example_extractor.py
+++ b/src/skill_seekers/cli/test_example_extractor.py
@@ -27,19 +27,18 @@ Example usage:
     python test_example_extractor.py tests/ --min-confidence 0.7
 """
 
-from dataclasses import dataclass, field, asdict
-from typing import List, Dict, Optional, Literal, Set
-from pathlib import Path
-import ast
-import re
-import hashlib
-import logging
 import argparse
+import ast
+import hashlib
 import json
-import sys
+import logging
+import re
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+from typing import Literal
 
 # Configure logging
-logging.basicConfig(level=logging.INFO, format='%(levelname)s: %(message)s')
+logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
 logger = logging.getLogger(__name__)
 
 
@@ -47,22 +46,23 @@ logger = logging.getLogger(__name__)
 # DATA MODELS
 # ============================================================================
 
+
 @dataclass
 class TestExample:
     """Single extracted usage example from test code"""
 
     # Identity
-    example_id: str          # Unique hash of example
-    test_name: str           # Test function/method name
+    example_id: str  # Unique hash of example
+    test_name: str  # Test function/method name
     category: Literal["instantiation", "method_call", "config", "setup", "workflow"]
 
     # Code
-    code: str                # Actual example code
-    language: str            # Programming language
+    code: str  # Actual example code
+    language: str  # Programming language
 
     # Context
-    description: str         # What this demonstrates
-    expected_behavior: str   # Expected outcome from assertions
+    description: str  # What this demonstrates
+    expected_behavior: str  # Expected outcome from assertions
 
     # Source
     file_path: str
@@ -71,13 +71,13 @@ class TestExample:
 
     # Quality
     complexity_score: float  # 0-1 scale (higher = more complex/valuable)
-    confidence: float        # 0-1 scale (higher = more confident extraction)
+    confidence: float  # 0-1 scale (higher = more confident extraction)
 
     # Optional fields (must come after required fields)
-    setup_code: Optional[str] = None  # Required setup code
-    tags: List[str] = field(default_factory=list)  # ["pytest", "mock", "async"]
-    dependencies: List[str] = field(default_factory=list)  # Imported modules
-    ai_analysis: Optional[Dict] = None  # AI-generated analysis (C3.6)
+    setup_code: str | None = None  # Required setup code
+    tags: list[str] = field(default_factory=list)  # ["pytest", "mock", "async"]
+    dependencies: list[str] = field(default_factory=list)  # Imported modules
+    ai_analysis: dict | None = None  # AI-generated analysis (C3.6)
 
     def to_dict(self) -> dict:
         """Convert to dictionary for JSON serialization"""
@@ -96,12 +96,12 @@ class TestExample:
 
         # Add AI analysis if available (C3.6)
         if self.ai_analysis:
-            md += f"\n**🤖 AI Analysis:**  \n"
-            if self.ai_analysis.get('explanation'):
+            md += "\n**🤖 AI Analysis:**  \n"
+            if self.ai_analysis.get("explanation"):
                 md += f"*{self.ai_analysis['explanation']}*  \n"
-            if self.ai_analysis.get('best_practices'):
+            if self.ai_analysis.get("best_practices"):
                 md += f"**Best Practices:** {', '.join(self.ai_analysis['best_practices'])}  \n"
-            if self.ai_analysis.get('tutorial_group'):
+            if self.ai_analysis.get("tutorial_group"):
                 md += f"**Tutorial Group:** {self.ai_analysis['tutorial_group']}  \n"
 
         md += f"\n```{self.language.lower()}\n"
@@ -117,13 +117,13 @@ class ExampleReport:
     """Summary of test example extraction results"""
 
     total_examples: int
-    examples_by_category: Dict[str, int]
-    examples_by_language: Dict[str, int]
-    examples: List[TestExample]
+    examples_by_category: dict[str, int]
+    examples_by_language: dict[str, int]
+    examples: list[TestExample]
     avg_complexity: float
     high_value_count: int  # confidence > 0.7
-    file_path: Optional[str] = None  # If single file
-    directory: Optional[str] = None  # If directory
+    file_path: str | None = None  # If single file
+    directory: str | None = None  # If directory
 
     def to_dict(self) -> dict:
         """Convert to dictionary for JSON serialization"""
@@ -135,7 +135,7 @@ class ExampleReport:
             "high_value_count": self.high_value_count,
             "file_path": self.file_path,
             "directory": self.directory,
-            "examples": [ex.to_dict() for ex in self.examples]
+            "examples": [ex.to_dict() for ex in self.examples],
         }
 
     def to_markdown(self) -> str:
@@ -164,19 +164,20 @@ class ExampleReport:
 # PYTHON TEST ANALYZER (AST-based)
 # ============================================================================
 
+
 class PythonTestAnalyzer:
     """Deep AST-based test example extraction for Python"""
 
     def __init__(self):
         self.trivial_patterns = {
-            'assertTrue(True)',
-            'assertFalse(False)',
-            'assertEqual(1, 1)',
-            'assertIsNone(None)',
-            'assertIsNotNone(None)',
+            "assertTrue(True)",
+            "assertFalse(False)",
+            "assertEqual(1, 1)",
+            "assertIsNone(None)",
+            "assertIsNotNone(None)",
         }
 
-    def extract(self, file_path: str, code: str) -> List[TestExample]:
+    def extract(self, file_path: str, code: str) -> list[TestExample]:
         """Extract examples from Python test file"""
         examples = []
 
@@ -193,20 +194,16 @@ class PythonTestAnalyzer:
         for node in ast.walk(tree):
             if isinstance(node, ast.ClassDef):
                 if self._is_test_class(node):
-                    examples.extend(self._extract_from_test_class(
-                        node, file_path, imports
-                    ))
+                    examples.extend(self._extract_from_test_class(node, file_path, imports))
 
             # Find test functions (pytest)
             elif isinstance(node, ast.FunctionDef):
                 if self._is_test_function(node):
-                    examples.extend(self._extract_from_test_function(
-                        node, file_path, imports
-                    ))
+                    examples.extend(self._extract_from_test_function(node, file_path, imports))
 
         return examples
 
-    def _extract_imports(self, tree: ast.AST) -> List[str]:
+    def _extract_imports(self, tree: ast.AST) -> list[str]:
         """Extract imported modules"""
         imports = []
         for node in ast.walk(tree):
@@ -221,30 +218,30 @@ class PythonTestAnalyzer:
         """Check if class is a test class"""
         # unittest.TestCase pattern
         for base in node.bases:
-            if isinstance(base, ast.Name) and 'Test' in base.id:
-                return True
-            elif isinstance(base, ast.Attribute) and base.attr == 'TestCase':
+            if (
+                isinstance(base, ast.Name)
+                and "Test" in base.id
+                or isinstance(base, ast.Attribute)
+                and base.attr == "TestCase"
+            ):
                 return True
         return False
 
     def _is_test_function(self, node: ast.FunctionDef) -> bool:
         """Check if function is a test function"""
         # pytest pattern: starts with test_
-        if node.name.startswith('test_'):
+        if node.name.startswith("test_"):
             return True
         # Has @pytest.mark decorator
         for decorator in node.decorator_list:
             if isinstance(decorator, ast.Attribute):
-                if 'pytest' in ast.unparse(decorator):
+                if "pytest" in ast.unparse(decorator):
                     return True
         return False
 
     def _extract_from_test_class(
-        self,
-        class_node: ast.ClassDef,
-        file_path: str,
-        imports: List[str]
-    ) -> List[TestExample]:
+        self, class_node: ast.ClassDef, file_path: str, imports: list[str]
+    ) -> list[TestExample]:
         """Extract examples from unittest.TestCase class"""
         examples = []
 
@@ -253,63 +250,46 @@ class PythonTestAnalyzer:
 
         # Process each test method
         for node in class_node.body:
-            if isinstance(node, ast.FunctionDef) and node.name.startswith('test_'):
-                examples.extend(self._analyze_test_body(
-                    node,
-                    file_path,
-                    imports,
-                    setup_code=setup_code
-                ))
+            if isinstance(node, ast.FunctionDef) and node.name.startswith("test_"):
+                examples.extend(self._analyze_test_body(node, file_path, imports, setup_code=setup_code))
 
         return examples
 
     def _extract_from_test_function(
-        self,
-        func_node: ast.FunctionDef,
-        file_path: str,
-        imports: List[str]
-    ) -> List[TestExample]:
+        self, func_node: ast.FunctionDef, file_path: str, imports: list[str]
+    ) -> list[TestExample]:
         """Extract examples from pytest test function"""
         # Check for fixture parameters
         fixture_setup = self._extract_fixtures(func_node)
 
-        return self._analyze_test_body(
-            func_node,
-            file_path,
-            imports,
-            setup_code=fixture_setup
-        )
+        return self._analyze_test_body(func_node, file_path, imports, setup_code=fixture_setup)
 
-    def _extract_setup_method(self, class_node: ast.ClassDef) -> Optional[str]:
+    def _extract_setup_method(self, class_node: ast.ClassDef) -> str | None:
         """Extract setUp method code"""
         for node in class_node.body:
-            if isinstance(node, ast.FunctionDef) and node.name == 'setUp':
+            if isinstance(node, ast.FunctionDef) and node.name == "setUp":
                 return ast.unparse(node.body)
         return None
 
-    def _extract_fixtures(self, func_node: ast.FunctionDef) -> Optional[str]:
+    def _extract_fixtures(self, func_node: ast.FunctionDef) -> str | None:
         """Extract pytest fixture parameters"""
         if not func_node.args.args:
             return None
 
         # Skip 'self' parameter
-        params = [arg.arg for arg in func_node.args.args if arg.arg != 'self']
+        params = [arg.arg for arg in func_node.args.args if arg.arg != "self"]
         if params:
             return f"# Fixtures: {', '.join(params)}"
         return None
 
     def _analyze_test_body(
-        self,
-        func_node: ast.FunctionDef,
-        file_path: str,
-        imports: List[str],
-        setup_code: Optional[str] = None
-    ) -> List[TestExample]:
+        self, func_node: ast.FunctionDef, file_path: str, imports: list[str], setup_code: str | None = None
+    ) -> list[TestExample]:
         """Analyze test function body for extractable patterns"""
         examples = []
 
         # Get docstring for description
-        docstring = ast.get_docstring(func_node) or func_node.name.replace('_', ' ')
+        docstring = ast.get_docstring(func_node) or func_node.name.replace("_", " ")
 
         # Detect tags
         tags = self._detect_tags(func_node, imports)
@@ -321,7 +301,9 @@ class PythonTestAnalyzer:
         examples.extend(instantiations)
 
         # 2. Method calls with assertions
-        method_calls = self._find_method_calls_with_assertions(func_node, file_path, docstring, setup_code, tags, imports)
+        method_calls = self._find_method_calls_with_assertions(
+            func_node, file_path, docstring, setup_code, tags, imports
+        )
         examples.extend(method_calls)
 
         # 3. Configuration dictionaries
@@ -334,28 +316,28 @@ class PythonTestAnalyzer:
 
         return examples
 
-    def _detect_tags(self, func_node: ast.FunctionDef, imports: List[str]) -> List[str]:
+    def _detect_tags(self, func_node: ast.FunctionDef, imports: list[str]) -> list[str]:
         """Detect test tags (pytest, mock, async, etc.)"""
         tags = []
 
         # Check decorators
         for decorator in func_node.decorator_list:
             decorator_str = ast.unparse(decorator).lower()
-            if 'pytest' in decorator_str:
-                tags.append('pytest')
-            if 'mock' in decorator_str:
-                tags.append('mock')
-            if 'async' in decorator_str or func_node.name.startswith('test_async'):
-                tags.append('async')
+            if "pytest" in decorator_str:
+                tags.append("pytest")
+            if "mock" in decorator_str:
+                tags.append("mock")
+            if "async" in decorator_str or func_node.name.startswith("test_async"):
+                tags.append("async")
 
         # Check if using unittest
-        if 'unittest' in imports:
-            tags.append('unittest')
+        if "unittest" in imports:
+            tags.append("unittest")
 
         # Check function body for mock usage
         func_str = ast.unparse(func_node).lower()
-        if 'mock' in func_str or 'patch' in func_str:
-            tags.append('mock')
+        if "mock" in func_str or "patch" in func_str:
+            tags.append("mock")
 
         return list(set(tags))
 
@@ -364,10 +346,10 @@ class PythonTestAnalyzer:
         func_node: ast.FunctionDef,
         file_path: str,
         description: str,
-        setup_code: Optional[str],
-        tags: List[str],
-        imports: List[str]
-    ) -> List[TestExample]:
+        setup_code: str | None,
+        tags: list[str],
+        imports: list[str],
+    ) -> list[TestExample]:
         """Find object instantiation patterns: obj = ClassName(...)"""
         examples = []
 
@@ -379,7 +361,7 @@ class PythonTestAnalyzer:
                         code = ast.unparse(node)
 
                         # Skip trivial or mock-only
-                        if len(code) < 20 or 'Mock()' in code:
+                        if len(code) < 20 or "Mock()" in code:
                             continue
 
                         # Get class name
@@ -400,7 +382,7 @@ class PythonTestAnalyzer:
                             complexity_score=self._calculate_complexity(code),
                             confidence=0.8,
                             tags=tags,
-                            dependencies=imports
+                            dependencies=imports,
                         )
                         examples.append(example)
 
@@ -411,10 +393,10 @@ class PythonTestAnalyzer:
         func_node: ast.FunctionDef,
         file_path: str,
         description: str,
-        setup_code: Optional[str],
-        tags: List[str],
-        imports: List[str]
-    ) -> List[TestExample]:
+        setup_code: str | None,
+        tags: list[str],
+        imports: list[str],
+    ) -> list[TestExample]:
         """Find method calls followed by assertions"""
         examples = []
 
@@ -450,7 +432,7 @@ class PythonTestAnalyzer:
                             complexity_score=self._calculate_complexity(code),
                             confidence=0.85,
                             tags=tags,
-                            dependencies=imports
+                            dependencies=imports,
                         )
                         examples.append(example)
 
@@ -461,10 +443,10 @@ class PythonTestAnalyzer:
         func_node: ast.FunctionDef,
         file_path: str,
         description: str,
-        setup_code: Optional[str],
-        tags: List[str],
-        imports: List[str]
-    ) -> List[TestExample]:
+        setup_code: str | None,
+        tags: list[str],
+        imports: list[str],
+    ) -> list[TestExample]:
         """Find configuration dictionary patterns"""
         examples = []
 
@@ -491,7 +473,7 @@ class PythonTestAnalyzer:
                             complexity_score=self._calculate_complexity(code),
                             confidence=0.75,
                             tags=tags,
-                            dependencies=imports
+                            dependencies=imports,
                         )
                         examples.append(example)
 
@@ -502,10 +484,10 @@ class PythonTestAnalyzer:
         func_node: ast.FunctionDef,
         file_path: str,
         description: str,
-        setup_code: Optional[str],
-        tags: List[str],
-        imports: List[str]
-    ) -> List[TestExample]:
+        setup_code: str | None,
+        tags: list[str],
+        imports: list[str],
+    ) -> list[TestExample]:
         """Find multi-step workflow patterns (integration tests)"""
         examples = []
 
@@ -515,7 +497,7 @@ class PythonTestAnalyzer:
             code = ast.unparse(func_node.body)
 
             # Skip if too long (> 30 lines)
-            if code.count('\n') > 30:
+            if code.count("\n") > 30:
                 return examples
 
             example = TestExample(
@@ -532,8 +514,8 @@ class PythonTestAnalyzer:
                 line_end=func_node.end_lineno or func_node.lineno,
                 complexity_score=min(1.0, len(func_node.body) / 10),
                 confidence=0.9,
-                tags=tags + ['workflow', 'integration'],
-                dependencies=imports
+                tags=tags + ["workflow", "integration"],
+                dependencies=imports,
             )
             examples.append(example)
 
@@ -568,7 +550,7 @@ class PythonTestAnalyzer:
 
         if isinstance(node, ast.Expr) and isinstance(node.value, ast.Call):
             call_str = ast.unparse(node.value).lower()
-            assertion_methods = ['assert', 'expect', 'should']
+            assertion_methods = ["assert", "expect", "should"]
             return any(method in call_str for method in assertion_methods)
 
         return False
@@ -584,7 +566,7 @@ class PythonTestAnalyzer:
     def _is_integration_test(self, func_node: ast.FunctionDef) -> bool:
         """Check if test looks like an integration test"""
         test_name = func_node.name.lower()
-        integration_keywords = ['workflow', 'integration', 'end_to_end', 'e2e', 'full']
+        integration_keywords = ["workflow", "integration", "end_to_end", "e2e", "full"]
         return any(keyword in test_name for keyword in integration_keywords)
 
     def _extract_assertion_after(self, func_node: ast.FunctionDef, target_node: ast.AST) -> str:
@@ -608,8 +590,8 @@ class PythonTestAnalyzer:
     def _calculate_complexity(self, code: str) -> float:
         """Calculate code complexity score (0-1)"""
         # Simple heuristic: more lines + more parameters = more complex
-        lines = code.count('\n') + 1
-        params = code.count(',') + 1
+        lines = code.count("\n") + 1
+        params = code.count(",") + 1
 
         complexity = min(1.0, (lines * 0.1) + (params * 0.05))
         return round(complexity, 2)
@@ -623,57 +605,58 @@ class PythonTestAnalyzer:
 # GENERIC TEST ANALYZER (Regex-based for non-Python languages)
 # ============================================================================
 
+
 class GenericTestAnalyzer:
     """Regex-based test example extraction for non-Python languages"""
 
     # Language-specific regex patterns
     PATTERNS = {
         "javascript": {
-            "instantiation": r'(?:const|let|var)\s+(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)',
-            "assertion": r'expect\(([^)]+)\)\.to(?:Equal|Be|Match)\(([^)]+)\)',
+            "instantiation": r"(?:const|let|var)\s+(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)",
+            "assertion": r"expect\(([^)]+)\)\.to(?:Equal|Be|Match)\(([^)]+)\)",
             "test_function": r'(?:test|it)\(["\']([^"\']+)["\']',
-            "config": r'(?:const|let)\s+config\s*=\s*\{[\s\S]{20,500}?\}',
+            "config": r"(?:const|let)\s+config\s*=\s*\{[\s\S]{20,500}?\}",
         },
         "typescript": {
-            "instantiation": r'(?:const|let|var)\s+(\w+):\s*\w+\s*=\s*new\s+(\w+)\(([^)]*)\)',
-            "assertion": r'expect\(([^)]+)\)\.to(?:Equal|Be|Match)\(([^)]+)\)',
+            "instantiation": r"(?:const|let|var)\s+(\w+):\s*\w+\s*=\s*new\s+(\w+)\(([^)]*)\)",
+            "assertion": r"expect\(([^)]+)\)\.to(?:Equal|Be|Match)\(([^)]+)\)",
             "test_function": r'(?:test|it)\(["\']([^"\']+)["\']',
-            "config": r'(?:const|let)\s+config:\s*\w+\s*=\s*\{[\s\S]{20,500}?\}',
+            "config": r"(?:const|let)\s+config:\s*\w+\s*=\s*\{[\s\S]{20,500}?\}",
         },
         "go": {
-            "instantiation": r'(\w+)\s*:=\s*(\w+)\{([^}]+)\}',
+            "instantiation": r"(\w+)\s*:=\s*(\w+)\{([^}]+)\}",
             "assertion": r't\.(?:Error|Fatal)(?:f)?\(["\']([^"\']+)["\']',
-            "test_function": r'func\s+(Test\w+)\(t\s+\*testing\.T\)',
-            "table_test": r'tests\s*:=\s*\[\]struct\s*\{[\s\S]{50,1000}?\}',
+            "test_function": r"func\s+(Test\w+)\(t\s+\*testing\.T\)",
+            "table_test": r"tests\s*:=\s*\[\]struct\s*\{[\s\S]{50,1000}?\}",
         },
         "rust": {
-            "instantiation": r'let\s+(\w+)\s*=\s*(\w+)::new\(([^)]*)\)',
-            "assertion": r'assert(?:_eq)?!\(([^)]+)\)',
-            "test_function": r'#\[test\]\s*fn\s+(\w+)\(\)',
+            "instantiation": r"let\s+(\w+)\s*=\s*(\w+)::new\(([^)]*)\)",
+            "assertion": r"assert(?:_eq)?!\(([^)]+)\)",
+            "test_function": r"#\[test\]\s*fn\s+(\w+)\(\)",
         },
         "java": {
-            "instantiation": r'(\w+)\s+(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)',
-            "assertion": r'assert(?:Equals|True|False|NotNull)\(([^)]+)\)',
-            "test_function": r'@Test\s+public\s+void\s+(\w+)\(\)',
+            "instantiation": r"(\w+)\s+(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)",
+            "assertion": r"assert(?:Equals|True|False|NotNull)\(([^)]+)\)",
+            "test_function": r"@Test\s+public\s+void\s+(\w+)\(\)",
         },
         "csharp": {
-            "instantiation": r'var\s+(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)',
-            "assertion": r'Assert\.(?:AreEqual|IsTrue|IsFalse|IsNotNull)\(([^)]+)\)',
-            "test_function": r'\[Test\]\s+public\s+void\s+(\w+)\(\)',
+            "instantiation": r"var\s+(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)",
+            "assertion": r"Assert\.(?:AreEqual|IsTrue|IsFalse|IsNotNull)\(([^)]+)\)",
+            "test_function": r"\[Test\]\s+public\s+void\s+(\w+)\(\)",
         },
         "php": {
-            "instantiation": r'\$(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)',
-            "assertion": r'\$this->assert(?:Equals|True|False|NotNull)\(([^)]+)\)',
-            "test_function": r'public\s+function\s+(test\w+)\(\)',
+            "instantiation": r"\$(\w+)\s*=\s*new\s+(\w+)\(([^)]*)\)",
+            "assertion": r"\$this->assert(?:Equals|True|False|NotNull)\(([^)]+)\)",
+            "test_function": r"public\s+function\s+(test\w+)\(\)",
         },
         "ruby": {
-            "instantiation": r'(\w+)\s*=\s*(\w+)\.new\(([^)]*)\)',
-            "assertion": r'expect\(([^)]+)\)\.to\s+(?:eq|be|match)\(([^)]+)\)',
+            "instantiation": r"(\w+)\s*=\s*(\w+)\.new\(([^)]*)\)",
+            "assertion": r"expect\(([^)]+)\)\.to\s+(?:eq|be|match)\(([^)]+)\)",
             "test_function": r'(?:test|it)\s+["\']([^"\']+)["\']',
-        }
+        },
     }
 
-    def extract(self, file_path: str, code: str, language: str) -> List[TestExample]:
+    def extract(self, file_path: str, code: str, language: str) -> list[TestExample]:
         """Extract examples from test file using regex patterns"""
         examples = []
 
@@ -704,7 +687,7 @@ class GenericTestAnalyzer:
                     code=inst_match.group(0),
                     language=language,
                     file_path=file_path,
-                    line_number=code[:start_pos + inst_match.start()].count('\n') + 1
+                    line_number=code[: start_pos + inst_match.start()].count("\n") + 1,
                 )
                 examples.append(example)
 
@@ -717,20 +700,14 @@ class GenericTestAnalyzer:
                         code=config_match.group(0),
                         language=language,
                         file_path=file_path,
-                        line_number=code[:start_pos + config_match.start()].count('\n') + 1
+                        line_number=code[: start_pos + config_match.start()].count("\n") + 1,
                     )
                     examples.append(example)
 
         return examples
 
     def _create_example(
-        self,
-        test_name: str,
-        category: str,
-        code: str,
-        language: str,
-        file_path: str,
-        line_number: int
+        self, test_name: str, category: str, code: str, language: str, file_path: str, line_number: int
     ) -> TestExample:
         """Create TestExample from regex match"""
         return TestExample(
@@ -743,11 +720,11 @@ class GenericTestAnalyzer:
             expected_behavior="",
             file_path=file_path,
             line_start=line_number,
-            line_end=line_number + code.count('\n'),
-            complexity_score=min(1.0, (code.count('\n') + 1) * 0.1),
+            line_end=line_number + code.count("\n"),
+            complexity_score=min(1.0, (code.count("\n") + 1) * 0.1),
             confidence=0.6,  # Lower confidence for regex extraction
             tags=[],
-            dependencies=[]
+            dependencies=[],
         )
 
 
@@ -755,6 +732,7 @@ class GenericTestAnalyzer:
 # EXAMPLE QUALITY FILTER
 # ============================================================================
 
+
 class ExampleQualityFilter:
     """Filter out trivial or low-quality examples"""
 
@@ -764,16 +742,16 @@ class ExampleQualityFilter:
 
         # Trivial patterns to exclude
         self.trivial_patterns = [
-            'Mock()',
-            'MagicMock()',
-            'assertTrue(True)',
-            'assertFalse(False)',
-            'assertEqual(1, 1)',
-            'pass',
-            '...',
+            "Mock()",
+            "MagicMock()",
+            "assertTrue(True)",
+            "assertFalse(False)",
+            "assertEqual(1, 1)",
+            "pass",
+            "...",
         ]
 
-    def filter(self, examples: List[TestExample]) -> List[TestExample]:
+    def filter(self, examples: list[TestExample]) -> list[TestExample]:
         """Filter examples by quality criteria"""
         filtered = []
 
@@ -803,42 +781,43 @@ class ExampleQualityFilter:
 # TEST EXAMPLE EXTRACTOR (Main Orchestrator)
 # ============================================================================
 
+
 class TestExampleExtractor:
     """Main orchestrator for test example extraction"""
 
     # Test file patterns
     TEST_PATTERNS = [
-        'test_*.py',
-        '*_test.py',
-        'test*.js',
-        '*test.js',
-        '*_test.go',
-        '*_test.rs',
-        'Test*.java',
-        'Test*.cs',
-        '*Test.php',
-        '*_spec.rb',
+        "test_*.py",
+        "*_test.py",
+        "test*.js",
+        "*test.js",
+        "*_test.go",
+        "*_test.rs",
+        "Test*.java",
+        "Test*.cs",
+        "*Test.php",
+        "*_spec.rb",
     ]
 
     # Language detection by extension
     LANGUAGE_MAP = {
-        '.py': 'Python',
-        '.js': 'JavaScript',
-        '.ts': 'TypeScript',
-        '.go': 'Go',
-        '.rs': 'Rust',
-        '.java': 'Java',
-        '.cs': 'C#',
-        '.php': 'PHP',
-        '.rb': 'Ruby',
+        ".py": "Python",
+        ".js": "JavaScript",
+        ".ts": "TypeScript",
+        ".go": "Go",
+        ".rs": "Rust",
+        ".java": "Java",
+        ".cs": "C#",
+        ".php": "PHP",
+        ".rb": "Ruby",
     }
 
     def __init__(
         self,
         min_confidence: float = 0.7,
         max_per_file: int = 10,
-        languages: Optional[List[str]] = None,
-        enhance_with_ai: bool = True
+        languages: list[str] | None = None,
+        enhance_with_ai: bool = True,
     ):
         self.python_analyzer = PythonTestAnalyzer()
         self.generic_analyzer = GenericTestAnalyzer()
@@ -852,16 +831,13 @@ class TestExampleExtractor:
         if self.enhance_with_ai:
             try:
                 from skill_seekers.cli.ai_enhancer import TestExampleEnhancer
+
                 self.ai_enhancer = TestExampleEnhancer()
             except Exception as e:
                 logger.warning(f"⚠️  Failed to initialize AI enhancer: {e}")
                 self.enhance_with_ai = False
 
-    def extract_from_directory(
-        self,
-        directory: Path,
-        recursive: bool = True
-    ) -> ExampleReport:
+    def extract_from_directory(self, directory: Path, recursive: bool = True) -> ExampleReport:
         """Extract examples from all test files in directory"""
         directory = Path(directory)
 
@@ -882,7 +858,7 @@ class TestExampleExtractor:
         # Generate report
         return self._create_report(all_examples, directory=str(directory))
 
-    def extract_from_file(self, file_path: Path) -> List[TestExample]:
+    def extract_from_file(self, file_path: Path) -> list[TestExample]:
         """Extract examples from single test file"""
         file_path = Path(file_path)
 
@@ -898,13 +874,13 @@ class TestExampleExtractor:
 
         # Read file
         try:
-            code = file_path.read_text(encoding='utf-8')
+            code = file_path.read_text(encoding="utf-8")
         except UnicodeDecodeError:
             logger.warning(f"Failed to read {file_path} (encoding error)")
             return []
 
         # Extract examples based on language
-        if language == 'Python':
+        if language == "Python":
             examples = self.python_analyzer.extract(str(file_path), code)
         else:
             examples = self.generic_analyzer.extract(str(file_path), code, language)
@@ -915,17 +891,13 @@ class TestExampleExtractor:
         # Limit per file
         if len(filtered_examples) > self.max_per_file:
             # Sort by confidence and take top N
-            filtered_examples = sorted(
-                filtered_examples,
-                key=lambda x: x.confidence,
-                reverse=True
-            )[:self.max_per_file]
+            filtered_examples = sorted(filtered_examples, key=lambda x: x.confidence, reverse=True)[: self.max_per_file]
 
         logger.info(f"Extracted {len(filtered_examples)} examples from {file_path.name}")
 
         return filtered_examples
 
-    def _find_test_files(self, directory: Path, recursive: bool) -> List[Path]:
+    def _find_test_files(self, directory: Path, recursive: bool) -> list[Path]:
         """Find test files in directory"""
         test_files = []
 
@@ -940,13 +912,10 @@ class TestExampleExtractor:
     def _detect_language(self, file_path: Path) -> str:
         """Detect programming language from file extension"""
         suffix = file_path.suffix.lower()
-        return self.LANGUAGE_MAP.get(suffix, 'Unknown')
+        return self.LANGUAGE_MAP.get(suffix, "Unknown")
 
     def _create_report(
-        self,
-        examples: List[TestExample],
-        file_path: Optional[str] = None,
-        directory: Optional[str] = None
+        self, examples: list[TestExample], file_path: str | None = None, directory: str | None = None
     ) -> ExampleReport:
         """Create summary report from examples"""
         # Enhance examples with AI analysis (C3.6)
@@ -957,20 +926,18 @@ class TestExampleExtractor:
 
             # Update examples with AI analysis
             for i, example in enumerate(examples):
-                if i < len(enhanced_dicts) and 'ai_analysis' in enhanced_dicts[i]:
-                    example.ai_analysis = enhanced_dicts[i]['ai_analysis']
+                if i < len(enhanced_dicts) and "ai_analysis" in enhanced_dicts[i]:
+                    example.ai_analysis = enhanced_dicts[i]["ai_analysis"]
 
         # Count by category
         examples_by_category = {}
         for example in examples:
-            examples_by_category[example.category] = \
-                examples_by_category.get(example.category, 0) + 1
+            examples_by_category[example.category] = examples_by_category.get(example.category, 0) + 1
 
         # Count by language
         examples_by_language = {}
         for example in examples:
-            examples_by_language[example.language] = \
-                examples_by_language.get(example.language, 0) + 1
+            examples_by_language[example.language] = examples_by_language.get(example.language, 0) + 1
 
         # Calculate averages
         avg_complexity = sum(ex.complexity_score for ex in examples) / len(examples) if examples else 0.0
@@ -984,7 +951,7 @@ class TestExampleExtractor:
             avg_complexity=round(avg_complexity, 2),
             high_value_count=high_value_count,
             file_path=file_path,
-            directory=directory
+            directory=directory,
         )
 
 
@@ -992,10 +959,11 @@ class TestExampleExtractor:
 # COMMAND-LINE INTERFACE
 # ============================================================================
 
+
 def main():
     """Main entry point for CLI"""
     parser = argparse.ArgumentParser(
-        description='Extract usage examples from test files',
+        description="Extract usage examples from test files",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -1010,49 +978,20 @@ Examples:
 
   # Filter by confidence
   %(prog)s tests/ --min-confidence 0.7
-        """
+        """,
     )
 
+    parser.add_argument("directory", nargs="?", help="Directory containing test files")
+    parser.add_argument("--file", help="Single test file to analyze")
+    parser.add_argument("--language", help="Filter by programming language (python, javascript, etc.)")
     parser.add_argument(
-        'directory',
-        nargs='?',
-        help='Directory containing test files'
+        "--min-confidence", type=float, default=0.5, help="Minimum confidence threshold (0.0-1.0, default: 0.5)"
     )
+    parser.add_argument("--max-per-file", type=int, default=10, help="Maximum examples per file (default: 10)")
+    parser.add_argument("--json", action="store_true", help="Output JSON format")
+    parser.add_argument("--markdown", action="store_true", help="Output Markdown format")
     parser.add_argument(
-        '--file',
-        help='Single test file to analyze'
-    )
-    parser.add_argument(
-        '--language',
-        help='Filter by programming language (python, javascript, etc.)'
-    )
-    parser.add_argument(
-        '--min-confidence',
-        type=float,
-        default=0.5,
-        help='Minimum confidence threshold (0.0-1.0, default: 0.5)'
-    )
-    parser.add_argument(
-        '--max-per-file',
-        type=int,
-        default=10,
-        help='Maximum examples per file (default: 10)'
-    )
-    parser.add_argument(
-        '--json',
-        action='store_true',
-        help='Output JSON format'
-    )
-    parser.add_argument(
-        '--markdown',
-        action='store_true',
-        help='Output Markdown format'
-    )
-    parser.add_argument(
-        '--recursive',
-        action='store_true',
-        default=True,
-        help='Search directory recursively (default: True)'
+        "--recursive", action="store_true", default=True, help="Search directory recursively (default: True)"
     )
 
     args = parser.parse_args()
@@ -1064,9 +1003,7 @@ Examples:
     # Create extractor
     languages = [args.language] if args.language else None
     extractor = TestExampleExtractor(
-        min_confidence=args.min_confidence,
-        max_per_file=args.max_per_file,
-        languages=languages
+        min_confidence=args.min_confidence, max_per_file=args.max_per_file, languages=languages
     )
 
     # Extract examples
@@ -1074,10 +1011,7 @@ Examples:
         examples = extractor.extract_from_file(Path(args.file))
         report = extractor._create_report(examples, file_path=args.file)
     else:
-        report = extractor.extract_from_directory(
-            Path(args.directory),
-            recursive=args.recursive
-        )
+        report = extractor.extract_from_directory(Path(args.directory), recursive=args.recursive)
 
     # Output results
     if args.json:
@@ -1086,19 +1020,19 @@ Examples:
         print(report.to_markdown())
     else:
         # Human-readable summary
-        print(f"\nTest Example Extraction Results")
-        print(f"=" * 50)
+        print("\nTest Example Extraction Results")
+        print("=" * 50)
         print(f"Total Examples: {report.total_examples}")
         print(f"High Value (confidence > 0.7): {report.high_value_count}")
         print(f"Average Complexity: {report.avg_complexity:.2f}")
-        print(f"\nExamples by Category:")
+        print("\nExamples by Category:")
         for category, count in sorted(report.examples_by_category.items()):
             print(f"  {category}: {count}")
-        print(f"\nExamples by Language:")
+        print("\nExamples by Language:")
         for language, count in sorted(report.examples_by_language.items()):
             print(f"  {language}: {count}")
-        print(f"\nUse --json or --markdown for detailed output")
+        print("\nUse --json or --markdown for detailed output")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
diff --git a/src/skill_seekers/cli/test_unified_simple.py b/src/skill_seekers/cli/test_unified_simple.py
index f759fd1..2854bd2 100644
--- a/src/skill_seekers/cli/test_unified_simple.py
+++ b/src/skill_seekers/cli/test_unified_simple.py
@@ -5,9 +5,9 @@ Simple Integration Tests for Unified Multi-Source Scraper
 Focuses on real-world usage patterns rather than unit tests.
 """
 
+import json
 import os
 import sys
-import json
 import tempfile
 from pathlib import Path
 
@@ -16,16 +16,12 @@ sys.path.insert(0, str(Path(__file__).parent))
 
 from .config_validator import validate_config
 
+
 def test_validate_existing_unified_configs():
     """Test that all existing unified configs are valid"""
-    configs_dir = Path(__file__).parent.parent / 'configs'
+    configs_dir = Path(__file__).parent.parent / "configs"
 
-    unified_configs = [
-        'godot_unified.json',
-        'react_unified.json',
-        'django_unified.json',
-        'fastapi_unified.json'
-    ]
+    unified_configs = ["godot_unified.json", "react_unified.json", "django_unified.json", "fastapi_unified.json"]
 
     for config_name in unified_configs:
         config_path = configs_dir / config_name
@@ -40,13 +36,9 @@ def test_validate_existing_unified_configs():
 
 def test_backward_compatibility():
     """Test that legacy configs still work"""
-    configs_dir = Path(__file__).parent.parent / 'configs'
+    configs_dir = Path(__file__).parent.parent / "configs"
 
-    legacy_configs = [
-        'react.json',
-        'godot.json',
-        'django.json'
-    ]
+    legacy_configs = ["react.json", "godot.json", "django.json"]
 
     for config_name in legacy_configs:
         config_path = configs_dir / config_name
@@ -54,7 +46,7 @@ def test_backward_compatibility():
             print(f"\n✓ Validating legacy {config_name}...")
             validator = validate_config(str(config_path))
             assert not validator.is_unified, f"{config_name} should be legacy format"
-            print(f"  Format: Legacy")
+            print("  Format: Legacy")
 
 
 def test_create_temp_unified_config():
@@ -64,22 +56,12 @@ def test_create_temp_unified_config():
         "description": "Test unified config",
         "merge_mode": "rule-based",
         "sources": [
-            {
-                "type": "documentation",
-                "base_url": "https://example.com/docs",
-                "extract_api": True,
-                "max_pages": 50
-            },
-            {
-                "type": "github",
-                "repo": "test/repo",
-                "include_code": True,
-                "code_analysis_depth": "surface"
-            }
-        ]
+            {"type": "documentation", "base_url": "https://example.com/docs", "extract_api": True, "max_pages": 50},
+            {"type": "github", "repo": "test/repo", "include_code": True, "code_analysis_depth": "surface"},
+        ],
     }
 
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(config, f)
         config_path = f.name
 
@@ -88,7 +70,7 @@ def test_create_temp_unified_config():
         validator = validate_config(config_path)
         assert validator.is_unified
         assert validator.needs_api_merge()
-        assert len(validator.config['sources']) == 2
+        assert len(validator.config["sources"]) == 2
         print("  ✓ Config is valid unified format")
         print(f"  Sources: {len(validator.config['sources'])}")
     finally:
@@ -102,22 +84,13 @@ def test_mixed_source_types():
         "description": "Test mixed sources",
         "merge_mode": "rule-based",
         "sources": [
-            {
-                "type": "documentation",
-                "base_url": "https://example.com"
-            },
-            {
-                "type": "github",
-                "repo": "test/repo"
-            },
-            {
-                "type": "pdf",
-                "path": "/path/to/manual.pdf"
-            }
-        ]
+            {"type": "documentation", "base_url": "https://example.com"},
+            {"type": "github", "repo": "test/repo"},
+            {"type": "pdf", "path": "/path/to/manual.pdf"},
+        ],
     }
 
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(config, f)
         config_path = f.name
 
@@ -125,13 +98,13 @@ def test_mixed_source_types():
         print("\n✓ Validating mixed source types...")
         validator = validate_config(config_path)
         assert validator.is_unified
-        assert len(validator.config['sources']) == 3
+        assert len(validator.config["sources"]) == 3
 
         # Check each source type
-        source_types = [s['type'] for s in validator.config['sources']]
-        assert 'documentation' in source_types
-        assert 'github' in source_types
-        assert 'pdf' in source_types
+        source_types = [s["type"] for s in validator.config["sources"]]
+        assert "documentation" in source_types
+        assert "github" in source_types
+        assert "pdf" in source_types
         print("  ✓ All 3 source types validated")
     finally:
         os.unlink(config_path)
@@ -143,12 +116,10 @@ def test_config_validation_errors():
     config = {
         "name": "test",
         "description": "Test",
-        "sources": [
-            {"type": "invalid_type", "url": "https://example.com"}
-        ]
+        "sources": [{"type": "invalid_type", "url": "https://example.com"}],
     }
 
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(config, f)
         config_path = f.name
 
@@ -166,7 +137,7 @@ def test_config_validation_errors():
 
 
 # Run tests
-if __name__ == '__main__':
+if __name__ == "__main__":
     print("=" * 60)
     print("Running Unified Scraper Integration Tests")
     print("=" * 60)
@@ -188,5 +159,6 @@ if __name__ == '__main__':
     except Exception as e:
         print(f"\n❌ Unexpected error: {e}")
         import traceback
+
         traceback.print_exc()
         sys.exit(1)
diff --git a/src/skill_seekers/cli/unified_codebase_analyzer.py b/src/skill_seekers/cli/unified_codebase_analyzer.py
index a4e1b02..1a2bee8 100644
--- a/src/skill_seekers/cli/unified_codebase_analyzer.py
+++ b/src/skill_seekers/cli/unified_codebase_analyzer.py
@@ -13,21 +13,21 @@ Analysis modes:
 """
 
 import os
-from pathlib import Path
-from typing import Dict, Optional, List
 from dataclasses import dataclass
+from pathlib import Path
 
-from skill_seekers.cli.github_fetcher import GitHubThreeStreamFetcher, ThreeStreamData
+from skill_seekers.cli.github_fetcher import GitHubThreeStreamFetcher
 
 
 @dataclass
 class AnalysisResult:
     """Unified analysis result from any codebase source."""
-    code_analysis: Dict
-    github_docs: Optional[Dict] = None
-    github_insights: Optional[Dict] = None
-    source_type: str = 'local'  # 'local' or 'github'
-    analysis_depth: str = 'basic'  # 'basic' or 'c3x'
+
+    code_analysis: dict
+    github_docs: dict | None = None
+    github_insights: dict | None = None
+    source_type: str = "local"  # 'local' or 'github'
+    analysis_depth: str = "basic"  # 'basic' or 'c3x'
 
 
 class UnifiedCodebaseAnalyzer:
@@ -59,21 +59,17 @@ class UnifiedCodebaseAnalyzer:
         )
     """
 
-    def __init__(self, github_token: Optional[str] = None):
+    def __init__(self, github_token: str | None = None):
         """
         Initialize analyzer.
 
         Args:
             github_token: Optional GitHub API token for higher rate limits
         """
-        self.github_token = github_token or os.getenv('GITHUB_TOKEN')
+        self.github_token = github_token or os.getenv("GITHUB_TOKEN")
 
     def analyze(
-        self,
-        source: str,
-        depth: str = 'c3x',
-        fetch_github_metadata: bool = True,
-        output_dir: Optional[Path] = None
+        self, source: str, depth: str = "c3x", fetch_github_metadata: bool = True, output_dir: Path | None = None
     ) -> AnalysisResult:
         """
         Analyze codebase with specified depth.
@@ -92,18 +88,14 @@ class UnifiedCodebaseAnalyzer:
 
         # Step 1: Acquire source
         if self.is_github_url(source):
-            print(f"📦 Source type: GitHub repository")
+            print("📦 Source type: GitHub repository")
             return self._analyze_github(source, depth, fetch_github_metadata, output_dir)
         else:
-            print(f"📁 Source type: Local directory")
+            print("📁 Source type: Local directory")
             return self._analyze_local(source, depth)
 
     def _analyze_github(
-        self,
-        repo_url: str,
-        depth: str,
-        fetch_metadata: bool,
-        output_dir: Optional[Path]
+        self, repo_url: str, depth: str, fetch_metadata: bool, output_dir: Path | None
     ) -> AnalysisResult:
         """
         Analyze GitHub repository with three-stream fetcher.
@@ -123,32 +115,28 @@ class UnifiedCodebaseAnalyzer:
 
         # Analyze code with specified depth
         code_directory = three_streams.code_stream.directory
-        if depth == 'basic':
+        if depth == "basic":
             code_analysis = self.basic_analysis(code_directory)
-        elif depth == 'c3x':
+        elif depth == "c3x":
             code_analysis = self.c3x_analysis(code_directory)
         else:
             raise ValueError(f"Unknown depth: {depth}. Use 'basic' or 'c3x'")
 
         # Build result with all streams
-        result = AnalysisResult(
-            code_analysis=code_analysis,
-            source_type='github',
-            analysis_depth=depth
-        )
+        result = AnalysisResult(code_analysis=code_analysis, source_type="github", analysis_depth=depth)
 
         # Add GitHub-specific data if available
         if fetch_metadata:
             result.github_docs = {
-                'readme': three_streams.docs_stream.readme,
-                'contributing': three_streams.docs_stream.contributing,
-                'docs_files': three_streams.docs_stream.docs_files
+                "readme": three_streams.docs_stream.readme,
+                "contributing": three_streams.docs_stream.contributing,
+                "docs_files": three_streams.docs_stream.docs_files,
             }
             result.github_insights = {
-                'metadata': three_streams.insights_stream.metadata,
-                'common_problems': three_streams.insights_stream.common_problems,
-                'known_solutions': three_streams.insights_stream.known_solutions,
-                'top_labels': three_streams.insights_stream.top_labels
+                "metadata": three_streams.insights_stream.metadata,
+                "common_problems": three_streams.insights_stream.common_problems,
+                "known_solutions": three_streams.insights_stream.known_solutions,
+                "top_labels": three_streams.insights_stream.top_labels,
             }
 
         return result
@@ -173,20 +161,16 @@ class UnifiedCodebaseAnalyzer:
             raise NotADirectoryError(f"Not a directory: {directory}")
 
         # Analyze code with specified depth
-        if depth == 'basic':
+        if depth == "basic":
             code_analysis = self.basic_analysis(code_directory)
-        elif depth == 'c3x':
+        elif depth == "c3x":
             code_analysis = self.c3x_analysis(code_directory)
         else:
             raise ValueError(f"Unknown depth: {depth}. Use 'basic' or 'c3x'")
 
-        return AnalysisResult(
-            code_analysis=code_analysis,
-            source_type='local',
-            analysis_depth=depth
-        )
+        return AnalysisResult(code_analysis=code_analysis, source_type="local", analysis_depth=depth)
 
-    def basic_analysis(self, directory: Path) -> Dict:
+    def basic_analysis(self, directory: Path) -> dict:
         """
         Fast, shallow analysis (1-2 min).
 
@@ -205,19 +189,19 @@ class UnifiedCodebaseAnalyzer:
         print("📊 Running basic analysis (1-2 min)...")
 
         analysis = {
-            'directory': str(directory),
-            'analysis_type': 'basic',
-            'files': self.list_files(directory),
-            'structure': self.get_directory_structure(directory),
-            'imports': self.extract_imports(directory),
-            'entry_points': self.find_entry_points(directory),
-            'statistics': self.compute_statistics(directory)
+            "directory": str(directory),
+            "analysis_type": "basic",
+            "files": self.list_files(directory),
+            "structure": self.get_directory_structure(directory),
+            "imports": self.extract_imports(directory),
+            "entry_points": self.find_entry_points(directory),
+            "statistics": self.compute_statistics(directory),
         }
 
         print(f"✅ Basic analysis complete: {len(analysis['files'])} files analyzed")
         return analysis
 
-    def c3x_analysis(self, directory: Path) -> Dict:
+    def c3x_analysis(self, directory: Path) -> dict:
         """
         Deep C3.x analysis (20-60 min).
 
@@ -245,17 +229,18 @@ class UnifiedCodebaseAnalyzer:
 
         try:
             # Import codebase analyzer
-            from .codebase_scraper import analyze_codebase
             import tempfile
 
+            from .codebase_scraper import analyze_codebase
+
             # Create temporary output directory for C3.x analysis
-            temp_output = Path(tempfile.mkdtemp(prefix='c3x_analysis_'))
+            temp_output = Path(tempfile.mkdtemp(prefix="c3x_analysis_"))
 
             # Run full C3.x analysis
             analyze_codebase(
                 directory=directory,
                 output_dir=temp_output,
-                depth='deep',
+                depth="deep",
                 languages=None,  # All languages
                 file_patterns=None,  # All files
                 build_api_reference=True,
@@ -265,20 +250,16 @@ class UnifiedCodebaseAnalyzer:
                 build_how_to_guides=True,
                 extract_config_patterns=True,
                 enhance_with_ai=False,  # Disable AI for speed
-                ai_mode='none'
+                ai_mode="none",
             )
 
             # Load C3.x results from output files
             c3x_data = self._load_c3x_results(temp_output)
 
             # Merge with basic analysis
-            c3x = {
-                **basic,
-                'analysis_type': 'c3x',
-                **c3x_data
-            }
+            c3x = {**basic, "analysis_type": "c3x", **c3x_data}
 
-            print(f"✅ C3.x analysis complete!")
+            print("✅ C3.x analysis complete!")
             print(f"   - {len(c3x_data.get('c3_1_patterns', []))} design patterns detected")
             print(f"   - {c3x_data.get('c3_2_examples_count', 0)} test examples extracted")
             print(f"   - {len(c3x_data.get('c3_3_guides', []))} how-to guides generated")
@@ -289,24 +270,24 @@ class UnifiedCodebaseAnalyzer:
 
         except Exception as e:
             print(f"⚠️  C3.x analysis failed: {e}")
-            print(f"   Falling back to basic analysis with placeholders")
+            print("   Falling back to basic analysis with placeholders")
 
             # Fall back to placeholders
             c3x = {
                 **basic,
-                'analysis_type': 'c3x',
-                'c3_1_patterns': [],
-                'c3_2_examples': [],
-                'c3_2_examples_count': 0,
-                'c3_3_guides': [],
-                'c3_4_configs': [],
-                'c3_7_architecture': [],
-                'error': str(e)
+                "analysis_type": "c3x",
+                "c3_1_patterns": [],
+                "c3_2_examples": [],
+                "c3_2_examples_count": 0,
+                "c3_3_guides": [],
+                "c3_4_configs": [],
+                "c3_7_architecture": [],
+                "error": str(e),
             }
 
             return c3x
 
-    def _load_c3x_results(self, output_dir: Path) -> Dict:
+    def _load_c3x_results(self, output_dir: Path) -> dict:
         """
         Load C3.x analysis results from output directory.
 
@@ -321,65 +302,65 @@ class UnifiedCodebaseAnalyzer:
         c3x_data = {}
 
         # C3.1: Design Patterns
-        patterns_file = output_dir / 'patterns' / 'design_patterns.json'
+        patterns_file = output_dir / "patterns" / "design_patterns.json"
         if patterns_file.exists():
-            with open(patterns_file, 'r') as f:
+            with open(patterns_file) as f:
                 patterns_data = json.load(f)
-                c3x_data['c3_1_patterns'] = patterns_data.get('patterns', [])
+                c3x_data["c3_1_patterns"] = patterns_data.get("patterns", [])
         else:
-            c3x_data['c3_1_patterns'] = []
+            c3x_data["c3_1_patterns"] = []
 
         # C3.2: Test Examples
-        examples_file = output_dir / 'test_examples' / 'test_examples.json'
+        examples_file = output_dir / "test_examples" / "test_examples.json"
         if examples_file.exists():
-            with open(examples_file, 'r') as f:
+            with open(examples_file) as f:
                 examples_data = json.load(f)
-                c3x_data['c3_2_examples'] = examples_data.get('examples', [])
-                c3x_data['c3_2_examples_count'] = examples_data.get('total_examples', 0)
+                c3x_data["c3_2_examples"] = examples_data.get("examples", [])
+                c3x_data["c3_2_examples_count"] = examples_data.get("total_examples", 0)
         else:
-            c3x_data['c3_2_examples'] = []
-            c3x_data['c3_2_examples_count'] = 0
+            c3x_data["c3_2_examples"] = []
+            c3x_data["c3_2_examples_count"] = 0
 
         # C3.3: How-to Guides
-        guides_file = output_dir / 'tutorials' / 'guide_collection.json'
+        guides_file = output_dir / "tutorials" / "guide_collection.json"
         if guides_file.exists():
-            with open(guides_file, 'r') as f:
+            with open(guides_file) as f:
                 guides_data = json.load(f)
-                c3x_data['c3_3_guides'] = guides_data.get('guides', [])
+                c3x_data["c3_3_guides"] = guides_data.get("guides", [])
         else:
-            c3x_data['c3_3_guides'] = []
+            c3x_data["c3_3_guides"] = []
 
         # C3.4: Config Patterns
-        config_file = output_dir / 'config_patterns' / 'config_patterns.json'
+        config_file = output_dir / "config_patterns" / "config_patterns.json"
         if config_file.exists():
-            with open(config_file, 'r') as f:
+            with open(config_file) as f:
                 config_data = json.load(f)
-                c3x_data['c3_4_configs'] = config_data.get('config_files', [])
+                c3x_data["c3_4_configs"] = config_data.get("config_files", [])
         else:
-            c3x_data['c3_4_configs'] = []
+            c3x_data["c3_4_configs"] = []
 
         # C3.7: Architecture
-        arch_file = output_dir / 'architecture' / 'architectural_patterns.json'
+        arch_file = output_dir / "architecture" / "architectural_patterns.json"
         if arch_file.exists():
-            with open(arch_file, 'r') as f:
+            with open(arch_file) as f:
                 arch_data = json.load(f)
-                c3x_data['c3_7_architecture'] = arch_data.get('patterns', [])
+                c3x_data["c3_7_architecture"] = arch_data.get("patterns", [])
         else:
-            c3x_data['c3_7_architecture'] = []
+            c3x_data["c3_7_architecture"] = []
 
         # Add dependency graph data
-        dep_file = output_dir / 'dependencies' / 'dependency_graph.json'
+        dep_file = output_dir / "dependencies" / "dependency_graph.json"
         if dep_file.exists():
-            with open(dep_file, 'r') as f:
+            with open(dep_file) as f:
                 dep_data = json.load(f)
-                c3x_data['dependency_graph'] = dep_data
+                c3x_data["dependency_graph"] = dep_data
 
         # Add API reference data
-        api_file = output_dir / 'code_analysis.json'
+        api_file = output_dir / "code_analysis.json"
         if api_file.exists():
-            with open(api_file, 'r') as f:
+            with open(api_file) as f:
                 api_data = json.load(f)
-                c3x_data['api_reference'] = api_data
+                c3x_data["api_reference"] = api_data
 
         return c3x_data
 
@@ -393,9 +374,9 @@ class UnifiedCodebaseAnalyzer:
         Returns:
             True if GitHub URL, False otherwise
         """
-        return 'github.com' in source
+        return "github.com" in source
 
-    def list_files(self, directory: Path) -> List[Dict]:
+    def list_files(self, directory: Path) -> list[dict]:
         """
         List all files in directory with metadata.
 
@@ -406,20 +387,22 @@ class UnifiedCodebaseAnalyzer:
             List of file info dicts
         """
         files = []
-        for file_path in directory.rglob('*'):
+        for file_path in directory.rglob("*"):
             if file_path.is_file():
                 try:
-                    files.append({
-                        'path': str(file_path.relative_to(directory)),
-                        'size': file_path.stat().st_size,
-                        'extension': file_path.suffix
-                    })
+                    files.append(
+                        {
+                            "path": str(file_path.relative_to(directory)),
+                            "size": file_path.stat().st_size,
+                            "extension": file_path.suffix,
+                        }
+                    )
                 except Exception:
                     # Skip files we can't access
                     continue
         return files
 
-    def get_directory_structure(self, directory: Path) -> Dict:
+    def get_directory_structure(self, directory: Path) -> dict:
         """
         Get directory structure tree.
 
@@ -429,35 +412,24 @@ class UnifiedCodebaseAnalyzer:
         Returns:
             Dict representing directory structure
         """
-        structure = {
-            'name': directory.name,
-            'type': 'directory',
-            'children': []
-        }
+        structure = {"name": directory.name, "type": "directory", "children": []}
 
         try:
             for item in sorted(directory.iterdir()):
-                if item.name.startswith('.'):
+                if item.name.startswith("."):
                     continue  # Skip hidden files
 
                 if item.is_dir():
                     # Only include immediate subdirectories
-                    structure['children'].append({
-                        'name': item.name,
-                        'type': 'directory'
-                    })
+                    structure["children"].append({"name": item.name, "type": "directory"})
                 elif item.is_file():
-                    structure['children'].append({
-                        'name': item.name,
-                        'type': 'file',
-                        'extension': item.suffix
-                    })
+                    structure["children"].append({"name": item.name, "type": "file", "extension": item.suffix})
         except Exception:
             pass
 
         return structure
 
-    def extract_imports(self, directory: Path) -> Dict[str, List[str]]:
+    def extract_imports(self, directory: Path) -> dict[str, list[str]]:
         """
         Extract import statements from code files.
 
@@ -467,27 +439,23 @@ class UnifiedCodebaseAnalyzer:
         Returns:
             Dict mapping file extensions to import lists
         """
-        imports = {
-            '.py': [],
-            '.js': [],
-            '.ts': []
-        }
+        imports = {".py": [], ".js": [], ".ts": []}
 
         # Sample up to 10 files per extension
-        for ext in imports.keys():
-            files = list(directory.rglob(f'*{ext}'))[:10]
+        for ext in imports:
+            files = list(directory.rglob(f"*{ext}"))[:10]
             for file_path in files:
                 try:
-                    content = file_path.read_text(encoding='utf-8')
-                    if ext == '.py':
+                    content = file_path.read_text(encoding="utf-8")
+                    if ext == ".py":
                         # Extract Python imports
-                        for line in content.split('\n')[:50]:  # Check first 50 lines
-                            if line.strip().startswith(('import ', 'from ')):
+                        for line in content.split("\n")[:50]:  # Check first 50 lines
+                            if line.strip().startswith(("import ", "from ")):
                                 imports[ext].append(line.strip())
-                    elif ext in ['.js', '.ts']:
+                    elif ext in [".js", ".ts"]:
                         # Extract JS/TS imports
-                        for line in content.split('\n')[:50]:
-                            if line.strip().startswith(('import ', 'require(')):
+                        for line in content.split("\n")[:50]:
+                            if line.strip().startswith(("import ", "require(")):
                                 imports[ext].append(line.strip())
                 except Exception:
                     continue
@@ -495,7 +463,7 @@ class UnifiedCodebaseAnalyzer:
         # Remove empty lists
         return {k: v for k, v in imports.items() if v}
 
-    def find_entry_points(self, directory: Path) -> List[str]:
+    def find_entry_points(self, directory: Path) -> list[str]:
         """
         Find potential entry points (main files, setup files, etc.).
 
@@ -509,10 +477,20 @@ class UnifiedCodebaseAnalyzer:
 
         # Common entry point patterns
         entry_patterns = [
-            'main.py', '__main__.py', 'app.py', 'server.py',
-            'index.js', 'index.ts', 'main.js', 'main.ts',
-            'setup.py', 'pyproject.toml', 'package.json',
-            'Makefile', 'docker-compose.yml', 'Dockerfile'
+            "main.py",
+            "__main__.py",
+            "app.py",
+            "server.py",
+            "index.js",
+            "index.ts",
+            "main.js",
+            "main.ts",
+            "setup.py",
+            "pyproject.toml",
+            "package.json",
+            "Makefile",
+            "docker-compose.yml",
+            "Dockerfile",
         ]
 
         for pattern in entry_patterns:
@@ -525,7 +503,7 @@ class UnifiedCodebaseAnalyzer:
 
         return entry_points
 
-    def compute_statistics(self, directory: Path) -> Dict:
+    def compute_statistics(self, directory: Path) -> dict:
         """
         Compute basic statistics about the codebase.
 
@@ -535,39 +513,34 @@ class UnifiedCodebaseAnalyzer:
         Returns:
             Dict with statistics
         """
-        stats = {
-            'total_files': 0,
-            'total_size_bytes': 0,
-            'file_types': {},
-            'languages': {}
-        }
+        stats = {"total_files": 0, "total_size_bytes": 0, "file_types": {}, "languages": {}}
 
-        for file_path in directory.rglob('*'):
+        for file_path in directory.rglob("*"):
             if not file_path.is_file():
                 continue
 
             try:
-                stats['total_files'] += 1
-                stats['total_size_bytes'] += file_path.stat().st_size
+                stats["total_files"] += 1
+                stats["total_size_bytes"] += file_path.stat().st_size
 
                 ext = file_path.suffix
                 if ext:
-                    stats['file_types'][ext] = stats['file_types'].get(ext, 0) + 1
+                    stats["file_types"][ext] = stats["file_types"].get(ext, 0) + 1
 
                     # Map extensions to languages
                     language_map = {
-                        '.py': 'Python',
-                        '.js': 'JavaScript',
-                        '.ts': 'TypeScript',
-                        '.go': 'Go',
-                        '.rs': 'Rust',
-                        '.java': 'Java',
-                        '.rb': 'Ruby',
-                        '.php': 'PHP'
+                        ".py": "Python",
+                        ".js": "JavaScript",
+                        ".ts": "TypeScript",
+                        ".go": "Go",
+                        ".rs": "Rust",
+                        ".java": "Java",
+                        ".rb": "Ruby",
+                        ".php": "PHP",
                     }
                     if ext in language_map:
                         lang = language_map[ext]
-                        stats['languages'][lang] = stats['languages'].get(lang, 0) + 1
+                        stats["languages"][lang] = stats["languages"].get(lang, 0) + 1
             except Exception:
                 continue
 
diff --git a/src/skill_seekers/cli/unified_scraper.py b/src/skill_seekers/cli/unified_scraper.py
index e8dfa03..9fadfd5 100644
--- a/src/skill_seekers/cli/unified_scraper.py
+++ b/src/skill_seekers/cli/unified_scraper.py
@@ -12,31 +12,28 @@ Usage:
     skill-seekers unified --config configs/react_unified.json --merge-mode claude-enhanced
 """
 
-import os
-import sys
+import argparse
 import json
 import logging
-import argparse
-import subprocess
+import os
 import shutil
+import subprocess
+import sys
 from pathlib import Path
-from typing import Dict, List, Any, Optional
+from typing import Any
 
 # Import validators and scrapers
 try:
     from skill_seekers.cli.config_validator import ConfigValidator, validate_config
     from skill_seekers.cli.conflict_detector import ConflictDetector
-    from skill_seekers.cli.merge_sources import RuleBasedMerger, ClaudeEnhancedMerger
+    from skill_seekers.cli.merge_sources import ClaudeEnhancedMerger, RuleBasedMerger
     from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 except ImportError as e:
     print(f"Error importing modules: {e}")
     print("Make sure you're running from the project root directory")
     sys.exit(1)
 
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s - %(levelname)s - %(message)s'
-)
+logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
 logger = logging.getLogger(__name__)
 
 
@@ -52,7 +49,7 @@ class UnifiedScraper:
     5. Build unified skill
     """
 
-    def __init__(self, config_path: str, merge_mode: Optional[str] = None):
+    def __init__(self, config_path: str, merge_mode: str | None = None):
         """
         Initialize unified scraper.
 
@@ -68,21 +65,21 @@ class UnifiedScraper:
         self.config = self.validator.config
 
         # Determine merge mode
-        self.merge_mode = merge_mode or self.config.get('merge_mode', 'rule-based')
+        self.merge_mode = merge_mode or self.config.get("merge_mode", "rule-based")
         logger.info(f"Merge mode: {self.merge_mode}")
 
         # Storage for scraped data - use lists to support multiple sources of same type
         self.scraped_data = {
-            'documentation': [],  # List of doc sources
-            'github': [],         # List of github sources
-            'pdf': []             # List of pdf sources
+            "documentation": [],  # List of doc sources
+            "github": [],  # List of github sources
+            "pdf": [],  # List of pdf sources
         }
 
         # Track source index for unique naming (multi-source support)
-        self._source_counters = {'documentation': 0, 'github': 0, 'pdf': 0}
+        self._source_counters = {"documentation": 0, "github": 0, "pdf": 0}
 
         # Output paths - cleaner organization
-        self.name = self.config['name']
+        self.name = self.config["name"]
         self.output_dir = f"output/{self.name}"  # Final skill only
 
         # Use hidden cache directory for intermediate files
@@ -107,17 +104,16 @@ class UnifiedScraper:
         from datetime import datetime
 
         # Create log filename with timestamp
-        timestamp = datetime.now().strftime('%Y-%m-%d_%H-%M-%S')
+        timestamp = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
         log_file = f"{self.logs_dir}/unified_{timestamp}.log"
 
         # Add file handler to root logger
-        file_handler = logging.FileHandler(log_file, encoding='utf-8')
+        file_handler = logging.FileHandler(log_file, encoding="utf-8")
         file_handler.setLevel(logging.DEBUG)
 
         # Create formatter
         formatter = logging.Formatter(
-            '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
-            datefmt='%Y-%m-%d %H:%M:%S'
+            "%(asctime)s - %(name)s - %(levelname)s - %(message)s", datefmt="%Y-%m-%d %H:%M:%S"
         )
         file_handler.setFormatter(formatter)
 
@@ -141,18 +137,18 @@ class UnifiedScraper:
             logger.warning("Config is not unified format, converting...")
             self.config = self.validator.convert_legacy_to_unified()
 
-        sources = self.config.get('sources', [])
+        sources = self.config.get("sources", [])
 
         for i, source in enumerate(sources):
-            source_type = source['type']
-            logger.info(f"\n[{i+1}/{len(sources)}] Scraping {source_type} source...")
+            source_type = source["type"]
+            logger.info(f"\n[{i + 1}/{len(sources)}] Scraping {source_type} source...")
 
             try:
-                if source_type == 'documentation':
+                if source_type == "documentation":
                     self._scrape_documentation(source)
-                elif source_type == 'github':
+                elif source_type == "github":
                     self._scrape_github(source)
-                elif source_type == 'pdf':
+                elif source_type == "pdf":
                     self._scrape_pdf(source)
                 else:
                     logger.warning(f"Unknown source type: {source_type}")
@@ -162,40 +158,40 @@ class UnifiedScraper:
 
         logger.info(f"\n✅ Scraped {len(self.scraped_data)} sources successfully")
 
-    def _scrape_documentation(self, source: Dict[str, Any]):
+    def _scrape_documentation(self, source: dict[str, Any]):
         """Scrape documentation website."""
         # Create temporary config for doc scraper
         doc_config = {
-            'name': f"{self.name}_docs",
-            'base_url': source['base_url'],
-            'selectors': source.get('selectors', {}),
-            'url_patterns': source.get('url_patterns', {}),
-            'categories': source.get('categories', {}),
-            'rate_limit': source.get('rate_limit', 0.5),
-            'max_pages': source.get('max_pages', 100)
+            "name": f"{self.name}_docs",
+            "base_url": source["base_url"],
+            "selectors": source.get("selectors", {}),
+            "url_patterns": source.get("url_patterns", {}),
+            "categories": source.get("categories", {}),
+            "rate_limit": source.get("rate_limit", 0.5),
+            "max_pages": source.get("max_pages", 100),
         }
 
         # Pass through llms.txt settings (so unified configs behave the same as doc_scraper configs)
-        if 'llms_txt_url' in source:
-            doc_config['llms_txt_url'] = source.get('llms_txt_url')
+        if "llms_txt_url" in source:
+            doc_config["llms_txt_url"] = source.get("llms_txt_url")
 
-        if 'skip_llms_txt' in source:
-            doc_config['skip_llms_txt'] = source.get('skip_llms_txt')
+        if "skip_llms_txt" in source:
+            doc_config["skip_llms_txt"] = source.get("skip_llms_txt")
 
         # Optional: support overriding start URLs
-        if 'start_urls' in source:
-            doc_config['start_urls'] = source.get('start_urls')
+        if "start_urls" in source:
+            doc_config["start_urls"] = source.get("start_urls")
 
         # Write temporary config
-        temp_config_path = os.path.join(self.data_dir, 'temp_docs_config.json')
-        with open(temp_config_path, 'w', encoding='utf-8') as f:
+        temp_config_path = os.path.join(self.data_dir, "temp_docs_config.json")
+        with open(temp_config_path, "w", encoding="utf-8") as f:
             json.dump(doc_config, f, indent=2)
 
         # Run doc_scraper as subprocess
         logger.info(f"Scraping documentation from {source['base_url']}")
 
         doc_scraper_path = Path(__file__).parent / "doc_scraper.py"
-        cmd = [sys.executable, str(doc_scraper_path), '--config', temp_config_path, '--fresh']
+        cmd = [sys.executable, str(doc_scraper_path), "--config", temp_config_path, "--fresh"]
 
         result = subprocess.run(cmd, capture_output=True, text=True, stdin=subprocess.DEVNULL)
 
@@ -213,18 +209,20 @@ class UnifiedScraper:
         docs_data_file = f"output/{doc_config['name']}_data/summary.json"
 
         if os.path.exists(docs_data_file):
-            with open(docs_data_file, 'r', encoding='utf-8') as f:
+            with open(docs_data_file, encoding="utf-8") as f:
                 summary = json.load(f)
 
             # Append to documentation list (multi-source support)
-            self.scraped_data['documentation'].append({
-                'source_id': doc_config['name'],
-                'base_url': source['base_url'],
-                'pages': summary.get('pages', []),
-                'total_pages': summary.get('total_pages', 0),
-                'data_file': docs_data_file,
-                'refs_dir': ''  # Will be set after moving to cache
-            })
+            self.scraped_data["documentation"].append(
+                {
+                    "source_id": doc_config["name"],
+                    "base_url": source["base_url"],
+                    "pages": summary.get("pages", []),
+                    "total_pages": summary.get("total_pages", 0),
+                    "data_file": docs_data_file,
+                    "refs_dir": "",  # Will be set after moving to cache
+                }
+            )
 
             logger.info(f"✅ Documentation: {summary.get('total_pages', 0)} pages scraped")
         else:
@@ -246,9 +244,9 @@ class UnifiedScraper:
             logger.info(f"📦 Moved docs output to cache: {cache_docs_dir}")
 
             # Update refs_dir in scraped_data with cache location
-            refs_dir_path = os.path.join(cache_docs_dir, 'references')
-            if self.scraped_data['documentation']:
-                self.scraped_data['documentation'][-1]['refs_dir'] = refs_dir_path
+            refs_dir_path = os.path.join(cache_docs_dir, "references")
+            if self.scraped_data["documentation"]:
+                self.scraped_data["documentation"][-1]["refs_dir"] = refs_dir_path
 
         if os.path.exists(docs_data_dir):
             cache_data_dir = os.path.join(self.data_dir, f"{doc_config['name']}_data")
@@ -257,7 +255,7 @@ class UnifiedScraper:
             shutil.move(docs_data_dir, cache_data_dir)
             logger.info(f"📦 Moved docs data to cache: {cache_data_dir}")
 
-    def _clone_github_repo(self, repo_name: str, idx: int = 0) -> Optional[str]:
+    def _clone_github_repo(self, repo_name: str, idx: int = 0) -> str | None:
         """
         Clone GitHub repository to cache directory for C3.x analysis.
         Reuses existing clone if already present.
@@ -274,9 +272,9 @@ class UnifiedScraper:
         clone_path = os.path.join(self.repos_dir, repo_dir_name)
 
         # Check if already cloned
-        if os.path.exists(clone_path) and os.path.isdir(os.path.join(clone_path, '.git')):
+        if os.path.exists(clone_path) and os.path.isdir(os.path.join(clone_path, ".git")):
             logger.info(f"♻️  Found existing repository clone: {clone_path}")
-            logger.info(f"   Reusing for C3.x analysis (skip re-cloning)")
+            logger.info("   Reusing for C3.x analysis (skip re-cloning)")
             return clone_path
 
         # repos_dir already created in __init__
@@ -285,18 +283,18 @@ class UnifiedScraper:
         repo_url = f"https://github.com/{repo_name}.git"
         logger.info(f"🔄 Cloning repository for C3.x analysis: {repo_url}")
         logger.info(f"   → {clone_path}")
-        logger.info(f"   💾 Clone will be saved for future reuse")
+        logger.info("   💾 Clone will be saved for future reuse")
 
         try:
             result = subprocess.run(
-                ['git', 'clone', repo_url, clone_path],
+                ["git", "clone", repo_url, clone_path],
                 capture_output=True,
                 text=True,
-                timeout=600  # 10 minute timeout for full clone
+                timeout=600,  # 10 minute timeout for full clone
             )
 
             if result.returncode == 0:
-                logger.info(f"✅ Repository cloned successfully")
+                logger.info("✅ Repository cloned successfully")
                 logger.info(f"   📁 Saved to: {clone_path}")
                 return clone_path
             else:
@@ -307,7 +305,7 @@ class UnifiedScraper:
                 return None
 
         except subprocess.TimeoutExpired:
-            logger.error(f"❌ Git clone timed out after 10 minutes")
+            logger.error("❌ Git clone timed out after 10 minutes")
             if os.path.exists(clone_path):
                 shutil.rmtree(clone_path)
             return None
@@ -317,7 +315,7 @@ class UnifiedScraper:
                 shutil.rmtree(clone_path)
             return None
 
-    def _scrape_github(self, source: Dict[str, Any]):
+    def _scrape_github(self, source: dict[str, Any]):
         """Scrape GitHub repository."""
         try:
             from skill_seekers.cli.github_scraper import GitHubScraper
@@ -326,16 +324,16 @@ class UnifiedScraper:
             return
 
         # Multi-source support: Get unique index for this GitHub source
-        idx = self._source_counters['github']
-        self._source_counters['github'] += 1
+        idx = self._source_counters["github"]
+        self._source_counters["github"] += 1
 
         # Extract repo identifier for unique naming
-        repo = source['repo']
-        repo_id = repo.replace('/', '_')
+        repo = source["repo"]
+        repo_id = repo.replace("/", "_")
 
         # Check if we need to clone for C3.x analysis
-        enable_codebase_analysis = source.get('enable_codebase_analysis', True)
-        local_repo_path = source.get('local_repo_path')
+        enable_codebase_analysis = source.get("enable_codebase_analysis", True)
+        local_repo_path = source.get("local_repo_path")
         cloned_repo_path = None
 
         # Auto-clone if C3.x analysis is enabled but no local path provided
@@ -351,24 +349,24 @@ class UnifiedScraper:
 
         # Create config for GitHub scraper
         github_config = {
-            'repo': repo,
-            'name': f"{self.name}_github_{idx}_{repo_id}",
-            'github_token': source.get('github_token'),
-            'include_issues': source.get('include_issues', True),
-            'max_issues': source.get('max_issues', 100),
-            'include_changelog': source.get('include_changelog', True),
-            'include_releases': source.get('include_releases', True),
-            'include_code': source.get('include_code', True),
-            'code_analysis_depth': source.get('code_analysis_depth', 'surface'),
-            'file_patterns': source.get('file_patterns', []),
-            'local_repo_path': local_repo_path  # Use cloned path if available
+            "repo": repo,
+            "name": f"{self.name}_github_{idx}_{repo_id}",
+            "github_token": source.get("github_token"),
+            "include_issues": source.get("include_issues", True),
+            "max_issues": source.get("max_issues", 100),
+            "include_changelog": source.get("include_changelog", True),
+            "include_releases": source.get("include_releases", True),
+            "include_code": source.get("include_code", True),
+            "code_analysis_depth": source.get("code_analysis_depth", "surface"),
+            "file_patterns": source.get("file_patterns", []),
+            "local_repo_path": local_repo_path,  # Use cloned path if available
         }
 
         # Pass directory exclusions if specified (optional)
-        if 'exclude_dirs' in source:
-            github_config['exclude_dirs'] = source['exclude_dirs']
-        if 'exclude_dirs_additional' in source:
-            github_config['exclude_dirs_additional'] = source['exclude_dirs_additional']
+        if "exclude_dirs" in source:
+            github_config["exclude_dirs"] = source["exclude_dirs"]
+        if "exclude_dirs_additional" in source:
+            github_config["exclude_dirs_additional"] = source["exclude_dirs_additional"]
 
         # Scrape
         logger.info(f"Scraping GitHub repository: {source['repo']}")
@@ -381,13 +379,14 @@ class UnifiedScraper:
             try:
                 c3_data = self._run_c3_analysis(local_repo_path, source)
                 if c3_data:
-                    github_data['c3_analysis'] = c3_data
+                    github_data["c3_analysis"] = c3_data
                     logger.info("✅ C3.x analysis complete")
                 else:
                     logger.warning("⚠️  C3.x analysis returned no data")
             except Exception as e:
                 logger.warning(f"⚠️  C3.x analysis failed: {e}")
                 import traceback
+
                 logger.debug(f"Traceback: {traceback.format_exc()}")
                 # Continue without C3.x data - graceful degradation
 
@@ -396,32 +395,29 @@ class UnifiedScraper:
             logger.info(f"📁 Repository clone saved for future use: {cloned_repo_path}")
 
         # Save data to unified location with unique filename
-        github_data_file = os.path.join(self.data_dir, f'github_data_{idx}_{repo_id}.json')
-        with open(github_data_file, 'w', encoding='utf-8') as f:
+        github_data_file = os.path.join(self.data_dir, f"github_data_{idx}_{repo_id}.json")
+        with open(github_data_file, "w", encoding="utf-8") as f:
             json.dump(github_data, f, indent=2, ensure_ascii=False)
 
         # ALSO save to the location GitHubToSkillConverter expects (with C3.x data!)
         converter_data_file = f"output/{github_config['name']}_github_data.json"
-        with open(converter_data_file, 'w', encoding='utf-8') as f:
+        with open(converter_data_file, "w", encoding="utf-8") as f:
             json.dump(github_data, f, indent=2, ensure_ascii=False)
 
         # Append to list instead of overwriting (multi-source support)
-        self.scraped_data['github'].append({
-            'repo': repo,
-            'repo_id': repo_id,
-            'idx': idx,
-            'data': github_data,
-            'data_file': github_data_file
-        })
+        self.scraped_data["github"].append(
+            {"repo": repo, "repo_id": repo_id, "idx": idx, "data": github_data, "data_file": github_data_file}
+        )
 
         # Build standalone SKILL.md for synthesis using GitHubToSkillConverter
         try:
             from skill_seekers.cli.github_scraper import GitHubToSkillConverter
+
             # Use github_config which has the correct name field
             # Converter will load from output/{name}_github_data.json which now has C3.x data
             converter = GitHubToSkillConverter(config=github_config)
             converter.build_skill()
-            logger.info(f"✅ GitHub: Standalone SKILL.md created")
+            logger.info("✅ GitHub: Standalone SKILL.md created")
         except Exception as e:
             logger.warning(f"⚠️  Failed to build standalone GitHub SKILL.md: {e}")
 
@@ -430,7 +426,7 @@ class UnifiedScraper:
         github_data_file_path = f"output/{github_config['name']}_github_data.json"
 
         if os.path.exists(github_output_dir):
-            cache_github_dir = os.path.join(self.sources_dir, github_config['name'])
+            cache_github_dir = os.path.join(self.sources_dir, github_config["name"])
             if os.path.exists(cache_github_dir):
                 shutil.rmtree(cache_github_dir)
             shutil.move(github_output_dir, cache_github_dir)
@@ -443,9 +439,9 @@ class UnifiedScraper:
             shutil.move(github_data_file_path, cache_github_data)
             logger.info(f"📦 Moved GitHub data to cache: {cache_github_data}")
 
-        logger.info(f"✅ GitHub: Repository scraped successfully")
+        logger.info("✅ GitHub: Repository scraped successfully")
 
-    def _scrape_pdf(self, source: Dict[str, Any]):
+    def _scrape_pdf(self, source: dict[str, Any]):
         """Scrape PDF document."""
         try:
             from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
@@ -454,20 +450,20 @@ class UnifiedScraper:
             return
 
         # Multi-source support: Get unique index for this PDF source
-        idx = self._source_counters['pdf']
-        self._source_counters['pdf'] += 1
+        idx = self._source_counters["pdf"]
+        self._source_counters["pdf"] += 1
 
         # Extract PDF identifier for unique naming (filename without extension)
-        pdf_path = source['path']
+        pdf_path = source["path"]
         pdf_id = os.path.splitext(os.path.basename(pdf_path))[0]
 
         # Create config for PDF scraper
         pdf_config = {
-            'name': f"{self.name}_pdf_{idx}_{pdf_id}",
-            'pdf': source['path'],
-            'extract_tables': source.get('extract_tables', False),
-            'ocr': source.get('ocr', False),
-            'password': source.get('password')
+            "name": f"{self.name}_pdf_{idx}_{pdf_id}",
+            "pdf": source["path"],
+            "extract_tables": source.get("extract_tables", False),
+            "ocr": source.get("ocr", False),
+            "password": source.get("password"),
         }
 
         # Scrape
@@ -476,29 +472,25 @@ class UnifiedScraper:
         pdf_data = converter.extract_all()
 
         # Save data
-        pdf_data_file = os.path.join(self.data_dir, f'pdf_data_{idx}_{pdf_id}.json')
-        with open(pdf_data_file, 'w', encoding='utf-8') as f:
+        pdf_data_file = os.path.join(self.data_dir, f"pdf_data_{idx}_{pdf_id}.json")
+        with open(pdf_data_file, "w", encoding="utf-8") as f:
             json.dump(pdf_data, f, indent=2, ensure_ascii=False)
 
         # Append to list instead of overwriting
-        self.scraped_data['pdf'].append({
-            'pdf_path': pdf_path,
-            'pdf_id': pdf_id,
-            'idx': idx,
-            'data': pdf_data,
-            'data_file': pdf_data_file
-        })
+        self.scraped_data["pdf"].append(
+            {"pdf_path": pdf_path, "pdf_id": pdf_id, "idx": idx, "data": pdf_data, "data_file": pdf_data_file}
+        )
 
         # Build standalone SKILL.md for synthesis
         try:
             converter.build_skill()
-            logger.info(f"✅ PDF: Standalone SKILL.md created")
+            logger.info("✅ PDF: Standalone SKILL.md created")
         except Exception as e:
             logger.warning(f"⚠️  Failed to build standalone PDF SKILL.md: {e}")
 
         logger.info(f"✅ PDF: {len(pdf_data.get('pages', []))} pages extracted")
 
-    def _load_json(self, file_path: Path) -> Dict:
+    def _load_json(self, file_path: Path) -> dict:
         """
         Load JSON file safely.
 
@@ -513,13 +505,13 @@ class UnifiedScraper:
             return {}
 
         try:
-            with open(file_path, 'r', encoding='utf-8') as f:
+            with open(file_path, encoding="utf-8") as f:
                 return json.load(f)
-        except (json.JSONDecodeError, IOError) as e:
+        except (OSError, json.JSONDecodeError) as e:
             logger.warning(f"Failed to load JSON {file_path}: {e}")
             return {}
 
-    def _load_guide_collection(self, tutorials_dir: Path) -> Dict:
+    def _load_guide_collection(self, tutorials_dir: Path) -> dict:
         """
         Load how-to guide collection from tutorials directory.
 
@@ -531,22 +523,22 @@ class UnifiedScraper:
         """
         if not tutorials_dir.exists():
             logger.warning(f"Tutorials directory not found: {tutorials_dir}")
-            return {'guides': []}
+            return {"guides": []}
 
-        collection_file = tutorials_dir / 'guide_collection.json'
+        collection_file = tutorials_dir / "guide_collection.json"
         if collection_file.exists():
             return self._load_json(collection_file)
 
         # Fallback: scan for individual guide JSON files
         guides = []
-        for guide_file in tutorials_dir.glob('guide_*.json'):
+        for guide_file in tutorials_dir.glob("guide_*.json"):
             guide_data = self._load_json(guide_file)
             if guide_data:
                 guides.append(guide_data)
 
-        return {'guides': guides, 'total_count': len(guides)}
+        return {"guides": guides, "total_count": len(guides)}
 
-    def _load_api_reference(self, api_dir: Path) -> Dict[str, Any]:
+    def _load_api_reference(self, api_dir: Path) -> dict[str, Any]:
         """
         Load API reference markdown files from api_reference directory.
 
@@ -561,16 +553,16 @@ class UnifiedScraper:
             return {}
 
         api_refs = {}
-        for md_file in api_dir.glob('*.md'):
+        for md_file in api_dir.glob("*.md"):
             try:
                 module_name = md_file.stem
-                api_refs[module_name] = md_file.read_text(encoding='utf-8')
-            except IOError as e:
+                api_refs[module_name] = md_file.read_text(encoding="utf-8")
+            except OSError as e:
                 logger.warning(f"Failed to read API reference {md_file}: {e}")
 
         return api_refs
 
-    def _run_c3_analysis(self, local_repo_path: str, source: Dict[str, Any]) -> Dict[str, Any]:
+    def _run_c3_analysis(self, local_repo_path: str, source: dict[str, Any]) -> dict[str, Any]:
         """
         Run comprehensive C3.x codebase analysis.
 
@@ -592,7 +584,7 @@ class UnifiedScraper:
             return {}
 
         # Create temp output dir for C3.x analysis
-        temp_output = Path(self.data_dir) / 'c3_analysis_temp'
+        temp_output = Path(self.data_dir) / "c3_analysis_temp"
         temp_output.mkdir(parents=True, exist_ok=True)
 
         logger.info(f"   Analyzing codebase: {local_repo_path}")
@@ -602,37 +594,37 @@ class UnifiedScraper:
             results = analyze_codebase(
                 directory=Path(local_repo_path),
                 output_dir=temp_output,
-                depth='deep',
+                depth="deep",
                 languages=None,  # Analyze all languages
-                file_patterns=source.get('file_patterns'),
-                build_api_reference=True,   # C2.5: API Reference
-                extract_comments=False,     # Not needed
+                file_patterns=source.get("file_patterns"),
+                build_api_reference=True,  # C2.5: API Reference
+                extract_comments=False,  # Not needed
                 build_dependency_graph=True,  # C2.6: Dependency Graph
-                detect_patterns=True,       # C3.1: Design patterns
-                extract_test_examples=True, # C3.2: Test examples
-                build_how_to_guides=True,   # C3.3: How-to guides
+                detect_patterns=True,  # C3.1: Design patterns
+                extract_test_examples=True,  # C3.2: Test examples
+                build_how_to_guides=True,  # C3.3: How-to guides
                 extract_config_patterns=True,  # C3.4: Config patterns
-                enhance_with_ai=source.get('ai_mode', 'auto') != 'none',
-                ai_mode=source.get('ai_mode', 'auto')
+                enhance_with_ai=source.get("ai_mode", "auto") != "none",
+                ai_mode=source.get("ai_mode", "auto"),
             )
 
             # Load C3.x outputs into memory
             c3_data = {
-                'patterns': self._load_json(temp_output / 'patterns' / 'detected_patterns.json'),
-                'test_examples': self._load_json(temp_output / 'test_examples' / 'test_examples.json'),
-                'how_to_guides': self._load_guide_collection(temp_output / 'tutorials'),
-                'config_patterns': self._load_json(temp_output / 'config_patterns' / 'config_patterns.json'),
-                'architecture': self._load_json(temp_output / 'architecture' / 'architectural_patterns.json'),
-                'api_reference': self._load_api_reference(temp_output / 'api_reference'),  # C2.5
-                'dependency_graph': self._load_json(temp_output / 'dependencies' / 'dependency_graph.json')  # C2.6
+                "patterns": self._load_json(temp_output / "patterns" / "detected_patterns.json"),
+                "test_examples": self._load_json(temp_output / "test_examples" / "test_examples.json"),
+                "how_to_guides": self._load_guide_collection(temp_output / "tutorials"),
+                "config_patterns": self._load_json(temp_output / "config_patterns" / "config_patterns.json"),
+                "architecture": self._load_json(temp_output / "architecture" / "architectural_patterns.json"),
+                "api_reference": self._load_api_reference(temp_output / "api_reference"),  # C2.5
+                "dependency_graph": self._load_json(temp_output / "dependencies" / "dependency_graph.json"),  # C2.6
             }
 
             # Log summary
-            total_patterns = sum(len(f.get('patterns', [])) for f in c3_data.get('patterns', []))
-            total_examples = c3_data.get('test_examples', {}).get('total_examples', 0)
-            total_guides = len(c3_data.get('how_to_guides', {}).get('guides', []))
-            total_configs = len(c3_data.get('config_patterns', {}).get('config_files', []))
-            arch_patterns = len(c3_data.get('architecture', {}).get('patterns', []))
+            total_patterns = sum(len(f.get("patterns", [])) for f in c3_data.get("patterns", []))
+            total_examples = c3_data.get("test_examples", {}).get("total_examples", 0)
+            total_guides = len(c3_data.get("how_to_guides", {}).get("guides", []))
+            total_configs = len(c3_data.get("config_patterns", {}).get("config_files", []))
+            arch_patterns = len(c3_data.get("architecture", {}).get("patterns", []))
 
             logger.info(f"   ✓ Design Patterns: {total_patterns}")
             logger.info(f"   ✓ Test Examples: {total_examples}")
@@ -645,6 +637,7 @@ class UnifiedScraper:
         except Exception as e:
             logger.error(f"C3.x analysis failed: {e}")
             import traceback
+
             traceback.print_exc()
             return {}
 
@@ -656,7 +649,7 @@ class UnifiedScraper:
                 except Exception as e:
                     logger.warning(f"Failed to clean up temp directory: {e}")
 
-    def detect_conflicts(self) -> List:
+    def detect_conflicts(self) -> list:
         """
         Detect conflicts between documentation and code.
 
@@ -674,18 +667,18 @@ class UnifiedScraper:
             return []
 
         # Get documentation and GitHub data
-        docs_data = self.scraped_data.get('documentation', {})
-        github_data = self.scraped_data.get('github', {})
+        docs_data = self.scraped_data.get("documentation", {})
+        github_data = self.scraped_data.get("github", {})
 
         if not docs_data or not github_data:
             logger.warning("Missing documentation or GitHub data for conflict detection")
             return []
 
         # Load data files
-        with open(docs_data['data_file'], 'r', encoding='utf-8') as f:
+        with open(docs_data["data_file"], encoding="utf-8") as f:
             docs_json = json.load(f)
 
-        with open(github_data['data_file'], 'r', encoding='utf-8') as f:
+        with open(github_data["data_file"], encoding="utf-8") as f:
             github_json = json.load(f)
 
         # Detect conflicts
@@ -693,26 +686,26 @@ class UnifiedScraper:
         conflicts = detector.detect_all_conflicts()
 
         # Save conflicts
-        conflicts_file = os.path.join(self.data_dir, 'conflicts.json')
+        conflicts_file = os.path.join(self.data_dir, "conflicts.json")
         detector.save_conflicts(conflicts, conflicts_file)
 
         # Print summary
         summary = detector.generate_summary(conflicts)
-        logger.info(f"\n📊 Conflict Summary:")
+        logger.info("\n📊 Conflict Summary:")
         logger.info(f"   Total: {summary['total']}")
-        logger.info(f"   By Type:")
-        for ctype, count in summary['by_type'].items():
+        logger.info("   By Type:")
+        for ctype, count in summary["by_type"].items():
             if count > 0:
                 logger.info(f"     - {ctype}: {count}")
-        logger.info(f"   By Severity:")
-        for severity, count in summary['by_severity'].items():
+        logger.info("   By Severity:")
+        for severity, count in summary["by_severity"].items():
             if count > 0:
-                emoji = '🔴' if severity == 'high' else '🟡' if severity == 'medium' else '🟢'
+                emoji = "🔴" if severity == "high" else "🟡" if severity == "medium" else "🟢"
                 logger.info(f"     {emoji} {severity}: {count}")
 
         return conflicts
 
-    def merge_sources(self, conflicts: List):
+    def merge_sources(self, conflicts: list):
         """
         Merge data from multiple sources.
 
@@ -728,18 +721,18 @@ class UnifiedScraper:
             return None
 
         # Get data files
-        docs_data = self.scraped_data.get('documentation', {})
-        github_data = self.scraped_data.get('github', {})
+        docs_data = self.scraped_data.get("documentation", {})
+        github_data = self.scraped_data.get("github", {})
 
         # Load data
-        with open(docs_data['data_file'], 'r', encoding='utf-8') as f:
+        with open(docs_data["data_file"], encoding="utf-8") as f:
             docs_json = json.load(f)
 
-        with open(github_data['data_file'], 'r', encoding='utf-8') as f:
+        with open(github_data["data_file"], encoding="utf-8") as f:
             github_json = json.load(f)
 
         # Choose merger
-        if self.merge_mode == 'claude-enhanced':
+        if self.merge_mode == "claude-enhanced":
             merger = ClaudeEnhancedMerger(docs_json, github_json, conflicts)
         else:
             merger = RuleBasedMerger(docs_json, github_json, conflicts)
@@ -748,15 +741,15 @@ class UnifiedScraper:
         merged_data = merger.merge_all()
 
         # Save merged data
-        merged_file = os.path.join(self.data_dir, 'merged_data.json')
-        with open(merged_file, 'w', encoding='utf-8') as f:
+        merged_file = os.path.join(self.data_dir, "merged_data.json")
+        with open(merged_file, "w", encoding="utf-8") as f:
             json.dump(merged_data, f, indent=2, ensure_ascii=False)
 
         logger.info(f"✅ Merged data saved: {merged_file}")
 
         return merged_data
 
-    def build_skill(self, merged_data: Optional[Dict] = None):
+    def build_skill(self, merged_data: dict | None = None):
         """
         Build final unified skill.
 
@@ -769,20 +762,14 @@ class UnifiedScraper:
 
         # Load conflicts if they exist
         conflicts = []
-        conflicts_file = os.path.join(self.data_dir, 'conflicts.json')
+        conflicts_file = os.path.join(self.data_dir, "conflicts.json")
         if os.path.exists(conflicts_file):
-            with open(conflicts_file, 'r', encoding='utf-8') as f:
+            with open(conflicts_file, encoding="utf-8") as f:
                 conflicts_data = json.load(f)
-                conflicts = conflicts_data.get('conflicts', [])
+                conflicts = conflicts_data.get("conflicts", [])
 
         # Build skill
-        builder = UnifiedSkillBuilder(
-            self.config,
-            self.scraped_data,
-            merged_data,
-            conflicts,
-            cache_dir=self.cache_dir
-        )
+        builder = UnifiedSkillBuilder(self.config, self.scraped_data, merged_data, conflicts, cache_dir=self.cache_dir)
 
         builder.build()
 
@@ -824,6 +811,7 @@ class UnifiedScraper:
         except Exception as e:
             logger.error(f"\n\n❌ Error during scraping: {e}")
             import traceback
+
             traceback.print_exc()
             sys.exit(1)
 
@@ -831,7 +819,7 @@ class UnifiedScraper:
 def main():
     """Main entry point."""
     parser = argparse.ArgumentParser(
-        description='Unified multi-source scraper',
+        description="Unified multi-source scraper",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
@@ -843,17 +831,18 @@ Examples:
 
   # Backward compatible with legacy configs
   skill-seekers unified --config configs/react.json
-        """
+        """,
     )
 
-    parser.add_argument('--config', '-c', required=True,
-                       help='Path to unified config JSON file')
-    parser.add_argument('--merge-mode', '-m',
-                       choices=['rule-based', 'claude-enhanced'],
-                       help='Override config merge mode')
-    parser.add_argument('--skip-codebase-analysis',
-                       action='store_true',
-                       help='Skip C3.x codebase analysis for GitHub sources (default: enabled)')
+    parser.add_argument("--config", "-c", required=True, help="Path to unified config JSON file")
+    parser.add_argument(
+        "--merge-mode", "-m", choices=["rule-based", "claude-enhanced"], help="Override config merge mode"
+    )
+    parser.add_argument(
+        "--skip-codebase-analysis",
+        action="store_true",
+        help="Skip C3.x codebase analysis for GitHub sources (default: enabled)",
+    )
 
     args = parser.parse_args()
 
@@ -862,14 +851,14 @@ Examples:
 
     # Disable codebase analysis if requested
     if args.skip_codebase_analysis:
-        for source in scraper.config.get('sources', []):
-            if source['type'] == 'github':
-                source['enable_codebase_analysis'] = False
+        for source in scraper.config.get("sources", []):
+            if source["type"] == "github":
+                source["enable_codebase_analysis"] = False
                 logger.info(f"⏭️  Skipping codebase analysis for GitHub source: {source.get('repo', 'unknown')}")
 
     # Run scraper
     scraper.run()
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
diff --git a/src/skill_seekers/cli/unified_skill_builder.py b/src/skill_seekers/cli/unified_skill_builder.py
index ee67239..c414c2d 100644
--- a/src/skill_seekers/cli/unified_skill_builder.py
+++ b/src/skill_seekers/cli/unified_skill_builder.py
@@ -12,12 +12,11 @@ Supports mixed sources (documentation, GitHub, PDF) and highlights
 discrepancies transparently.
 """
 
-import os
 import json
-import shutil
 import logging
+import os
+import shutil
 from pathlib import Path
-from typing import Dict, List, Any, Optional
 
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -28,9 +27,14 @@ class UnifiedSkillBuilder:
     Builds unified skill from multi-source data.
     """
 
-    def __init__(self, config: Dict, scraped_data: Dict,
-                 merged_data: Optional[Dict] = None, conflicts: Optional[List] = None,
-                 cache_dir: Optional[str] = None):
+    def __init__(
+        self,
+        config: dict,
+        scraped_data: dict,
+        merged_data: dict | None = None,
+        conflicts: list | None = None,
+        cache_dir: str | None = None,
+    ):
         """
         Initialize skill builder.
 
@@ -47,8 +51,8 @@ class UnifiedSkillBuilder:
         self.conflicts = conflicts or []
         self.cache_dir = cache_dir
 
-        self.name = config['name']
-        self.description = config['description']
+        self.name = config["name"]
+        self.description = config["description"]
         self.skill_dir = f"output/{self.name}"
 
         # Create directories
@@ -73,7 +77,7 @@ class UnifiedSkillBuilder:
 
         logger.info(f"✅ Unified skill built: {self.skill_dir}/")
 
-    def _load_source_skill_mds(self) -> Dict[str, str]:
+    def _load_source_skill_mds(self) -> dict[str, str]:
         """Load standalone SKILL.md files from each source.
 
         Returns:
@@ -92,9 +96,9 @@ class UnifiedSkillBuilder:
         docs_skill_path = sources_dir / f"{self.name}_docs" / "SKILL.md"
         if docs_skill_path.exists():
             try:
-                skill_mds['documentation'] = docs_skill_path.read_text(encoding='utf-8')
+                skill_mds["documentation"] = docs_skill_path.read_text(encoding="utf-8")
                 logger.debug(f"Loaded documentation SKILL.md ({len(skill_mds['documentation'])} chars)")
-            except IOError as e:
+            except OSError as e:
                 logger.warning(f"Failed to read documentation SKILL.md: {e}")
 
         # Load ALL GitHub sources (multi-source support)
@@ -103,15 +107,15 @@ class UnifiedSkillBuilder:
             github_skill_path = github_dir / "SKILL.md"
             if github_skill_path.exists():
                 try:
-                    content = github_skill_path.read_text(encoding='utf-8')
+                    content = github_skill_path.read_text(encoding="utf-8")
                     github_sources.append(content)
                     logger.debug(f"Loaded GitHub SKILL.md from {github_dir.name} ({len(content)} chars)")
-                except IOError as e:
+                except OSError as e:
                     logger.warning(f"Failed to read GitHub SKILL.md from {github_dir.name}: {e}")
 
         if github_sources:
             # Concatenate all GitHub sources with separator
-            skill_mds['github'] = '\n\n---\n\n'.join(github_sources)
+            skill_mds["github"] = "\n\n---\n\n".join(github_sources)
             logger.debug(f"Combined {len(github_sources)} GitHub SKILL.md files")
 
         # Load ALL PDF sources (multi-source support)
@@ -120,21 +124,21 @@ class UnifiedSkillBuilder:
             pdf_skill_path = pdf_dir / "SKILL.md"
             if pdf_skill_path.exists():
                 try:
-                    content = pdf_skill_path.read_text(encoding='utf-8')
+                    content = pdf_skill_path.read_text(encoding="utf-8")
                     pdf_sources.append(content)
                     logger.debug(f"Loaded PDF SKILL.md from {pdf_dir.name} ({len(content)} chars)")
-                except IOError as e:
+                except OSError as e:
                     logger.warning(f"Failed to read PDF SKILL.md from {pdf_dir.name}: {e}")
 
         if pdf_sources:
             # Concatenate all PDF sources with separator
-            skill_mds['pdf'] = '\n\n---\n\n'.join(pdf_sources)
+            skill_mds["pdf"] = "\n\n---\n\n".join(pdf_sources)
             logger.debug(f"Combined {len(pdf_sources)} PDF SKILL.md files")
 
         logger.info(f"Loaded {len(skill_mds)} source SKILL.md files")
         return skill_mds
 
-    def _parse_skill_md_sections(self, skill_md: str) -> Dict[str, str]:
+    def _parse_skill_md_sections(self, skill_md: str) -> dict[str, str]:
         """Parse SKILL.md into sections by ## headers.
 
         Args:
@@ -148,21 +152,21 @@ class UnifiedSkillBuilder:
         current_section = None
         current_content = []
 
-        lines = skill_md.split('\n')
+        lines = skill_md.split("\n")
 
         for line in lines:
             # Detect section header (## Header)
-            if line.startswith('## '):
+            if line.startswith("## "):
                 # Save previous section
                 if current_section:
-                    sections[current_section] = '\n'.join(current_content).strip()
+                    sections[current_section] = "\n".join(current_content).strip()
 
                 # Start new section
                 current_section = line[3:].strip()
                 # Remove emoji and markdown formatting
-                current_section = current_section.split('](')[0]  # Remove links
-                for emoji in ['📚', '🏗️', '⚠️', '🔧', '📖', '💡', '🎯', '📊', '🔍', '⚙️', '🧪', '📝', '🗂️', '📐', '⚡']:
-                    current_section = current_section.replace(emoji, '').strip()
+                current_section = current_section.split("](")[0]  # Remove links
+                for emoji in ["📚", "🏗️", "⚠️", "🔧", "📖", "💡", "🎯", "📊", "🔍", "⚙️", "🧪", "📝", "🗂️", "📐", "⚡"]:
+                    current_section = current_section.replace(emoji, "").strip()
                 current_content = []
             elif current_section:
                 # Accumulate content for current section
@@ -170,12 +174,12 @@ class UnifiedSkillBuilder:
 
         # Save last section
         if current_section and current_content:
-            sections[current_section] = '\n'.join(current_content).strip()
+            sections[current_section] = "\n".join(current_content).strip()
 
         logger.debug(f"Parsed {len(sections)} sections from SKILL.md")
         return sections
 
-    def _synthesize_docs_github(self, skill_mds: Dict[str, str]) -> str:
+    def _synthesize_docs_github(self, skill_mds: dict[str, str]) -> str:
         """Synthesize documentation + GitHub sources with weighted merge.
 
         Strategy:
@@ -194,14 +198,14 @@ class UnifiedSkillBuilder:
         Returns:
             Synthesized SKILL.md content
         """
-        docs_sections = self._parse_skill_md_sections(skill_mds.get('documentation', ''))
-        github_sections = self._parse_skill_md_sections(skill_mds.get('github', ''))
+        docs_sections = self._parse_skill_md_sections(skill_mds.get("documentation", ""))
+        github_sections = self._parse_skill_md_sections(skill_mds.get("github", ""))
 
         # Extract GitHub metadata from full content
-        github_full = skill_mds.get('github', '')
+        github_full = skill_mds.get("github", "")
 
         # Start with YAML frontmatter
-        skill_name = self.name.lower().replace('_', '-').replace(' ', '-')[:64]
+        skill_name = self.name.lower().replace("_", "-").replace(" ", "-")[:64]
         desc = self.description[:1024] if len(self.description) > 1024 else self.description
 
         content = f"""---
@@ -217,103 +221,103 @@ description: {desc}
 
 This skill synthesizes knowledge from multiple sources:
 
-- ✅ **Official Documentation**: {self.config.get('sources', [{}])[0].get('base_url', 'N/A')}
-- ✅ **GitHub Repository**: {[s for s in self.config.get('sources', []) if s.get('type') == 'github'][0].get('repo', 'N/A') if [s for s in self.config.get('sources', []) if s.get('type') == 'github'] else 'N/A'}
+- ✅ **Official Documentation**: {self.config.get("sources", [{}])[0].get("base_url", "N/A")}
+- ✅ **GitHub Repository**: {[s for s in self.config.get("sources", []) if s.get("type") == "github"][0].get("repo", "N/A") if [s for s in self.config.get("sources", []) if s.get("type") == "github"] else "N/A"}
 
 """
 
         # Add GitHub Description and Metadata if present
-        if 'Description' in github_sections:
+        if "Description" in github_sections:
             content += "## 📦 About\n\n"
-            content += github_sections['Description'] + "\n\n"
+            content += github_sections["Description"] + "\n\n"
 
         # Add Repository Info from GitHub
-        if 'Repository Info' in github_sections:
+        if "Repository Info" in github_sections:
             content += "### Repository Info\n\n"
-            content += github_sections['Repository Info'] + "\n\n"
+            content += github_sections["Repository Info"] + "\n\n"
 
         # Add Language stats from GitHub
-        if 'Languages' in github_sections:
+        if "Languages" in github_sections:
             content += "### Languages\n\n"
-            content += github_sections['Languages'] + "\n\n"
+            content += github_sections["Languages"] + "\n\n"
 
         content += "## 💡 When to Use This Skill\n\n"
 
         # Merge "When to Use" sections - Fix placeholder text
         when_to_use_added = False
-        for key in ['When to Use This Skill', 'When to Use']:
+        for key in ["When to Use This Skill", "When to Use"]:
             if key in docs_sections:
                 # Fix placeholder text: httpx_docs → httpx
-                when_content = docs_sections[key].replace('httpx_docs', self.name)
-                when_content = when_content.replace('httpx_github', self.name)
+                when_content = docs_sections[key].replace("httpx_docs", self.name)
+                when_content = when_content.replace("httpx_github", self.name)
                 content += when_content + "\n\n"
                 when_to_use_added = True
                 break
 
-        if 'When to Use This Skill' in github_sections:
+        if "When to Use This Skill" in github_sections:
             if when_to_use_added:
                 content += "**From repository analysis:**\n\n"
-            content += github_sections['When to Use This Skill'] + "\n\n"
+            content += github_sections["When to Use This Skill"] + "\n\n"
 
         # Quick Reference: Merge from both sources
         content += "## 🎯 Quick Reference\n\n"
 
-        if 'Quick Reference' in docs_sections:
+        if "Quick Reference" in docs_sections:
             content += "**From Documentation:**\n\n"
-            content += docs_sections['Quick Reference'] + "\n\n"
+            content += docs_sections["Quick Reference"] + "\n\n"
 
-        if 'Quick Reference' in github_sections:
+        if "Quick Reference" in github_sections:
             # Include GitHub's Quick Reference (contains design patterns summary)
             logger.info(f"DEBUG: Including GitHub Quick Reference ({len(github_sections['Quick Reference'])} chars)")
-            content += github_sections['Quick Reference'] + "\n\n"
+            content += github_sections["Quick Reference"] + "\n\n"
         else:
             logger.warning("DEBUG: GitHub Quick Reference section NOT FOUND!")
 
         # Design Patterns (GitHub only - C3.1 analysis)
-        if 'Design Patterns Detected' in github_sections:
+        if "Design Patterns Detected" in github_sections:
             content += "### Design Patterns Detected\n\n"
             content += "*From C3.1 codebase analysis (confidence > 0.7)*\n\n"
-            content += github_sections['Design Patterns Detected'] + "\n\n"
+            content += github_sections["Design Patterns Detected"] + "\n\n"
 
         # Code Examples: Prefer GitHub (real usage)
         content += "## 🧪 Code Examples\n\n"
 
-        if 'Code Examples' in github_sections:
+        if "Code Examples" in github_sections:
             content += "**From Repository Tests:**\n\n"
             # Note: GitHub section already includes "*High-quality examples from codebase (C3.2)*" label
-            content += github_sections['Code Examples'] + "\n\n"
-        elif 'Usage Examples' in github_sections:
+            content += github_sections["Code Examples"] + "\n\n"
+        elif "Usage Examples" in github_sections:
             content += "**From Repository:**\n\n"
-            content += github_sections['Usage Examples'] + "\n\n"
+            content += github_sections["Usage Examples"] + "\n\n"
 
-        if 'Example Code Patterns' in docs_sections:
+        if "Example Code Patterns" in docs_sections:
             content += "**From Documentation:**\n\n"
-            content += docs_sections['Example Code Patterns'] + "\n\n"
+            content += docs_sections["Example Code Patterns"] + "\n\n"
 
         # API Reference: Include from both sources
-        if 'API Reference' in docs_sections or 'API Reference' in github_sections:
+        if "API Reference" in docs_sections or "API Reference" in github_sections:
             content += "## 🔧 API Reference\n\n"
 
-            if 'API Reference' in github_sections:
+            if "API Reference" in github_sections:
                 # Note: GitHub section already includes "*Extracted from codebase analysis (C2.5)*" label
-                content += github_sections['API Reference'] + "\n\n"
+                content += github_sections["API Reference"] + "\n\n"
 
-            if 'API Reference' in docs_sections:
+            if "API Reference" in docs_sections:
                 content += "**Official API Documentation:**\n\n"
-                content += docs_sections['API Reference'] + "\n\n"
+                content += docs_sections["API Reference"] + "\n\n"
 
         # Known Issues: GitHub only
-        if 'Known Issues' in github_sections:
+        if "Known Issues" in github_sections:
             content += "## ⚠️ Known Issues\n\n"
             content += "*Recent issues from GitHub*\n\n"
-            content += github_sections['Known Issues'] + "\n\n"
+            content += github_sections["Known Issues"] + "\n\n"
 
         # Recent Releases: GitHub only (include subsection if present)
-        if 'Recent Releases' in github_sections:
+        if "Recent Releases" in github_sections:
             # Recent Releases might be a subsection within Known Issues
             # Check if it's standalone
-            releases_content = github_sections['Recent Releases']
-            if releases_content.strip() and not releases_content.startswith('###'):
+            releases_content = github_sections["Recent Releases"]
+            if releases_content.strip() and not releases_content.startswith("###"):
                 content += "### Recent Releases\n"
             content += releases_content + "\n\n"
 
@@ -330,7 +334,7 @@ This skill synthesizes knowledge from multiple sources:
 
         return content
 
-    def _synthesize_docs_github_pdf(self, skill_mds: Dict[str, str]) -> str:
+    def _synthesize_docs_github_pdf(self, skill_mds: dict[str, str]) -> str:
         """Synthesize all three sources: documentation + GitHub + PDF.
 
         Strategy:
@@ -346,21 +350,21 @@ This skill synthesizes knowledge from multiple sources:
         """
         # Start with docs+github synthesis
         base_content = self._synthesize_docs_github(skill_mds)
-        pdf_sections = self._parse_skill_md_sections(skill_mds.get('pdf', ''))
+        pdf_sections = self._parse_skill_md_sections(skill_mds.get("pdf", ""))
 
         # Find insertion point after Quick Reference
-        lines = base_content.split('\n')
+        lines = base_content.split("\n")
         insertion_index = -1
 
         for i, line in enumerate(lines):
-            if line.startswith('## 🧪 Code Examples') or line.startswith('## 🔧 API Reference'):
+            if line.startswith("## 🧪 Code Examples") or line.startswith("## 🔧 API Reference"):
                 insertion_index = i
                 break
 
         if insertion_index == -1:
             # Fallback: insert before Reference Documentation
             for i, line in enumerate(lines):
-                if line.startswith('## 📖 Reference Documentation'):
+                if line.startswith("## 📖 Reference Documentation"):
                     insertion_index = i
                     break
 
@@ -368,17 +372,17 @@ This skill synthesizes knowledge from multiple sources:
         pdf_content_lines = []
 
         # Add Chapter Overview
-        if 'Chapter Overview' in pdf_sections:
+        if "Chapter Overview" in pdf_sections:
             pdf_content_lines.append("## 📚 PDF Documentation Structure\n")
             pdf_content_lines.append("*From PDF analysis*\n")
-            pdf_content_lines.append(pdf_sections['Chapter Overview'])
+            pdf_content_lines.append(pdf_sections["Chapter Overview"])
             pdf_content_lines.append("\n")
 
         # Add Key Concepts
-        if 'Key Concepts' in pdf_sections:
+        if "Key Concepts" in pdf_sections:
             pdf_content_lines.append("## 🔍 Key Concepts\n")
             pdf_content_lines.append("*Extracted from PDF headings*\n")
-            pdf_content_lines.append(pdf_sections['Key Concepts'])
+            pdf_content_lines.append(pdf_sections["Key Concepts"])
             pdf_content_lines.append("\n")
 
         # Insert PDF content
@@ -388,17 +392,17 @@ This skill synthesizes knowledge from multiple sources:
             # Append at end before footer
             footer_index = -1
             for i, line in enumerate(lines):
-                if line.startswith('---') and i > len(lines) - 5:
+                if line.startswith("---") and i > len(lines) - 5:
                     footer_index = i
                     break
             if footer_index != -1:
                 lines[footer_index:footer_index] = pdf_content_lines
 
         # Update reference documentation to include PDF
-        final_content = '\n'.join(lines)
+        final_content = "\n".join(lines)
         final_content = final_content.replace(
-            '- [Codebase Analysis](references/codebase_analysis/ARCHITECTURE.md)\n',
-            '- [Codebase Analysis](references/codebase_analysis/ARCHITECTURE.md)\n- [PDF Documentation](references/pdf/)\n'
+            "- [Codebase Analysis](references/codebase_analysis/ARCHITECTURE.md)\n",
+            "- [Codebase Analysis](references/codebase_analysis/ARCHITECTURE.md)\n- [PDF Documentation](references/pdf/)\n",
         )
 
         return final_content
@@ -411,15 +415,15 @@ This skill synthesizes knowledge from multiple sources:
         2. If found, use synthesis formulas for rich content
         3. If not found, fall back to legacy minimal generation
         """
-        skill_path = os.path.join(self.skill_dir, 'SKILL.md')
+        skill_path = os.path.join(self.skill_dir, "SKILL.md")
 
         # Try to load source SKILL.md files
         skill_mds = self._load_source_skill_mds()
 
         # Determine synthesis strategy based on available sources
-        has_docs = 'documentation' in skill_mds
-        has_github = 'github' in skill_mds
-        has_pdf = 'pdf' in skill_mds
+        has_docs = "documentation" in skill_mds
+        has_github = "github" in skill_mds
+        has_pdf = "pdf" in skill_mds
 
         content = None
 
@@ -442,15 +446,15 @@ This skill synthesizes knowledge from multiple sources:
 
         elif has_docs:
             logger.info("Using documentation SKILL.md as-is")
-            content = skill_mds['documentation']
+            content = skill_mds["documentation"]
 
         elif has_github:
             logger.info("Using GitHub SKILL.md as-is")
-            content = skill_mds['github']
+            content = skill_mds["github"]
 
         elif has_pdf:
             logger.info("Using PDF SKILL.md as-is")
-            content = skill_mds['pdf']
+            content = skill_mds["pdf"]
 
         # Fallback: generate minimal SKILL.md (legacy behavior)
         if not content:
@@ -458,12 +462,12 @@ This skill synthesizes knowledge from multiple sources:
             content = self._generate_minimal_skill_md()
 
         # Write final content
-        with open(skill_path, 'w', encoding='utf-8') as f:
+        with open(skill_path, "w", encoding="utf-8") as f:
             f.write(content)
 
         logger.info(f"Created SKILL.md ({len(content)} chars, ~{len(content.split())} words)")
 
-    def _synthesize_docs_pdf(self, skill_mds: Dict[str, str]) -> str:
+    def _synthesize_docs_pdf(self, skill_mds: dict[str, str]) -> str:
         """Synthesize documentation + PDF sources.
 
         Strategy:
@@ -476,40 +480,40 @@ This skill synthesizes knowledge from multiple sources:
         Returns:
             Synthesized SKILL.md content
         """
-        docs_content = skill_mds['documentation']
-        pdf_sections = self._parse_skill_md_sections(skill_mds['pdf'])
+        docs_content = skill_mds["documentation"]
+        pdf_sections = self._parse_skill_md_sections(skill_mds["pdf"])
 
-        lines = docs_content.split('\n')
+        lines = docs_content.split("\n")
         insertion_index = -1
 
         # Find insertion point before Reference Documentation
         for i, line in enumerate(lines):
-            if line.startswith('## 📖 Reference') or line.startswith('## Reference'):
+            if line.startswith("## 📖 Reference") or line.startswith("## Reference"):
                 insertion_index = i
                 break
 
         # Build PDF sections
         pdf_content_lines = []
 
-        if 'Chapter Overview' in pdf_sections:
+        if "Chapter Overview" in pdf_sections:
             pdf_content_lines.append("## 📚 PDF Documentation Structure\n")
             pdf_content_lines.append("*From PDF analysis*\n")
-            pdf_content_lines.append(pdf_sections['Chapter Overview'])
+            pdf_content_lines.append(pdf_sections["Chapter Overview"])
             pdf_content_lines.append("\n")
 
-        if 'Key Concepts' in pdf_sections:
+        if "Key Concepts" in pdf_sections:
             pdf_content_lines.append("## 🔍 Key Concepts\n")
             pdf_content_lines.append("*Extracted from PDF headings*\n")
-            pdf_content_lines.append(pdf_sections['Key Concepts'])
+            pdf_content_lines.append(pdf_sections["Key Concepts"])
             pdf_content_lines.append("\n")
 
         # Insert PDF content
         if pdf_content_lines and insertion_index != -1:
             lines[insertion_index:insertion_index] = pdf_content_lines
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
-    def _synthesize_github_pdf(self, skill_mds: Dict[str, str]) -> str:
+    def _synthesize_github_pdf(self, skill_mds: dict[str, str]) -> str:
         """Synthesize GitHub + PDF sources.
 
         Strategy:
@@ -522,39 +526,39 @@ This skill synthesizes knowledge from multiple sources:
         Returns:
             Synthesized SKILL.md content
         """
-        github_content = skill_mds['github']
-        pdf_sections = self._parse_skill_md_sections(skill_mds['pdf'])
+        github_content = skill_mds["github"]
+        pdf_sections = self._parse_skill_md_sections(skill_mds["pdf"])
 
-        lines = github_content.split('\n')
+        lines = github_content.split("\n")
         insertion_index = -1
 
         # Find insertion point before Reference Documentation
         for i, line in enumerate(lines):
-            if line.startswith('## 📖 Reference') or line.startswith('## Reference'):
+            if line.startswith("## 📖 Reference") or line.startswith("## Reference"):
                 insertion_index = i
                 break
 
         # Build PDF sections
         pdf_content_lines = []
 
-        if 'Chapter Overview' in pdf_sections:
+        if "Chapter Overview" in pdf_sections:
             pdf_content_lines.append("## 📚 PDF Documentation Structure\n")
             pdf_content_lines.append("*From PDF analysis*\n")
-            pdf_content_lines.append(pdf_sections['Chapter Overview'])
+            pdf_content_lines.append(pdf_sections["Chapter Overview"])
             pdf_content_lines.append("\n")
 
         # Insert PDF content
         if pdf_content_lines and insertion_index != -1:
             lines[insertion_index:insertion_index] = pdf_content_lines
 
-        return '\n'.join(lines)
+        return "\n".join(lines)
 
     def _generate_minimal_skill_md(self) -> str:
         """Generate minimal SKILL.md (legacy fallback behavior).
 
         Used when no source SKILL.md files are available.
         """
-        skill_name = self.name.lower().replace('_', '-').replace(' ', '-')[:64]
+        skill_name = self.name.lower().replace("_", "-").replace(" ", "-")[:64]
         desc = self.description[:1024] if len(self.description) > 1024 else self.description
 
         content = f"""---
@@ -573,39 +577,39 @@ This skill combines knowledge from multiple sources:
 """
 
         # List sources
-        for source in self.config.get('sources', []):
-            source_type = source['type']
-            if source_type == 'documentation':
+        for source in self.config.get("sources", []):
+            source_type = source["type"]
+            if source_type == "documentation":
                 content += f"- ✅ **Documentation**: {source.get('base_url', 'N/A')}\n"
                 content += f"  - Pages: {source.get('max_pages', 'unlimited')}\n"
-            elif source_type == 'github':
+            elif source_type == "github":
                 content += f"- ✅ **GitHub Repository**: {source.get('repo', 'N/A')}\n"
                 content += f"  - Code Analysis: {source.get('code_analysis_depth', 'surface')}\n"
                 content += f"  - Issues: {source.get('max_issues', 0)}\n"
-            elif source_type == 'pdf':
+            elif source_type == "pdf":
                 content += f"- ✅ **PDF Document**: {source.get('path', 'N/A')}\n"
 
         # C3.x Architecture & Code Analysis section (if available)
-        github_data = self.scraped_data.get('github', {}).get('data', {})
-        if github_data.get('c3_analysis'):
-            content += self._format_c3_summary_section(github_data['c3_analysis'])
+        github_data = self.scraped_data.get("github", {}).get("data", {})
+        if github_data.get("c3_analysis"):
+            content += self._format_c3_summary_section(github_data["c3_analysis"])
 
         # Data quality section
         if self.conflicts:
-            content += f"\n## ⚠️ Data Quality\n\n"
+            content += "\n## ⚠️ Data Quality\n\n"
             content += f"**{len(self.conflicts)} conflicts detected** between sources.\n\n"
 
             # Count by type
             by_type = {}
             for conflict in self.conflicts:
-                ctype = conflict.type if hasattr(conflict, 'type') else conflict.get('type', 'unknown')
+                ctype = conflict.type if hasattr(conflict, "type") else conflict.get("type", "unknown")
                 by_type[ctype] = by_type.get(ctype, 0) + 1
 
             content += "**Conflict Breakdown:**\n"
             for ctype, count in by_type.items():
                 content += f"- {ctype}: {count}\n"
 
-            content += f"\nSee `references/conflicts.md` for detailed conflict information.\n"
+            content += "\nSee `references/conflicts.md` for detailed conflict information.\n"
 
         # Merged API section (if available)
         if self.merged_data:
@@ -615,20 +619,20 @@ This skill combines knowledge from multiple sources:
         content += "\n## 📖 Reference Documentation\n\n"
         content += "Organized by source:\n\n"
 
-        for source in self.config.get('sources', []):
-            source_type = source['type']
+        for source in self.config.get("sources", []):
+            source_type = source["type"]
             content += f"- [{source_type.title()}](references/{source_type}/)\n"
 
         # When to use this skill
-        content += f"\n## 💡 When to Use This Skill\n\n"
-        content += f"Use this skill when you need to:\n"
+        content += "\n## 💡 When to Use This Skill\n\n"
+        content += "Use this skill when you need to:\n"
         content += f"- Understand how to use {self.name}\n"
-        content += f"- Look up API documentation\n"
-        content += f"- Find usage examples\n"
+        content += "- Look up API documentation\n"
+        content += "- Find usage examples\n"
 
-        if 'github' in self.scraped_data:
-            content += f"- Check for known issues or recent changes\n"
-            content += f"- Review release history\n"
+        if "github" in self.scraped_data:
+            content += "- Check for known issues or recent changes\n"
+            content += "- Review release history\n"
 
         content += "\n---\n\n"
         content += "*Generated by Skill Seeker's unified multi-source scraper*\n"
@@ -643,16 +647,16 @@ This skill combines knowledge from multiple sources:
         content = "\n## 🔧 API Reference\n\n"
         content += "*Merged from documentation and code analysis*\n\n"
 
-        apis = self.merged_data.get('apis', {})
+        apis = self.merged_data.get("apis", {})
 
         if not apis:
             return content + "*No APIs to display*\n"
 
         # Group APIs by status
-        matched = {k: v for k, v in apis.items() if v.get('status') == 'matched'}
-        conflicts = {k: v for k, v in apis.items() if v.get('status') == 'conflict'}
-        docs_only = {k: v for k, v in apis.items() if v.get('status') == 'docs_only'}
-        code_only = {k: v for k, v in apis.items() if v.get('status') == 'code_only'}
+        matched = {k: v for k, v in apis.items() if v.get("status") == "matched"}
+        conflicts = {k: v for k, v in apis.items() if v.get("status") == "conflict"}
+        docs_only = {k: v for k, v in apis.items() if v.get("status") == "docs_only"}
+        code_only = {k: v for k, v in apis.items() if v.get("status") == "code_only"}
 
         # Show matched APIs first
         if matched:
@@ -670,28 +674,28 @@ This skill combines knowledge from multiple sources:
 
         # Show undocumented APIs
         if code_only:
-            content += f"\n### 💻 Undocumented APIs\n\n"
+            content += "\n### 💻 Undocumented APIs\n\n"
             content += f"*Found in code but not in documentation ({len(code_only)} total)*\n\n"
             for api_name, api_data in list(code_only.items())[:5]:
                 content += self._format_api_entry(api_data, inline_conflict=False)
 
         # Show removed/missing APIs
         if docs_only:
-            content += f"\n### 📖 Documentation-Only APIs\n\n"
+            content += "\n### 📖 Documentation-Only APIs\n\n"
             content += f"*Documented but not found in code ({len(docs_only)} total)*\n\n"
             for api_name, api_data in list(docs_only.items())[:5]:
                 content += self._format_api_entry(api_data, inline_conflict=False)
 
-        content += f"\n*See references/api/ for complete API documentation*\n"
+        content += "\n*See references/api/ for complete API documentation*\n"
 
         return content
 
-    def _format_api_entry(self, api_data: Dict, inline_conflict: bool = False) -> str:
+    def _format_api_entry(self, api_data: dict, inline_conflict: bool = False) -> str:
         """Format a single API entry."""
-        name = api_data.get('name', 'Unknown')
-        signature = api_data.get('merged_signature', name)
-        description = api_data.get('merged_description', '')
-        warning = api_data.get('warning', '')
+        name = api_data.get("name", "Unknown")
+        signature = api_data.get("merged_signature", name)
+        description = api_data.get("merged_description", "")
+        warning = api_data.get("warning", "")
 
         entry = f"#### `{signature}`\n\n"
 
@@ -703,10 +707,10 @@ This skill combines knowledge from multiple sources:
             entry += f"⚠️ **Conflict**: {warning}\n\n"
 
             # Show both versions if available
-            conflict = api_data.get('conflict', {})
+            conflict = api_data.get("conflict", {})
             if conflict:
-                docs_info = conflict.get('docs_info')
-                code_info = conflict.get('code_info')
+                docs_info = conflict.get("docs_info")
+                code_info = conflict.get("code_info")
 
                 if docs_info and code_info:
                     entry += "**Documentation says:**\n"
@@ -715,25 +719,25 @@ This skill combines knowledge from multiple sources:
                     entry += f"```\n{self._format_code_signature(code_info)}\n```\n\n"
 
         # Add source info
-        source = api_data.get('source', 'unknown')
+        source = api_data.get("source", "unknown")
         entry += f"*Source: {source}*\n\n"
 
         entry += "---\n\n"
 
         return entry
 
-    def _format_code_signature(self, code_info: Dict) -> str:
+    def _format_code_signature(self, code_info: dict) -> str:
         """Format code signature for display."""
-        name = code_info.get('name', '')
-        params = code_info.get('parameters', [])
-        return_type = code_info.get('return_type')
+        name = code_info.get("name", "")
+        params = code_info.get("parameters", [])
+        return_type = code_info.get("return_type")
 
         param_strs = []
         for param in params:
-            param_str = param.get('name', '')
-            if param.get('type_hint'):
+            param_str = param.get("name", "")
+            if param.get("type_hint"):
                 param_str += f": {param['type_hint']}"
-            if param.get('default'):
+            if param.get("default"):
                 param_str += f" = {param['default']}"
             param_strs.append(param_str)
 
@@ -748,15 +752,15 @@ This skill combines knowledge from multiple sources:
         logger.info("Generating reference files...")
 
         # Generate references for each source type (now lists)
-        docs_list = self.scraped_data.get('documentation', [])
+        docs_list = self.scraped_data.get("documentation", [])
         if docs_list:
             self._generate_docs_references(docs_list)
 
-        github_list = self.scraped_data.get('github', [])
+        github_list = self.scraped_data.get("github", [])
         if github_list:
             self._generate_github_references(github_list)
 
-        pdf_list = self.scraped_data.get('pdf', [])
+        pdf_list = self.scraped_data.get("pdf", [])
         if pdf_list:
             self._generate_pdf_references(pdf_list)
 
@@ -765,35 +769,35 @@ This skill combines knowledge from multiple sources:
             self._generate_merged_api_reference()
 
         # Generate C3.x codebase analysis references if available (multi-source)
-        github_list = self.scraped_data.get('github', [])
+        github_list = self.scraped_data.get("github", [])
         for github_source in github_list:
-            github_data = github_source.get('data', {})
-            if github_data.get('c3_analysis'):
-                repo_id = github_source.get('repo_id', 'unknown')
+            github_data = github_source.get("data", {})
+            if github_data.get("c3_analysis"):
+                repo_id = github_source.get("repo_id", "unknown")
                 self._generate_c3_analysis_references(repo_id=repo_id)
 
-    def _generate_docs_references(self, docs_list: List[Dict]):
+    def _generate_docs_references(self, docs_list: list[dict]):
         """Generate references from multiple documentation sources."""
         # Skip if no documentation sources
         if not docs_list:
             return
 
-        docs_dir = os.path.join(self.skill_dir, 'references', 'documentation')
+        docs_dir = os.path.join(self.skill_dir, "references", "documentation")
         os.makedirs(docs_dir, exist_ok=True)
 
-        all_copied_files: List[str] = []
+        all_copied_files: list[str] = []
 
         # Process each documentation source
         for i, doc_source in enumerate(docs_list):
-            source_id = doc_source.get('source_id', f'source_{i}')
-            base_url = doc_source.get('base_url', 'Unknown')
-            refs_dir = doc_source.get('refs_dir', '')
+            source_id = doc_source.get("source_id", f"source_{i}")
+            base_url = doc_source.get("base_url", "Unknown")
+            refs_dir = doc_source.get("refs_dir", "")
 
             # Create subdirectory for this source
             source_dir = os.path.join(docs_dir, source_id)
             os.makedirs(source_dir, exist_ok=True)
 
-            copied_files: List[str] = []
+            copied_files: list[str] = []
 
             if refs_dir and os.path.isdir(refs_dir):
                 for entry in sorted(os.listdir(refs_dir)):
@@ -805,14 +809,14 @@ This skill combines knowledge from multiple sources:
                     copied_files.append(entry)
 
             # Create index for this source
-            source_index_path = os.path.join(source_dir, 'index.md')
-            with open(source_index_path, 'w', encoding='utf-8') as f:
+            source_index_path = os.path.join(source_dir, "index.md")
+            with open(source_index_path, "w", encoding="utf-8") as f:
                 f.write(f"# Documentation: {source_id}\n\n")
                 f.write(f"**Source**: {base_url}\n\n")
                 f.write(f"**Pages**: {doc_source.get('total_pages', 'N/A')}\n\n")
 
                 if copied_files:
-                    files_no_index = [p for p in copied_files if p.lower() != 'index.md']
+                    files_no_index = [p for p in copied_files if p.lower() != "index.md"]
                     f.write("## Files\n\n")
                     for filename in files_no_index:
                         f.write(f"- [{filename}]({filename})\n")
@@ -822,77 +826,77 @@ This skill combines knowledge from multiple sources:
             all_copied_files.extend(copied_files)
 
         # Create main index
-        index_path = os.path.join(docs_dir, 'index.md')
-        with open(index_path, 'w', encoding='utf-8') as f:
+        index_path = os.path.join(docs_dir, "index.md")
+        with open(index_path, "w", encoding="utf-8") as f:
             f.write("# Documentation References\n\n")
             f.write(f"Combined from {len(docs_list)} documentation sources.\n\n")
 
             f.write("## Sources\n\n")
             for doc_source in docs_list:
-                source_id = doc_source.get('source_id', 'unknown')
-                base_url = doc_source.get('base_url', 'Unknown')
-                total_pages = doc_source.get('total_pages', 'N/A')
+                source_id = doc_source.get("source_id", "unknown")
+                base_url = doc_source.get("base_url", "Unknown")
+                total_pages = doc_source.get("total_pages", "N/A")
                 f.write(f"- [{source_id}]({source_id}/index.md) - {base_url} ({total_pages} pages)\n")
 
         logger.info(f"Created documentation references ({len(docs_list)} sources)")
 
-    def _generate_github_references(self, github_list: List[Dict]):
+    def _generate_github_references(self, github_list: list[dict]):
         """Generate references from multiple GitHub sources."""
         # Skip if no GitHub sources
         if not github_list:
             return
 
-        github_dir = os.path.join(self.skill_dir, 'references', 'github')
+        github_dir = os.path.join(self.skill_dir, "references", "github")
         os.makedirs(github_dir, exist_ok=True)
 
         # Process each GitHub source
         for i, github_source in enumerate(github_list):
-            repo = github_source.get('repo', f'repo_{i}')
-            repo_id = github_source.get('repo_id', repo.replace('/', '_'))
-            github_data = github_source.get('data', {})
+            repo = github_source.get("repo", f"repo_{i}")
+            repo_id = github_source.get("repo_id", repo.replace("/", "_"))
+            github_data = github_source.get("data", {})
 
             # Create subdirectory for this repo
             repo_dir = os.path.join(github_dir, repo_id)
             os.makedirs(repo_dir, exist_ok=True)
 
             # Create README reference
-            if github_data.get('readme'):
-                readme_path = os.path.join(repo_dir, 'README.md')
-                with open(readme_path, 'w', encoding='utf-8') as f:
+            if github_data.get("readme"):
+                readme_path = os.path.join(repo_dir, "README.md")
+                with open(readme_path, "w", encoding="utf-8") as f:
                     f.write(f"# Repository README: {repo}\n\n")
-                    f.write(github_data['readme'])
+                    f.write(github_data["readme"])
 
             # Create issues reference
-            if github_data.get('issues'):
-                issues_path = os.path.join(repo_dir, 'issues.md')
-                with open(issues_path, 'w', encoding='utf-8') as f:
+            if github_data.get("issues"):
+                issues_path = os.path.join(repo_dir, "issues.md")
+                with open(issues_path, "w", encoding="utf-8") as f:
                     f.write(f"# GitHub Issues: {repo}\n\n")
                     f.write(f"{len(github_data['issues'])} recent issues.\n\n")
 
-                    for issue in github_data['issues'][:20]:
+                    for issue in github_data["issues"][:20]:
                         f.write(f"## #{issue['number']}: {issue['title']}\n\n")
                         f.write(f"**State**: {issue['state']}\n")
-                        if issue.get('labels'):
+                        if issue.get("labels"):
                             f.write(f"**Labels**: {', '.join(issue['labels'])}\n")
                         f.write(f"**URL**: {issue.get('url', 'N/A')}\n\n")
 
             # Create releases reference
-            if github_data.get('releases'):
-                releases_path = os.path.join(repo_dir, 'releases.md')
-                with open(releases_path, 'w', encoding='utf-8') as f:
+            if github_data.get("releases"):
+                releases_path = os.path.join(repo_dir, "releases.md")
+                with open(releases_path, "w", encoding="utf-8") as f:
                     f.write(f"# Releases: {repo}\n\n")
 
-                    for release in github_data['releases'][:10]:
+                    for release in github_data["releases"][:10]:
                         f.write(f"## {release['tag_name']}: {release.get('name', 'N/A')}\n\n")
                         f.write(f"**Published**: {release.get('published_at', 'N/A')[:10]}\n\n")
-                        if release.get('body'):
-                            f.write(release['body'][:500])
+                        if release.get("body"):
+                            f.write(release["body"][:500])
                             f.write("\n\n")
 
             # Create index for this repo
-            repo_index_path = os.path.join(repo_dir, 'index.md')
-            repo_info = github_data.get('repo_info', {})
-            with open(repo_index_path, 'w', encoding='utf-8') as f:
+            repo_index_path = os.path.join(repo_dir, "index.md")
+            repo_info = github_data.get("repo_info", {})
+            with open(repo_index_path, "w", encoding="utf-8") as f:
                 f.write(f"# GitHub: {repo}\n\n")
                 f.write(f"**Stars**: {repo_info.get('stars', 'N/A')}\n")
                 f.write(f"**Language**: {repo_info.get('language', 'N/A')}\n")
@@ -900,40 +904,40 @@ This skill combines knowledge from multiple sources:
                 f.write(f"**Releases**: {len(github_data.get('releases', []))}\n\n")
                 f.write("## Files\n\n")
                 f.write("- [README.md](README.md)\n")
-                if github_data.get('issues'):
+                if github_data.get("issues"):
                     f.write("- [issues.md](issues.md)\n")
-                if github_data.get('releases'):
+                if github_data.get("releases"):
                     f.write("- [releases.md](releases.md)\n")
 
         # Create main index
-        index_path = os.path.join(github_dir, 'index.md')
-        with open(index_path, 'w', encoding='utf-8') as f:
+        index_path = os.path.join(github_dir, "index.md")
+        with open(index_path, "w", encoding="utf-8") as f:
             f.write("# GitHub References\n\n")
             f.write(f"Combined from {len(github_list)} GitHub repositories.\n\n")
 
             f.write("## Repositories\n\n")
             for github_source in github_list:
-                repo = github_source.get('repo', 'unknown')
-                repo_id = github_source.get('repo_id', repo.replace('/', '_'))
-                github_data = github_source.get('data', {})
-                repo_info = github_data.get('repo_info', {})
-                stars = repo_info.get('stars', 'N/A')
+                repo = github_source.get("repo", "unknown")
+                repo_id = github_source.get("repo_id", repo.replace("/", "_"))
+                github_data = github_source.get("data", {})
+                repo_info = github_data.get("repo_info", {})
+                stars = repo_info.get("stars", "N/A")
                 f.write(f"- [{repo}]({repo_id}/index.md) - {stars} stars\n")
 
         logger.info(f"Created GitHub references ({len(github_list)} repos)")
 
-    def _generate_pdf_references(self, pdf_list: List[Dict]):
+    def _generate_pdf_references(self, pdf_list: list[dict]):
         """Generate references from PDF sources."""
         # Skip if no PDF sources
         if not pdf_list:
             return
 
-        pdf_dir = os.path.join(self.skill_dir, 'references', 'pdf')
+        pdf_dir = os.path.join(self.skill_dir, "references", "pdf")
         os.makedirs(pdf_dir, exist_ok=True)
 
         # Create index
-        index_path = os.path.join(pdf_dir, 'index.md')
-        with open(index_path, 'w', encoding='utf-8') as f:
+        index_path = os.path.join(pdf_dir, "index.md")
+        with open(index_path, "w", encoding="utf-8") as f:
             f.write("# PDF Documentation\n\n")
             f.write(f"Reference from {len(pdf_list)} PDF document(s).\n\n")
 
@@ -941,16 +945,16 @@ This skill combines knowledge from multiple sources:
 
     def _generate_merged_api_reference(self):
         """Generate merged API reference file."""
-        api_dir = os.path.join(self.skill_dir, 'references', 'api')
+        api_dir = os.path.join(self.skill_dir, "references", "api")
         os.makedirs(api_dir, exist_ok=True)
 
-        api_path = os.path.join(api_dir, 'merged_api.md')
+        api_path = os.path.join(api_dir, "merged_api.md")
 
-        with open(api_path, 'w') as f:
+        with open(api_path, "w") as f:
             f.write("# Merged API Reference\n\n")
             f.write("*Combined from documentation and code analysis*\n\n")
 
-            apis = self.merged_data.get('apis', {})
+            apis = self.merged_data.get("apis", {})
 
             for api_name in sorted(apis.keys()):
                 api_data = apis[api_name]
@@ -959,17 +963,17 @@ This skill combines knowledge from multiple sources:
 
         logger.info(f"Created merged API reference ({len(apis)} APIs)")
 
-    def _generate_c3_analysis_references(self, repo_id: str = 'github'):
+    def _generate_c3_analysis_references(self, repo_id: str = "github"):
         """Generate codebase analysis references (C3.5) for a specific GitHub source.
 
         Args:
             repo_id: Repository identifier (e.g., 'encode_httpx') for multi-source support
         """
         # Find the correct github_source from the list
-        github_list = self.scraped_data.get('github', [])
+        github_list = self.scraped_data.get("github", [])
         github_source = None
         for source in github_list:
-            if source.get('repo_id') == repo_id:
+            if source.get("repo_id") == repo_id:
                 github_source = source
                 break
 
@@ -977,14 +981,14 @@ This skill combines knowledge from multiple sources:
             logger.warning(f"GitHub source with repo_id '{repo_id}' not found")
             return
 
-        github_data = github_source.get('data', {})
-        c3_data = github_data.get('c3_analysis')
+        github_data = github_source.get("data", {})
+        c3_data = github_data.get("c3_analysis")
 
         if not c3_data:
             return
 
         # Create unique directory per repo for multi-source support
-        c3_dir = os.path.join(self.skill_dir, 'references', 'codebase_analysis', repo_id)
+        c3_dir = os.path.join(self.skill_dir, "references", "codebase_analysis", repo_id)
         os.makedirs(c3_dir, exist_ok=True)
 
         logger.info("Generating C3.x codebase analysis references...")
@@ -993,19 +997,19 @@ This skill combines knowledge from multiple sources:
         self._generate_architecture_overview(c3_dir, c3_data, github_data)
 
         # Generate subdirectories for each C3.x component
-        self._generate_pattern_references(c3_dir, c3_data.get('patterns'))
-        self._generate_example_references(c3_dir, c3_data.get('test_examples'))
-        self._generate_guide_references(c3_dir, c3_data.get('how_to_guides'))
-        self._generate_config_references(c3_dir, c3_data.get('config_patterns'))
-        self._copy_architecture_details(c3_dir, c3_data.get('architecture'))
+        self._generate_pattern_references(c3_dir, c3_data.get("patterns"))
+        self._generate_example_references(c3_dir, c3_data.get("test_examples"))
+        self._generate_guide_references(c3_dir, c3_data.get("how_to_guides"))
+        self._generate_config_references(c3_dir, c3_data.get("config_patterns"))
+        self._copy_architecture_details(c3_dir, c3_data.get("architecture"))
 
         logger.info("✅ Created codebase analysis references")
 
-    def _generate_architecture_overview(self, c3_dir: str, c3_data: Dict, github_data: Dict):
+    def _generate_architecture_overview(self, c3_dir: str, c3_data: dict, github_data: dict):
         """Generate comprehensive ARCHITECTURE.md (C3.5 main deliverable)."""
-        arch_path = os.path.join(c3_dir, 'ARCHITECTURE.md')
+        arch_path = os.path.join(c3_dir, "ARCHITECTURE.md")
 
-        with open(arch_path, 'w', encoding='utf-8') as f:
+        with open(arch_path, "w", encoding="utf-8") as f:
             f.write(f"# {self.name.title()} Architecture Overview\n\n")
             f.write("*Generated from C3.x automated codebase analysis*\n\n")
 
@@ -1014,18 +1018,18 @@ This skill combines knowledge from multiple sources:
             f.write(f"{self.description}\n\n")
 
             # Section 2: Architectural Patterns (C3.7)
-            if c3_data.get('architecture'):
-                arch = c3_data['architecture']
-                patterns = arch.get('patterns', [])
+            if c3_data.get("architecture"):
+                arch = c3_data["architecture"]
+                patterns = arch.get("patterns", [])
                 if patterns:
                     f.write("## 2. Architectural Patterns\n\n")
                     f.write("*Detected architectural patterns from codebase structure*\n\n")
                     for pattern in patterns[:5]:  # Top 5 patterns
                         f.write(f"### {pattern['pattern_name']}\n\n")
                         f.write(f"- **Confidence**: {pattern['confidence']:.2f}\n")
-                        if pattern.get('framework'):
+                        if pattern.get("framework"):
                             f.write(f"- **Framework**: {pattern['framework']}\n")
-                        if pattern.get('evidence'):
+                        if pattern.get("evidence"):
                             f.write(f"- **Evidence**: {', '.join(pattern['evidence'][:3])}\n")
                         f.write("\n")
 
@@ -1034,15 +1038,15 @@ This skill combines knowledge from multiple sources:
 
             # Try to get languages from C3.7 architecture analysis first
             languages = {}
-            if c3_data.get('architecture'):
-                languages = c3_data['architecture'].get('languages', {})
+            if c3_data.get("architecture"):
+                languages = c3_data["architecture"].get("languages", {})
 
             # If no languages from C3.7, try to get from GitHub data
             if not languages:
                 # github_data already available from method scope
-                if github_data.get('languages'):
+                if github_data.get("languages"):
                     # GitHub data has languages as list, convert to dict with count 1
-                    languages = {lang: 1 for lang in github_data['languages']}
+                    languages = dict.fromkeys(github_data["languages"], 1)
 
             if languages:
                 f.write("**Languages Detected**:\n")
@@ -1054,94 +1058,100 @@ This skill combines knowledge from multiple sources:
                 f.write("\n")
 
             # Add frameworks if available
-            if c3_data.get('architecture'):
-                frameworks = c3_data['architecture'].get('frameworks_detected', [])
+            if c3_data.get("architecture"):
+                frameworks = c3_data["architecture"].get("frameworks_detected", [])
                 if frameworks:
                     f.write("**Frameworks & Libraries**:\n")
                     for fw in frameworks[:10]:
                         f.write(f"- {fw}\n")
                     f.write("\n")
 
-            if not languages and not (c3_data.get('architecture') and c3_data['architecture'].get('frameworks_detected')):
+            if not languages and not (
+                c3_data.get("architecture") and c3_data["architecture"].get("frameworks_detected")
+            ):
                 f.write("*Technology stack analysis not available*\n\n")
 
             # Section 4: Design Patterns (C3.1)
-            if c3_data.get('patterns'):
+            if c3_data.get("patterns"):
                 f.write("## 4. Design Patterns\n\n")
                 f.write("*Classic design patterns identified in the codebase*\n\n")
 
                 # Summarize pattern types
                 pattern_summary = {}
-                for file_data in c3_data['patterns']:
-                    for pattern in file_data.get('patterns', []):
-                        ptype = pattern['pattern_type']
+                for file_data in c3_data["patterns"]:
+                    for pattern in file_data.get("patterns", []):
+                        ptype = pattern["pattern_type"]
                         pattern_summary[ptype] = pattern_summary.get(ptype, 0) + 1
 
                 if pattern_summary:
                     for ptype, count in sorted(pattern_summary.items(), key=lambda x: x[1], reverse=True):
                         f.write(f"- **{ptype}**: {count} instance(s)\n")
-                    f.write(f"\n📁 See `references/codebase_analysis/patterns/` for detailed analysis.\n\n")
+                    f.write("\n📁 See `references/codebase_analysis/patterns/` for detailed analysis.\n\n")
                 else:
                     f.write("*No design patterns detected.*\n\n")
 
             # Section 5: Configuration Overview (C3.4)
-            if c3_data.get('config_patterns'):
+            if c3_data.get("config_patterns"):
                 f.write("## 5. Configuration Overview\n\n")
-                config = c3_data['config_patterns']
-                config_files = config.get('config_files', [])
+                config = c3_data["config_patterns"]
+                config_files = config.get("config_files", [])
 
                 if config_files:
                     f.write(f"**{len(config_files)} configuration file(s) detected**:\n\n")
                     for cf in config_files[:10]:  # Top 10
                         f.write(f"- **`{cf['relative_path']}`**: {cf['type']}\n")
-                        if cf.get('purpose'):
+                        if cf.get("purpose"):
                             f.write(f"  - Purpose: {cf['purpose']}\n")
 
                     # Add security warnings if available
-                    if config.get('ai_enhancements'):
-                        insights = config['ai_enhancements'].get('overall_insights', {})
-                        security_issues = insights.get('security_issues_found', 0)
+                    if config.get("ai_enhancements"):
+                        insights = config["ai_enhancements"].get("overall_insights", {})
+                        security_issues = insights.get("security_issues_found", 0)
                         if security_issues > 0:
-                            f.write(f"\n🔐 **Security Alert**: {security_issues} potential security issue(s) found in configurations.\n")
-                            if insights.get('recommended_actions'):
+                            f.write(
+                                f"\n🔐 **Security Alert**: {security_issues} potential security issue(s) found in configurations.\n"
+                            )
+                            if insights.get("recommended_actions"):
                                 f.write("\n**Recommended Actions**:\n")
-                                for action in insights['recommended_actions'][:5]:
+                                for action in insights["recommended_actions"][:5]:
                                     f.write(f"- {action}\n")
-                    f.write(f"\n📁 See `references/codebase_analysis/configuration/` for details.\n\n")
+                    f.write("\n📁 See `references/codebase_analysis/configuration/` for details.\n\n")
                 else:
                     f.write("*No configuration files detected.*\n\n")
 
             # Section 6: Common Workflows (C3.3)
-            if c3_data.get('how_to_guides'):
+            if c3_data.get("how_to_guides"):
                 f.write("## 6. Common Workflows\n\n")
-                guides = c3_data['how_to_guides'].get('guides', [])
+                guides = c3_data["how_to_guides"].get("guides", [])
 
                 if guides:
                     f.write(f"**{len(guides)} how-to guide(s) extracted from codebase**:\n\n")
                     for guide in guides[:10]:  # Top 10
                         f.write(f"- {guide.get('title', 'Untitled Guide')}\n")
-                    f.write(f"\n📁 See `references/codebase_analysis/guides/` for detailed tutorials.\n\n")
+                    f.write("\n📁 See `references/codebase_analysis/guides/` for detailed tutorials.\n\n")
                 else:
                     f.write("*No workflow guides extracted.*\n\n")
 
             # Section 7: Usage Examples (C3.2)
-            if c3_data.get('test_examples'):
+            if c3_data.get("test_examples"):
                 f.write("## 7. Usage Examples\n\n")
-                examples = c3_data['test_examples']
-                total = examples.get('total_examples', 0)
-                high_value = examples.get('high_value_count', 0)
+                examples = c3_data["test_examples"]
+                total = examples.get("total_examples", 0)
+                high_value = examples.get("high_value_count", 0)
 
                 if total > 0:
                     f.write(f"**{total} usage example(s) extracted from tests**:\n")
                     f.write(f"- High-value examples: {high_value}\n")
 
                     # Category breakdown
-                    if examples.get('examples_by_category'):
+                    if examples.get("examples_by_category"):
                         f.write("\n**By Category**:\n")
-                        for cat, count in sorted(examples['examples_by_category'].items(), key=lambda x: x[1], reverse=True):
+                        for cat, count in sorted(
+                            examples["examples_by_category"].items(), key=lambda x: x[1], reverse=True
+                        ):
                             f.write(f"- {cat}: {count}\n")
 
-                    f.write(f"\n📁 See `references/codebase_analysis/examples/` for code samples.\n\n")
+                    f.write("\n📁 See `references/codebase_analysis/examples/` for code samples.\n\n")
                 else:
                     f.write("*No test examples extracted.*\n\n")
 
@@ -1149,8 +1159,8 @@ This skill combines knowledge from multiple sources:
             f.write("## 8. Entry Points & Directory Structure\n\n")
             f.write("*Analysis based on codebase organization*\n\n")
 
-            if c3_data.get('architecture'):
-                dir_struct = c3_data['architecture'].get('directory_structure', {})
+            if c3_data.get("architecture"):
+                dir_struct = c3_data["architecture"].get("directory_structure", {})
                 if dir_struct:
                     f.write("**Main Directories**:\n")
                     for dir_name, file_count in sorted(dir_struct.items(), key=lambda x: x[1], reverse=True)[:15]:
@@ -1162,71 +1172,71 @@ This skill combines knowledge from multiple sources:
             f.write("*This architecture overview was automatically generated by C3.x codebase analysis.*\n")
             f.write("*Last updated: skill build time*\n")
 
-        logger.info(f"📐 Created ARCHITECTURE.md")
+        logger.info("📐 Created ARCHITECTURE.md")
 
-    def _generate_pattern_references(self, c3_dir: str, patterns_data: Dict):
+    def _generate_pattern_references(self, c3_dir: str, patterns_data: dict):
         """Generate design pattern references (C3.1)."""
         if not patterns_data:
             return
 
-        patterns_dir = os.path.join(c3_dir, 'patterns')
+        patterns_dir = os.path.join(c3_dir, "patterns")
         os.makedirs(patterns_dir, exist_ok=True)
 
         # Save JSON data
-        json_path = os.path.join(patterns_dir, 'detected_patterns.json')
-        with open(json_path, 'w', encoding='utf-8') as f:
+        json_path = os.path.join(patterns_dir, "detected_patterns.json")
+        with open(json_path, "w", encoding="utf-8") as f:
             json.dump(patterns_data, f, indent=2, ensure_ascii=False)
 
         # Create summary markdown
-        md_path = os.path.join(patterns_dir, 'index.md')
-        with open(md_path, 'w', encoding='utf-8') as f:
+        md_path = os.path.join(patterns_dir, "index.md")
+        with open(md_path, "w", encoding="utf-8") as f:
             f.write("# Design Patterns\n\n")
             f.write("*Detected patterns from C3.1 analysis*\n\n")
 
             for file_data in patterns_data:
-                patterns = file_data.get('patterns', [])
+                patterns = file_data.get("patterns", [])
                 if patterns:
                     f.write(f"## {file_data['file_path']}\n\n")
                     for p in patterns:
                         f.write(f"### {p['pattern_type']}\n\n")
-                        if p.get('class_name'):
+                        if p.get("class_name"):
                             f.write(f"- **Class**: `{p['class_name']}`\n")
-                        if p.get('confidence'):
+                        if p.get("confidence"):
                             f.write(f"- **Confidence**: {p['confidence']:.2f}\n")
-                        if p.get('indicators'):
+                        if p.get("indicators"):
                             f.write(f"- **Indicators**: {', '.join(p['indicators'][:3])}\n")
                         f.write("\n")
 
         logger.info(f"   ✓ Design patterns: {len(patterns_data)} files")
 
-    def _generate_example_references(self, c3_dir: str, examples_data: Dict):
+    def _generate_example_references(self, c3_dir: str, examples_data: dict):
         """Generate test example references (C3.2)."""
         if not examples_data:
             return
 
-        examples_dir = os.path.join(c3_dir, 'examples')
+        examples_dir = os.path.join(c3_dir, "examples")
         os.makedirs(examples_dir, exist_ok=True)
 
         # Save JSON data
-        json_path = os.path.join(examples_dir, 'test_examples.json')
-        with open(json_path, 'w', encoding='utf-8') as f:
+        json_path = os.path.join(examples_dir, "test_examples.json")
+        with open(json_path, "w", encoding="utf-8") as f:
             json.dump(examples_data, f, indent=2, ensure_ascii=False)
 
         # Create summary markdown
-        md_path = os.path.join(examples_dir, 'index.md')
-        with open(md_path, 'w', encoding='utf-8') as f:
+        md_path = os.path.join(examples_dir, "index.md")
+        with open(md_path, "w", encoding="utf-8") as f:
             f.write("# Usage Examples\n\n")
             f.write("*Extracted from test files (C3.2)*\n\n")
 
-            total = examples_data.get('total_examples', 0)
-            high_value = examples_data.get('high_value_count', 0)
+            total = examples_data.get("total_examples", 0)
+            high_value = examples_data.get("high_value_count", 0)
 
             f.write(f"**Total Examples**: {total}\n")
             f.write(f"**High-Value Examples**: {high_value}\n\n")
 
             # List high-value examples
-            examples = examples_data.get('examples', [])
-            high_value_examples = [e for e in examples if e.get('confidence', 0) > 0.7]
+            examples = examples_data.get("examples", [])
+            high_value_examples = [e for e in examples if e.get("confidence", 0) > 0.7]
 
             if high_value_examples:
                 f.write("## High-Value Examples\n\n")
@@ -1235,30 +1245,30 @@ This skill combines knowledge from multiple sources:
                     f.write(f"- **Category**: {ex.get('category', 'unknown')}\n")
                     f.write(f"- **Confidence**: {ex.get('confidence', 0):.2f}\n")
                     f.write(f"- **File**: `{ex.get('file_path', 'N/A')}`\n")
-                    if ex.get('code_snippet'):
+                    if ex.get("code_snippet"):
                         f.write(f"\n```python\n{ex['code_snippet'][:300]}\n```\n")
                     f.write("\n")
 
         logger.info(f"   ✓ Test examples: {total} total, {high_value} high-value")
 
-    def _generate_guide_references(self, c3_dir: str, guides_data: Dict):
+    def _generate_guide_references(self, c3_dir: str, guides_data: dict):
         """Generate how-to guide references (C3.3)."""
         if not guides_data:
             return
 
-        guides_dir = os.path.join(c3_dir, 'guides')
+        guides_dir = os.path.join(c3_dir, "guides")
         os.makedirs(guides_dir, exist_ok=True)
 
         # Save JSON collection data
-        json_path = os.path.join(guides_dir, 'guide_collection.json')
-        with open(json_path, 'w', encoding='utf-8') as f:
+        json_path = os.path.join(guides_dir, "guide_collection.json")
+        with open(json_path, "w", encoding="utf-8") as f:
             json.dump(guides_data, f, indent=2, ensure_ascii=False)
 
-        guides = guides_data.get('guides', [])
+        guides = guides_data.get("guides", [])
 
         # Create index
-        md_path = os.path.join(guides_dir, 'index.md')
-        with open(md_path, 'w', encoding='utf-8') as f:
+        md_path = os.path.join(guides_dir, "index.md")
+        with open(md_path, "w", encoding="utf-8") as f:
             f.write("# How-To Guides\n\n")
             f.write("*Workflow tutorials extracted from codebase (C3.3)*\n\n")
 
@@ -1272,46 +1282,46 @@ This skill combines knowledge from multiple sources:
 
         # Save individual guide markdown files
         for guide in guides:
-            guide_id = guide.get('id', 'unknown')
+            guide_id = guide.get("id", "unknown")
             guide_path = os.path.join(guides_dir, f"guide_{guide_id}.md")
 
-            with open(guide_path, 'w', encoding='utf-8') as f:
+            with open(guide_path, "w", encoding="utf-8") as f:
                 f.write(f"# {guide.get('title', 'Untitled Guide')}\n\n")
 
-                if guide.get('description'):
+                if guide.get("description"):
                     f.write(f"{guide['description']}\n\n")
 
-                steps = guide.get('steps', [])
+                steps = guide.get("steps", [])
                 if steps:
                     f.write("## Steps\n\n")
                     for i, step in enumerate(steps, 1):
                         f.write(f"### {i}. {step.get('action', 'Step')}\n\n")
-                        if step.get('code_example'):
-                            lang = step.get('language', 'python')
+                        if step.get("code_example"):
+                            lang = step.get("language", "python")
                             f.write(f"```{lang}\n{step['code_example']}\n```\n\n")
-                        if step.get('explanation'):
+                        if step.get("explanation"):
                             f.write(f"{step['explanation']}\n\n")
 
         logger.info(f"   ✓ How-to guides: {len(guides)}")
 
-    def _generate_config_references(self, c3_dir: str, config_data: Dict):
+    def _generate_config_references(self, c3_dir: str, config_data: dict):
         """Generate configuration pattern references (C3.4)."""
         if not config_data:
             return
 
-        config_dir = os.path.join(c3_dir, 'configuration')
+        config_dir = os.path.join(c3_dir, "configuration")
         os.makedirs(config_dir, exist_ok=True)
 
         # Save JSON data
-        json_path = os.path.join(config_dir, 'config_patterns.json')
-        with open(json_path, 'w', encoding='utf-8') as f:
+        json_path = os.path.join(config_dir, "config_patterns.json")
+        with open(json_path, "w", encoding="utf-8") as f:
             json.dump(config_data, f, indent=2, ensure_ascii=False)
 
         # Create summary markdown
-        md_path = os.path.join(config_dir, 'index.md')
-        config_files = config_data.get('config_files', [])
+        md_path = os.path.join(config_dir, "index.md")
+        config_files = config_data.get("config_files", [])
 
-        with open(md_path, 'w', encoding='utf-8') as f:
+        with open(md_path, "w", encoding="utf-8") as f:
             f.write("# Configuration Patterns\n\n")
             f.write("*Detected configuration files (C3.4)*\n\n")
 
@@ -1326,91 +1336,91 @@ This skill combines knowledge from multiple sources:
                     f.write(f"- **Settings**: {len(cf.get('settings', []))}\n")
 
                     # Show AI enhancements if available
-                    if cf.get('ai_enhancement'):
-                        enh = cf['ai_enhancement']
-                        if enh.get('security_concern'):
+                    if cf.get("ai_enhancement"):
+                        enh = cf["ai_enhancement"]
+                        if enh.get("security_concern"):
                             f.write(f"- **Security**: {enh['security_concern']}\n")
-                        if enh.get('best_practice'):
+                        if enh.get("best_practice"):
                             f.write(f"- **Best Practice**: {enh['best_practice']}\n")
 
                     f.write("\n")
 
                 # Overall insights
-                if config_data.get('ai_enhancements'):
-                    insights = config_data['ai_enhancements'].get('overall_insights', {})
+                if config_data.get("ai_enhancements"):
+                    insights = config_data["ai_enhancements"].get("overall_insights", {})
                     if insights:
                         f.write("## Overall Insights\n\n")
-                        if insights.get('security_issues_found'):
+                        if insights.get("security_issues_found"):
                             f.write(f"🔐 **Security Issues**: {insights['security_issues_found']}\n\n")
-                        if insights.get('recommended_actions'):
+                        if insights.get("recommended_actions"):
                             f.write("**Recommended Actions**:\n")
-                            for action in insights['recommended_actions']:
+                            for action in insights["recommended_actions"]:
                                 f.write(f"- {action}\n")
                             f.write("\n")
 
         logger.info(f"   ✓ Configuration files: {len(config_files)}")
 
-    def _copy_architecture_details(self, c3_dir: str, arch_data: Dict):
+    def _copy_architecture_details(self, c3_dir: str, arch_data: dict):
         """Copy architectural pattern JSON details (C3.7)."""
         if not arch_data:
             return
 
-        arch_dir = os.path.join(c3_dir, 'architecture_details')
+        arch_dir = os.path.join(c3_dir, "architecture_details")
         os.makedirs(arch_dir, exist_ok=True)
 
         # Save full JSON data
-        json_path = os.path.join(arch_dir, 'architectural_patterns.json')
-        with open(json_path, 'w', encoding='utf-8') as f:
+        json_path = os.path.join(arch_dir, "architectural_patterns.json")
+        with open(json_path, "w", encoding="utf-8") as f:
             json.dump(arch_data, f, indent=2, ensure_ascii=False)
 
         # Create summary markdown
-        md_path = os.path.join(arch_dir, 'index.md')
-        with open(md_path, 'w', encoding='utf-8') as f:
+        md_path = os.path.join(arch_dir, "index.md")
+        with open(md_path, "w", encoding="utf-8") as f:
             f.write("# Architectural Patterns (Detailed)\n\n")
             f.write("*Comprehensive architectural analysis (C3.7)*\n\n")
 
-            patterns = arch_data.get('patterns', [])
+            patterns = arch_data.get("patterns", [])
             if patterns:
                 f.write("## Detected Patterns\n\n")
                 for p in patterns:
                     f.write(f"### {p['pattern_name']}\n\n")
                     f.write(f"- **Confidence**: {p['confidence']:.2f}\n")
-                    if p.get('framework'):
+                    if p.get("framework"):
                         f.write(f"- **Framework**: {p['framework']}\n")
-                    if p.get('evidence'):
-                        f.write(f"- **Evidence**:\n")
-                        for e in p['evidence'][:5]:
+                    if p.get("evidence"):
+                        f.write("- **Evidence**:\n")
+                        for e in p["evidence"][:5]:
                             f.write(f"  - {e}\n")
                     f.write("\n")
 
         logger.info(f"   ✓ Architectural details: {len(patterns)} patterns")
 
-    def _format_c3_summary_section(self, c3_data: Dict) -> str:
+    def _format_c3_summary_section(self, c3_data: dict) -> str:
         """Format C3.x analysis summary for SKILL.md."""
         content = "\n## 🏗️ Architecture & Code Analysis\n\n"
         content += "*This skill includes comprehensive codebase analysis*\n\n"
 
         # Add architectural pattern summary
-        if c3_data.get('architecture'):
-            patterns = c3_data['architecture'].get('patterns', [])
+        if c3_data.get("architecture"):
+            patterns = c3_data["architecture"].get("patterns", [])
             if patterns:
                 top_pattern = patterns[0]
                 content += f"**Primary Architecture**: {top_pattern['pattern_name']}"
-                if top_pattern.get('framework'):
+                if top_pattern.get("framework"):
                     content += f" ({top_pattern['framework']})"
                 content += f" - Confidence: {top_pattern['confidence']:.0%}\n\n"
 
         # Add design patterns summary
-        if c3_data.get('patterns'):
-            total_patterns = sum(len(f.get('patterns', [])) for f in c3_data['patterns'])
+        if c3_data.get("patterns"):
+            total_patterns = sum(len(f.get("patterns", [])) for f in c3_data["patterns"])
             if total_patterns > 0:
                 content += f"**Design Patterns**: {total_patterns} detected\n"
 
                 # Show top 3 pattern types
                 pattern_summary = {}
-                for file_data in c3_data['patterns']:
-                    for pattern in file_data.get('patterns', []):
-                        ptype = pattern['pattern_type']
+                for file_data in c3_data["patterns"]:
+                    for pattern in file_data.get("patterns", []):
+                        ptype = pattern["pattern_type"]
                         pattern_summary[ptype] = pattern_summary.get(ptype, 0) + 1
 
                 top_patterns = sorted(pattern_summary.items(), key=lambda x: x[1], reverse=True)[:3]
@@ -1419,28 +1429,28 @@ This skill combines knowledge from multiple sources:
                 content += "\n"
 
         # Add test examples summary
-        if c3_data.get('test_examples'):
-            total = c3_data['test_examples'].get('total_examples', 0)
-            high_value = c3_data['test_examples'].get('high_value_count', 0)
+        if c3_data.get("test_examples"):
+            total = c3_data["test_examples"].get("total_examples", 0)
+            high_value = c3_data["test_examples"].get("high_value_count", 0)
             if total > 0:
                 content += f"**Usage Examples**: {total} extracted from tests ({high_value} high-value)\n\n"
 
         # Add how-to guides summary
-        if c3_data.get('how_to_guides'):
-            guide_count = len(c3_data['how_to_guides'].get('guides', []))
+        if c3_data.get("how_to_guides"):
+            guide_count = len(c3_data["how_to_guides"].get("guides", []))
             if guide_count > 0:
                 content += f"**How-To Guides**: {guide_count} workflow tutorials\n\n"
 
         # Add configuration summary
-        if c3_data.get('config_patterns'):
-            config_files = c3_data['config_patterns'].get('config_files', [])
+        if c3_data.get("config_patterns"):
+            config_files = c3_data["config_patterns"].get("config_files", [])
             if config_files:
                 content += f"**Configuration Files**: {len(config_files)} analyzed\n"
 
                 # Add security warning if present
-                if c3_data['config_patterns'].get('ai_enhancements'):
-                    insights = c3_data['config_patterns']['ai_enhancements'].get('overall_insights', {})
-                    security_issues = insights.get('security_issues_found', 0)
+                if c3_data["config_patterns"].get("ai_enhancements"):
+                    insights = c3_data["config_patterns"]["ai_enhancements"].get("overall_insights", {})
+                    security_issues = insights.get("security_issues_found", 0)
                     if security_issues > 0:
                         content += f"- 🔐 **Security Alert**: {security_issues} issue(s) detected\n"
                 content += "\n"
@@ -1452,16 +1462,28 @@ This skill combines knowledge from multiple sources:
 
     def _generate_conflicts_report(self):
         """Generate detailed conflicts report."""
-        conflicts_path = os.path.join(self.skill_dir, 'references', 'conflicts.md')
+        conflicts_path = os.path.join(self.skill_dir, "references", "conflicts.md")
 
-        with open(conflicts_path, 'w') as f:
+        with open(conflicts_path, "w") as f:
             f.write("# Conflict Report\n\n")
             f.write(f"Found **{len(self.conflicts)}** conflicts between sources.\n\n")
 
             # Group by severity
-            high = [c for c in self.conflicts if (hasattr(c, 'severity') and c.severity == 'high') or c.get('severity') == 'high']
-            medium = [c for c in self.conflicts if (hasattr(c, 'severity') and c.severity == 'medium') or c.get('severity') == 'medium']
-            low = [c for c in self.conflicts if (hasattr(c, 'severity') and c.severity == 'low') or c.get('severity') == 'low']
+            high = [
+                c
+                for c in self.conflicts
+                if (hasattr(c, "severity") and c.severity == "high") or c.get("severity") == "high"
+            ]
+            medium = [
+                c
+                for c in self.conflicts
+                if (hasattr(c, "severity") and c.severity == "medium") or c.get("severity") == "medium"
+            ]
+            low = [
+                c
+                for c in self.conflicts
+                if (hasattr(c, "severity") and c.severity == "low") or c.get("severity") == "low"
+            ]
 
             f.write("## Severity Breakdown\n\n")
             f.write(f"- 🔴 **High**: {len(high)} (action required)\n")
@@ -1474,8 +1496,10 @@ This skill combines knowledge from multiple sources:
                 f.write("*These conflicts require immediate attention*\n\n")
 
                 for conflict in high:
-                    api_name = conflict.api_name if hasattr(conflict, 'api_name') else conflict.get('api_name', 'Unknown')
-                    diff = conflict.difference if hasattr(conflict, 'difference') else conflict.get('difference', 'N/A')
+                    api_name = (
+                        conflict.api_name if hasattr(conflict, "api_name") else conflict.get("api_name", "Unknown")
+                    )
+                    diff = conflict.difference if hasattr(conflict, "difference") else conflict.get("difference", "N/A")
 
                     f.write(f"### {api_name}\n\n")
                     f.write(f"**Issue**: {diff}\n\n")
@@ -1485,16 +1509,18 @@ This skill combines knowledge from multiple sources:
                 f.write("## 🟡 Medium Severity\n\n")
 
                 for conflict in medium[:20]:  # Limit to 20
-                    api_name = conflict.api_name if hasattr(conflict, 'api_name') else conflict.get('api_name', 'Unknown')
-                    diff = conflict.difference if hasattr(conflict, 'difference') else conflict.get('difference', 'N/A')
+                    api_name = (
+                        conflict.api_name if hasattr(conflict, "api_name") else conflict.get("api_name", "Unknown")
+                    )
+                    diff = conflict.difference if hasattr(conflict, "difference") else conflict.get("difference", "N/A")
 
                     f.write(f"### {api_name}\n\n")
                     f.write(f"{diff}\n\n")
 
-        logger.info(f"Created conflicts report")
+        logger.info("Created conflicts report")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Test with mock data
     import sys
 
@@ -1504,19 +1530,11 @@ if __name__ == '__main__':
 
     config_path = sys.argv[1]
 
-    with open(config_path, 'r') as f:
+    with open(config_path) as f:
         config = json.load(f)
 
     # Mock scraped data
-    scraped_data = {
-        'github': {
-            'data': {
-                'readme': '# Test Repository',
-                'issues': [],
-                'releases': []
-            }
-        }
-    }
+    scraped_data = {"github": {"data": {"readme": "# Test Repository", "issues": [], "releases": []}}}
 
     builder = UnifiedSkillBuilder(config, scraped_data)
     builder.build()
diff --git a/src/skill_seekers/cli/upload_skill.py b/src/skill_seekers/cli/upload_skill.py
index 8204151..f7c67d2 100755
--- a/src/skill_seekers/cli/upload_skill.py
+++ b/src/skill_seekers/cli/upload_skill.py
@@ -17,27 +17,20 @@ Usage:
     skill-seekers upload output/react-openai.zip --target openai
 """
 
+import argparse
 import os
 import sys
-import json
-import argparse
 from pathlib import Path
 
 # Import utilities
 try:
-    from utils import (
-        print_upload_instructions,
-        validate_zip_file
-    )
+    from utils import print_upload_instructions, validate_zip_file
 except ImportError:
     sys.path.insert(0, str(Path(__file__).parent))
-    from utils import (
-        print_upload_instructions,
-        validate_zip_file
-    )
+    from utils import print_upload_instructions
 
 
-def upload_skill_api(package_path, target='claude', api_key=None):
+def upload_skill_api(package_path, target="claude", api_key=None):
     """
     Upload skill package to LLM platform
 
@@ -62,7 +55,7 @@ def upload_skill_api(package_path, target='claude', api_key=None):
 
     # Get API key
     if not api_key:
-        api_key = os.environ.get(adaptor.get_env_var_name(), '').strip()
+        api_key = os.environ.get(adaptor.get_env_var_name(), "").strip()
 
     if not api_key:
         return False, f"{adaptor.get_env_var_name()} not set. Export your API key first."
@@ -91,19 +84,19 @@ def upload_skill_api(package_path, target='claude', api_key=None):
     try:
         result = adaptor.upload(package_path, api_key)
 
-        if result['success']:
+        if result["success"]:
             print()
             print(f"✅ {result['message']}")
             print()
-            if result['url']:
+            if result["url"]:
                 print("Your skill is now available at:")
                 print(f"   {result['url']}")
-            if result['skill_id']:
+            if result["skill_id"]:
                 print(f"   Skill ID: {result['skill_id']}")
             print()
             return True, "Upload successful"
         else:
-            return False, result['message']
+            return False, result["message"]
 
     except Exception as e:
         return False, f"Unexpected error: {str(e)}"
@@ -136,25 +129,19 @@ Examples:
 
   # Upload with explicit API key
   skill-seekers upload output/react.zip --api-key sk-ant-...
-        """
+        """,
     )
 
-    parser.add_argument(
-        'package_file',
-        help='Path to skill package file (e.g., output/react.zip)'
-    )
+    parser.add_argument("package_file", help="Path to skill package file (e.g., output/react.zip)")
 
     parser.add_argument(
-        '--target',
-        choices=['claude', 'gemini', 'openai'],
-        default='claude',
-        help='Target LLM platform (default: claude)'
+        "--target",
+        choices=["claude", "gemini", "openai"],
+        default="claude",
+        help="Target LLM platform (default: claude)",
     )
 
-    parser.add_argument(
-        '--api-key',
-        help='Platform API key (or set environment variable)'
-    )
+    parser.add_argument("--api-key", help="Platform API key (or set environment variable)")
 
     args = parser.parse_args()
 
diff --git a/src/skill_seekers/cli/utils.py b/src/skill_seekers/cli/utils.py
index 15c038d..07e3732 100755
--- a/src/skill_seekers/cli/utils.py
+++ b/src/skill_seekers/cli/utils.py
@@ -3,21 +3,21 @@
 Utility functions for Skill Seeker CLI tools
 """
 
-import os
-import sys
-import subprocess
-import platform
-import time
 import logging
+import os
+import platform
+import subprocess
+import time
+from collections.abc import Callable
 from pathlib import Path
-from typing import Optional, Tuple, Dict, Union, TypeVar, Callable
+from typing import TypeVar
 
 logger = logging.getLogger(__name__)
 
-T = TypeVar('T')
+T = TypeVar("T")
 
 
-def open_folder(folder_path: Union[str, Path]) -> bool:
+def open_folder(folder_path: str | Path) -> bool:
     """
     Open a folder in the system file browser
 
@@ -50,10 +50,10 @@ def open_folder(folder_path: Union[str, Path]) -> bool:
         return True
 
     except subprocess.CalledProcessError:
-        print(f"⚠️  Could not open folder automatically")
+        print("⚠️  Could not open folder automatically")
         return False
     except FileNotFoundError:
-        print(f"⚠️  File browser not found on system")
+        print("⚠️  File browser not found on system")
         return False
 
 
@@ -64,18 +64,18 @@ def has_api_key() -> bool:
     Returns:
         bool: True if API key is set, False otherwise
     """
-    api_key = os.environ.get('ANTHROPIC_API_KEY', '').strip()
+    api_key = os.environ.get("ANTHROPIC_API_KEY", "").strip()
     return len(api_key) > 0
 
 
-def get_api_key() -> Optional[str]:
+def get_api_key() -> str | None:
     """
     Get ANTHROPIC_API_KEY from environment
 
     Returns:
         str: API key or None if not set
     """
-    api_key = os.environ.get('ANTHROPIC_API_KEY', '').strip()
+    api_key = os.environ.get("ANTHROPIC_API_KEY", "").strip()
     return api_key if api_key else None
 
 
@@ -89,7 +89,7 @@ def get_upload_url() -> str:
     return "https://claude.ai/skills"
 
 
-def print_upload_instructions(zip_path: Union[str, Path]) -> None:
+def print_upload_instructions(zip_path: str | Path) -> None:
     """
     Print clear upload instructions for manual upload
 
@@ -106,7 +106,7 @@ def print_upload_instructions(zip_path: Union[str, Path]) -> None:
     print(f"📤 Upload to Claude: {get_upload_url()}")
     print()
     print(f"1. Go to {get_upload_url()}")
-    print("2. Click \"Upload Skill\"")
+    print('2. Click "Upload Skill"')
     print(f"3. Select: {zip_path}")
     print("4. Done! ✅")
     print()
@@ -130,7 +130,7 @@ def format_file_size(size_bytes: int) -> str:
         return f"{size_bytes / (1024 * 1024):.1f} MB"
 
 
-def validate_skill_directory(skill_dir: Union[str, Path]) -> Tuple[bool, Optional[str]]:
+def validate_skill_directory(skill_dir: str | Path) -> tuple[bool, str | None]:
     """
     Validate that a directory is a valid skill directory
 
@@ -155,7 +155,7 @@ def validate_skill_directory(skill_dir: Union[str, Path]) -> Tuple[bool, Optiona
     return True, None
 
 
-def validate_zip_file(zip_path: Union[str, Path]) -> Tuple[bool, Optional[str]]:
+def validate_zip_file(zip_path: str | Path) -> tuple[bool, str | None]:
     """
     Validate that a file is a valid skill .zip file
 
@@ -173,13 +173,13 @@ def validate_zip_file(zip_path: Union[str, Path]) -> Tuple[bool, Optional[str]]:
     if not zip_path.is_file():
         return False, f"Not a file: {zip_path}"
 
-    if not zip_path.suffix == '.zip':
+    if not zip_path.suffix == ".zip":
         return False, f"Not a .zip file: {zip_path}"
 
     return True, None
 
 
-def read_reference_files(skill_dir: Union[str, Path], max_chars: int = 100000, preview_limit: int = 40000) -> Dict[str, Dict]:
+def read_reference_files(skill_dir: str | Path, max_chars: int = 100000, preview_limit: int = 40000) -> dict[str, dict]:
     """Read reference files from a skill directory with enriched metadata.
 
     This function reads markdown files from the references/ subdirectory
@@ -210,13 +210,13 @@ def read_reference_files(skill_dir: Union[str, Path], max_chars: int = 100000, p
 
     skill_path = Path(skill_dir)
     references_dir = skill_path / "references"
-    references: Dict[str, Dict] = {}
+    references: dict[str, dict] = {}
 
     if not references_dir.exists():
         print(f"⚠ No references directory found at {references_dir}")
         return references
 
-    def _determine_source_metadata(relative_path: Path) -> Tuple[str, str, Optional[str]]:
+    def _determine_source_metadata(relative_path: Path) -> tuple[str, str, str | None]:
         """Determine source type, confidence level, and repo_id from path.
 
         For multi-source support, extracts repo_id from paths like:
@@ -230,54 +230,54 @@ def read_reference_files(skill_dir: Union[str, Path], max_chars: int = 100000, p
         repo_id = None  # Default: no repo identity
 
         # Documentation sources (official docs)
-        if path_str.startswith('documentation/'):
-            return 'documentation', 'high', None
+        if path_str.startswith("documentation/"):
+            return "documentation", "high", None
 
         # GitHub sources
-        elif path_str.startswith('github/'):
+        elif path_str.startswith("github/"):
             # README and releases are medium confidence
-            if 'README' in path_str or 'releases' in path_str:
-                return 'github', 'medium', None
+            if "README" in path_str or "releases" in path_str:
+                return "github", "medium", None
             # Issues are low confidence (user reports)
-            elif 'issues' in path_str:
-                return 'github', 'low', None
+            elif "issues" in path_str:
+                return "github", "low", None
             else:
-                return 'github', 'medium', None
+                return "github", "medium", None
 
         # PDF sources (books, manuals)
-        elif path_str.startswith('pdf/'):
-            return 'pdf', 'high', None
+        elif path_str.startswith("pdf/"):
+            return "pdf", "high", None
 
         # Merged API (synthesized from multiple sources)
-        elif path_str.startswith('api/'):
-            return 'api', 'high', None
+        elif path_str.startswith("api/"):
+            return "api", "high", None
 
         # Codebase analysis (C3.x automated analysis)
-        elif path_str.startswith('codebase_analysis/'):
+        elif path_str.startswith("codebase_analysis/"):
             # Extract repo_id from path: codebase_analysis/{repo_id}/...
             parts = Path(path_str).parts
             if len(parts) >= 2:
                 repo_id = parts[1]  # e.g., 'encode_httpx', 'encode_httpcore'
 
             # ARCHITECTURE.md is high confidence (comprehensive)
-            if 'ARCHITECTURE' in path_str:
-                return 'codebase_analysis', 'high', repo_id
+            if "ARCHITECTURE" in path_str:
+                return "codebase_analysis", "high", repo_id
             # Patterns and examples are medium (heuristic-based)
-            elif 'patterns' in path_str or 'examples' in path_str:
-                return 'codebase_analysis', 'medium', repo_id
+            elif "patterns" in path_str or "examples" in path_str:
+                return "codebase_analysis", "medium", repo_id
             # Configuration is high (direct extraction)
-            elif 'configuration' in path_str:
-                return 'codebase_analysis', 'high', repo_id
+            elif "configuration" in path_str:
+                return "codebase_analysis", "high", repo_id
             else:
-                return 'codebase_analysis', 'medium', repo_id
+                return "codebase_analysis", "medium", repo_id
 
         # Conflicts report (discrepancy detection)
-        elif 'conflicts' in path_str:
-            return 'conflicts', 'medium', None
+        elif "conflicts" in path_str:
+            return "conflicts", "medium", None
 
         # Fallback
         else:
-            return 'unknown', 'medium', None
+            return "unknown", "medium", None
 
     total_chars = 0
     # Search recursively for all .md files (including subdirectories like github/README.md)
@@ -285,7 +285,7 @@ def read_reference_files(skill_dir: Union[str, Path], max_chars: int = 100000, p
         # Note: We now include index.md files as they contain important content
         # (patterns, examples, configuration analysis)
 
-        content = ref_file.read_text(encoding='utf-8')
+        content = ref_file.read_text(encoding="utf-8")
 
         # Limit size per file
         truncated = False
@@ -299,13 +299,13 @@ def read_reference_files(skill_dir: Union[str, Path], max_chars: int = 100000, p
 
         # Build enriched metadata (with repo_id for multi-source support)
         references[str(relative_path)] = {
-            'content': content,
-            'source': source_type,
-            'confidence': confidence,
-            'path': str(relative_path),
-            'truncated': truncated,
-            'size': len(content),
-            'repo_id': repo_id  # None for single-source, repo identifier for multi-source
+            "content": content,
+            "source": source_type,
+            "confidence": confidence,
+            "path": str(relative_path),
+            "truncated": truncated,
+            "size": len(content),
+            "repo_id": repo_id,  # None for single-source, repo identifier for multi-source
         }
 
         total_chars += len(content)
@@ -319,10 +319,7 @@ def read_reference_files(skill_dir: Union[str, Path], max_chars: int = 100000, p
 
 
 def retry_with_backoff(
-    operation: Callable[[], T],
-    max_attempts: int = 3,
-    base_delay: float = 1.0,
-    operation_name: str = "operation"
+    operation: Callable[[], T], max_attempts: int = 3, base_delay: float = 1.0, operation_name: str = "operation"
 ) -> T:
     """Retry an operation with exponential backoff.
 
@@ -348,7 +345,7 @@ def retry_with_backoff(
         ...     return response.text
         >>> content = retry_with_backoff(fetch_page, max_attempts=3, operation_name=f"fetch {url}")
     """
-    last_exception: Optional[Exception] = None
+    last_exception: Exception | None = None
 
     for attempt in range(1, max_attempts + 1):
         try:
@@ -358,15 +355,11 @@ def retry_with_backoff(
             if attempt < max_attempts:
                 delay = base_delay * (2 ** (attempt - 1))
                 logger.warning(
-                    "%s failed (attempt %d/%d), retrying in %.1fs: %s",
-                    operation_name, attempt, max_attempts, delay, e
+                    "%s failed (attempt %d/%d), retrying in %.1fs: %s", operation_name, attempt, max_attempts, delay, e
                 )
                 time.sleep(delay)
             else:
-                logger.error(
-                    "%s failed after %d attempts: %s",
-                    operation_name, max_attempts, e
-                )
+                logger.error("%s failed after %d attempts: %s", operation_name, max_attempts, e)
 
     # This should always have a value, but mypy doesn't know that
     if last_exception is not None:
@@ -375,10 +368,7 @@ def retry_with_backoff(
 
 
 async def retry_with_backoff_async(
-    operation: Callable[[], T],
-    max_attempts: int = 3,
-    base_delay: float = 1.0,
-    operation_name: str = "operation"
+    operation: Callable[[], T], max_attempts: int = 3, base_delay: float = 1.0, operation_name: str = "operation"
 ) -> T:
     """Async version of retry_with_backoff for async operations.
 
@@ -403,7 +393,7 @@ async def retry_with_backoff_async(
     """
     import asyncio
 
-    last_exception: Optional[Exception] = None
+    last_exception: Exception | None = None
 
     for attempt in range(1, max_attempts + 1):
         try:
@@ -413,15 +403,11 @@ async def retry_with_backoff_async(
             if attempt < max_attempts:
                 delay = base_delay * (2 ** (attempt - 1))
                 logger.warning(
-                    "%s failed (attempt %d/%d), retrying in %.1fs: %s",
-                    operation_name, attempt, max_attempts, delay, e
+                    "%s failed (attempt %d/%d), retrying in %.1fs: %s", operation_name, attempt, max_attempts, delay, e
                 )
                 await asyncio.sleep(delay)
             else:
-                logger.error(
-                    "%s failed after %d attempts: %s",
-                    operation_name, max_attempts, e
-                )
+                logger.error("%s failed after %d attempts: %s", operation_name, max_attempts, e)
 
     if last_exception is not None:
         raise last_exception
diff --git a/src/skill_seekers/mcp/agent_detector.py b/src/skill_seekers/mcp/agent_detector.py
index 75e41b8..bc2bb2d 100644
--- a/src/skill_seekers/mcp/agent_detector.py
+++ b/src/skill_seekers/mcp/agent_detector.py
@@ -13,10 +13,9 @@ Supported agents:
 """
 
 import json
-import os
 import platform
 from pathlib import Path
-from typing import Dict, List, Optional, Tuple, Any
+from typing import Any
 
 
 class AgentDetector:
@@ -30,8 +29,8 @@ class AgentDetector:
             "config_paths": {
                 "Linux": "~/.config/claude-code/mcp.json",
                 "Darwin": "~/Library/Application Support/Claude/mcp.json",
-                "Windows": "~\\AppData\\Roaming\\Claude\\mcp.json"
-            }
+                "Windows": "~\\AppData\\Roaming\\Claude\\mcp.json",
+            },
         },
         "cursor": {
             "name": "Cursor",
@@ -39,8 +38,8 @@ class AgentDetector:
             "config_paths": {
                 "Linux": "~/.cursor/mcp_settings.json",
                 "Darwin": "~/Library/Application Support/Cursor/mcp_settings.json",
-                "Windows": "~\\AppData\\Roaming\\Cursor\\mcp_settings.json"
-            }
+                "Windows": "~\\AppData\\Roaming\\Cursor\\mcp_settings.json",
+            },
         },
         "windsurf": {
             "name": "Windsurf",
@@ -48,8 +47,8 @@ class AgentDetector:
             "config_paths": {
                 "Linux": "~/.windsurf/mcp_config.json",
                 "Darwin": "~/Library/Application Support/Windsurf/mcp_config.json",
-                "Windows": "~\\AppData\\Roaming\\Windsurf\\mcp_config.json"
-            }
+                "Windows": "~\\AppData\\Roaming\\Windsurf\\mcp_config.json",
+            },
         },
         "vscode-cline": {
             "name": "VS Code + Cline",
@@ -57,8 +56,8 @@ class AgentDetector:
             "config_paths": {
                 "Linux": "~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json",
                 "Darwin": "~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json",
-                "Windows": "~\\AppData\\Roaming\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json"
-            }
+                "Windows": "~\\AppData\\Roaming\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json",
+            },
         },
         "intellij": {
             "name": "IntelliJ IDEA",
@@ -66,16 +65,16 @@ class AgentDetector:
             "config_paths": {
                 "Linux": "~/.config/JetBrains/IntelliJIdea2024.3/mcp.xml",
                 "Darwin": "~/Library/Application Support/JetBrains/IntelliJIdea2024.3/mcp.xml",
-                "Windows": "~\\AppData\\Roaming\\JetBrains\\IntelliJIdea2024.3\\mcp.xml"
-            }
-        }
+                "Windows": "~\\AppData\\Roaming\\JetBrains\\IntelliJIdea2024.3\\mcp.xml",
+            },
+        },
     }
 
     def __init__(self):
         """Initialize the agent detector."""
         self.system = platform.system()
 
-    def detect_agents(self) -> List[Dict[str, str]]:
+    def detect_agents(self) -> list[dict[str, str]]:
         """
         Detect installed AI coding agents on the system.
 
@@ -88,16 +87,18 @@ class AgentDetector:
         for agent_id, config in self.AGENT_CONFIG.items():
             config_path = self._get_config_path(agent_id)
             if config_path:
-                detected.append({
-                    "agent": agent_id,
-                    "name": config["name"],
-                    "config_path": config_path,
-                    "transport": config["transport"]
-                })
+                detected.append(
+                    {
+                        "agent": agent_id,
+                        "name": config["name"],
+                        "config_path": config_path,
+                        "transport": config["transport"],
+                    }
+                )
 
         return detected
 
-    def _get_config_path(self, agent_id: str) -> Optional[str]:
+    def _get_config_path(self, agent_id: str) -> str | None:
         """
         Get the configuration path for a specific agent.
 
@@ -123,7 +124,7 @@ class AgentDetector:
 
         return None
 
-    def get_transport_type(self, agent_id: str) -> Optional[str]:
+    def get_transport_type(self, agent_id: str) -> str | None:
         """
         Get the transport type for a specific agent.
 
@@ -137,12 +138,7 @@ class AgentDetector:
             return None
         return self.AGENT_CONFIG[agent_id]["transport"]
 
-    def generate_config(
-        self,
-        agent_id: str,
-        server_command: str,
-        http_port: Optional[int] = 3000
-    ) -> Optional[str]:
+    def generate_config(self, agent_id: str, server_command: str, http_port: int | None = 3000) -> str | None:
         """
         Generate MCP configuration for a specific agent.
 
@@ -181,14 +177,7 @@ class AgentDetector:
         command = parts[0] if parts else "skill-seekers"
         args = parts[1:] if len(parts) > 1 else ["mcp"]
 
-        config = {
-            "mcpServers": {
-                "skill-seeker": {
-                    "command": command,
-                    "args": args
-                }
-            }
-        }
+        config = {"mcpServers": {"skill-seeker": {"command": command, "args": args}}}
 
         return json.dumps(config, indent=2)
 
@@ -202,13 +191,7 @@ class AgentDetector:
         Returns:
             JSON configuration string
         """
-        config = {
-            "mcpServers": {
-                "skill-seeker": {
-                    "url": f"http://localhost:{http_port}"
-                }
-            }
-        }
+        config = {"mcpServers": {"skill-seeker": {"url": f"http://localhost:{http_port}"}}}
 
         return json.dumps(config, indent=2)
 
@@ -237,7 +220,7 @@ class AgentDetector:
 </application>"""
         return xml
 
-    def get_all_config_paths(self) -> Dict[str, str]:
+    def get_all_config_paths(self) -> dict[str, str]:
         """
         Get all possible configuration paths for the current system.
 
@@ -263,7 +246,7 @@ class AgentDetector:
         """
         return self._get_config_path(agent_id) is not None
 
-    def get_agent_info(self, agent_id: str) -> Optional[Dict[str, Any]]:
+    def get_agent_info(self, agent_id: str) -> dict[str, Any] | None:
         """
         Get detailed information about a specific agent.
 
@@ -284,11 +267,11 @@ class AgentDetector:
             "name": config["name"],
             "transport": config["transport"],
             "config_path": config_path,
-            "installed": config_path is not None
+            "installed": config_path is not None,
         }
 
 
-def detect_agents() -> List[Dict[str, str]]:
+def detect_agents() -> list[dict[str, str]]:
     """
     Convenience function to detect installed agents.
 
@@ -299,11 +282,7 @@ def detect_agents() -> List[Dict[str, str]]:
     return detector.detect_agents()
 
 
-def generate_config(
-    agent_name: str,
-    server_command: str = "skill-seekers mcp",
-    http_port: int = 3000
-) -> Optional[str]:
+def generate_config(agent_name: str, server_command: str = "skill-seekers mcp", http_port: int = 3000) -> str | None:
     """
     Convenience function to generate config for a specific agent.
 
@@ -319,7 +298,7 @@ def generate_config(
     return detector.generate_config(agent_name, server_command, http_port)
 
 
-def get_transport_type(agent_name: str) -> Optional[str]:
+def get_transport_type(agent_name: str) -> str | None:
     """
     Convenience function to get transport type for an agent.
 
diff --git a/src/skill_seekers/mcp/git_repo.py b/src/skill_seekers/mcp/git_repo.py
index bcdf9f9..71f65a2 100644
--- a/src/skill_seekers/mcp/git_repo.py
+++ b/src/skill_seekers/mcp/git_repo.py
@@ -8,8 +8,8 @@ import json
 import os
 import shutil
 from pathlib import Path
-from typing import Optional
 from urllib.parse import urlparse
+
 import git
 from git.exc import GitCommandError, InvalidGitRepositoryError
 
@@ -17,7 +17,7 @@ from git.exc import GitCommandError, InvalidGitRepositoryError
 class GitConfigRepo:
     """Manages git operations for config repositories."""
 
-    def __init__(self, cache_dir: Optional[str] = None):
+    def __init__(self, cache_dir: str | None = None):
         """
         Initialize git repository manager.
 
@@ -43,8 +43,8 @@ class GitConfigRepo:
         source_name: str,
         git_url: str,
         branch: str = "main",
-        token: Optional[str] = None,
-        force_refresh: bool = False
+        token: str | None = None,
+        force_refresh: bool = False,
     ) -> Path:
         """
         Clone repository if not cached, else pull latest changes.
@@ -93,7 +93,7 @@ class GitConfigRepo:
                     # Pull latest changes
                     origin.pull(branch)
                     return repo_path
-                except (InvalidGitRepositoryError, GitCommandError) as e:
+                except (InvalidGitRepositoryError, GitCommandError):
                     # Corrupted repo - delete and re-clone
                     shutil.rmtree(repo_path)
                     raise  # Re-raise to trigger clone below
@@ -104,7 +104,7 @@ class GitConfigRepo:
                 repo_path,
                 branch=branch,
                 depth=1,  # Shallow clone
-                single_branch=True  # Only clone one branch
+                single_branch=True,  # Only clone one branch
             )
             return repo_path
 
@@ -114,21 +114,14 @@ class GitConfigRepo:
             # Provide helpful error messages
             if "authentication failed" in error_msg.lower() or "403" in error_msg:
                 raise GitCommandError(
-                    f"Authentication failed for {git_url}. "
-                    f"Check your token or permissions.",
-                    128
+                    f"Authentication failed for {git_url}. Check your token or permissions.", 128
                 ) from e
             elif "not found" in error_msg.lower() or "404" in error_msg:
                 raise GitCommandError(
-                    f"Repository not found: {git_url}. "
-                    f"Verify the URL is correct and you have access.",
-                    128
+                    f"Repository not found: {git_url}. Verify the URL is correct and you have access.", 128
                 ) from e
             else:
-                raise GitCommandError(
-                    f"Failed to clone repository: {error_msg}",
-                    128
-                ) from e
+                raise GitCommandError(f"Failed to clone repository: {error_msg}", 128) from e
 
     def find_configs(self, repo_path: Path) -> list[Path]:
         """
@@ -208,7 +201,7 @@ class GitConfigRepo:
             ValueError: If JSON is invalid
         """
         try:
-            with open(config_path, 'r', encoding='utf-8') as f:
+            with open(config_path, encoding="utf-8") as f:
                 return json.load(f)
         except json.JSONDecodeError as e:
             raise ValueError(f"Invalid JSON in config file {config_path.name}: {e}") from e
diff --git a/src/skill_seekers/mcp/server.py b/src/skill_seekers/mcp/server.py
index eb66fa5..08bbe76 100644
--- a/src/skill_seekers/mcp/server.py
+++ b/src/skill_seekers/mcp/server.py
@@ -21,40 +21,46 @@ warnings.warn(
     "  NEW: python -m skill_seekers.mcp.server_fastmcp\n"
     "The new server provides the same functionality with improved performance.",
     DeprecationWarning,
-    stacklevel=2
+    stacklevel=2,
 )
 
 # Re-export tool functions for backward compatibility with tests
 try:
     from skill_seekers.mcp.tools.config_tools import (
         generate_config as generate_config_tool,
+    )
+    from skill_seekers.mcp.tools.config_tools import (
         list_configs as list_configs_tool,
+    )
+    from skill_seekers.mcp.tools.config_tools import (
         validate_config as validate_config_tool,
     )
+    from skill_seekers.mcp.tools.packaging_tools import (
+        install_skill_tool,
+        package_skill_tool,
+        upload_skill_tool,
+    )
     from skill_seekers.mcp.tools.scraping_tools import (
+        detect_patterns_tool,
         estimate_pages_tool,
+        extract_config_patterns_tool,
+        run_subprocess_with_streaming,
         scrape_docs_tool,
         scrape_github_tool,
         scrape_pdf_tool,
-        detect_patterns_tool,
-        extract_config_patterns_tool,
-        run_subprocess_with_streaming,
     )
-    from skill_seekers.mcp.tools.packaging_tools import (
-        package_skill_tool,
-        upload_skill_tool,
-        install_skill_tool,
+    from skill_seekers.mcp.tools.source_tools import (
+        add_config_source_tool,
+        fetch_config_tool,
+        list_config_sources_tool,
+        remove_config_source_tool,
+        submit_config_tool,
+    )
+    from skill_seekers.mcp.tools.splitting_tools import (
+        generate_router as generate_router_tool,
     )
     from skill_seekers.mcp.tools.splitting_tools import (
         split_config as split_config_tool,
-        generate_router as generate_router_tool,
-    )
-    from skill_seekers.mcp.tools.source_tools import (
-        fetch_config_tool,
-        submit_config_tool,
-        add_config_source_tool,
-        list_config_sources_tool,
-        remove_config_source_tool,
     )
 
     # For test compatibility - create call_tool router function
@@ -110,96 +116,85 @@ try:
     async def list_tools():
         """Mock list_tools for backward compatibility with tests."""
         from mcp.types import Tool
+
         tools = [
             Tool(
                 name="generate_config",
                 description="Generate config file",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="list_configs",
                 description="List available configs",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="validate_config",
                 description="Validate config file",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="estimate_pages",
                 description="Estimate page count",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
-                name="scrape_docs",
-                description="Scrape documentation",
-                inputSchema={"type": "object", "properties": {}}
+                name="scrape_docs", description="Scrape documentation", inputSchema={"type": "object", "properties": {}}
             ),
             Tool(
                 name="scrape_github",
                 description="Scrape GitHub repository",
-                inputSchema={"type": "object", "properties": {}}
-            ),
-            Tool(
-                name="scrape_pdf",
-                description="Scrape PDF file",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
+            Tool(name="scrape_pdf", description="Scrape PDF file", inputSchema={"type": "object", "properties": {}}),
             Tool(
                 name="package_skill",
                 description="Package skill into .zip",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="upload_skill",
                 description="Upload skill to Claude",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
+            Tool(name="install_skill", description="Install skill", inputSchema={"type": "object", "properties": {}}),
             Tool(
-                name="install_skill",
-                description="Install skill",
-                inputSchema={"type": "object", "properties": {}}
-            ),
-            Tool(
-                name="split_config",
-                description="Split large config",
-                inputSchema={"type": "object", "properties": {}}
+                name="split_config", description="Split large config", inputSchema={"type": "object", "properties": {}}
             ),
             Tool(
                 name="generate_router",
                 description="Generate router skill",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="fetch_config",
                 description="Fetch config from source",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="submit_config",
                 description="Submit config to community",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="add_config_source",
                 description="Add config source",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="list_config_sources",
                 description="List config sources",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="remove_config_source",
                 description="Remove config source",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
             Tool(
                 name="extract_config_patterns",
                 description="Extract configuration patterns from config files",
-                inputSchema={"type": "object", "properties": {}}
+                inputSchema={"type": "object", "properties": {}},
             ),
         ]
         return tools
@@ -212,6 +207,7 @@ except ImportError:
 if __name__ == "__main__":
     try:
         from skill_seekers.mcp import server_fastmcp
+
         # Run the new server
         server_fastmcp.main()
     except ImportError as e:
diff --git a/src/skill_seekers/mcp/server_fastmcp.py b/src/skill_seekers/mcp/server_fastmcp.py
index de54057..412cf4c 100644
--- a/src/skill_seekers/mcp/server_fastmcp.py
+++ b/src/skill_seekers/mcp/server_fastmcp.py
@@ -46,11 +46,9 @@ All tool implementations are delegated to modular tool files in tools/ directory
   }
 """
 
-import sys
 import argparse
 import logging
-from pathlib import Path
-from typing import Any
+import sys
 
 # Import FastMCP
 MCP_AVAILABLE = False
@@ -60,6 +58,7 @@ TextContent = None
 try:
     from mcp.server import FastMCP
     from mcp.types import TextContent
+
     MCP_AVAILABLE = True
 except ImportError as e:
     # Only exit if running as main module, not when importing for tests
@@ -72,63 +71,64 @@ except ImportError as e:
 # Import all tool implementations
 try:
     from .tools import (
-        # Config tools
-        generate_config_impl,
-        list_configs_impl,
-        validate_config_impl,
+        add_config_source_impl,
+        build_how_to_guides_impl,
+        detect_patterns_impl,
+        enhance_skill_impl,
         # Scraping tools
         estimate_pages_impl,
+        extract_config_patterns_impl,
+        extract_test_examples_impl,
+        # Source tools
+        fetch_config_impl,
+        # Config tools
+        generate_config_impl,
+        generate_router_impl,
+        install_skill_impl,
+        list_config_sources_impl,
+        list_configs_impl,
+        # Packaging tools
+        package_skill_impl,
+        remove_config_source_impl,
+        scrape_codebase_impl,
         scrape_docs_impl,
         scrape_github_impl,
         scrape_pdf_impl,
-        scrape_codebase_impl,
-        detect_patterns_impl,
-        extract_test_examples_impl,
-        build_how_to_guides_impl,
-        extract_config_patterns_impl,
-        # Packaging tools
-        package_skill_impl,
-        upload_skill_impl,
-        enhance_skill_impl,
-        install_skill_impl,
         # Splitting tools
         split_config_impl,
-        generate_router_impl,
-        # Source tools
-        fetch_config_impl,
         submit_config_impl,
-        add_config_source_impl,
-        list_config_sources_impl,
-        remove_config_source_impl,
+        upload_skill_impl,
+        validate_config_impl,
     )
 except ImportError:
     # Fallback for direct script execution
     import os
+
     sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
     from tools import (
-        generate_config_impl,
-        list_configs_impl,
-        validate_config_impl,
+        add_config_source_impl,
+        build_how_to_guides_impl,
+        detect_patterns_impl,
+        enhance_skill_impl,
         estimate_pages_impl,
+        extract_config_patterns_impl,
+        extract_test_examples_impl,
+        fetch_config_impl,
+        generate_config_impl,
+        generate_router_impl,
+        install_skill_impl,
+        list_config_sources_impl,
+        list_configs_impl,
+        package_skill_impl,
+        remove_config_source_impl,
+        scrape_codebase_impl,
         scrape_docs_impl,
         scrape_github_impl,
         scrape_pdf_impl,
-        scrape_codebase_impl,
-        detect_patterns_impl,
-        extract_test_examples_impl,
-        build_how_to_guides_impl,
-        extract_config_patterns_impl,
-        package_skill_impl,
-        upload_skill_impl,
-        enhance_skill_impl,
-        install_skill_impl,
         split_config_impl,
-        generate_router_impl,
-        fetch_config_impl,
         submit_config_impl,
-        add_config_source_impl,
-        list_config_sources_impl,
-        remove_config_source_impl,
+        upload_skill_impl,
+        validate_config_impl,
     )
 
 # Initialize FastMCP server
@@ -139,6 +139,7 @@ if MCP_AVAILABLE and FastMCP is not None:
         instructions="Skill Seeker MCP Server - Generate Claude AI skills from documentation",
     )
 
+
 # Helper decorator for tests (when MCP is not available)
 def safe_tool_decorator(*args, **kwargs):
     """Decorator that works when mcp is None (for testing)"""
@@ -148,6 +149,7 @@ def safe_tool_decorator(*args, **kwargs):
         # Return a pass-through decorator for testing
         def wrapper(func):
             return func
+
         return wrapper
 
 
@@ -196,9 +198,7 @@ async def generate_config(
     return str(result)
 
 
-@safe_tool_decorator(
-    description="List all available preset configurations."
-)
+@safe_tool_decorator(description="List all available preset configurations.")
 async def list_configs() -> str:
     """
     List all available preset configurations.
@@ -212,9 +212,7 @@ async def list_configs() -> str:
     return str(result)
 
 
-@safe_tool_decorator(
-    description="Validate a config file for errors."
-)
+@safe_tool_decorator(description="Validate a config file for errors.")
 async def validate_config(config_path: str) -> str:
     """
     Validate a config file for errors.
@@ -1179,20 +1177,20 @@ async def run_http_server(host: str, port: int):
         # Add route before the catch-all SSE route
         app.routes.insert(0, Route("/health", health_check, methods=["GET"]))
 
-        logging.info(f"🚀 Starting Skill Seeker MCP Server (HTTP mode)")
+        logging.info("🚀 Starting Skill Seeker MCP Server (HTTP mode)")
         logging.info(f"📡 Server URL: http://{host}:{port}")
         logging.info(f"🔗 SSE Endpoint: http://{host}:{port}/sse")
         logging.info(f"💚 Health Check: http://{host}:{port}/health")
         logging.info(f"📝 Messages: http://{host}:{port}/messages/")
         logging.info("")
         logging.info("Claude Desktop Configuration (HTTP):")
-        logging.info('{')
+        logging.info("{")
         logging.info('  "mcpServers": {')
         logging.info('    "skill-seeker": {')
         logging.info(f'      "url": "http://{host}:{port}/sse"')
-        logging.info('    }')
-        logging.info('  }')
-        logging.info('}')
+        logging.info("    }")
+        logging.info("  }")
+        logging.info("}")
         logging.info("")
         logging.info("Press Ctrl+C to stop the server")
 
diff --git a/src/skill_seekers/mcp/server_legacy.py b/src/skill_seekers/mcp/server_legacy.py
index 5e099fc..73e8103 100644
--- a/src/skill_seekers/mcp/server_legacy.py
+++ b/src/skill_seekers/mcp/server_legacy.py
@@ -13,6 +13,7 @@ import sys
 import time
 from pathlib import Path
 from typing import Any
+
 import httpx
 
 # Import external MCP package
@@ -24,7 +25,8 @@ TextContent = None
 
 try:
     from mcp.server import Server
-    from mcp.types import Tool, TextContent
+    from mcp.types import TextContent, Tool
+
     MCP_AVAILABLE = True
 except ImportError as e:
     if __name__ == "__main__":
@@ -47,6 +49,7 @@ try:
 except ImportError:
     ConfigValidator = None  # Graceful degradation if not available
 
+
 # Helper decorator that works even when app is None
 def safe_decorator(decorator_func):
     """Returns the decorator if MCP is available, otherwise returns a no-op"""
@@ -56,6 +59,7 @@ def safe_decorator(decorator_func):
         # Return a decorator that just returns the function unchanged
         def noop_decorator(func):
             return func
+
         return noop_decorator
 
 
@@ -74,7 +78,7 @@ def run_subprocess_with_streaming(cmd, timeout=None):
             stderr=subprocess.PIPE,
             text=True,
             bufsize=1,  # Line buffered
-            universal_newlines=True
+            universal_newlines=True,
         )
 
         stdout_lines = []
@@ -96,6 +100,7 @@ def run_subprocess_with_streaming(cmd, timeout=None):
             # Read available output (non-blocking)
             try:
                 import select
+
                 readable, _, _ = select.select([process.stdout, process.stderr], [], [], 0.1)
 
                 if process.stdout in readable:
@@ -118,8 +123,8 @@ def run_subprocess_with_streaming(cmd, timeout=None):
         if remaining_stderr:
             stderr_lines.append(remaining_stderr)
 
-        stdout = ''.join(stdout_lines)
-        stderr = ''.join(stderr_lines)
+        stdout = "".join(stdout_lines)
+        stderr = "".join(stderr_lines)
         returncode = process.returncode
 
         return stdout, stderr, returncode
@@ -662,10 +667,7 @@ async def generate_config_tool(args: dict) -> list[TextContent]:
     rate_limit = args.get("rate_limit", 0.5)
 
     # Handle unlimited mode
-    if unlimited:
-        max_pages = None
-        limit_msg = "unlimited (no page limit)"
-    elif max_pages == -1:
+    if unlimited or max_pages == -1:
         max_pages = None
         limit_msg = "unlimited (no page limit)"
     else:
@@ -676,25 +678,18 @@ async def generate_config_tool(args: dict) -> list[TextContent]:
         "name": name,
         "description": description,
         "base_url": url,
-        "selectors": {
-            "main_content": "article",
-            "title": "h1",
-            "code_blocks": "pre code"
-        },
-        "url_patterns": {
-            "include": [],
-            "exclude": []
-        },
+        "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+        "url_patterns": {"include": [], "exclude": []},
         "categories": {},
         "rate_limit": rate_limit,
-        "max_pages": max_pages
+        "max_pages": max_pages,
     }
 
     # Save to configs directory
     config_path = Path("configs") / f"{name}.json"
     config_path.parent.mkdir(exist_ok=True)
 
-    with open(config_path, 'w') as f:
+    with open(config_path, "w") as f:
         json.dump(config, f, indent=2)
 
     result = f"""✅ Config created: {config_path}
@@ -731,14 +726,9 @@ async def estimate_pages_tool(args: dict) -> list[TextContent]:
         timeout = max(300, max_discovery // 2)  # Minimum 5 minutes
 
     # Run estimate_pages.py
-    cmd = [
-        sys.executable,
-        str(CLI_DIR / "estimate_pages.py"),
-        config_path,
-        "--max-discovery", str(max_discovery)
-    ]
+    cmd = [sys.executable, str(CLI_DIR / "estimate_pages.py"), config_path, "--max-discovery", str(max_discovery)]
 
-    progress_msg = f"🔄 Estimating page count...\n"
+    progress_msg = "🔄 Estimating page count...\n"
     progress_msg += f"⏱️ Maximum time: {timeout // 60} minutes\n\n"
 
     stdout, stderr, returncode = run_subprocess_with_streaming(cmd, timeout=timeout)
@@ -761,27 +751,27 @@ async def scrape_docs_tool(args: dict) -> list[TextContent]:
     merge_mode = args.get("merge_mode")
 
     # Load config to detect format
-    with open(config_path, 'r') as f:
+    with open(config_path) as f:
         config = json.load(f)
 
     # Detect if unified format (has 'sources' array)
-    is_unified = 'sources' in config and isinstance(config['sources'], list)
+    is_unified = "sources" in config and isinstance(config["sources"], list)
 
     # Handle unlimited mode by modifying config temporarily
     if unlimited:
         # Set max_pages to None (unlimited)
         if is_unified:
             # For unified configs, set max_pages on documentation sources
-            for source in config.get('sources', []):
-                if source.get('type') == 'documentation':
-                    source['max_pages'] = None
+            for source in config.get("sources", []):
+                if source.get("type") == "documentation":
+                    source["max_pages"] = None
         else:
             # For legacy configs
-            config['max_pages'] = None
+            config["max_pages"] = None
 
         # Create temporary config file
-        temp_config_path = config_path.replace('.json', '_unlimited_temp.json')
-        with open(temp_config_path, 'w') as f:
+        temp_config_path = config_path.replace(".json", "_unlimited_temp.json")
+        with open(temp_config_path, "w") as f:
             json.dump(config, f, indent=2)
 
         config_to_use = temp_config_path
@@ -791,19 +781,15 @@ async def scrape_docs_tool(args: dict) -> list[TextContent]:
     # Choose scraper based on format
     if is_unified:
         scraper_script = "unified_scraper.py"
-        progress_msg = f"🔄 Starting unified multi-source scraping...\n"
-        progress_msg += f"📦 Config format: Unified (multiple sources)\n"
+        progress_msg = "🔄 Starting unified multi-source scraping...\n"
+        progress_msg += "📦 Config format: Unified (multiple sources)\n"
     else:
         scraper_script = "doc_scraper.py"
-        progress_msg = f"🔄 Starting scraping process...\n"
-        progress_msg += f"📦 Config format: Legacy (single source)\n"
+        progress_msg = "🔄 Starting scraping process...\n"
+        progress_msg += "📦 Config format: Legacy (single source)\n"
 
     # Build command
-    cmd = [
-        sys.executable,
-        str(CLI_DIR / scraper_script),
-        "--config", config_to_use
-    ]
+    cmd = [sys.executable, str(CLI_DIR / scraper_script), "--config", config_to_use]
 
     # Add merge mode for unified configs
     if is_unified and merge_mode:
@@ -833,12 +819,12 @@ async def scrape_docs_tool(args: dict) -> list[TextContent]:
             if is_unified:
                 # For unified configs, estimate based on all sources
                 total_pages = 0
-                for source in config.get('sources', []):
-                    if source.get('type') == 'documentation':
-                        total_pages += source.get('max_pages', 500)
+                for source in config.get("sources", []):
+                    if source.get("type") == "documentation":
+                        total_pages += source.get("max_pages", 500)
                 max_pages = total_pages or 500
             else:
-                max_pages = config.get('max_pages', 500)
+                max_pages = config.get("max_pages", 500)
 
             # Estimate: 30s per page + buffer
             timeout = max(3600, max_pages * 35)  # Minimum 1 hour, or 35s per page
@@ -849,8 +835,8 @@ async def scrape_docs_tool(args: dict) -> list[TextContent]:
     if timeout:
         progress_msg += f"⏱️ Maximum time allowed: {timeout // 60} minutes\n"
     else:
-        progress_msg += f"⏱️ Unlimited mode - no timeout\n"
-    progress_msg += f"📝 Progress will be shown below:\n\n"
+        progress_msg += "⏱️ Unlimited mode - no timeout\n"
+    progress_msg += "📝 Progress will be shown below:\n\n"
 
     # Run scraper with streaming
     stdout, stderr, returncode = run_subprocess_with_streaming(cmd, timeout=timeout)
@@ -874,7 +860,7 @@ async def package_skill_tool(args: dict) -> list[TextContent]:
     auto_upload = args.get("auto_upload", True)
 
     # Check if API key exists - only upload if available
-    has_api_key = os.environ.get('ANTHROPIC_API_KEY', '').strip()
+    has_api_key = os.environ.get("ANTHROPIC_API_KEY", "").strip()
     should_upload = auto_upload and has_api_key
 
     # Run package_skill.py
@@ -883,7 +869,7 @@ async def package_skill_tool(args: dict) -> list[TextContent]:
         str(CLI_DIR / "package_skill.py"),
         skill_dir,
         "--no-open",  # Don't open folder in MCP context
-        "--skip-quality-check"  # Skip interactive quality checks in MCP context
+        "--skip-quality-check",  # Skip interactive quality checks in MCP context
     ]
 
     # Add upload flag only if we have API key
@@ -934,11 +920,7 @@ async def upload_skill_tool(args: dict) -> list[TextContent]:
     skill_zip = args["skill_zip"]
 
     # Run upload_skill.py
-    cmd = [
-        sys.executable,
-        str(CLI_DIR / "upload_skill.py"),
-        skill_zip
-    ]
+    cmd = [sys.executable, str(CLI_DIR / "upload_skill.py"), skill_zip]
 
     # Timeout: 5 minutes for upload
     timeout = 300
@@ -1003,36 +985,37 @@ async def validate_config_tool(args: dict) -> list[TextContent]:
         # Try unified config validator first
         try:
             from config_validator import validate_config
+
             validator = validate_config(config_path)
 
-            result = f"✅ Config is valid!\n\n"
+            result = "✅ Config is valid!\n\n"
 
             # Show format
             if validator.is_unified:
-                result += f"📦 Format: Unified (multi-source)\n"
+                result += "📦 Format: Unified (multi-source)\n"
                 result += f"  Name: {validator.config['name']}\n"
                 result += f"  Sources: {len(validator.config.get('sources', []))}\n"
 
                 # Show sources
-                for i, source in enumerate(validator.config.get('sources', []), 1):
+                for i, source in enumerate(validator.config.get("sources", []), 1):
                     result += f"\n  Source {i}: {source['type']}\n"
-                    if source['type'] == 'documentation':
+                    if source["type"] == "documentation":
                         result += f"    URL: {source.get('base_url', 'N/A')}\n"
                         result += f"    Max pages: {source.get('max_pages', 'Not set')}\n"
-                    elif source['type'] == 'github':
+                    elif source["type"] == "github":
                         result += f"    Repo: {source.get('repo', 'N/A')}\n"
                         result += f"    Code depth: {source.get('code_analysis_depth', 'surface')}\n"
-                    elif source['type'] == 'pdf':
+                    elif source["type"] == "pdf":
                         result += f"    Path: {source.get('path', 'N/A')}\n"
 
                 # Show merge settings if applicable
                 if validator.needs_api_merge():
-                    merge_mode = validator.config.get('merge_mode', 'rule-based')
+                    merge_mode = validator.config.get("merge_mode", "rule-based")
                     result += f"\n  Merge mode: {merge_mode}\n"
-                    result += f"  API merging: Required (docs + code sources)\n"
+                    result += "  API merging: Required (docs + code sources)\n"
 
             else:
-                result += f"📦 Format: Legacy (single source)\n"
+                result += "📦 Format: Legacy (single source)\n"
                 result += f"  Name: {validator.config['name']}\n"
                 result += f"  Base URL: {validator.config.get('base_url', 'N/A')}\n"
                 result += f"  Max pages: {validator.config.get('max_pages', 'Not set')}\n"
@@ -1042,29 +1025,30 @@ async def validate_config_tool(args: dict) -> list[TextContent]:
 
         except ImportError:
             # Fall back to legacy validation
-            from doc_scraper import validate_config
             import json
 
-            with open(config_path, 'r') as f:
+            from doc_scraper import validate_config
+
+            with open(config_path) as f:
                 config = json.load(f)
 
             # Validate config - returns (errors, warnings) tuple
             errors, warnings = validate_config(config)
 
             if errors:
-                result = f"❌ Config validation failed:\n\n"
+                result = "❌ Config validation failed:\n\n"
                 for error in errors:
                     result += f"  • {error}\n"
             else:
-                result = f"✅ Config is valid!\n\n"
-                result += f"📦 Format: Legacy (single source)\n"
+                result = "✅ Config is valid!\n\n"
+                result += "📦 Format: Legacy (single source)\n"
                 result += f"  Name: {config['name']}\n"
                 result += f"  Base URL: {config['base_url']}\n"
                 result += f"  Max pages: {config.get('max_pages', 'Not set')}\n"
                 result += f"  Rate limit: {config.get('rate_limit', 'Not set')}s\n"
 
                 if warnings:
-                    result += f"\n⚠️  Warnings:\n"
+                    result += "\n⚠️  Warnings:\n"
                     for warning in warnings:
                         result += f"  • {warning}\n"
 
@@ -1086,8 +1070,10 @@ async def split_config_tool(args: dict) -> list[TextContent]:
         sys.executable,
         str(CLI_DIR / "split_config.py"),
         config_path,
-        "--strategy", strategy,
-        "--target-pages", str(target_pages)
+        "--strategy",
+        strategy,
+        "--target-pages",
+        str(target_pages),
     ]
 
     if dry_run:
@@ -1292,11 +1278,7 @@ async def fetch_config_tool(args: dict) -> list[TextContent]:
             git_repo = GitConfigRepo()
             try:
                 repo_path = git_repo.clone_or_pull(
-                    source_name=source_name,
-                    git_url=git_url,
-                    branch=branch,
-                    token=token,
-                    force_refresh=force_refresh
+                    source_name=source_name, git_url=git_url, branch=branch, token=token, force_refresh=force_refresh
                 )
             except Exception as e:
                 return [TextContent(type="text", text=f"❌ Git error: {str(e)}")]
@@ -1314,7 +1296,7 @@ async def fetch_config_tool(args: dict) -> list[TextContent]:
             dest_path.mkdir(parents=True, exist_ok=True)
             config_file = dest_path / f"{config_name}.json"
 
-            with open(config_file, 'w') as f:
+            with open(config_file, "w") as f:
                 json.dump(config_data, f, indent=2)
 
             result = f"""✅ Config fetched from git source successfully!
@@ -1324,7 +1306,7 @@ async def fetch_config_tool(args: dict) -> list[TextContent]:
 🔗 Source: {source_name}
 🌿 Branch: {branch}
 📁 Repository: {git_url}
-🔄 Refreshed: {'Yes (forced)' if force_refresh else 'No (used cache)'}
+🔄 Refreshed: {"Yes (forced)" if force_refresh else "No (used cache)"}
 
 Next steps:
   1. Review config: cat {config_file}
@@ -1350,7 +1332,7 @@ Next steps:
                     git_url=git_url,
                     branch=branch,
                     token=token,
-                    force_refresh=force_refresh
+                    force_refresh=force_refresh,
                 )
             except ValueError as e:
                 return [TextContent(type="text", text=f"❌ Invalid git URL: {str(e)}")]
@@ -1370,7 +1352,7 @@ Next steps:
             dest_path.mkdir(parents=True, exist_ok=True)
             config_file = dest_path / f"{config_name}.json"
 
-            with open(config_file, 'w') as f:
+            with open(config_file, "w") as f:
                 json.dump(config_data, f, indent=2)
 
             result = f"""✅ Config fetched from git URL successfully!
@@ -1379,7 +1361,7 @@ Next steps:
 📂 Saved to: {config_file}
 📁 Repository: {git_url}
 🌿 Branch: {branch}
-🔄 Refreshed: {'Yes (forced)' if force_refresh else 'No (used cache)'}
+🔄 Refreshed: {"Yes (forced)" if force_refresh else "No (used cache)"}
 
 Next steps:
   1. Review config: cat {config_file}
@@ -1436,21 +1418,28 @@ Next steps:
                             if tags:
                                 result += f"    Tags: {tags}\n"
 
-                    result += f"\n💡 To download a config, use: fetch_config with config_name='<name>'\n"
+                    result += "\n💡 To download a config, use: fetch_config with config_name='<name>'\n"
                     result += f"📚 API Docs: {API_BASE_URL}/docs\n"
 
                     return [TextContent(type="text", text=result)]
 
                 # Download specific config
                 if not config_name:
-                    return [TextContent(type="text", text="❌ Error: Please provide config_name or set list_available=true")]
+                    return [
+                        TextContent(type="text", text="❌ Error: Please provide config_name or set list_available=true")
+                    ]
 
                 # Get config details first
                 detail_url = f"{API_BASE_URL}/api/configs/{config_name}"
                 detail_response = await client.get(detail_url)
 
                 if detail_response.status_code == 404:
-                    return [TextContent(type="text", text=f"❌ Config '{config_name}' not found. Use list_available=true to see available configs.")]
+                    return [
+                        TextContent(
+                            type="text",
+                            text=f"❌ Config '{config_name}' not found. Use list_available=true to see available configs.",
+                        )
+                    ]
 
                 detail_response.raise_for_status()
                 config_info = detail_response.json()
@@ -1466,7 +1455,7 @@ Next steps:
                 dest_path.mkdir(parents=True, exist_ok=True)
                 config_file = dest_path / f"{config_name}.json"
 
-                with open(config_file, 'w') as f:
+                with open(config_file, "w") as f:
                     json.dump(config_data, f, indent=2)
 
                 # Build result message
@@ -1474,15 +1463,15 @@ Next steps:
 
 📦 Config: {config_name}
 📂 Saved to: {config_file}
-📊 Category: {config_info.get('category', 'uncategorized')}
-🏷️  Tags: {', '.join(config_info.get('tags', []))}
-📄 Type: {config_info.get('type', 'unknown')}
-📝 Description: {config_info.get('description', 'No description')}
+📊 Category: {config_info.get("category", "uncategorized")}
+🏷️  Tags: {", ".join(config_info.get("tags", []))}
+📄 Type: {config_info.get("type", "unknown")}
+📝 Description: {config_info.get("description", "No description")}
 
-🔗 Source: {config_info.get('primary_source', 'N/A')}
-📏 Max pages: {config_info.get('max_pages', 'N/A')}
-📦 File size: {config_info.get('file_size', 'N/A')} bytes
-🕒 Last updated: {config_info.get('last_updated', 'N/A')}
+🔗 Source: {config_info.get("primary_source", "N/A")}
+📏 Max pages: {config_info.get("max_pages", "N/A")}
+📦 File size: {config_info.get("file_size", "N/A")} bytes
+🕒 Last updated: {config_info.get("last_updated", "N/A")}
 
 Next steps:
   1. Review config: cat {config_file}
@@ -1495,7 +1484,11 @@ Next steps:
                 return [TextContent(type="text", text=result)]
 
     except httpx.HTTPError as e:
-        return [TextContent(type="text", text=f"❌ HTTP Error: {str(e)}\n\nCheck your internet connection or try again later.")]
+        return [
+            TextContent(
+                type="text", text=f"❌ HTTP Error: {str(e)}\n\nCheck your internet connection or try again later."
+            )
+        ]
     except json.JSONDecodeError as e:
         return [TextContent(type="text", text=f"❌ JSON Error: Invalid response from API: {str(e)}")]
     except Exception as e:
@@ -1537,16 +1530,20 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
 
     # Validation: Must provide exactly one of config_name or config_path
     if not config_name and not config_path:
-        return [TextContent(
-            type="text",
-            text="❌ Error: Must provide either config_name or config_path\n\nExamples:\n  install_skill(config_name='react')\n  install_skill(config_path='configs/custom.json')"
-        )]
+        return [
+            TextContent(
+                type="text",
+                text="❌ Error: Must provide either config_name or config_path\n\nExamples:\n  install_skill(config_name='react')\n  install_skill(config_path='configs/custom.json')",
+            )
+        ]
 
     if config_name and config_path:
-        return [TextContent(
-            type="text",
-            text="❌ Error: Cannot provide both config_name and config_path\n\nChoose one:\n  - config_name: Fetch from API (e.g., 'react')\n  - config_path: Use existing file (e.g., 'configs/custom.json')"
-        )]
+        return [
+            TextContent(
+                type="text",
+                text="❌ Error: Cannot provide both config_name and config_path\n\nChoose one:\n  - config_name: Fetch from API (e.g., 'react')\n  - config_path: Use existing file (e.g., 'configs/custom.json')",
+            )
+        ]
 
     # Initialize output
     output_lines = []
@@ -1560,11 +1557,11 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
 
     # Track workflow state
     workflow_state = {
-        'config_path': config_path,
-        'skill_name': None,
-        'skill_dir': None,
-        'zip_path': None,
-        'phases_completed': []
+        "config_path": config_path,
+        "skill_name": None,
+        "skill_dir": None,
+        "zip_path": None,
+        "phases_completed": [],
     }
 
     try:
@@ -1578,10 +1575,7 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
 
             if not dry_run:
                 # Call fetch_config_tool directly
-                fetch_result = await fetch_config_tool({
-                    "config_name": config_name,
-                    "destination": destination
-                })
+                fetch_result = await fetch_config_tool({"config_name": config_name, "destination": destination})
 
                 # Parse result to extract config path
                 fetch_output = fetch_result[0].text
@@ -1592,15 +1586,15 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
                 # Expected format: "✅ Config saved to: configs/react.json"
                 match = re.search(r"saved to:\s*(.+\.json)", fetch_output)
                 if match:
-                    workflow_state['config_path'] = match.group(1).strip()
+                    workflow_state["config_path"] = match.group(1).strip()
                     output_lines.append(f"✅ Config fetched: {workflow_state['config_path']}")
                 else:
                     return [TextContent(type="text", text="\n".join(output_lines) + "\n\n❌ Failed to fetch config")]
 
-                workflow_state['phases_completed'].append('fetch_config')
+                workflow_state["phases_completed"].append("fetch_config")
             else:
                 output_lines.append("  [DRY RUN] Would fetch config from API")
-                workflow_state['config_path'] = f"{destination}/{config_name}.json"
+                workflow_state["config_path"] = f"{destination}/{config_name}.json"
 
             output_lines.append("")
 
@@ -1615,23 +1609,27 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
         if not dry_run:
             # Load config to get skill name
             try:
-                with open(workflow_state['config_path'], 'r') as f:
+                with open(workflow_state["config_path"]) as f:
                     config = json.load(f)
-                    workflow_state['skill_name'] = config.get('name', 'unknown')
+                    workflow_state["skill_name"] = config.get("name", "unknown")
             except Exception as e:
-                return [TextContent(type="text", text="\n".join(output_lines) + f"\n\n❌ Failed to read config: {str(e)}")]
+                return [
+                    TextContent(type="text", text="\n".join(output_lines) + f"\n\n❌ Failed to read config: {str(e)}")
+                ]
 
             # Call scrape_docs_tool (does NOT include enhancement)
             output_lines.append("Scraping documentation (this may take 20-45 minutes)...")
             output_lines.append("")
 
-            scrape_result = await scrape_docs_tool({
-                "config_path": workflow_state['config_path'],
-                "unlimited": unlimited,
-                "enhance_local": False,  # Enhancement is separate phase
-                "skip_scrape": False,
-                "dry_run": False
-            })
+            scrape_result = await scrape_docs_tool(
+                {
+                    "config_path": workflow_state["config_path"],
+                    "unlimited": unlimited,
+                    "enhance_local": False,  # Enhancement is separate phase
+                    "skip_scrape": False,
+                    "dry_run": False,
+                }
+            )
 
             scrape_output = scrape_result[0].text
             output_lines.append(scrape_output)
@@ -1639,14 +1637,16 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
 
             # Check for success
             if "❌" in scrape_output:
-                return [TextContent(type="text", text="\n".join(output_lines) + "\n\n❌ Scraping failed - see error above")]
+                return [
+                    TextContent(type="text", text="\n".join(output_lines) + "\n\n❌ Scraping failed - see error above")
+                ]
 
-            workflow_state['skill_dir'] = f"{destination}/{workflow_state['skill_name']}"
-            workflow_state['phases_completed'].append('scrape_docs')
+            workflow_state["skill_dir"] = f"{destination}/{workflow_state['skill_name']}"
+            workflow_state["phases_completed"].append("scrape_docs")
         else:
             output_lines.append("  [DRY RUN] Would scrape documentation")
-            workflow_state['skill_name'] = "example"
-            workflow_state['skill_dir'] = f"{destination}/example"
+            workflow_state["skill_name"] = "example"
+            workflow_state["skill_dir"] = f"{destination}/example"
 
         output_lines.append("")
 
@@ -1666,7 +1666,7 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
             cmd = [
                 sys.executable,
                 str(CLI_DIR / "enhance_skill_local.py"),
-                workflow_state['skill_dir']
+                workflow_state["skill_dir"],
                 # Headless is default, no flag needed
             ]
 
@@ -1682,7 +1682,7 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
                 return [TextContent(type="text", text="\n".join(output_lines))]
 
             output_lines.append(stdout)
-            workflow_state['phases_completed'].append('enhance_skill')
+            workflow_state["phases_completed"].append("enhance_skill")
         else:
             output_lines.append("  [DRY RUN] Would enhance SKILL.md with Claude Code")
 
@@ -1697,10 +1697,12 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
 
         if not dry_run:
             # Call package_skill_tool (auto_upload=False, we handle upload separately)
-            package_result = await package_skill_tool({
-                "skill_dir": workflow_state['skill_dir'],
-                "auto_upload": False  # We handle upload in next phase
-            })
+            package_result = await package_skill_tool(
+                {
+                    "skill_dir": workflow_state["skill_dir"],
+                    "auto_upload": False,  # We handle upload in next phase
+                }
+            )
 
             package_output = package_result[0].text
             output_lines.append(package_output)
@@ -1710,15 +1712,15 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
             # Expected format: "Saved to: output/react.zip"
             match = re.search(r"Saved to:\s*(.+\.zip)", package_output)
             if match:
-                workflow_state['zip_path'] = match.group(1).strip()
+                workflow_state["zip_path"] = match.group(1).strip()
             else:
                 # Fallback: construct zip path
-                workflow_state['zip_path'] = f"{destination}/{workflow_state['skill_name']}.zip"
+                workflow_state["zip_path"] = f"{destination}/{workflow_state['skill_name']}.zip"
 
-            workflow_state['phases_completed'].append('package_skill')
+            workflow_state["phases_completed"].append("package_skill")
         else:
             output_lines.append("  [DRY RUN] Would package to .zip file")
-            workflow_state['zip_path'] = f"{destination}/{workflow_state['skill_name']}.zip"
+            workflow_state["zip_path"] = f"{destination}/{workflow_state['skill_name']}.zip"
 
         output_lines.append("")
 
@@ -1731,19 +1733,17 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
             output_lines.append("")
 
             # Check for API key
-            has_api_key = os.environ.get('ANTHROPIC_API_KEY', '').strip()
+            has_api_key = os.environ.get("ANTHROPIC_API_KEY", "").strip()
 
             if not dry_run:
                 if has_api_key:
                     # Call upload_skill_tool
-                    upload_result = await upload_skill_tool({
-                        "skill_zip": workflow_state['zip_path']
-                    })
+                    upload_result = await upload_skill_tool({"skill_zip": workflow_state["zip_path"]})
 
                     upload_output = upload_result[0].text
                     output_lines.append(upload_output)
 
-                    workflow_state['phases_completed'].append('upload_skill')
+                    workflow_state["phases_completed"].append("upload_skill")
                 else:
                     output_lines.append("⚠️  ANTHROPIC_API_KEY not set - skipping upload")
                     output_lines.append("")
@@ -1768,13 +1768,13 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
 
         if not dry_run:
             output_lines.append("Phases completed:")
-            for phase in workflow_state['phases_completed']:
+            for phase in workflow_state["phases_completed"]:
                 output_lines.append(f"  ✓ {phase}")
             output_lines.append("")
 
             output_lines.append("📁 Output:")
             output_lines.append(f"  Skill directory: {workflow_state['skill_dir']}")
-            if workflow_state['zip_path']:
+            if workflow_state["zip_path"]:
                 output_lines.append(f"  Skill package: {workflow_state['zip_path']}")
             output_lines.append("")
 
@@ -1785,7 +1785,7 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
                 output_lines.append("📝 Manual upload required (see instructions above)")
             else:
                 output_lines.append("📤 To upload:")
-                output_lines.append("   skill-seekers upload " + workflow_state['zip_path'])
+                output_lines.append("   skill-seekers upload " + workflow_state["zip_path"])
         else:
             output_lines.append("This was a dry run. No actions were taken.")
             output_lines.append("")
@@ -1802,7 +1802,7 @@ async def install_skill_tool(args: dict) -> list[TextContent]:
         output_lines.append(f"❌ Workflow failed: {str(e)}")
         output_lines.append("")
         output_lines.append("Phases completed before failure:")
-        for phase in workflow_state['phases_completed']:
+        for phase in workflow_state["phases_completed"]:
             output_lines.append(f"  ✓ {phase}")
         return [TextContent(type="text", text="\n".join(output_lines))]
 
@@ -1812,7 +1812,9 @@ async def submit_config_tool(args: dict) -> list[TextContent]:
     try:
         from github import Github, GithubException
     except ImportError:
-        return [TextContent(type="text", text="❌ Error: PyGithub not installed.\n\nInstall with: pip install PyGithub")]
+        return [
+            TextContent(type="text", text="❌ Error: PyGithub not installed.\n\nInstall with: pip install PyGithub")
+        ]
 
     config_path = args.get("config_path")
     config_json_str = args.get("config_json")
@@ -1826,7 +1828,7 @@ async def submit_config_tool(args: dict) -> list[TextContent]:
             if not config_file.exists():
                 return [TextContent(type="text", text=f"❌ Error: Config file not found: {config_path}")]
 
-            with open(config_file, 'r') as f:
+            with open(config_file) as f:
                 config_data = json.load(f)
                 config_json_str = json.dumps(config_data, indent=2)
                 config_name = config_data.get("name", config_file.stem)
@@ -1843,7 +1845,12 @@ async def submit_config_tool(args: dict) -> list[TextContent]:
 
         # Use ConfigValidator for comprehensive validation
         if ConfigValidator is None:
-            return [TextContent(type="text", text="❌ Error: ConfigValidator not available. Please ensure config_validator.py is in the CLI directory.")]
+            return [
+                TextContent(
+                    type="text",
+                    text="❌ Error: ConfigValidator not available. Please ensure config_validator.py is in the CLI directory.",
+                )
+            ]
 
         try:
             validator = ConfigValidator(config_data)
@@ -1855,22 +1862,26 @@ async def submit_config_tool(args: dict) -> list[TextContent]:
 
             # Additional format validation (ConfigValidator only checks structure)
             # Validate name format (alphanumeric, hyphens, underscores only)
-            if not re.match(r'^[a-zA-Z0-9_-]+$', config_name):
-                raise ValueError(f"Invalid name format: '{config_name}'\nNames must contain only alphanumeric characters, hyphens, and underscores")
+            if not re.match(r"^[a-zA-Z0-9_-]+$", config_name):
+                raise ValueError(
+                    f"Invalid name format: '{config_name}'\nNames must contain only alphanumeric characters, hyphens, and underscores"
+                )
 
             # Validate URL formats
             if not is_unified:
                 # Legacy config - check base_url
-                base_url = config_data.get('base_url', '')
-                if base_url and not (base_url.startswith('http://') or base_url.startswith('https://')):
+                base_url = config_data.get("base_url", "")
+                if base_url and not (base_url.startswith("http://") or base_url.startswith("https://")):
                     raise ValueError(f"Invalid base_url format: '{base_url}'\nURLs must start with http:// or https://")
             else:
                 # Unified config - check URLs in sources
-                for idx, source in enumerate(config_data.get('sources', [])):
-                    if source.get('type') == 'documentation':
-                        source_url = source.get('base_url', '')
-                        if source_url and not (source_url.startswith('http://') or source_url.startswith('https://')):
-                            raise ValueError(f"Source {idx} (documentation): Invalid base_url format: '{source_url}'\nURLs must start with http:// or https://")
+                for idx, source in enumerate(config_data.get("sources", [])):
+                    if source.get("type") == "documentation":
+                        source_url = source.get("base_url", "")
+                        if source_url and not (source_url.startswith("http://") or source_url.startswith("https://")):
+                            raise ValueError(
+                                f"Source {idx} (documentation): Invalid base_url format: '{source_url}'\nURLs must start with http:// or https://"
+                            )
 
         except ValueError as validation_error:
             # Provide detailed validation feedback
@@ -1894,12 +1905,14 @@ Please fix these issues and try again.
         # Detect category based on config format and content
         if is_unified:
             # For unified configs, look at source types
-            source_types = [src.get('type') for src in config_data.get('sources', [])]
-            if 'documentation' in source_types and 'github' in source_types:
-                category = "multi-source"
-            elif 'documentation' in source_types and 'pdf' in source_types:
-                category = "multi-source"
-            elif len(source_types) > 1:
+            source_types = [src.get("type") for src in config_data.get("sources", [])]
+            if (
+                "documentation" in source_types
+                and "github" in source_types
+                or "documentation" in source_types
+                and "pdf" in source_types
+                or len(source_types) > 1
+            ):
                 category = "multi-source"
             else:
                 category = "unified"
@@ -1920,21 +1933,26 @@ Please fix these issues and try again.
         warnings = []
         if not is_unified:
             # Legacy config warnings
-            if 'max_pages' not in config_data:
+            if "max_pages" not in config_data:
                 warnings.append("⚠️ No max_pages set - will use default (100)")
-            elif config_data.get('max_pages') in (None, -1):
+            elif config_data.get("max_pages") in (None, -1):
                 warnings.append("⚠️ Unlimited scraping enabled - may scrape thousands of pages and take hours")
         else:
             # Unified config warnings
-            for src in config_data.get('sources', []):
-                if src.get('type') == 'documentation' and 'max_pages' not in src:
-                    warnings.append(f"⚠️ No max_pages set for documentation source - will use default (100)")
-                elif src.get('type') == 'documentation' and src.get('max_pages') in (None, -1):
-                    warnings.append(f"⚠️ Unlimited scraping enabled for documentation source")
+            for src in config_data.get("sources", []):
+                if src.get("type") == "documentation" and "max_pages" not in src:
+                    warnings.append("⚠️ No max_pages set for documentation source - will use default (100)")
+                elif src.get("type") == "documentation" and src.get("max_pages") in (None, -1):
+                    warnings.append("⚠️ Unlimited scraping enabled for documentation source")
 
         # Check for GitHub token
         if not github_token:
-            return [TextContent(type="text", text="❌ Error: GitHub token required.\n\nProvide github_token parameter or set GITHUB_TOKEN environment variable.\n\nCreate token at: https://github.com/settings/tokens")]
+            return [
+                TextContent(
+                    type="text",
+                    text="❌ Error: GitHub token required.\n\nProvide github_token parameter or set GITHUB_TOKEN environment variable.\n\nCreate token at: https://github.com/settings/tokens",
+                )
+            ]
 
         # Create GitHub issue
         try:
@@ -1962,7 +1980,7 @@ Please fix these issues and try again.
 {testing_notes if testing_notes else "Not provided"}
 
 ### Documentation URL
-{config_data.get('base_url') if not is_unified else 'See sources in config'}
+{config_data.get("base_url") if not is_unified else "See sources in config"}
 
 {"### Validation Warnings" if warnings else ""}
 {chr(10).join(f"- {w}" for w in warnings) if warnings else ""}
@@ -1978,9 +1996,7 @@ Please fix these issues and try again.
 
             # Create issue
             issue = repo.create_issue(
-                title=f"[CONFIG] {config_name}",
-                body=issue_body,
-                labels=["config-submission", "needs-review"]
+                title=f"[CONFIG] {config_name}", body=issue_body, labels=["config-submission", "needs-review"]
             )
 
             result = f"""✅ Config submitted successfully!
@@ -2004,7 +2020,12 @@ What happens next:
             return [TextContent(type="text", text=result)]
 
         except GithubException as e:
-            return [TextContent(type="text", text=f"❌ GitHub Error: {str(e)}\n\nCheck your token permissions (needs 'repo' or 'public_repo' scope).")]
+            return [
+                TextContent(
+                    type="text",
+                    text=f"❌ GitHub Error: {str(e)}\n\nCheck your token permissions (needs 'repo' or 'public_repo' scope).",
+                )
+            ]
 
     except Exception as e:
         return [TextContent(type="text", text=f"❌ Error: {str(e)}")]
@@ -2038,34 +2059,34 @@ async def add_config_source_tool(args: dict) -> list[TextContent]:
             token_env=token_env,
             branch=branch,
             priority=priority,
-            enabled=enabled
+            enabled=enabled,
         )
 
         # Check if this is an update
         is_update = "updated_at" in source and source["added_at"] != source["updated_at"]
 
-        result = f"""✅ Config source {'updated' if is_update else 'registered'} successfully!
+        result = f"""✅ Config source {"updated" if is_update else "registered"} successfully!
 
-📛 Name: {source['name']}
-📁 Repository: {source['git_url']}
-🔖 Type: {source['type']}
-🌿 Branch: {source['branch']}
-🔑 Token env: {source.get('token_env', 'None')}
-⚡ Priority: {source['priority']} (lower = higher priority)
-✓ Enabled: {source['enabled']}
-🕒 Added: {source['added_at'][:19]}
+📛 Name: {source["name"]}
+📁 Repository: {source["git_url"]}
+🔖 Type: {source["type"]}
+🌿 Branch: {source["branch"]}
+🔑 Token env: {source.get("token_env", "None")}
+⚡ Priority: {source["priority"]} (lower = higher priority)
+✓ Enabled: {source["enabled"]}
+🕒 Added: {source["added_at"][:19]}
 
 Usage:
   # Fetch config from this source
-  fetch_config(source="{source['name']}", config_name="your-config")
+  fetch_config(source="{source["name"]}", config_name="your-config")
 
   # List all sources
   list_config_sources()
 
   # Remove this source
-  remove_config_source(name="{source['name']}")
+  remove_config_source(name="{source["name"]}")
 
-💡 Make sure to set {source.get('token_env', 'GIT_TOKEN')} environment variable for private repos
+💡 Make sure to set {source.get("token_env", "GIT_TOKEN")} environment variable for private repos
 """
 
         return [TextContent(type="text", text=result)]
@@ -2169,7 +2190,7 @@ Next steps:
 
             result = f"""❌ Source '{name}' not found
 
-Available sources: {', '.join(available) if available else 'none'}
+Available sources: {", ".join(available) if available else "none"}
 
 To see all sources:
   list_config_sources()
@@ -2189,11 +2210,7 @@ async def main():
     from mcp.server.stdio import stdio_server
 
     async with stdio_server() as (read_stream, write_stream):
-        await app.run(
-            read_stream,
-            write_stream,
-            app.create_initialization_options()
-        )
+        await app.run(read_stream, write_stream, app.create_initialization_options())
 
 
 if __name__ == "__main__":
diff --git a/src/skill_seekers/mcp/source_manager.py b/src/skill_seekers/mcp/source_manager.py
index 35cf698..df4c793 100644
--- a/src/skill_seekers/mcp/source_manager.py
+++ b/src/skill_seekers/mcp/source_manager.py
@@ -5,16 +5,14 @@ Manages registry of custom config sources (git repositories)
 """
 
 import json
-import os
 from datetime import datetime, timezone
 from pathlib import Path
-from typing import Optional
 
 
 class SourceManager:
     """Manages config source registry at ~/.skill-seekers/sources.json"""
 
-    def __init__(self, config_dir: Optional[str] = None):
+    def __init__(self, config_dir: str | None = None):
         """
         Initialize source manager.
 
@@ -41,10 +39,10 @@ class SourceManager:
         name: str,
         git_url: str,
         source_type: str = "github",
-        token_env: Optional[str] = None,
+        token_env: str | None = None,
         branch: str = "main",
         priority: int = 100,
-        enabled: bool = True
+        enabled: bool = True,
     ) -> dict:
         """
         Add or update a config source.
@@ -66,10 +64,7 @@ class SourceManager:
         """
         # Validate name
         if not name or not name.replace("-", "").replace("_", "").isalnum():
-            raise ValueError(
-                f"Invalid source name '{name}'. "
-                "Must be alphanumeric with optional hyphens/underscores."
-            )
+            raise ValueError(f"Invalid source name '{name}'. Must be alphanumeric with optional hyphens/underscores.")
 
         # Validate git_url
         if not git_url or not git_url.strip():
@@ -89,7 +84,7 @@ class SourceManager:
             "enabled": enabled,
             "priority": priority,
             "added_at": datetime.now(timezone.utc).isoformat(),
-            "updated_at": datetime.now(timezone.utc).isoformat()
+            "updated_at": datetime.now(timezone.utc).isoformat(),
         }
 
         # Load registry
@@ -141,10 +136,7 @@ class SourceManager:
 
         # Not found - provide helpful error
         available = [s["name"] for s in registry["sources"]]
-        raise KeyError(
-            f"Source '{name}' not found. "
-            f"Available sources: {', '.join(available) if available else 'none'}"
-        )
+        raise KeyError(f"Source '{name}' not found. Available sources: {', '.join(available) if available else 'none'}")
 
     def list_sources(self, enabled_only: bool = False) -> list[dict]:
         """
@@ -187,11 +179,7 @@ class SourceManager:
 
         return False
 
-    def update_source(
-        self,
-        name: str,
-        **kwargs
-    ) -> dict:
+    def update_source(self, name: str, **kwargs) -> dict:
         """
         Update specific fields of an existing source.
 
@@ -239,7 +227,7 @@ class SourceManager:
             Registry dictionary
         """
         try:
-            with open(self.registry_file, 'r', encoding='utf-8') as f:
+            with open(self.registry_file, encoding="utf-8") as f:
                 return json.load(f)
         except json.JSONDecodeError as e:
             raise ValueError(f"Corrupted registry file: {e}") from e
@@ -259,7 +247,7 @@ class SourceManager:
         temp_file = self.registry_file.with_suffix(".tmp")
 
         try:
-            with open(temp_file, 'w', encoding='utf-8') as f:
+            with open(temp_file, "w", encoding="utf-8") as f:
                 json.dump(registry, f, indent=2, ensure_ascii=False)
 
             # Atomic rename
@@ -287,7 +275,7 @@ class SourceManager:
             "gitlab": "GITLAB_TOKEN",
             "gitea": "GITEA_TOKEN",
             "bitbucket": "BITBUCKET_TOKEN",
-            "custom": "GIT_TOKEN"
+            "custom": "GIT_TOKEN",
         }
 
         return type_map.get(source_type.lower(), "GIT_TOKEN")
diff --git a/src/skill_seekers/mcp/tools/__init__.py b/src/skill_seekers/mcp/tools/__init__.py
index 87d115d..d723a32 100644
--- a/src/skill_seekers/mcp/tools/__init__.py
+++ b/src/skill_seekers/mcp/tools/__init__.py
@@ -15,41 +15,73 @@ __version__ = "2.5.2"
 
 from .config_tools import (
     generate_config as generate_config_impl,
+)
+from .config_tools import (
     list_configs as list_configs_impl,
+)
+from .config_tools import (
     validate_config as validate_config_impl,
 )
-
-from .scraping_tools import (
-    estimate_pages_tool as estimate_pages_impl,
-    scrape_docs_tool as scrape_docs_impl,
-    scrape_github_tool as scrape_github_impl,
-    scrape_pdf_tool as scrape_pdf_impl,
-    scrape_codebase_tool as scrape_codebase_impl,
-    detect_patterns_tool as detect_patterns_impl,
-    extract_test_examples_tool as extract_test_examples_impl,
-    build_how_to_guides_tool as build_how_to_guides_impl,
-    extract_config_patterns_tool as extract_config_patterns_impl,
-)
-
 from .packaging_tools import (
-    package_skill_tool as package_skill_impl,
-    upload_skill_tool as upload_skill_impl,
     enhance_skill_tool as enhance_skill_impl,
+)
+from .packaging_tools import (
     install_skill_tool as install_skill_impl,
 )
-
-from .splitting_tools import (
-    split_config as split_config_impl,
-    generate_router as generate_router_impl,
+from .packaging_tools import (
+    package_skill_tool as package_skill_impl,
+)
+from .packaging_tools import (
+    upload_skill_tool as upload_skill_impl,
+)
+from .scraping_tools import (
+    build_how_to_guides_tool as build_how_to_guides_impl,
+)
+from .scraping_tools import (
+    detect_patterns_tool as detect_patterns_impl,
+)
+from .scraping_tools import (
+    estimate_pages_tool as estimate_pages_impl,
+)
+from .scraping_tools import (
+    extract_config_patterns_tool as extract_config_patterns_impl,
+)
+from .scraping_tools import (
+    extract_test_examples_tool as extract_test_examples_impl,
+)
+from .scraping_tools import (
+    scrape_codebase_tool as scrape_codebase_impl,
+)
+from .scraping_tools import (
+    scrape_docs_tool as scrape_docs_impl,
+)
+from .scraping_tools import (
+    scrape_github_tool as scrape_github_impl,
+)
+from .scraping_tools import (
+    scrape_pdf_tool as scrape_pdf_impl,
+)
+from .source_tools import (
+    add_config_source_tool as add_config_source_impl,
 )
-
 from .source_tools import (
     fetch_config_tool as fetch_config_impl,
-    submit_config_tool as submit_config_impl,
-    add_config_source_tool as add_config_source_impl,
+)
+from .source_tools import (
     list_config_sources_tool as list_config_sources_impl,
+)
+from .source_tools import (
     remove_config_source_tool as remove_config_source_impl,
 )
+from .source_tools import (
+    submit_config_tool as submit_config_impl,
+)
+from .splitting_tools import (
+    generate_router as generate_router_impl,
+)
+from .splitting_tools import (
+    split_config as split_config_impl,
+)
 
 __all__ = [
     # Config tools
diff --git a/src/skill_seekers/mcp/tools/config_tools.py b/src/skill_seekers/mcp/tools/config_tools.py
index 3482d32..daa2179 100644
--- a/src/skill_seekers/mcp/tools/config_tools.py
+++ b/src/skill_seekers/mcp/tools/config_tools.py
@@ -8,7 +8,6 @@ for documentation scraping.
 import json
 import sys
 from pathlib import Path
-from typing import Any, List
 
 try:
     from mcp.types import TextContent
@@ -16,10 +15,12 @@ except ImportError:
     # Graceful degradation: Create a simple fallback class for testing
     class TextContent:
         """Fallback TextContent for when MCP is not installed"""
+
         def __init__(self, type: str, text: str):
             self.type = type
             self.text = text
 
+
 # Path to CLI tools
 CLI_DIR = Path(__file__).parent.parent.parent / "cli"
 
@@ -31,7 +32,7 @@ except ImportError:
     ConfigValidator = None  # Graceful degradation if not available
 
 
-async def generate_config(args: dict) -> List[TextContent]:
+async def generate_config(args: dict) -> list[TextContent]:
     """
     Generate a config file for documentation scraping.
 
@@ -58,10 +59,7 @@ async def generate_config(args: dict) -> List[TextContent]:
     rate_limit = args.get("rate_limit", 0.5)
 
     # Handle unlimited mode
-    if unlimited:
-        max_pages = None
-        limit_msg = "unlimited (no page limit)"
-    elif max_pages == -1:
+    if unlimited or max_pages == -1:
         max_pages = None
         limit_msg = "unlimited (no page limit)"
     else:
@@ -72,25 +70,18 @@ async def generate_config(args: dict) -> List[TextContent]:
         "name": name,
         "description": description,
         "base_url": url,
-        "selectors": {
-            "main_content": "article",
-            "title": "h1",
-            "code_blocks": "pre code"
-        },
-        "url_patterns": {
-            "include": [],
-            "exclude": []
-        },
+        "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+        "url_patterns": {"include": [], "exclude": []},
         "categories": {},
         "rate_limit": rate_limit,
-        "max_pages": max_pages
+        "max_pages": max_pages,
     }
 
     # Save to configs directory
     config_path = Path("configs") / f"{name}.json"
     config_path.parent.mkdir(exist_ok=True)
 
-    with open(config_path, 'w') as f:
+    with open(config_path, "w") as f:
         json.dump(config, f, indent=2)
 
     result = f"""✅ Config created: {config_path}
@@ -112,7 +103,7 @@ Note: Default selectors may need adjustment for your documentation site.
     return [TextContent(type="text", text=result)]
 
 
-async def list_configs(args: dict) -> List[TextContent]:
+async def list_configs(args: dict) -> list[TextContent]:
     """
     List all available preset configurations.
 
@@ -155,7 +146,7 @@ async def list_configs(args: dict) -> List[TextContent]:
     return [TextContent(type="text", text=result)]
 
 
-async def validate_config(args: dict) -> List[TextContent]:
+async def validate_config(args: dict) -> list[TextContent]:
     """
     Validate a config file for errors.
 
@@ -183,36 +174,37 @@ async def validate_config(args: dict) -> List[TextContent]:
         # Try unified config validator first
         try:
             from config_validator import validate_config
+
             validator = validate_config(config_path)
 
-            result = f"✅ Config is valid!\n\n"
+            result = "✅ Config is valid!\n\n"
 
             # Show format
             if validator.is_unified:
-                result += f"📦 Format: Unified (multi-source)\n"
+                result += "📦 Format: Unified (multi-source)\n"
                 result += f"  Name: {validator.config['name']}\n"
                 result += f"  Sources: {len(validator.config.get('sources', []))}\n"
 
                 # Show sources
-                for i, source in enumerate(validator.config.get('sources', []), 1):
+                for i, source in enumerate(validator.config.get("sources", []), 1):
                     result += f"\n  Source {i}: {source['type']}\n"
-                    if source['type'] == 'documentation':
+                    if source["type"] == "documentation":
                         result += f"    URL: {source.get('base_url', 'N/A')}\n"
                         result += f"    Max pages: {source.get('max_pages', 'Not set')}\n"
-                    elif source['type'] == 'github':
+                    elif source["type"] == "github":
                         result += f"    Repo: {source.get('repo', 'N/A')}\n"
                         result += f"    Code depth: {source.get('code_analysis_depth', 'surface')}\n"
-                    elif source['type'] == 'pdf':
+                    elif source["type"] == "pdf":
                         result += f"    Path: {source.get('path', 'N/A')}\n"
 
                 # Show merge settings if applicable
                 if validator.needs_api_merge():
-                    merge_mode = validator.config.get('merge_mode', 'rule-based')
+                    merge_mode = validator.config.get("merge_mode", "rule-based")
                     result += f"\n  Merge mode: {merge_mode}\n"
-                    result += f"  API merging: Required (docs + code sources)\n"
+                    result += "  API merging: Required (docs + code sources)\n"
 
             else:
-                result += f"📦 Format: Legacy (single source)\n"
+                result += "📦 Format: Legacy (single source)\n"
                 result += f"  Name: {validator.config['name']}\n"
                 result += f"  Base URL: {validator.config.get('base_url', 'N/A')}\n"
                 result += f"  Max pages: {validator.config.get('max_pages', 'Not set')}\n"
@@ -222,29 +214,30 @@ async def validate_config(args: dict) -> List[TextContent]:
 
         except ImportError:
             # Fall back to legacy validation
-            from doc_scraper import validate_config
             import json
 
-            with open(config_path, 'r') as f:
+            from doc_scraper import validate_config
+
+            with open(config_path) as f:
                 config = json.load(f)
 
             # Validate config - returns (errors, warnings) tuple
             errors, warnings = validate_config(config)
 
             if errors:
-                result = f"❌ Config validation failed:\n\n"
+                result = "❌ Config validation failed:\n\n"
                 for error in errors:
                     result += f"  • {error}\n"
             else:
-                result = f"✅ Config is valid!\n\n"
-                result += f"📦 Format: Legacy (single source)\n"
+                result = "✅ Config is valid!\n\n"
+                result += "📦 Format: Legacy (single source)\n"
                 result += f"  Name: {config['name']}\n"
                 result += f"  Base URL: {config['base_url']}\n"
                 result += f"  Max pages: {config.get('max_pages', 'Not set')}\n"
                 result += f"  Rate limit: {config.get('rate_limit', 'Not set')}s\n"
 
                 if warnings:
-                    result += f"\n⚠️  Warnings:\n"
+                    result += "\n⚠️  Warnings:\n"
                     for warning in warnings:
                         result += f"  • {warning}\n"
 
diff --git a/src/skill_seekers/mcp/tools/packaging_tools.py b/src/skill_seekers/mcp/tools/packaging_tools.py
index e95f811..7d93e1c 100644
--- a/src/skill_seekers/mcp/tools/packaging_tools.py
+++ b/src/skill_seekers/mcp/tools/packaging_tools.py
@@ -5,7 +5,6 @@ This module contains tools for packaging, uploading, and installing skills.
 Extracted from server.py for better modularity.
 """
 
-import asyncio
 import json
 import os
 import re
@@ -13,7 +12,6 @@ import subprocess
 import sys
 import time
 from pathlib import Path
-from typing import Any, List, Tuple
 
 try:
     from mcp.types import TextContent
@@ -21,6 +19,7 @@ except ImportError:
     # Graceful degradation: Create a simple fallback class for testing
     class TextContent:
         """Fallback TextContent for when MCP is not installed"""
+
         def __init__(self, type: str, text: str):
             self.type = type
             self.text = text
@@ -30,7 +29,7 @@ except ImportError:
 CLI_DIR = Path(__file__).parent.parent.parent / "cli"
 
 
-def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> Tuple[str, str, int]:
+def run_subprocess_with_streaming(cmd: list[str], timeout: int = None) -> tuple[str, str, int]:
     """
     Run subprocess with real-time output streaming.
 
@@ -51,7 +50,7 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> Tuple[
             stderr=subprocess.PIPE,
             text=True,
             bufsize=1,  # Line buffered
-            universal_newlines=True
+            universal_newlines=True,
         )
 
         stdout_lines = []
@@ -73,6 +72,7 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> Tuple[
             # Read available output (non-blocking)
             try:
                 import select
+
                 readable, _, _ = select.select([process.stdout, process.stderr], [], [], 0.1)
 
                 if process.stdout in readable:
@@ -95,8 +95,8 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> Tuple[
         if remaining_stderr:
             stderr_lines.append(remaining_stderr)
 
-        stdout = ''.join(stdout_lines)
-        stderr = ''.join(stderr_lines)
+        stdout = "".join(stdout_lines)
+        stderr = "".join(stderr_lines)
         returncode = process.returncode
 
         return stdout, stderr, returncode
@@ -105,7 +105,7 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> Tuple[
         return "", f"Error running subprocess: {str(e)}", 1
 
 
-async def package_skill_tool(args: dict) -> List[TextContent]:
+async def package_skill_tool(args: dict) -> list[TextContent]:
     """
     Package skill for target LLM platform and optionally auto-upload.
 
@@ -129,14 +129,16 @@ async def package_skill_tool(args: dict) -> List[TextContent]:
     try:
         adaptor = get_adaptor(target)
     except ValueError as e:
-        return [TextContent(
-            type="text",
-            text=f"❌ Invalid platform: {str(e)}\n\nSupported platforms: claude, gemini, openai, markdown"
-        )]
+        return [
+            TextContent(
+                type="text",
+                text=f"❌ Invalid platform: {str(e)}\n\nSupported platforms: claude, gemini, openai, markdown",
+            )
+        ]
 
     # Check if platform-specific API key exists - only upload if available
     env_var_name = adaptor.get_env_var_name()
-    has_api_key = os.environ.get(env_var_name, '').strip() if env_var_name else False
+    has_api_key = os.environ.get(env_var_name, "").strip() if env_var_name else False
     should_upload = auto_upload and has_api_key
 
     # Run package_skill.py with target parameter
@@ -146,7 +148,8 @@ async def package_skill_tool(args: dict) -> List[TextContent]:
         skill_dir,
         "--no-open",  # Don't open folder in MCP context
         "--skip-quality-check",  # Skip interactive quality checks in MCP context
-        "--target", target  # Add target platform
+        "--target",
+        target,  # Add target platform
     ]
 
     # Add upload flag only if we have API key
@@ -169,13 +172,13 @@ async def package_skill_tool(args: dict) -> List[TextContent]:
         if should_upload:
             # Upload succeeded
             output += f"\n\n✅ Skill packaged and uploaded to {adaptor.PLATFORM_NAME}!"
-            if target == 'claude':
+            if target == "claude":
                 output += "\n   Your skill is now available in Claude!"
                 output += "\n   Go to https://claude.ai/skills to use it"
-            elif target == 'gemini':
+            elif target == "gemini":
                 output += "\n   Your skill is now available in Gemini!"
                 output += "\n   Go to https://aistudio.google.com/ to use it"
-            elif target == 'openai':
+            elif target == "openai":
                 output += "\n   Your assistant is now available in OpenAI!"
                 output += "\n   Go to https://platform.openai.com/assistants/ to use it"
         elif auto_upload and not has_api_key:
@@ -183,38 +186,38 @@ async def package_skill_tool(args: dict) -> List[TextContent]:
             output += f"\n\n📝 Skill packaged successfully for {adaptor.PLATFORM_NAME}!"
             output += "\n"
             output += "\n💡 To enable automatic upload:"
-            if target == 'claude':
+            if target == "claude":
                 output += "\n   1. Get API key from https://console.anthropic.com/"
                 output += "\n   2. Set: export ANTHROPIC_API_KEY=sk-ant-..."
                 output += "\n\n📤 Manual upload:"
                 output += "\n   1. Find the .zip file in your output/ folder"
                 output += "\n   2. Go to https://claude.ai/skills"
                 output += "\n   3. Click 'Upload Skill' and select the .zip file"
-            elif target == 'gemini':
+            elif target == "gemini":
                 output += "\n   1. Get API key from https://aistudio.google.com/"
                 output += "\n   2. Set: export GOOGLE_API_KEY=AIza..."
                 output += "\n\n📤 Manual upload:"
                 output += "\n   1. Go to https://aistudio.google.com/"
                 output += "\n   2. Upload the .tar.gz file from your output/ folder"
-            elif target == 'openai':
+            elif target == "openai":
                 output += "\n   1. Get API key from https://platform.openai.com/"
                 output += "\n   2. Set: export OPENAI_API_KEY=sk-proj-..."
                 output += "\n\n📤 Manual upload:"
                 output += "\n   1. Use OpenAI Assistants API"
                 output += "\n   2. Upload the .zip file from your output/ folder"
-            elif target == 'markdown':
+            elif target == "markdown":
                 output += "\n   (No API key needed - markdown is export only)"
                 output += "\n   Package created for manual distribution"
         else:
             # auto_upload=False, just packaged
             output += f"\n\n✅ Skill packaged successfully for {adaptor.PLATFORM_NAME}!"
-            if target == 'claude':
+            if target == "claude":
                 output += "\n   Upload manually to https://claude.ai/skills"
-            elif target == 'gemini':
+            elif target == "gemini":
                 output += "\n   Upload manually to https://aistudio.google.com/"
-            elif target == 'openai':
+            elif target == "openai":
                 output += "\n   Upload manually via OpenAI Assistants API"
-            elif target == 'markdown':
+            elif target == "markdown":
                 output += "\n   Package ready for manual distribution"
 
         return [TextContent(type="text", text=output)]
@@ -222,7 +225,7 @@ async def package_skill_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output}\n\n❌ Error:\n{stderr}")]
 
 
-async def upload_skill_tool(args: dict) -> List[TextContent]:
+async def upload_skill_tool(args: dict) -> list[TextContent]:
     """
     Upload skill package to target LLM platform.
 
@@ -247,25 +250,20 @@ async def upload_skill_tool(args: dict) -> List[TextContent]:
     try:
         adaptor = get_adaptor(target)
     except ValueError as e:
-        return [TextContent(
-            type="text",
-            text=f"❌ Invalid platform: {str(e)}\n\nSupported platforms: claude, gemini, openai"
-        )]
+        return [
+            TextContent(
+                type="text", text=f"❌ Invalid platform: {str(e)}\n\nSupported platforms: claude, gemini, openai"
+            )
+        ]
 
     # Check if upload is supported
-    if target == 'markdown':
-        return [TextContent(
-            type="text",
-            text="❌ Markdown export does not support upload. Use the packaged file manually."
-        )]
+    if target == "markdown":
+        return [
+            TextContent(type="text", text="❌ Markdown export does not support upload. Use the packaged file manually.")
+        ]
 
     # Run upload_skill.py with target parameter
-    cmd = [
-        sys.executable,
-        str(CLI_DIR / "upload_skill.py"),
-        skill_zip,
-        "--target", target
-    ]
+    cmd = [sys.executable, str(CLI_DIR / "upload_skill.py"), skill_zip, "--target", target]
 
     # Add API key if provided
     if api_key:
@@ -287,7 +285,7 @@ async def upload_skill_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output}\n\n❌ Error:\n{stderr}")]
 
 
-async def enhance_skill_tool(args: dict) -> List[TextContent]:
+async def enhance_skill_tool(args: dict) -> list[TextContent]:
     """
     Enhance SKILL.md with AI using target platform's model.
 
@@ -314,32 +312,24 @@ async def enhance_skill_tool(args: dict) -> List[TextContent]:
 
     # Validate skill directory
     if not skill_dir.exists():
-        return [TextContent(
-            type="text",
-            text=f"❌ Skill directory not found: {skill_dir}"
-        )]
+        return [TextContent(type="text", text=f"❌ Skill directory not found: {skill_dir}")]
 
     if not (skill_dir / "SKILL.md").exists():
-        return [TextContent(
-            type="text",
-            text=f"❌ SKILL.md not found in {skill_dir}"
-        )]
+        return [TextContent(type="text", text=f"❌ SKILL.md not found in {skill_dir}")]
 
     # Get platform adaptor
     try:
         adaptor = get_adaptor(target)
     except ValueError as e:
-        return [TextContent(
-            type="text",
-            text=f"❌ Invalid platform: {str(e)}\n\nSupported platforms: claude, gemini, openai"
-        )]
+        return [
+            TextContent(
+                type="text", text=f"❌ Invalid platform: {str(e)}\n\nSupported platforms: claude, gemini, openai"
+            )
+        ]
 
     # Check if enhancement is supported
     if not adaptor.supports_enhancement():
-        return [TextContent(
-            type="text",
-            text=f"❌ {adaptor.PLATFORM_NAME} does not support AI enhancement"
-        )]
+        return [TextContent(type="text", text=f"❌ {adaptor.PLATFORM_NAME} does not support AI enhancement")]
 
     output_lines = []
     output_lines.append(f"🚀 Enhancing skill with {adaptor.PLATFORM_NAME}")
@@ -348,17 +338,13 @@ async def enhance_skill_tool(args: dict) -> List[TextContent]:
     output_lines.append(f"Mode: {mode}")
     output_lines.append("")
 
-    if mode == 'local':
+    if mode == "local":
         # Use local enhancement (Claude Code)
         output_lines.append("Using Claude Code Max (local, no API key required)")
         output_lines.append("Running enhancement in headless mode...")
         output_lines.append("")
 
-        cmd = [
-            sys.executable,
-            str(CLI_DIR / "enhance_skill_local.py"),
-            str(skill_dir)
-        ]
+        cmd = [sys.executable, str(CLI_DIR / "enhance_skill_local.py"), str(skill_dir)]
 
         try:
             stdout, stderr, returncode = run_subprocess_with_streaming(cmd, timeout=900)
@@ -376,7 +362,7 @@ async def enhance_skill_tool(args: dict) -> List[TextContent]:
         except Exception as e:
             output_lines.append(f"❌ Error: {str(e)}")
 
-    elif mode == 'api':
+    elif mode == "api":
         # Use API enhancement
         output_lines.append(f"Using {adaptor.PLATFORM_NAME} API")
 
@@ -386,17 +372,13 @@ async def enhance_skill_tool(args: dict) -> List[TextContent]:
             api_key = os.environ.get(env_var)
 
             if not api_key:
-                return [TextContent(
-                    type="text",
-                    text=f"❌ {env_var} not set. Set API key or pass via api_key parameter."
-                )]
+                return [
+                    TextContent(type="text", text=f"❌ {env_var} not set. Set API key or pass via api_key parameter.")
+                ]
 
         # Validate API key
         if not adaptor.validate_api_key(api_key):
-            return [TextContent(
-                type="text",
-                text=f"❌ Invalid API key format for {adaptor.PLATFORM_NAME}"
-            )]
+            return [TextContent(type="text", text=f"❌ Invalid API key format for {adaptor.PLATFORM_NAME}")]
 
         output_lines.append("Calling API for enhancement...")
         output_lines.append("")
@@ -415,15 +397,12 @@ async def enhance_skill_tool(args: dict) -> List[TextContent]:
             output_lines.append(f"❌ Error: {str(e)}")
 
     else:
-        return [TextContent(
-            type="text",
-            text=f"❌ Invalid mode: {mode}. Use 'local' or 'api'"
-        )]
+        return [TextContent(type="text", text=f"❌ Invalid mode: {mode}. Use 'local' or 'api'")]
 
     return [TextContent(type="text", text="\n".join(output_lines))]
 
 
-async def install_skill_tool(args: dict) -> List[TextContent]:
+async def install_skill_tool(args: dict) -> list[TextContent]:
     """
     Complete skill installation workflow.
 
@@ -448,9 +427,10 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
         List of TextContent with workflow progress and results
     """
     # Import these here to avoid circular imports
+    from skill_seekers.cli.adaptors import get_adaptor
+
     from .scraping_tools import scrape_docs_tool
     from .source_tools import fetch_config_tool
-    from skill_seekers.cli.adaptors import get_adaptor
 
     # Extract and validate inputs
     config_name = args.get("config_name")
@@ -465,23 +445,28 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
     try:
         adaptor = get_adaptor(target)
     except ValueError as e:
-        return [TextContent(
-            type="text",
-            text=f"❌ Error: {str(e)}\n\nSupported platforms: claude, gemini, openai, markdown"
-        )]
+        return [
+            TextContent(
+                type="text", text=f"❌ Error: {str(e)}\n\nSupported platforms: claude, gemini, openai, markdown"
+            )
+        ]
 
     # Validation: Must provide exactly one of config_name or config_path
     if not config_name and not config_path:
-        return [TextContent(
-            type="text",
-            text="❌ Error: Must provide either config_name or config_path\n\nExamples:\n  install_skill(config_name='react')\n  install_skill(config_path='configs/custom.json')"
-        )]
+        return [
+            TextContent(
+                type="text",
+                text="❌ Error: Must provide either config_name or config_path\n\nExamples:\n  install_skill(config_name='react')\n  install_skill(config_path='configs/custom.json')",
+            )
+        ]
 
     if config_name and config_path:
-        return [TextContent(
-            type="text",
-            text="❌ Error: Cannot provide both config_name and config_path\n\nChoose one:\n  - config_name: Fetch from API (e.g., 'react')\n  - config_path: Use existing file (e.g., 'configs/custom.json')"
-        )]
+        return [
+            TextContent(
+                type="text",
+                text="❌ Error: Cannot provide both config_name and config_path\n\nChoose one:\n  - config_name: Fetch from API (e.g., 'react')\n  - config_path: Use existing file (e.g., 'configs/custom.json')",
+            )
+        ]
 
     # Initialize output
     output_lines = []
@@ -495,11 +480,11 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
 
     # Track workflow state
     workflow_state = {
-        'config_path': config_path,
-        'skill_name': None,
-        'skill_dir': None,
-        'zip_path': None,
-        'phases_completed': []
+        "config_path": config_path,
+        "skill_name": None,
+        "skill_dir": None,
+        "zip_path": None,
+        "phases_completed": [],
     }
 
     try:
@@ -513,10 +498,7 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
 
             if not dry_run:
                 # Call fetch_config_tool directly
-                fetch_result = await fetch_config_tool({
-                    "config_name": config_name,
-                    "destination": destination
-                })
+                fetch_result = await fetch_config_tool({"config_name": config_name, "destination": destination})
 
                 # Parse result to extract config path
                 fetch_output = fetch_result[0].text
@@ -527,15 +509,15 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
                 # Expected format: "✅ Config saved to: configs/react.json"
                 match = re.search(r"saved to:\s*(.+\.json)", fetch_output)
                 if match:
-                    workflow_state['config_path'] = match.group(1).strip()
+                    workflow_state["config_path"] = match.group(1).strip()
                     output_lines.append(f"✅ Config fetched: {workflow_state['config_path']}")
                 else:
                     return [TextContent(type="text", text="\n".join(output_lines) + "\n\n❌ Failed to fetch config")]
 
-                workflow_state['phases_completed'].append('fetch_config')
+                workflow_state["phases_completed"].append("fetch_config")
             else:
                 output_lines.append("  [DRY RUN] Would fetch config from API")
-                workflow_state['config_path'] = f"{destination}/{config_name}.json"
+                workflow_state["config_path"] = f"{destination}/{config_name}.json"
 
             output_lines.append("")
 
@@ -550,23 +532,27 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
         if not dry_run:
             # Load config to get skill name
             try:
-                with open(workflow_state['config_path'], 'r') as f:
+                with open(workflow_state["config_path"]) as f:
                     config = json.load(f)
-                    workflow_state['skill_name'] = config.get('name', 'unknown')
+                    workflow_state["skill_name"] = config.get("name", "unknown")
             except Exception as e:
-                return [TextContent(type="text", text="\n".join(output_lines) + f"\n\n❌ Failed to read config: {str(e)}")]
+                return [
+                    TextContent(type="text", text="\n".join(output_lines) + f"\n\n❌ Failed to read config: {str(e)}")
+                ]
 
             # Call scrape_docs_tool (does NOT include enhancement)
             output_lines.append("Scraping documentation (this may take 20-45 minutes)...")
             output_lines.append("")
 
-            scrape_result = await scrape_docs_tool({
-                "config_path": workflow_state['config_path'],
-                "unlimited": unlimited,
-                "enhance_local": False,  # Enhancement is separate phase
-                "skip_scrape": False,
-                "dry_run": False
-            })
+            scrape_result = await scrape_docs_tool(
+                {
+                    "config_path": workflow_state["config_path"],
+                    "unlimited": unlimited,
+                    "enhance_local": False,  # Enhancement is separate phase
+                    "skip_scrape": False,
+                    "dry_run": False,
+                }
+            )
 
             scrape_output = scrape_result[0].text
             output_lines.append(scrape_output)
@@ -574,14 +560,16 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
 
             # Check for success
             if "❌" in scrape_output:
-                return [TextContent(type="text", text="\n".join(output_lines) + "\n\n❌ Scraping failed - see error above")]
+                return [
+                    TextContent(type="text", text="\n".join(output_lines) + "\n\n❌ Scraping failed - see error above")
+                ]
 
-            workflow_state['skill_dir'] = f"{destination}/{workflow_state['skill_name']}"
-            workflow_state['phases_completed'].append('scrape_docs')
+            workflow_state["skill_dir"] = f"{destination}/{workflow_state['skill_name']}"
+            workflow_state["phases_completed"].append("scrape_docs")
         else:
             output_lines.append("  [DRY RUN] Would scrape documentation")
-            workflow_state['skill_name'] = "example"
-            workflow_state['skill_dir'] = f"{destination}/example"
+            workflow_state["skill_name"] = "example"
+            workflow_state["skill_dir"] = f"{destination}/example"
 
         output_lines.append("")
 
@@ -601,7 +589,7 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
             cmd = [
                 sys.executable,
                 str(CLI_DIR / "enhance_skill_local.py"),
-                workflow_state['skill_dir']
+                workflow_state["skill_dir"],
                 # Headless is default, no flag needed
             ]
 
@@ -617,7 +605,7 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
                 return [TextContent(type="text", text="\n".join(output_lines))]
 
             output_lines.append(stdout)
-            workflow_state['phases_completed'].append('enhance_skill')
+            workflow_state["phases_completed"].append("enhance_skill")
         else:
             output_lines.append("  [DRY RUN] Would enhance SKILL.md with Claude Code")
 
@@ -633,11 +621,13 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
 
         if not dry_run:
             # Call package_skill_tool with target
-            package_result = await package_skill_tool({
-                "skill_dir": workflow_state['skill_dir'],
-                "auto_upload": False,  # We handle upload in next phase
-                "target": target
-            })
+            package_result = await package_skill_tool(
+                {
+                    "skill_dir": workflow_state["skill_dir"],
+                    "auto_upload": False,  # We handle upload in next phase
+                    "target": target,
+                }
+            )
 
             package_output = package_result[0].text
             output_lines.append(package_output)
@@ -647,23 +637,23 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
             # Expected format: "Saved to: output/react.zip" or "Saved to: output/react-gemini.tar.gz"
             match = re.search(r"Saved to:\s*(.+\.(?:zip|tar\.gz))", package_output)
             if match:
-                workflow_state['zip_path'] = match.group(1).strip()
+                workflow_state["zip_path"] = match.group(1).strip()
             else:
                 # Fallback: construct package path based on platform
-                if target == 'gemini':
-                    workflow_state['zip_path'] = f"{destination}/{workflow_state['skill_name']}-gemini.tar.gz"
-                elif target == 'openai':
-                    workflow_state['zip_path'] = f"{destination}/{workflow_state['skill_name']}-openai.zip"
+                if target == "gemini":
+                    workflow_state["zip_path"] = f"{destination}/{workflow_state['skill_name']}-gemini.tar.gz"
+                elif target == "openai":
+                    workflow_state["zip_path"] = f"{destination}/{workflow_state['skill_name']}-openai.zip"
                 else:
-                    workflow_state['zip_path'] = f"{destination}/{workflow_state['skill_name']}.zip"
+                    workflow_state["zip_path"] = f"{destination}/{workflow_state['skill_name']}.zip"
 
-            workflow_state['phases_completed'].append('package_skill')
+            workflow_state["phases_completed"].append("package_skill")
         else:
             # Dry run - show expected package format
-            if target == 'gemini':
+            if target == "gemini":
                 pkg_ext = "tar.gz"
                 pkg_file = f"{destination}/{workflow_state['skill_name']}-gemini.tar.gz"
-            elif target == 'openai':
+            elif target == "openai":
                 pkg_ext = "zip"
                 pkg_file = f"{destination}/{workflow_state['skill_name']}-openai.zip"
             else:
@@ -671,7 +661,7 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
                 pkg_file = f"{destination}/{workflow_state['skill_name']}.zip"
 
             output_lines.append(f"  [DRY RUN] Would package to {pkg_ext} file for {adaptor.PLATFORM_NAME}")
-            workflow_state['zip_path'] = pkg_file
+            workflow_state["zip_path"] = pkg_file
 
         output_lines.append("")
 
@@ -685,32 +675,31 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
 
             # Check for platform-specific API key
             env_var_name = adaptor.get_env_var_name()
-            has_api_key = os.environ.get(env_var_name, '').strip()
+            has_api_key = os.environ.get(env_var_name, "").strip()
 
             if not dry_run:
                 if has_api_key:
                     # Upload not supported for markdown platform
-                    if target == 'markdown':
+                    if target == "markdown":
                         output_lines.append("⚠️  Markdown export does not support upload")
                         output_lines.append("    Package has been created - use manually")
                     else:
                         # Call upload_skill_tool with target
-                        upload_result = await upload_skill_tool({
-                            "skill_zip": workflow_state['zip_path'],
-                            "target": target
-                        })
+                        upload_result = await upload_skill_tool(
+                            {"skill_zip": workflow_state["zip_path"], "target": target}
+                        )
 
                         upload_output = upload_result[0].text
                         output_lines.append(upload_output)
 
-                        workflow_state['phases_completed'].append('upload_skill')
+                        workflow_state["phases_completed"].append("upload_skill")
                 else:
                     # Platform-specific instructions for missing API key
                     output_lines.append(f"⚠️  {env_var_name} not set - skipping upload")
                     output_lines.append("")
                     output_lines.append("To enable automatic upload:")
 
-                    if target == 'claude':
+                    if target == "claude":
                         output_lines.append("  1. Get API key from https://console.anthropic.com/")
                         output_lines.append("  2. Set: export ANTHROPIC_API_KEY=sk-ant-...")
                         output_lines.append("")
@@ -718,21 +707,21 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
                         output_lines.append("  1. Go to https://claude.ai/skills")
                         output_lines.append("  2. Click 'Upload Skill'")
                         output_lines.append(f"  3. Select: {workflow_state['zip_path']}")
-                    elif target == 'gemini':
+                    elif target == "gemini":
                         output_lines.append("  1. Get API key from https://aistudio.google.com/")
                         output_lines.append("  2. Set: export GOOGLE_API_KEY=AIza...")
                         output_lines.append("")
                         output_lines.append("📤 Manual upload:")
                         output_lines.append("  1. Go to https://aistudio.google.com/")
                         output_lines.append(f"  2. Upload package: {workflow_state['zip_path']}")
-                    elif target == 'openai':
+                    elif target == "openai":
                         output_lines.append("  1. Get API key from https://platform.openai.com/")
                         output_lines.append("  2. Set: export OPENAI_API_KEY=sk-proj-...")
                         output_lines.append("")
                         output_lines.append("📤 Manual upload:")
                         output_lines.append("  1. Use OpenAI Assistants API")
                         output_lines.append(f"  2. Upload package: {workflow_state['zip_path']}")
-                    elif target == 'markdown':
+                    elif target == "markdown":
                         output_lines.append("  (No API key needed - markdown is export only)")
                         output_lines.append(f"  Package created: {workflow_state['zip_path']}")
             else:
@@ -748,25 +737,25 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
 
         if not dry_run:
             output_lines.append("Phases completed:")
-            for phase in workflow_state['phases_completed']:
+            for phase in workflow_state["phases_completed"]:
                 output_lines.append(f"  ✓ {phase}")
             output_lines.append("")
 
             output_lines.append("📁 Output:")
             output_lines.append(f"  Skill directory: {workflow_state['skill_dir']}")
-            if workflow_state['zip_path']:
+            if workflow_state["zip_path"]:
                 output_lines.append(f"  Skill package: {workflow_state['zip_path']}")
             output_lines.append("")
 
-            if auto_upload and has_api_key and target != 'markdown':
+            if auto_upload and has_api_key and target != "markdown":
                 # Platform-specific success message
-                if target == 'claude':
+                if target == "claude":
                     output_lines.append("🎉 Your skill is now available in Claude!")
                     output_lines.append("   Go to https://claude.ai/skills to use it")
-                elif target == 'gemini':
+                elif target == "gemini":
                     output_lines.append("🎉 Your skill is now available in Gemini!")
                     output_lines.append("   Go to https://aistudio.google.com/ to use it")
-                elif target == 'openai':
+                elif target == "openai":
                     output_lines.append("🎉 Your assistant is now available in OpenAI!")
                     output_lines.append("   Go to https://platform.openai.com/assistants/ to use it")
             elif auto_upload:
@@ -790,6 +779,6 @@ async def install_skill_tool(args: dict) -> List[TextContent]:
         output_lines.append(f"❌ Workflow failed: {str(e)}")
         output_lines.append("")
         output_lines.append("Phases completed before failure:")
-        for phase in workflow_state['phases_completed']:
+        for phase in workflow_state["phases_completed"]:
             output_lines.append(f"  ✓ {phase}")
         return [TextContent(type="text", text="\n".join(output_lines))]
diff --git a/src/skill_seekers/mcp/tools/scraping_tools.py b/src/skill_seekers/mcp/tools/scraping_tools.py
index 192c51a..8d6409c 100644
--- a/src/skill_seekers/mcp/tools/scraping_tools.py
+++ b/src/skill_seekers/mcp/tools/scraping_tools.py
@@ -14,7 +14,6 @@ Extracted from server.py for better modularity and organization.
 import json
 import sys
 from pathlib import Path
-from typing import Any, List
 
 # MCP types - with graceful fallback for testing
 try:
@@ -23,15 +22,17 @@ except ImportError:
     # Graceful degradation: Create a simple fallback class for testing
     class TextContent:
         """Fallback TextContent for when MCP is not installed"""
+
         def __init__(self, type: str, text: str):
             self.type = type
             self.text = text
 
+
 # Path to CLI tools
 CLI_DIR = Path(__file__).parent.parent.parent / "cli"
 
 
-def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> tuple:
+def run_subprocess_with_streaming(cmd: list[str], timeout: int = None) -> tuple:
     """
     Run subprocess with real-time output streaming.
 
@@ -55,7 +56,7 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> tuple:
             stderr=subprocess.PIPE,
             text=True,
             bufsize=1,  # Line buffered
-            universal_newlines=True
+            universal_newlines=True,
         )
 
         stdout_lines = []
@@ -77,6 +78,7 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> tuple:
             # Read available output (non-blocking)
             try:
                 import select
+
                 readable, _, _ = select.select([process.stdout, process.stderr], [], [], 0.1)
 
                 if process.stdout in readable:
@@ -99,8 +101,8 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> tuple:
         if remaining_stderr:
             stderr_lines.append(remaining_stderr)
 
-        stdout = ''.join(stdout_lines)
-        stderr = ''.join(stderr_lines)
+        stdout = "".join(stdout_lines)
+        stderr = "".join(stderr_lines)
         returncode = process.returncode
 
         return stdout, stderr, returncode
@@ -109,7 +111,7 @@ def run_subprocess_with_streaming(cmd: List[str], timeout: int = None) -> tuple:
         return "", f"Error running subprocess: {str(e)}", 1
 
 
-async def estimate_pages_tool(args: dict) -> List[TextContent]:
+async def estimate_pages_tool(args: dict) -> list[TextContent]:
     """
     Estimate page count from a config file.
 
@@ -138,14 +140,9 @@ async def estimate_pages_tool(args: dict) -> List[TextContent]:
         timeout = max(300, max_discovery // 2)  # Minimum 5 minutes
 
     # Run estimate_pages.py
-    cmd = [
-        sys.executable,
-        str(CLI_DIR / "estimate_pages.py"),
-        config_path,
-        "--max-discovery", str(max_discovery)
-    ]
+    cmd = [sys.executable, str(CLI_DIR / "estimate_pages.py"), config_path, "--max-discovery", str(max_discovery)]
 
-    progress_msg = f"🔄 Estimating page count...\n"
+    progress_msg = "🔄 Estimating page count...\n"
     progress_msg += f"⏱️ Maximum time: {timeout // 60} minutes\n\n"
 
     stdout, stderr, returncode = run_subprocess_with_streaming(cmd, timeout=timeout)
@@ -158,7 +155,7 @@ async def estimate_pages_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output}\n\n❌ Error:\n{stderr}")]
 
 
-async def scrape_docs_tool(args: dict) -> List[TextContent]:
+async def scrape_docs_tool(args: dict) -> list[TextContent]:
     """
     Scrape documentation and build skill.
 
@@ -186,27 +183,27 @@ async def scrape_docs_tool(args: dict) -> List[TextContent]:
     merge_mode = args.get("merge_mode")
 
     # Load config to detect format
-    with open(config_path, 'r') as f:
+    with open(config_path) as f:
         config = json.load(f)
 
     # Detect if unified format (has 'sources' array)
-    is_unified = 'sources' in config and isinstance(config['sources'], list)
+    is_unified = "sources" in config and isinstance(config["sources"], list)
 
     # Handle unlimited mode by modifying config temporarily
     if unlimited:
         # Set max_pages to None (unlimited)
         if is_unified:
             # For unified configs, set max_pages on documentation sources
-            for source in config.get('sources', []):
-                if source.get('type') == 'documentation':
-                    source['max_pages'] = None
+            for source in config.get("sources", []):
+                if source.get("type") == "documentation":
+                    source["max_pages"] = None
         else:
             # For legacy configs
-            config['max_pages'] = None
+            config["max_pages"] = None
 
         # Create temporary config file
-        temp_config_path = config_path.replace('.json', '_unlimited_temp.json')
-        with open(temp_config_path, 'w') as f:
+        temp_config_path = config_path.replace(".json", "_unlimited_temp.json")
+        with open(temp_config_path, "w") as f:
             json.dump(config, f, indent=2)
 
         config_to_use = temp_config_path
@@ -216,19 +213,15 @@ async def scrape_docs_tool(args: dict) -> List[TextContent]:
     # Choose scraper based on format
     if is_unified:
         scraper_script = "unified_scraper.py"
-        progress_msg = f"🔄 Starting unified multi-source scraping...\n"
-        progress_msg += f"📦 Config format: Unified (multiple sources)\n"
+        progress_msg = "🔄 Starting unified multi-source scraping...\n"
+        progress_msg += "📦 Config format: Unified (multiple sources)\n"
     else:
         scraper_script = "doc_scraper.py"
-        progress_msg = f"🔄 Starting scraping process...\n"
-        progress_msg += f"📦 Config format: Legacy (single source)\n"
+        progress_msg = "🔄 Starting scraping process...\n"
+        progress_msg += "📦 Config format: Legacy (single source)\n"
 
     # Build command
-    cmd = [
-        sys.executable,
-        str(CLI_DIR / scraper_script),
-        "--config", config_to_use
-    ]
+    cmd = [sys.executable, str(CLI_DIR / scraper_script), "--config", config_to_use]
 
     # Add merge mode for unified configs
     if is_unified and merge_mode:
@@ -258,12 +251,12 @@ async def scrape_docs_tool(args: dict) -> List[TextContent]:
             if is_unified:
                 # For unified configs, estimate based on all sources
                 total_pages = 0
-                for source in config.get('sources', []):
-                    if source.get('type') == 'documentation':
-                        total_pages += source.get('max_pages', 500)
+                for source in config.get("sources", []):
+                    if source.get("type") == "documentation":
+                        total_pages += source.get("max_pages", 500)
                 max_pages = total_pages or 500
             else:
-                max_pages = config.get('max_pages', 500)
+                max_pages = config.get("max_pages", 500)
 
             # Estimate: 30s per page + buffer
             timeout = max(3600, max_pages * 35)  # Minimum 1 hour, or 35s per page
@@ -274,8 +267,8 @@ async def scrape_docs_tool(args: dict) -> List[TextContent]:
     if timeout:
         progress_msg += f"⏱️ Maximum time allowed: {timeout // 60} minutes\n"
     else:
-        progress_msg += f"⏱️ Unlimited mode - no timeout\n"
-    progress_msg += f"📝 Progress will be shown below:\n\n"
+        progress_msg += "⏱️ Unlimited mode - no timeout\n"
+    progress_msg += "📝 Progress will be shown below:\n\n"
 
     # Run scraper with streaming
     stdout, stderr, returncode = run_subprocess_with_streaming(cmd, timeout=timeout)
@@ -293,7 +286,7 @@ async def scrape_docs_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=error_output)]
 
 
-async def scrape_pdf_tool(args: dict) -> List[TextContent]:
+async def scrape_pdf_tool(args: dict) -> list[TextContent]:
     """
     Scrape PDF documentation and build Claude skill.
 
@@ -353,7 +346,7 @@ async def scrape_pdf_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output}\n\n❌ Error:\n{stderr}")]
 
 
-async def scrape_github_tool(args: dict) -> List[TextContent]:
+async def scrape_github_tool(args: dict) -> list[TextContent]:
     """
     Scrape GitHub repository and build Claude skill.
 
@@ -433,7 +426,7 @@ async def scrape_github_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output}\n\n❌ Error:\n{stderr}")]
 
 
-async def scrape_codebase_tool(args: dict) -> List[TextContent]:
+async def scrape_codebase_tool(args: dict) -> list[TextContent]:
     """
     Analyze local codebase and extract code knowledge.
 
@@ -506,7 +499,7 @@ async def scrape_codebase_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output_text}\n\n❌ Error:\n{stderr}")]
 
 
-async def detect_patterns_tool(args: dict) -> List[TextContent]:
+async def detect_patterns_tool(args: dict) -> list[TextContent]:
     """
     Detect design patterns in source code.
 
@@ -576,7 +569,7 @@ async def detect_patterns_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output_text}\n\n❌ Error:\n{stderr}")]
 
 
-async def extract_test_examples_tool(args: dict) -> List[TextContent]:
+async def extract_test_examples_tool(args: dict) -> list[TextContent]:
     """
     Extract usage examples from test files.
 
@@ -660,7 +653,7 @@ async def extract_test_examples_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output_text}\n\n❌ Error:\n{stderr}")]
 
 
-async def build_how_to_guides_tool(args: dict) -> List[TextContent]:
+async def build_how_to_guides_tool(args: dict) -> list[TextContent]:
     """
     Build how-to guides from workflow test examples.
 
@@ -735,7 +728,7 @@ async def build_how_to_guides_tool(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output_text}\n\n❌ Error:\n{stderr}")]
 
 
-async def extract_config_patterns_tool(args: dict) -> List[TextContent]:
+async def extract_config_patterns_tool(args: dict) -> list[TextContent]:
     """
     Extract configuration patterns from config files (C3.4).
 
diff --git a/src/skill_seekers/mcp/tools/source_tools.py b/src/skill_seekers/mcp/tools/source_tools.py
index 8d43a12..3d82505 100644
--- a/src/skill_seekers/mcp/tools/source_tools.py
+++ b/src/skill_seekers/mcp/tools/source_tools.py
@@ -13,25 +13,27 @@ import json
 import os
 import re
 from pathlib import Path
-from typing import Any, List
 
 # MCP types (imported conditionally)
 try:
     from mcp.types import TextContent
+
     MCP_AVAILABLE = True
 except ImportError:
     # Graceful degradation: Create a simple fallback class for testing
     class TextContent:
         """Fallback TextContent for when MCP is not installed"""
+
         def __init__(self, type: str, text: str):
             self.type = type
             self.text = text
+
     MCP_AVAILABLE = False
 
 import httpx
 
 
-async def fetch_config_tool(args: dict) -> List[TextContent]:
+async def fetch_config_tool(args: dict) -> list[TextContent]:
     """
     Fetch config from API, git URL, or named source.
 
@@ -95,11 +97,7 @@ async def fetch_config_tool(args: dict) -> List[TextContent]:
             git_repo = GitConfigRepo()
             try:
                 repo_path = git_repo.clone_or_pull(
-                    source_name=source_name,
-                    git_url=git_url,
-                    branch=branch,
-                    token=token,
-                    force_refresh=force_refresh
+                    source_name=source_name, git_url=git_url, branch=branch, token=token, force_refresh=force_refresh
                 )
             except Exception as e:
                 return [TextContent(type="text", text=f"❌ Git error: {str(e)}")]
@@ -117,7 +115,7 @@ async def fetch_config_tool(args: dict) -> List[TextContent]:
             dest_path.mkdir(parents=True, exist_ok=True)
             config_file = dest_path / f"{config_name}.json"
 
-            with open(config_file, 'w') as f:
+            with open(config_file, "w") as f:
                 json.dump(config_data, f, indent=2)
 
             result = f"""✅ Config fetched from git source successfully!
@@ -127,7 +125,7 @@ async def fetch_config_tool(args: dict) -> List[TextContent]:
 🔗 Source: {source_name}
 🌿 Branch: {branch}
 📁 Repository: {git_url}
-🔄 Refreshed: {'Yes (forced)' if force_refresh else 'No (used cache)'}
+🔄 Refreshed: {"Yes (forced)" if force_refresh else "No (used cache)"}
 
 Next steps:
   1. Review config: cat {config_file}
@@ -153,7 +151,7 @@ Next steps:
                     git_url=git_url,
                     branch=branch,
                     token=token,
-                    force_refresh=force_refresh
+                    force_refresh=force_refresh,
                 )
             except ValueError as e:
                 return [TextContent(type="text", text=f"❌ Invalid git URL: {str(e)}")]
@@ -173,7 +171,7 @@ Next steps:
             dest_path.mkdir(parents=True, exist_ok=True)
             config_file = dest_path / f"{config_name}.json"
 
-            with open(config_file, 'w') as f:
+            with open(config_file, "w") as f:
                 json.dump(config_data, f, indent=2)
 
             result = f"""✅ Config fetched from git URL successfully!
@@ -182,7 +180,7 @@ Next steps:
 📂 Saved to: {config_file}
 📁 Repository: {git_url}
 🌿 Branch: {branch}
-🔄 Refreshed: {'Yes (forced)' if force_refresh else 'No (used cache)'}
+🔄 Refreshed: {"Yes (forced)" if force_refresh else "No (used cache)"}
 
 Next steps:
   1. Review config: cat {config_file}
@@ -239,21 +237,28 @@ Next steps:
                             if tags:
                                 result += f"    Tags: {tags}\n"
 
-                    result += f"\n💡 To download a config, use: fetch_config with config_name='<name>'\n"
+                    result += "\n💡 To download a config, use: fetch_config with config_name='<name>'\n"
                     result += f"📚 API Docs: {API_BASE_URL}/docs\n"
 
                     return [TextContent(type="text", text=result)]
 
                 # Download specific config
                 if not config_name:
-                    return [TextContent(type="text", text="❌ Error: Please provide config_name or set list_available=true")]
+                    return [
+                        TextContent(type="text", text="❌ Error: Please provide config_name or set list_available=true")
+                    ]
 
                 # Get config details first
                 detail_url = f"{API_BASE_URL}/api/configs/{config_name}"
                 detail_response = await client.get(detail_url)
 
                 if detail_response.status_code == 404:
-                    return [TextContent(type="text", text=f"❌ Config '{config_name}' not found. Use list_available=true to see available configs.")]
+                    return [
+                        TextContent(
+                            type="text",
+                            text=f"❌ Config '{config_name}' not found. Use list_available=true to see available configs.",
+                        )
+                    ]
 
                 detail_response.raise_for_status()
                 config_info = detail_response.json()
@@ -269,7 +274,7 @@ Next steps:
                 dest_path.mkdir(parents=True, exist_ok=True)
                 config_file = dest_path / f"{config_name}.json"
 
-                with open(config_file, 'w') as f:
+                with open(config_file, "w") as f:
                     json.dump(config_data, f, indent=2)
 
                 # Build result message
@@ -277,15 +282,15 @@ Next steps:
 
 📦 Config: {config_name}
 📂 Saved to: {config_file}
-📊 Category: {config_info.get('category', 'uncategorized')}
-🏷️  Tags: {', '.join(config_info.get('tags', []))}
-📄 Type: {config_info.get('type', 'unknown')}
-📝 Description: {config_info.get('description', 'No description')}
+📊 Category: {config_info.get("category", "uncategorized")}
+🏷️  Tags: {", ".join(config_info.get("tags", []))}
+📄 Type: {config_info.get("type", "unknown")}
+📝 Description: {config_info.get("description", "No description")}
 
-🔗 Source: {config_info.get('primary_source', 'N/A')}
-📏 Max pages: {config_info.get('max_pages', 'N/A')}
-📦 File size: {config_info.get('file_size', 'N/A')} bytes
-🕒 Last updated: {config_info.get('last_updated', 'N/A')}
+🔗 Source: {config_info.get("primary_source", "N/A")}
+📏 Max pages: {config_info.get("max_pages", "N/A")}
+📦 File size: {config_info.get("file_size", "N/A")} bytes
+🕒 Last updated: {config_info.get("last_updated", "N/A")}
 
 Next steps:
   1. Review config: cat {config_file}
@@ -298,14 +303,18 @@ Next steps:
                 return [TextContent(type="text", text=result)]
 
     except httpx.HTTPError as e:
-        return [TextContent(type="text", text=f"❌ HTTP Error: {str(e)}\n\nCheck your internet connection or try again later.")]
+        return [
+            TextContent(
+                type="text", text=f"❌ HTTP Error: {str(e)}\n\nCheck your internet connection or try again later."
+            )
+        ]
     except json.JSONDecodeError as e:
         return [TextContent(type="text", text=f"❌ JSON Error: Invalid response from API: {str(e)}")]
     except Exception as e:
         return [TextContent(type="text", text=f"❌ Error: {str(e)}")]
 
 
-async def submit_config_tool(args: dict) -> List[TextContent]:
+async def submit_config_tool(args: dict) -> list[TextContent]:
     """
     Submit a custom config to skill-seekers-configs repository via GitHub issue.
 
@@ -325,12 +334,15 @@ async def submit_config_tool(args: dict) -> List[TextContent]:
     try:
         from github import Github, GithubException
     except ImportError:
-        return [TextContent(type="text", text="❌ Error: PyGithub not installed.\n\nInstall with: pip install PyGithub")]
+        return [
+            TextContent(type="text", text="❌ Error: PyGithub not installed.\n\nInstall with: pip install PyGithub")
+        ]
 
     # Import config validator
     try:
-        from pathlib import Path
         import sys
+        from pathlib import Path
+
         CLI_DIR = Path(__file__).parent.parent.parent / "cli"
         sys.path.insert(0, str(CLI_DIR))
         from config_validator import ConfigValidator
@@ -349,7 +361,7 @@ async def submit_config_tool(args: dict) -> List[TextContent]:
             if not config_file.exists():
                 return [TextContent(type="text", text=f"❌ Error: Config file not found: {config_path}")]
 
-            with open(config_file, 'r') as f:
+            with open(config_file) as f:
                 config_data = json.load(f)
                 config_json_str = json.dumps(config_data, indent=2)
                 config_name = config_data.get("name", config_file.stem)
@@ -366,7 +378,12 @@ async def submit_config_tool(args: dict) -> List[TextContent]:
 
         # Use ConfigValidator for comprehensive validation
         if ConfigValidator is None:
-            return [TextContent(type="text", text="❌ Error: ConfigValidator not available. Please ensure config_validator.py is in the CLI directory.")]
+            return [
+                TextContent(
+                    type="text",
+                    text="❌ Error: ConfigValidator not available. Please ensure config_validator.py is in the CLI directory.",
+                )
+            ]
 
         try:
             validator = ConfigValidator(config_data)
@@ -378,22 +395,26 @@ async def submit_config_tool(args: dict) -> List[TextContent]:
 
             # Additional format validation (ConfigValidator only checks structure)
             # Validate name format (alphanumeric, hyphens, underscores only)
-            if not re.match(r'^[a-zA-Z0-9_-]+$', config_name):
-                raise ValueError(f"Invalid name format: '{config_name}'\nNames must contain only alphanumeric characters, hyphens, and underscores")
+            if not re.match(r"^[a-zA-Z0-9_-]+$", config_name):
+                raise ValueError(
+                    f"Invalid name format: '{config_name}'\nNames must contain only alphanumeric characters, hyphens, and underscores"
+                )
 
             # Validate URL formats
             if not is_unified:
                 # Legacy config - check base_url
-                base_url = config_data.get('base_url', '')
-                if base_url and not (base_url.startswith('http://') or base_url.startswith('https://')):
+                base_url = config_data.get("base_url", "")
+                if base_url and not (base_url.startswith("http://") or base_url.startswith("https://")):
                     raise ValueError(f"Invalid base_url format: '{base_url}'\nURLs must start with http:// or https://")
             else:
                 # Unified config - check URLs in sources
-                for idx, source in enumerate(config_data.get('sources', [])):
-                    if source.get('type') == 'documentation':
-                        source_url = source.get('base_url', '')
-                        if source_url and not (source_url.startswith('http://') or source_url.startswith('https://')):
-                            raise ValueError(f"Source {idx} (documentation): Invalid base_url format: '{source_url}'\nURLs must start with http:// or https://")
+                for idx, source in enumerate(config_data.get("sources", [])):
+                    if source.get("type") == "documentation":
+                        source_url = source.get("base_url", "")
+                        if source_url and not (source_url.startswith("http://") or source_url.startswith("https://")):
+                            raise ValueError(
+                                f"Source {idx} (documentation): Invalid base_url format: '{source_url}'\nURLs must start with http:// or https://"
+                            )
 
         except ValueError as validation_error:
             # Provide detailed validation feedback
@@ -417,12 +438,14 @@ Please fix these issues and try again.
         # Detect category based on config format and content
         if is_unified:
             # For unified configs, look at source types
-            source_types = [src.get('type') for src in config_data.get('sources', [])]
-            if 'documentation' in source_types and 'github' in source_types:
-                category = "multi-source"
-            elif 'documentation' in source_types and 'pdf' in source_types:
-                category = "multi-source"
-            elif len(source_types) > 1:
+            source_types = [src.get("type") for src in config_data.get("sources", [])]
+            if (
+                "documentation" in source_types
+                and "github" in source_types
+                or "documentation" in source_types
+                and "pdf" in source_types
+                or len(source_types) > 1
+            ):
                 category = "multi-source"
             else:
                 category = "unified"
@@ -443,21 +466,26 @@ Please fix these issues and try again.
         warnings = []
         if not is_unified:
             # Legacy config warnings
-            if 'max_pages' not in config_data:
+            if "max_pages" not in config_data:
                 warnings.append("⚠️ No max_pages set - will use default (100)")
-            elif config_data.get('max_pages') in (None, -1):
+            elif config_data.get("max_pages") in (None, -1):
                 warnings.append("⚠️ Unlimited scraping enabled - may scrape thousands of pages and take hours")
         else:
             # Unified config warnings
-            for src in config_data.get('sources', []):
-                if src.get('type') == 'documentation' and 'max_pages' not in src:
-                    warnings.append(f"⚠️ No max_pages set for documentation source - will use default (100)")
-                elif src.get('type') == 'documentation' and src.get('max_pages') in (None, -1):
-                    warnings.append(f"⚠️ Unlimited scraping enabled for documentation source")
+            for src in config_data.get("sources", []):
+                if src.get("type") == "documentation" and "max_pages" not in src:
+                    warnings.append("⚠️ No max_pages set for documentation source - will use default (100)")
+                elif src.get("type") == "documentation" and src.get("max_pages") in (None, -1):
+                    warnings.append("⚠️ Unlimited scraping enabled for documentation source")
 
         # Check for GitHub token
         if not github_token:
-            return [TextContent(type="text", text="❌ Error: GitHub token required.\n\nProvide github_token parameter or set GITHUB_TOKEN environment variable.\n\nCreate token at: https://github.com/settings/tokens")]
+            return [
+                TextContent(
+                    type="text",
+                    text="❌ Error: GitHub token required.\n\nProvide github_token parameter or set GITHUB_TOKEN environment variable.\n\nCreate token at: https://github.com/settings/tokens",
+                )
+            ]
 
         # Create GitHub issue
         try:
@@ -485,7 +513,7 @@ Please fix these issues and try again.
 {testing_notes if testing_notes else "Not provided"}
 
 ### Documentation URL
-{config_data.get('base_url') if not is_unified else 'See sources in config'}
+{config_data.get("base_url") if not is_unified else "See sources in config"}
 
 {"### Validation Warnings" if warnings else ""}
 {chr(10).join(f"- {w}" for w in warnings) if warnings else ""}
@@ -501,9 +529,7 @@ Please fix these issues and try again.
 
             # Create issue
             issue = repo.create_issue(
-                title=f"[CONFIG] {config_name}",
-                body=issue_body,
-                labels=["config-submission", "needs-review"]
+                title=f"[CONFIG] {config_name}", body=issue_body, labels=["config-submission", "needs-review"]
             )
 
             result = f"""✅ Config submitted successfully!
@@ -527,13 +553,18 @@ What happens next:
             return [TextContent(type="text", text=result)]
 
         except GithubException as e:
-            return [TextContent(type="text", text=f"❌ GitHub Error: {str(e)}\n\nCheck your token permissions (needs 'repo' or 'public_repo' scope).")]
+            return [
+                TextContent(
+                    type="text",
+                    text=f"❌ GitHub Error: {str(e)}\n\nCheck your token permissions (needs 'repo' or 'public_repo' scope).",
+                )
+            ]
 
     except Exception as e:
         return [TextContent(type="text", text=f"❌ Error: {str(e)}")]
 
 
-async def add_config_source_tool(args: dict) -> List[TextContent]:
+async def add_config_source_tool(args: dict) -> list[TextContent]:
     """
     Register a git repository as a config source.
 
@@ -579,34 +610,34 @@ async def add_config_source_tool(args: dict) -> List[TextContent]:
             token_env=token_env,
             branch=branch,
             priority=priority,
-            enabled=enabled
+            enabled=enabled,
         )
 
         # Check if this is an update
         is_update = "updated_at" in source and source["added_at"] != source["updated_at"]
 
-        result = f"""✅ Config source {'updated' if is_update else 'registered'} successfully!
+        result = f"""✅ Config source {"updated" if is_update else "registered"} successfully!
 
-📛 Name: {source['name']}
-📁 Repository: {source['git_url']}
-🔖 Type: {source['type']}
-🌿 Branch: {source['branch']}
-🔑 Token env: {source.get('token_env', 'None')}
-⚡ Priority: {source['priority']} (lower = higher priority)
-✓ Enabled: {source['enabled']}
-🕒 Added: {source['added_at'][:19]}
+📛 Name: {source["name"]}
+📁 Repository: {source["git_url"]}
+🔖 Type: {source["type"]}
+🌿 Branch: {source["branch"]}
+🔑 Token env: {source.get("token_env", "None")}
+⚡ Priority: {source["priority"]} (lower = higher priority)
+✓ Enabled: {source["enabled"]}
+🕒 Added: {source["added_at"][:19]}
 
 Usage:
   # Fetch config from this source
-  fetch_config(source="{source['name']}", config_name="your-config")
+  fetch_config(source="{source["name"]}", config_name="your-config")
 
   # List all sources
   list_config_sources()
 
   # Remove this source
-  remove_config_source(name="{source['name']}")
+  remove_config_source(name="{source["name"]}")
 
-💡 Make sure to set {source.get('token_env', 'GIT_TOKEN')} environment variable for private repos
+💡 Make sure to set {source.get("token_env", "GIT_TOKEN")} environment variable for private repos
 """
 
         return [TextContent(type="text", text=result)]
@@ -617,7 +648,7 @@ Usage:
         return [TextContent(type="text", text=f"❌ Error: {str(e)}")]
 
 
-async def list_config_sources_tool(args: dict) -> List[TextContent]:
+async def list_config_sources_tool(args: dict) -> list[TextContent]:
     """
     List all registered config sources.
 
@@ -683,7 +714,7 @@ To add a source:
         return [TextContent(type="text", text=f"❌ Error: {str(e)}")]
 
 
-async def remove_config_source_tool(args: dict) -> List[TextContent]:
+async def remove_config_source_tool(args: dict) -> list[TextContent]:
     """
     Remove a registered config source.
 
@@ -732,7 +763,7 @@ Next steps:
 
             result = f"""❌ Source '{name}' not found
 
-Available sources: {', '.join(available) if available else 'none'}
+Available sources: {", ".join(available) if available else "none"}
 
 To see all sources:
   list_config_sources()
diff --git a/src/skill_seekers/mcp/tools/splitting_tools.py b/src/skill_seekers/mcp/tools/splitting_tools.py
index 8bf1cd1..daeb7b6 100644
--- a/src/skill_seekers/mcp/tools/splitting_tools.py
+++ b/src/skill_seekers/mcp/tools/splitting_tools.py
@@ -8,7 +8,6 @@ focused skills and generating router/hub skills for managing split documentation
 import glob
 import sys
 from pathlib import Path
-from typing import Any, List
 
 try:
     from mcp.types import TextContent
@@ -16,13 +15,16 @@ except ImportError:
     # Graceful degradation: Create a simple fallback class for testing
     class TextContent:
         """Fallback TextContent for when MCP is not installed"""
+
         def __init__(self, type: str, text: str):
             self.type = type
             self.text = text
 
+
 # Path to CLI tools
 CLI_DIR = Path(__file__).parent.parent.parent / "cli"
 
+
 # Import subprocess helper from parent module
 # We'll use a local import to avoid circular dependencies
 def run_subprocess_with_streaming(cmd, timeout=None):
@@ -43,7 +45,7 @@ def run_subprocess_with_streaming(cmd, timeout=None):
             stderr=subprocess.PIPE,
             text=True,
             bufsize=1,  # Line buffered
-            universal_newlines=True
+            universal_newlines=True,
         )
 
         stdout_lines = []
@@ -65,6 +67,7 @@ def run_subprocess_with_streaming(cmd, timeout=None):
             # Read available output (non-blocking)
             try:
                 import select
+
                 readable, _, _ = select.select([process.stdout, process.stderr], [], [], 0.1)
 
                 if process.stdout in readable:
@@ -87,8 +90,8 @@ def run_subprocess_with_streaming(cmd, timeout=None):
         if remaining_stderr:
             stderr_lines.append(remaining_stderr)
 
-        stdout = ''.join(stdout_lines)
-        stderr = ''.join(stderr_lines)
+        stdout = "".join(stdout_lines)
+        stderr = "".join(stderr_lines)
         returncode = process.returncode
 
         return stdout, stderr, returncode
@@ -97,7 +100,7 @@ def run_subprocess_with_streaming(cmd, timeout=None):
         return "", f"Error running subprocess: {str(e)}", 1
 
 
-async def split_config(args: dict) -> List[TextContent]:
+async def split_config(args: dict) -> list[TextContent]:
     """
     Split large configs into multiple focused skills.
 
@@ -131,8 +134,10 @@ async def split_config(args: dict) -> List[TextContent]:
         sys.executable,
         str(CLI_DIR / "split_config.py"),
         config_path,
-        "--strategy", strategy,
-        "--target-pages", str(target_pages)
+        "--strategy",
+        strategy,
+        "--target-pages",
+        str(target_pages),
     ]
 
     if dry_run:
@@ -154,7 +159,7 @@ async def split_config(args: dict) -> List[TextContent]:
         return [TextContent(type="text", text=f"{output}\n\n❌ Error:\n{stderr}")]
 
 
-async def generate_router(args: dict) -> List[TextContent]:
+async def generate_router(args: dict) -> list[TextContent]:
     """
     Generate router/hub skill for split documentation.
 
diff --git a/test_api.py b/test_api.py
index 9cfa69f..c63223d 100644
--- a/test_api.py
+++ b/test_api.py
@@ -1,13 +1,16 @@
 #!/usr/bin/env python3
 """Quick test of the config analyzer"""
+
 import sys
-sys.path.insert(0, 'api')
+
+sys.path.insert(0, "api")
 
 from pathlib import Path
+
 from api.config_analyzer import ConfigAnalyzer
 
 # Initialize analyzer
-config_dir = Path('configs')
+config_dir = Path("configs")
 analyzer = ConfigAnalyzer(config_dir, base_url="https://api.skillseekersweb.com")
 
 # Test analyzing all configs
@@ -31,7 +34,7 @@ for config in configs[:3]:
 print("\n\n📊 Categories:")
 categories = {}
 for config in configs:
-    cat = config['category']
+    cat = config["category"]
     categories[cat] = categories.get(cat, 0) + 1
 
 for cat, count in sorted(categories.items()):
diff --git a/tests/conftest.py b/tests/conftest.py
index 77d483d..9bc016f 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -6,6 +6,7 @@ Checks that the skill_seekers package is installed before running tests.
 """
 
 import sys
+
 import pytest
 
 
diff --git a/tests/test_adaptors/test_adaptors_e2e.py b/tests/test_adaptors/test_adaptors_e2e.py
index 8732bb9..6c98c99 100644
--- a/tests/test_adaptors/test_adaptors_e2e.py
+++ b/tests/test_adaptors/test_adaptors_e2e.py
@@ -9,14 +9,14 @@ Tests complete workflows without real API uploads:
 - Enhancement workflow (mocked)
 """
 
-import unittest
-import tempfile
-import zipfile
-import tarfile
 import json
+import tarfile
+import tempfile
+import unittest
+import zipfile
 from pathlib import Path
 
-from skill_seekers.cli.adaptors import get_adaptor, list_platforms
+from skill_seekers.cli.adaptors import get_adaptor
 from skill_seekers.cli.adaptors.base import SkillMetadata
 
 
@@ -128,7 +128,7 @@ Pass data to components:
 
     def test_e2e_all_platforms_from_same_skill(self):
         """Test that all platforms can package the same skill"""
-        platforms = ['claude', 'gemini', 'openai', 'markdown']
+        platforms = ["claude", "gemini", "openai", "markdown"]
         packages = {}
 
         for platform in platforms:
@@ -138,8 +138,7 @@ Pass data to components:
             package_path = adaptor.package(self.skill_dir, self.output_dir)
 
             # Verify package was created
-            self.assertTrue(package_path.exists(),
-                          f"Package not created for {platform}")
+            self.assertTrue(package_path.exists(), f"Package not created for {platform}")
 
             # Store for later verification
             packages[platform] = package_path
@@ -148,167 +147,160 @@ Pass data to components:
         self.assertEqual(len(packages), 4)
 
         # Verify correct extensions
-        self.assertTrue(str(packages['claude']).endswith('.zip'))
-        self.assertTrue(str(packages['gemini']).endswith('.tar.gz'))
-        self.assertTrue(str(packages['openai']).endswith('.zip'))
-        self.assertTrue(str(packages['markdown']).endswith('.zip'))
+        self.assertTrue(str(packages["claude"]).endswith(".zip"))
+        self.assertTrue(str(packages["gemini"]).endswith(".tar.gz"))
+        self.assertTrue(str(packages["openai"]).endswith(".zip"))
+        self.assertTrue(str(packages["markdown"]).endswith(".zip"))
 
     def test_e2e_claude_workflow(self):
         """Test complete Claude workflow: package + verify structure"""
-        adaptor = get_adaptor('claude')
+        adaptor = get_adaptor("claude")
 
         # Package
         package_path = adaptor.package(self.skill_dir, self.output_dir)
 
         # Verify package
         self.assertTrue(package_path.exists())
-        self.assertTrue(str(package_path).endswith('.zip'))
+        self.assertTrue(str(package_path).endswith(".zip"))
 
         # Verify contents
-        with zipfile.ZipFile(package_path, 'r') as zf:
+        with zipfile.ZipFile(package_path, "r") as zf:
             names = zf.namelist()
 
             # Should have SKILL.md
-            self.assertIn('SKILL.md', names)
+            self.assertIn("SKILL.md", names)
 
             # Should have references
-            self.assertTrue(any('references/' in name for name in names))
+            self.assertTrue(any("references/" in name for name in names))
 
             # Verify SKILL.md content (should have YAML frontmatter)
-            skill_content = zf.read('SKILL.md').decode('utf-8')
+            skill_content = zf.read("SKILL.md").decode("utf-8")
             # Claude uses YAML frontmatter (but current implementation doesn't add it in package)
             # Just verify content exists
             self.assertGreater(len(skill_content), 0)
 
     def test_e2e_gemini_workflow(self):
         """Test complete Gemini workflow: package + verify structure"""
-        adaptor = get_adaptor('gemini')
+        adaptor = get_adaptor("gemini")
 
         # Package
         package_path = adaptor.package(self.skill_dir, self.output_dir)
 
         # Verify package
         self.assertTrue(package_path.exists())
-        self.assertTrue(str(package_path).endswith('.tar.gz'))
+        self.assertTrue(str(package_path).endswith(".tar.gz"))
 
         # Verify contents
-        with tarfile.open(package_path, 'r:gz') as tar:
+        with tarfile.open(package_path, "r:gz") as tar:
             names = tar.getnames()
 
             # Should have system_instructions.md (not SKILL.md)
-            self.assertIn('system_instructions.md', names)
+            self.assertIn("system_instructions.md", names)
 
             # Should have references
-            self.assertTrue(any('references/' in name for name in names))
+            self.assertTrue(any("references/" in name for name in names))
 
             # Should have metadata
-            self.assertIn('gemini_metadata.json', names)
+            self.assertIn("gemini_metadata.json", names)
 
             # Verify metadata content
-            metadata_member = tar.getmember('gemini_metadata.json')
+            metadata_member = tar.getmember("gemini_metadata.json")
             metadata_file = tar.extractfile(metadata_member)
-            metadata = json.loads(metadata_file.read().decode('utf-8'))
+            metadata = json.loads(metadata_file.read().decode("utf-8"))
 
-            self.assertEqual(metadata['platform'], 'gemini')
-            self.assertEqual(metadata['name'], 'test-skill')
-            self.assertIn('created_with', metadata)
+            self.assertEqual(metadata["platform"], "gemini")
+            self.assertEqual(metadata["name"], "test-skill")
+            self.assertIn("created_with", metadata)
 
     def test_e2e_openai_workflow(self):
         """Test complete OpenAI workflow: package + verify structure"""
-        adaptor = get_adaptor('openai')
+        adaptor = get_adaptor("openai")
 
         # Package
         package_path = adaptor.package(self.skill_dir, self.output_dir)
 
         # Verify package
         self.assertTrue(package_path.exists())
-        self.assertTrue(str(package_path).endswith('.zip'))
+        self.assertTrue(str(package_path).endswith(".zip"))
 
         # Verify contents
-        with zipfile.ZipFile(package_path, 'r') as zf:
+        with zipfile.ZipFile(package_path, "r") as zf:
             names = zf.namelist()
 
             # Should have assistant_instructions.txt
-            self.assertIn('assistant_instructions.txt', names)
+            self.assertIn("assistant_instructions.txt", names)
 
             # Should have vector store files
-            self.assertTrue(any('vector_store_files/' in name for name in names))
+            self.assertTrue(any("vector_store_files/" in name for name in names))
 
             # Should have metadata
-            self.assertIn('openai_metadata.json', names)
+            self.assertIn("openai_metadata.json", names)
 
             # Verify metadata content
-            metadata_content = zf.read('openai_metadata.json').decode('utf-8')
+            metadata_content = zf.read("openai_metadata.json").decode("utf-8")
             metadata = json.loads(metadata_content)
 
-            self.assertEqual(metadata['platform'], 'openai')
-            self.assertEqual(metadata['name'], 'test-skill')
-            self.assertEqual(metadata['model'], 'gpt-4o')
-            self.assertIn('file_search', metadata['tools'])
+            self.assertEqual(metadata["platform"], "openai")
+            self.assertEqual(metadata["name"], "test-skill")
+            self.assertEqual(metadata["model"], "gpt-4o")
+            self.assertIn("file_search", metadata["tools"])
 
     def test_e2e_markdown_workflow(self):
         """Test complete Markdown workflow: package + verify structure"""
-        adaptor = get_adaptor('markdown')
+        adaptor = get_adaptor("markdown")
 
         # Package
         package_path = adaptor.package(self.skill_dir, self.output_dir)
 
         # Verify package
         self.assertTrue(package_path.exists())
-        self.assertTrue(str(package_path).endswith('.zip'))
+        self.assertTrue(str(package_path).endswith(".zip"))
 
         # Verify contents
-        with zipfile.ZipFile(package_path, 'r') as zf:
+        with zipfile.ZipFile(package_path, "r") as zf:
             names = zf.namelist()
 
             # Should have README.md
-            self.assertIn('README.md', names)
+            self.assertIn("README.md", names)
 
             # Should have DOCUMENTATION.md (combined)
-            self.assertIn('DOCUMENTATION.md', names)
+            self.assertIn("DOCUMENTATION.md", names)
 
             # Should have references
-            self.assertTrue(any('references/' in name for name in names))
+            self.assertTrue(any("references/" in name for name in names))
 
             # Should have metadata
-            self.assertIn('metadata.json', names)
+            self.assertIn("metadata.json", names)
 
             # Verify combined documentation
-            doc_content = zf.read('DOCUMENTATION.md').decode('utf-8')
+            doc_content = zf.read("DOCUMENTATION.md").decode("utf-8")
 
             # Should contain content from all references
-            self.assertIn('Getting Started', doc_content)
-            self.assertIn('React Hooks', doc_content)
-            self.assertIn('Components', doc_content)
+            self.assertIn("Getting Started", doc_content)
+            self.assertIn("React Hooks", doc_content)
+            self.assertIn("Components", doc_content)
 
     def test_e2e_package_format_validation(self):
         """Test that each platform creates correct package format"""
-        test_cases = [
-            ('claude', '.zip'),
-            ('gemini', '.tar.gz'),
-            ('openai', '.zip'),
-            ('markdown', '.zip')
-        ]
+        test_cases = [("claude", ".zip"), ("gemini", ".tar.gz"), ("openai", ".zip"), ("markdown", ".zip")]
 
         for platform, expected_ext in test_cases:
             adaptor = get_adaptor(platform)
             package_path = adaptor.package(self.skill_dir, self.output_dir)
 
             # Verify extension
-            if expected_ext == '.tar.gz':
-                self.assertTrue(str(package_path).endswith('.tar.gz'),
-                              f"{platform} should create .tar.gz file")
+            if expected_ext == ".tar.gz":
+                self.assertTrue(str(package_path).endswith(".tar.gz"), f"{platform} should create .tar.gz file")
             else:
-                self.assertTrue(str(package_path).endswith('.zip'),
-                              f"{platform} should create .zip file")
+                self.assertTrue(str(package_path).endswith(".zip"), f"{platform} should create .zip file")
 
     def test_e2e_package_filename_convention(self):
         """Test that package filenames follow convention"""
         test_cases = [
-            ('claude', 'test-skill.zip'),
-            ('gemini', 'test-skill-gemini.tar.gz'),
-            ('openai', 'test-skill-openai.zip'),
-            ('markdown', 'test-skill-markdown.zip')
+            ("claude", "test-skill.zip"),
+            ("gemini", "test-skill-gemini.tar.gz"),
+            ("openai", "test-skill-openai.zip"),
+            ("markdown", "test-skill-markdown.zip"),
         ]
 
         for platform, expected_name in test_cases:
@@ -316,127 +308,118 @@ Pass data to components:
             package_path = adaptor.package(self.skill_dir, self.output_dir)
 
             # Verify filename
-            self.assertEqual(package_path.name, expected_name,
-                           f"{platform} package filename incorrect")
+            self.assertEqual(package_path.name, expected_name, f"{platform} package filename incorrect")
 
     def test_e2e_all_platforms_preserve_references(self):
         """Test that all platforms preserve reference files"""
-        ref_files = ['getting_started.md', 'hooks.md', 'components.md']
+        ref_files = ["getting_started.md", "hooks.md", "components.md"]
 
-        for platform in ['claude', 'gemini', 'openai', 'markdown']:
+        for platform in ["claude", "gemini", "openai", "markdown"]:
             adaptor = get_adaptor(platform)
             package_path = adaptor.package(self.skill_dir, self.output_dir)
 
             # Check references are preserved
-            if platform == 'gemini':
-                with tarfile.open(package_path, 'r:gz') as tar:
+            if platform == "gemini":
+                with tarfile.open(package_path, "r:gz") as tar:
                     names = tar.getnames()
                     for ref_file in ref_files:
                         self.assertTrue(
-                            any(ref_file in name for name in names),
-                            f"{platform}: {ref_file} not found in package"
+                            any(ref_file in name for name in names), f"{platform}: {ref_file} not found in package"
                         )
             else:
-                with zipfile.ZipFile(package_path, 'r') as zf:
+                with zipfile.ZipFile(package_path, "r") as zf:
                     names = zf.namelist()
                     for ref_file in ref_files:
                         # OpenAI moves to vector_store_files/
-                        if platform == 'openai':
+                        if platform == "openai":
                             self.assertTrue(
-                                any(f'vector_store_files/{ref_file}' in name for name in names),
-                                f"{platform}: {ref_file} not found in vector_store_files/"
+                                any(f"vector_store_files/{ref_file}" in name for name in names),
+                                f"{platform}: {ref_file} not found in vector_store_files/",
                             )
                         else:
                             self.assertTrue(
-                                any(ref_file in name for name in names),
-                                f"{platform}: {ref_file} not found in package"
+                                any(ref_file in name for name in names), f"{platform}: {ref_file} not found in package"
                             )
 
     def test_e2e_metadata_consistency(self):
         """Test that metadata is consistent across platforms"""
-        platforms_with_metadata = ['gemini', 'openai', 'markdown']
+        platforms_with_metadata = ["gemini", "openai", "markdown"]
 
         for platform in platforms_with_metadata:
             adaptor = get_adaptor(platform)
             package_path = adaptor.package(self.skill_dir, self.output_dir)
 
             # Extract and verify metadata
-            if platform == 'gemini':
-                with tarfile.open(package_path, 'r:gz') as tar:
-                    metadata_member = tar.getmember('gemini_metadata.json')
+            if platform == "gemini":
+                with tarfile.open(package_path, "r:gz") as tar:
+                    metadata_member = tar.getmember("gemini_metadata.json")
                     metadata_file = tar.extractfile(metadata_member)
-                    metadata = json.loads(metadata_file.read().decode('utf-8'))
+                    metadata = json.loads(metadata_file.read().decode("utf-8"))
             else:
-                with zipfile.ZipFile(package_path, 'r') as zf:
-                    metadata_filename = f'{platform}_metadata.json' if platform == 'openai' else 'metadata.json'
-                    metadata_content = zf.read(metadata_filename).decode('utf-8')
+                with zipfile.ZipFile(package_path, "r") as zf:
+                    metadata_filename = f"{platform}_metadata.json" if platform == "openai" else "metadata.json"
+                    metadata_content = zf.read(metadata_filename).decode("utf-8")
                     metadata = json.loads(metadata_content)
 
             # Verify required fields
-            self.assertEqual(metadata['platform'], platform)
-            self.assertEqual(metadata['name'], 'test-skill')
-            self.assertIn('created_with', metadata)
+            self.assertEqual(metadata["platform"], platform)
+            self.assertEqual(metadata["name"], "test-skill")
+            self.assertIn("created_with", metadata)
 
     def test_e2e_format_skill_md_differences(self):
         """Test that each platform formats SKILL.md differently"""
-        metadata = SkillMetadata(
-            name="test-skill",
-            description="Test skill for E2E testing"
-        )
+        metadata = SkillMetadata(name="test-skill", description="Test skill for E2E testing")
 
         formats = {}
-        for platform in ['claude', 'gemini', 'openai', 'markdown']:
+        for platform in ["claude", "gemini", "openai", "markdown"]:
             adaptor = get_adaptor(platform)
             formatted = adaptor.format_skill_md(self.skill_dir, metadata)
             formats[platform] = formatted
 
         # Claude should have YAML frontmatter
-        self.assertTrue(formats['claude'].startswith('---'))
+        self.assertTrue(formats["claude"].startswith("---"))
 
         # Gemini and Markdown should NOT have YAML frontmatter
-        self.assertFalse(formats['gemini'].startswith('---'))
-        self.assertFalse(formats['markdown'].startswith('---'))
+        self.assertFalse(formats["gemini"].startswith("---"))
+        self.assertFalse(formats["markdown"].startswith("---"))
 
         # All should contain content from existing SKILL.md (React Framework)
         for platform, formatted in formats.items():
             # Check for content from existing SKILL.md
-            self.assertIn('react', formatted.lower(),
-                         f"{platform} should contain skill content")
+            self.assertIn("react", formatted.lower(), f"{platform} should contain skill content")
             # All should have non-empty content
-            self.assertGreater(len(formatted), 100,
-                             f"{platform} should have substantial content")
+            self.assertGreater(len(formatted), 100, f"{platform} should have substantial content")
 
     def test_e2e_upload_without_api_key(self):
         """Test upload behavior without API keys (should fail gracefully)"""
-        platforms_with_upload = ['claude', 'gemini', 'openai']
+        platforms_with_upload = ["claude", "gemini", "openai"]
 
         for platform in platforms_with_upload:
             adaptor = get_adaptor(platform)
             package_path = adaptor.package(self.skill_dir, self.output_dir)
 
             # Try upload without API key
-            result = adaptor.upload(package_path, '')
+            result = adaptor.upload(package_path, "")
 
             # Should fail
-            self.assertFalse(result['success'],
-                           f"{platform} should fail without API key")
-            self.assertIsNone(result['skill_id'])
-            self.assertIn('message', result)
+            self.assertFalse(result["success"], f"{platform} should fail without API key")
+            self.assertIsNone(result["skill_id"])
+            self.assertIn("message", result)
 
     def test_e2e_markdown_no_upload_support(self):
         """Test that markdown adaptor doesn't support upload"""
-        adaptor = get_adaptor('markdown')
+        adaptor = get_adaptor("markdown")
         package_path = adaptor.package(self.skill_dir, self.output_dir)
 
         # Try upload (should return informative message)
-        result = adaptor.upload(package_path, 'not-used')
+        result = adaptor.upload(package_path, "not-used")
 
         # Should indicate no upload support
-        self.assertFalse(result['success'])
-        self.assertIsNone(result['skill_id'])
-        self.assertIn('not support', result['message'].lower())
+        self.assertFalse(result["success"])
+        self.assertIsNone(result["skill_id"])
+        self.assertIn("not support", result["message"].lower())
         # URL should point to local file
-        self.assertIn(str(package_path.absolute()), result['url'])
+        self.assertIn(str(package_path.absolute()), result["url"])
 
 
 class TestAdaptorsWorkflowIntegration(unittest.TestCase):
@@ -459,7 +442,7 @@ class TestAdaptorsWorkflowIntegration(unittest.TestCase):
 
             # Export to all platforms
             packages = {}
-            for platform in ['claude', 'gemini', 'openai', 'markdown']:
+            for platform in ["claude", "gemini", "openai", "markdown"]:
                 adaptor = get_adaptor(platform)
                 package_path = adaptor.package(skill_dir, output_dir)
                 packages[platform] = package_path
@@ -479,31 +462,30 @@ class TestAdaptorsWorkflowIntegration(unittest.TestCase):
             # Test custom output paths
             custom_output = Path(temp_dir) / "custom" / "my-package.zip"
 
-            adaptor = get_adaptor('claude')
+            adaptor = get_adaptor("claude")
             package_path = adaptor.package(skill_dir, custom_output)
 
             # Should respect custom path
             self.assertTrue(package_path.exists())
-            self.assertTrue('my-package' in package_path.name or package_path.parent.name == 'custom')
+            self.assertTrue("my-package" in package_path.name or package_path.parent.name == "custom")
 
     def test_workflow_api_key_validation(self):
         """Test API key validation for each platform"""
         test_cases = [
-            ('claude', 'sk-ant-test123', True),
-            ('claude', 'invalid-key', False),
-            ('gemini', 'AIzaSyTest123', True),
-            ('gemini', 'sk-ant-test', False),
-            ('openai', 'sk-proj-test123', True),
-            ('openai', 'sk-test123', True),
-            ('openai', 'AIzaSy123', False),
-            ('markdown', 'any-key', False),  # Never uses keys
+            ("claude", "sk-ant-test123", True),
+            ("claude", "invalid-key", False),
+            ("gemini", "AIzaSyTest123", True),
+            ("gemini", "sk-ant-test", False),
+            ("openai", "sk-proj-test123", True),
+            ("openai", "sk-test123", True),
+            ("openai", "AIzaSy123", False),
+            ("markdown", "any-key", False),  # Never uses keys
         ]
 
         for platform, api_key, expected in test_cases:
             adaptor = get_adaptor(platform)
             result = adaptor.validate_api_key(api_key)
-            self.assertEqual(result, expected,
-                           f"{platform}: validate_api_key('{api_key}') should be {expected}")
+            self.assertEqual(result, expected, f"{platform}: validate_api_key('{api_key}') should be {expected}")
 
 
 class TestAdaptorsErrorHandling(unittest.TestCase):
@@ -520,7 +502,7 @@ class TestAdaptorsErrorHandling(unittest.TestCase):
             output_dir.mkdir()
 
             # Should handle gracefully (may create package but with empty content)
-            for platform in ['claude', 'gemini', 'openai', 'markdown']:
+            for platform in ["claude", "gemini", "openai", "markdown"]:
                 adaptor = get_adaptor(platform)
                 # Should not crash
                 try:
@@ -529,27 +511,27 @@ class TestAdaptorsErrorHandling(unittest.TestCase):
                     self.assertTrue(package_path.exists())
                 except Exception as e:
                     # If it raises, should be clear error
-                    self.assertIn('SKILL.md', str(e).lower() or 'reference' in str(e).lower())
+                    self.assertIn("SKILL.md", str(e).lower() or "reference" in str(e).lower())
 
     def test_error_upload_nonexistent_file(self):
         """Test upload with nonexistent file"""
-        for platform in ['claude', 'gemini', 'openai']:
+        for platform in ["claude", "gemini", "openai"]:
             adaptor = get_adaptor(platform)
-            result = adaptor.upload(Path('/nonexistent/file.zip'), 'test-key')
+            result = adaptor.upload(Path("/nonexistent/file.zip"), "test-key")
 
-            self.assertFalse(result['success'])
-            self.assertIn('not found', result['message'].lower())
+            self.assertFalse(result["success"])
+            self.assertIn("not found", result["message"].lower())
 
     def test_error_upload_wrong_format(self):
         """Test upload with wrong file format"""
-        with tempfile.NamedTemporaryFile(suffix='.txt') as tmp:
+        with tempfile.NamedTemporaryFile(suffix=".txt") as tmp:
             # Try uploading .txt file
-            for platform in ['claude', 'gemini', 'openai']:
+            for platform in ["claude", "gemini", "openai"]:
                 adaptor = get_adaptor(platform)
-                result = adaptor.upload(Path(tmp.name), 'test-key')
+                result = adaptor.upload(Path(tmp.name), "test-key")
 
-                self.assertFalse(result['success'])
+                self.assertFalse(result["success"])
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_adaptors/test_base.py b/tests/test_adaptors/test_base.py
index d91eab3..b8751c8 100644
--- a/tests/test_adaptors/test_base.py
+++ b/tests/test_adaptors/test_base.py
@@ -4,15 +4,13 @@ Tests for base adaptor and registry
 """
 
 import unittest
-from pathlib import Path
 
 from skill_seekers.cli.adaptors import (
-    get_adaptor,
-    list_platforms,
-    is_platform_available,
     SkillAdaptor,
     SkillMetadata,
-    ADAPTORS
+    get_adaptor,
+    is_platform_available,
+    list_platforms,
 )
 
 
@@ -21,10 +19,7 @@ class TestSkillMetadata(unittest.TestCase):
 
     def test_basic_metadata(self):
         """Test basic metadata creation"""
-        metadata = SkillMetadata(
-            name="test-skill",
-            description="Test skill description"
-        )
+        metadata = SkillMetadata(name="test-skill", description="Test skill description")
 
         self.assertEqual(metadata.name, "test-skill")
         self.assertEqual(metadata.description, "Test skill description")
@@ -39,7 +34,7 @@ class TestSkillMetadata(unittest.TestCase):
             description="React documentation",
             version="2.5.0",
             author="Test Author",
-            tags=["react", "javascript", "web"]
+            tags=["react", "javascript", "web"],
         )
 
         self.assertEqual(metadata.name, "react")
@@ -58,37 +53,37 @@ class TestAdaptorRegistry(unittest.TestCase):
 
         self.assertIsInstance(platforms, list)
         # Claude should always be available
-        self.assertIn('claude', platforms)
+        self.assertIn("claude", platforms)
 
     def test_is_platform_available(self):
         """Test checking platform availability"""
         # Claude should be available
-        self.assertTrue(is_platform_available('claude'))
+        self.assertTrue(is_platform_available("claude"))
 
         # Unknown platform should not be available
-        self.assertFalse(is_platform_available('unknown_platform'))
+        self.assertFalse(is_platform_available("unknown_platform"))
 
     def test_get_adaptor_claude(self):
         """Test getting Claude adaptor"""
-        adaptor = get_adaptor('claude')
+        adaptor = get_adaptor("claude")
 
         self.assertIsInstance(adaptor, SkillAdaptor)
-        self.assertEqual(adaptor.PLATFORM, 'claude')
-        self.assertEqual(adaptor.PLATFORM_NAME, 'Claude AI (Anthropic)')
+        self.assertEqual(adaptor.PLATFORM, "claude")
+        self.assertEqual(adaptor.PLATFORM_NAME, "Claude AI (Anthropic)")
 
     def test_get_adaptor_invalid(self):
         """Test getting invalid adaptor raises error"""
         with self.assertRaises(ValueError) as ctx:
-            get_adaptor('invalid_platform')
+            get_adaptor("invalid_platform")
 
         error_msg = str(ctx.exception)
-        self.assertIn('invalid_platform', error_msg)
-        self.assertIn('not supported', error_msg)
+        self.assertIn("invalid_platform", error_msg)
+        self.assertIn("not supported", error_msg)
 
     def test_get_adaptor_with_config(self):
         """Test getting adaptor with custom config"""
-        config = {'custom_setting': 'value'}
-        adaptor = get_adaptor('claude', config)
+        config = {"custom_setting": "value"}
+        adaptor = get_adaptor("claude", config)
 
         self.assertEqual(adaptor.config, config)
 
@@ -98,19 +93,19 @@ class TestBaseAdaptorInterface(unittest.TestCase):
 
     def setUp(self):
         """Set up test adaptor"""
-        self.adaptor = get_adaptor('claude')
+        self.adaptor = get_adaptor("claude")
 
     def test_validate_api_key_default(self):
         """Test default API key validation"""
         # Claude adaptor overrides this
-        self.assertTrue(self.adaptor.validate_api_key('sk-ant-test123'))
-        self.assertFalse(self.adaptor.validate_api_key('invalid'))
+        self.assertTrue(self.adaptor.validate_api_key("sk-ant-test123"))
+        self.assertFalse(self.adaptor.validate_api_key("invalid"))
 
     def test_get_env_var_name(self):
         """Test environment variable name"""
         env_var = self.adaptor.get_env_var_name()
 
-        self.assertEqual(env_var, 'ANTHROPIC_API_KEY')
+        self.assertEqual(env_var, "ANTHROPIC_API_KEY")
 
     def test_supports_enhancement(self):
         """Test enhancement support check"""
@@ -118,5 +113,5 @@ class TestBaseAdaptorInterface(unittest.TestCase):
         self.assertTrue(self.adaptor.supports_enhancement())
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_adaptors/test_claude_adaptor.py b/tests/test_adaptors/test_claude_adaptor.py
index 840c906..8db0568 100644
--- a/tests/test_adaptors/test_claude_adaptor.py
+++ b/tests/test_adaptors/test_claude_adaptor.py
@@ -3,12 +3,11 @@
 Tests for Claude adaptor (refactored from existing code)
 """
 
-import unittest
-from unittest.mock import patch, MagicMock, mock_open
-from pathlib import Path
 import tempfile
+import unittest
 import zipfile
-import json
+from pathlib import Path
+from unittest.mock import MagicMock, patch
 
 from skill_seekers.cli.adaptors import get_adaptor
 from skill_seekers.cli.adaptors.base import SkillMetadata
@@ -19,32 +18,32 @@ class TestClaudeAdaptor(unittest.TestCase):
 
     def setUp(self):
         """Set up test adaptor"""
-        self.adaptor = get_adaptor('claude')
+        self.adaptor = get_adaptor("claude")
 
     def test_platform_info(self):
         """Test platform identifiers"""
-        self.assertEqual(self.adaptor.PLATFORM, 'claude')
-        self.assertIn('Claude', self.adaptor.PLATFORM_NAME)
+        self.assertEqual(self.adaptor.PLATFORM, "claude")
+        self.assertIn("Claude", self.adaptor.PLATFORM_NAME)
         self.assertIsNotNone(self.adaptor.DEFAULT_API_ENDPOINT)
-        self.assertIn('anthropic.com', self.adaptor.DEFAULT_API_ENDPOINT)
+        self.assertIn("anthropic.com", self.adaptor.DEFAULT_API_ENDPOINT)
 
     def test_validate_api_key_valid(self):
         """Test valid Claude API keys"""
-        self.assertTrue(self.adaptor.validate_api_key('sk-ant-abc123'))
-        self.assertTrue(self.adaptor.validate_api_key('sk-ant-api03-test'))
-        self.assertTrue(self.adaptor.validate_api_key('  sk-ant-test  '))  # with whitespace
+        self.assertTrue(self.adaptor.validate_api_key("sk-ant-abc123"))
+        self.assertTrue(self.adaptor.validate_api_key("sk-ant-api03-test"))
+        self.assertTrue(self.adaptor.validate_api_key("  sk-ant-test  "))  # with whitespace
 
     def test_validate_api_key_invalid(self):
         """Test invalid API keys"""
-        self.assertFalse(self.adaptor.validate_api_key('AIzaSyABC123'))  # Gemini key
-        self.assertFalse(self.adaptor.validate_api_key('sk-proj-123'))  # OpenAI key (proj)
-        self.assertFalse(self.adaptor.validate_api_key('invalid'))
-        self.assertFalse(self.adaptor.validate_api_key(''))
-        self.assertFalse(self.adaptor.validate_api_key('sk-test'))  # Missing 'ant'
+        self.assertFalse(self.adaptor.validate_api_key("AIzaSyABC123"))  # Gemini key
+        self.assertFalse(self.adaptor.validate_api_key("sk-proj-123"))  # OpenAI key (proj)
+        self.assertFalse(self.adaptor.validate_api_key("invalid"))
+        self.assertFalse(self.adaptor.validate_api_key(""))
+        self.assertFalse(self.adaptor.validate_api_key("sk-test"))  # Missing 'ant'
 
     def test_get_env_var_name(self):
         """Test environment variable name"""
-        self.assertEqual(self.adaptor.get_env_var_name(), 'ANTHROPIC_API_KEY')
+        self.assertEqual(self.adaptor.get_env_var_name(), "ANTHROPIC_API_KEY")
 
     def test_supports_enhancement(self):
         """Test enhancement support"""
@@ -59,22 +58,18 @@ class TestClaudeAdaptor(unittest.TestCase):
             (skill_dir / "references").mkdir()
             (skill_dir / "references" / "test.md").write_text("# Test content")
 
-            metadata = SkillMetadata(
-                name="test-skill",
-                description="Test skill description",
-                version="1.0.0"
-            )
+            metadata = SkillMetadata(name="test-skill", description="Test skill description", version="1.0.0")
 
             formatted = self.adaptor.format_skill_md(skill_dir, metadata)
 
             # Should start with YAML frontmatter
-            self.assertTrue(formatted.startswith('---'))
+            self.assertTrue(formatted.startswith("---"))
             # Should contain metadata fields
-            self.assertIn('name:', formatted)
-            self.assertIn('description:', formatted)
-            self.assertIn('version:', formatted)
+            self.assertIn("name:", formatted)
+            self.assertIn("description:", formatted)
+            self.assertIn("version:", formatted)
             # Should have closing delimiter
-            self.assertTrue('---' in formatted[3:])  # Second occurrence
+            self.assertTrue("---" in formatted[3:])  # Second occurrence
 
     def test_format_skill_md_with_existing_content(self):
         """Test that existing SKILL.md content is preserved"""
@@ -93,16 +88,13 @@ This is existing skill content that should be preserved.
             (skill_dir / "SKILL.md").write_text(existing_content)
             (skill_dir / "references").mkdir()
 
-            metadata = SkillMetadata(
-                name="test-skill",
-                description="Test description"
-            )
+            metadata = SkillMetadata(name="test-skill", description="Test description")
 
             formatted = self.adaptor.format_skill_md(skill_dir, metadata)
 
             # Should contain existing content
-            self.assertIn('Existing Documentation', formatted)
-            self.assertIn('Feature 1', formatted)
+            self.assertIn("Existing Documentation", formatted)
+            self.assertIn("Feature 1", formatted)
 
     def test_package_creates_zip(self):
         """Test that package creates ZIP file with correct structure"""
@@ -125,15 +117,15 @@ This is existing skill content that should be preserved.
 
             # Verify package was created
             self.assertTrue(package_path.exists())
-            self.assertTrue(str(package_path).endswith('.zip'))
+            self.assertTrue(str(package_path).endswith(".zip"))
             # Should NOT have platform suffix (Claude is default)
-            self.assertEqual(package_path.name, 'test-skill.zip')
+            self.assertEqual(package_path.name, "test-skill.zip")
 
             # Verify package contents
-            with zipfile.ZipFile(package_path, 'r') as zf:
+            with zipfile.ZipFile(package_path, "r") as zf:
                 names = zf.namelist()
-                self.assertIn('SKILL.md', names)
-                self.assertTrue(any('references/' in name for name in names))
+                self.assertIn("SKILL.md", names)
+                self.assertTrue(any("references/" in name for name in names))
 
     def test_package_excludes_backup_files(self):
         """Test that backup files are excluded from package"""
@@ -152,62 +144,62 @@ This is existing skill content that should be preserved.
             package_path = self.adaptor.package(skill_dir, output_dir)
 
             # Verify backup is excluded
-            with zipfile.ZipFile(package_path, 'r') as zf:
+            with zipfile.ZipFile(package_path, "r") as zf:
                 names = zf.namelist()
-                self.assertNotIn('SKILL.md.backup', names)
+                self.assertNotIn("SKILL.md.backup", names)
 
-    @patch('requests.post')
+    @patch("requests.post")
     def test_upload_success(self, mock_post):
         """Test successful upload to Claude"""
-        with tempfile.NamedTemporaryFile(suffix='.zip') as tmp:
+        with tempfile.NamedTemporaryFile(suffix=".zip") as tmp:
             # Mock successful response
             mock_response = MagicMock()
             mock_response.status_code = 200
-            mock_response.json.return_value = {'id': 'skill_abc123'}
+            mock_response.json.return_value = {"id": "skill_abc123"}
             mock_post.return_value = mock_response
 
-            result = self.adaptor.upload(Path(tmp.name), 'sk-ant-test123')
+            result = self.adaptor.upload(Path(tmp.name), "sk-ant-test123")
 
-            self.assertTrue(result['success'])
-            self.assertEqual(result['skill_id'], 'skill_abc123')
-            self.assertIn('claude.ai', result['url'])
+            self.assertTrue(result["success"])
+            self.assertEqual(result["skill_id"], "skill_abc123")
+            self.assertIn("claude.ai", result["url"])
 
             # Verify correct API call
             mock_post.assert_called_once()
             call_args = mock_post.call_args
-            self.assertIn('anthropic.com', call_args[0][0])
-            self.assertEqual(call_args[1]['headers']['x-api-key'], 'sk-ant-test123')
+            self.assertIn("anthropic.com", call_args[0][0])
+            self.assertEqual(call_args[1]["headers"]["x-api-key"], "sk-ant-test123")
 
-    @patch('requests.post')
+    @patch("requests.post")
     def test_upload_failure(self, mock_post):
         """Test failed upload to Claude"""
-        with tempfile.NamedTemporaryFile(suffix='.zip') as tmp:
+        with tempfile.NamedTemporaryFile(suffix=".zip") as tmp:
             # Mock failed response
             mock_response = MagicMock()
             mock_response.status_code = 400
-            mock_response.text = 'Invalid skill format'
+            mock_response.text = "Invalid skill format"
             mock_post.return_value = mock_response
 
-            result = self.adaptor.upload(Path(tmp.name), 'sk-ant-test123')
+            result = self.adaptor.upload(Path(tmp.name), "sk-ant-test123")
 
-            self.assertFalse(result['success'])
-            self.assertIsNone(result['skill_id'])
-            self.assertIn('Invalid skill format', result['message'])
+            self.assertFalse(result["success"])
+            self.assertIsNone(result["skill_id"])
+            self.assertIn("Invalid skill format", result["message"])
 
     def test_upload_invalid_file(self):
         """Test upload with invalid file"""
-        result = self.adaptor.upload(Path('/nonexistent/file.zip'), 'sk-ant-test123')
+        result = self.adaptor.upload(Path("/nonexistent/file.zip"), "sk-ant-test123")
 
-        self.assertFalse(result['success'])
-        self.assertIn('not found', result['message'].lower())
+        self.assertFalse(result["success"])
+        self.assertIn("not found", result["message"].lower())
 
     def test_upload_wrong_format(self):
         """Test upload with wrong file format"""
-        with tempfile.NamedTemporaryFile(suffix='.tar.gz') as tmp:
-            result = self.adaptor.upload(Path(tmp.name), 'sk-ant-test123')
+        with tempfile.NamedTemporaryFile(suffix=".tar.gz") as tmp:
+            result = self.adaptor.upload(Path(tmp.name), "sk-ant-test123")
 
-            self.assertFalse(result['success'])
-            self.assertIn('not a zip', result['message'].lower())
+            self.assertFalse(result["success"])
+            self.assertIn("not a zip", result["message"].lower())
 
     @unittest.skip("Complex mocking - integration test needed with real API")
     def test_enhance_success(self):
@@ -229,7 +221,7 @@ This is existing skill content that should be preserved.
 
             self.assertTrue(package_path.exists())
             # Should respect custom naming if provided
-            self.assertTrue('my-package' in package_path.name or package_path.parent.name == 'custom')
+            self.assertTrue("my-package" in package_path.name or package_path.parent.name == "custom")
 
     def test_package_to_directory(self):
         """Test packaging to directory (should auto-name)"""
@@ -246,7 +238,7 @@ This is existing skill content that should be preserved.
             package_path = self.adaptor.package(skill_dir, output_dir)
 
             self.assertTrue(package_path.exists())
-            self.assertEqual(package_path.name, 'react.zip')
+            self.assertEqual(package_path.name, "react.zip")
             self.assertEqual(package_path.parent, output_dir)
 
 
@@ -255,7 +247,7 @@ class TestClaudeAdaptorEdgeCases(unittest.TestCase):
 
     def setUp(self):
         """Set up test adaptor"""
-        self.adaptor = get_adaptor('claude')
+        self.adaptor = get_adaptor("claude")
 
     def test_format_with_minimal_metadata(self):
         """Test formatting with only required metadata fields"""
@@ -265,15 +257,15 @@ class TestClaudeAdaptorEdgeCases(unittest.TestCase):
 
             metadata = SkillMetadata(
                 name="minimal",
-                description="Minimal skill"
+                description="Minimal skill",
                 # No version, author, tags
             )
 
             formatted = self.adaptor.format_skill_md(skill_dir, metadata)
 
             # Should still create valid output
-            self.assertIn('---', formatted)
-            self.assertIn('minimal', formatted)
+            self.assertIn("---", formatted)
+            self.assertIn("minimal", formatted)
 
     def test_format_with_special_characters_in_name(self):
         """Test formatting with special characters in skill name"""
@@ -281,42 +273,38 @@ class TestClaudeAdaptorEdgeCases(unittest.TestCase):
             skill_dir = Path(temp_dir)
             (skill_dir / "references").mkdir()
 
-            metadata = SkillMetadata(
-                name="test-skill_v2.0",
-                description="Skill with special chars"
-            )
+            metadata = SkillMetadata(name="test-skill_v2.0", description="Skill with special chars")
 
             formatted = self.adaptor.format_skill_md(skill_dir, metadata)
 
             # Should handle special characters
-            self.assertIn('test-skill_v2.0', formatted)
+            self.assertIn("test-skill_v2.0", formatted)
 
     def test_api_key_validation_edge_cases(self):
         """Test API key validation with edge cases"""
         # Empty string
-        self.assertFalse(self.adaptor.validate_api_key(''))
+        self.assertFalse(self.adaptor.validate_api_key(""))
 
         # Only whitespace
-        self.assertFalse(self.adaptor.validate_api_key('   '))
+        self.assertFalse(self.adaptor.validate_api_key("   "))
 
         # Correct prefix but very short
-        self.assertTrue(self.adaptor.validate_api_key('sk-ant-x'))
+        self.assertTrue(self.adaptor.validate_api_key("sk-ant-x"))
 
         # Case sensitive
-        self.assertFalse(self.adaptor.validate_api_key('SK-ANT-TEST'))
+        self.assertFalse(self.adaptor.validate_api_key("SK-ANT-TEST"))
 
     def test_upload_with_network_error(self):
         """Test upload with network errors"""
-        with tempfile.NamedTemporaryFile(suffix='.zip') as tmp:
-            with patch('requests.post') as mock_post:
-                # Simulate network error
-                mock_post.side_effect = Exception("Network error")
+        with tempfile.NamedTemporaryFile(suffix=".zip") as tmp, patch("requests.post") as mock_post:
+            # Simulate network error
+            mock_post.side_effect = Exception("Network error")
 
-                result = self.adaptor.upload(Path(tmp.name), 'sk-ant-test')
+            result = self.adaptor.upload(Path(tmp.name), "sk-ant-test")
 
-                self.assertFalse(result['success'])
-                self.assertIn('Network error', result['message'])
+            self.assertFalse(result["success"])
+            self.assertIn("Network error", result["message"])
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_adaptors/test_gemini_adaptor.py b/tests/test_adaptors/test_gemini_adaptor.py
index ead70e7..8b2451e 100644
--- a/tests/test_adaptors/test_gemini_adaptor.py
+++ b/tests/test_adaptors/test_gemini_adaptor.py
@@ -3,11 +3,10 @@
 Tests for Gemini adaptor
 """
 
-import unittest
-from unittest.mock import patch, MagicMock, mock_open
-from pathlib import Path
-import tempfile
 import tarfile
+import tempfile
+import unittest
+from pathlib import Path
 
 from skill_seekers.cli.adaptors import get_adaptor
 from skill_seekers.cli.adaptors.base import SkillMetadata
@@ -18,28 +17,28 @@ class TestGeminiAdaptor(unittest.TestCase):
 
     def setUp(self):
         """Set up test adaptor"""
-        self.adaptor = get_adaptor('gemini')
+        self.adaptor = get_adaptor("gemini")
 
     def test_platform_info(self):
         """Test platform identifiers"""
-        self.assertEqual(self.adaptor.PLATFORM, 'gemini')
-        self.assertEqual(self.adaptor.PLATFORM_NAME, 'Google Gemini')
+        self.assertEqual(self.adaptor.PLATFORM, "gemini")
+        self.assertEqual(self.adaptor.PLATFORM_NAME, "Google Gemini")
         self.assertIsNotNone(self.adaptor.DEFAULT_API_ENDPOINT)
 
     def test_validate_api_key_valid(self):
         """Test valid Google API key"""
-        self.assertTrue(self.adaptor.validate_api_key('AIzaSyABC123'))
-        self.assertTrue(self.adaptor.validate_api_key('  AIzaSyTest  '))  # with whitespace
+        self.assertTrue(self.adaptor.validate_api_key("AIzaSyABC123"))
+        self.assertTrue(self.adaptor.validate_api_key("  AIzaSyTest  "))  # with whitespace
 
     def test_validate_api_key_invalid(self):
         """Test invalid API keys"""
-        self.assertFalse(self.adaptor.validate_api_key('sk-ant-123'))  # Claude key
-        self.assertFalse(self.adaptor.validate_api_key('invalid'))
-        self.assertFalse(self.adaptor.validate_api_key(''))
+        self.assertFalse(self.adaptor.validate_api_key("sk-ant-123"))  # Claude key
+        self.assertFalse(self.adaptor.validate_api_key("invalid"))
+        self.assertFalse(self.adaptor.validate_api_key(""))
 
     def test_get_env_var_name(self):
         """Test environment variable name"""
-        self.assertEqual(self.adaptor.get_env_var_name(), 'GOOGLE_API_KEY')
+        self.assertEqual(self.adaptor.get_env_var_name(), "GOOGLE_API_KEY")
 
     def test_supports_enhancement(self):
         """Test enhancement support"""
@@ -54,18 +53,15 @@ class TestGeminiAdaptor(unittest.TestCase):
             (skill_dir / "references").mkdir()
             (skill_dir / "references" / "test.md").write_text("# Test content")
 
-            metadata = SkillMetadata(
-                name="test-skill",
-                description="Test skill description"
-            )
+            metadata = SkillMetadata(name="test-skill", description="Test skill description")
 
             formatted = self.adaptor.format_skill_md(skill_dir, metadata)
 
             # Should NOT start with YAML frontmatter
-            self.assertFalse(formatted.startswith('---'))
+            self.assertFalse(formatted.startswith("---"))
             # Should contain the content
-            self.assertIn('test-skill', formatted.lower())
-            self.assertIn('Test skill description', formatted)
+            self.assertIn("test-skill", formatted.lower())
+            self.assertIn("Test skill description", formatted)
 
     def test_package_creates_targz(self):
         """Test that package creates tar.gz file"""
@@ -86,16 +82,16 @@ class TestGeminiAdaptor(unittest.TestCase):
 
             # Verify package was created
             self.assertTrue(package_path.exists())
-            self.assertTrue(str(package_path).endswith('.tar.gz'))
-            self.assertIn('gemini', package_path.name)
+            self.assertTrue(str(package_path).endswith(".tar.gz"))
+            self.assertIn("gemini", package_path.name)
 
             # Verify package contents
-            with tarfile.open(package_path, 'r:gz') as tar:
+            with tarfile.open(package_path, "r:gz") as tar:
                 names = tar.getnames()
-                self.assertIn('system_instructions.md', names)
-                self.assertIn('gemini_metadata.json', names)
+                self.assertIn("system_instructions.md", names)
+                self.assertIn("gemini_metadata.json", names)
                 # Should have references
-                self.assertTrue(any('references' in name for name in names))
+                self.assertTrue(any("references" in name for name in names))
 
     @unittest.skip("Complex mocking - integration test needed with real API")
     def test_upload_success(self):
@@ -104,28 +100,28 @@ class TestGeminiAdaptor(unittest.TestCase):
 
     def test_upload_missing_library(self):
         """Test upload when google-generativeai is not installed"""
-        with tempfile.NamedTemporaryFile(suffix='.tar.gz') as tmp:
+        with tempfile.NamedTemporaryFile(suffix=".tar.gz") as tmp:
             # Simulate missing library by not mocking it
-            result = self.adaptor.upload(Path(tmp.name), 'AIzaSyTest')
+            result = self.adaptor.upload(Path(tmp.name), "AIzaSyTest")
 
-            self.assertFalse(result['success'])
-            self.assertIn('google-generativeai', result['message'])
-            self.assertIn('not installed', result['message'])
+            self.assertFalse(result["success"])
+            self.assertIn("google-generativeai", result["message"])
+            self.assertIn("not installed", result["message"])
 
     def test_upload_invalid_file(self):
         """Test upload with invalid file"""
-        result = self.adaptor.upload(Path('/nonexistent/file.tar.gz'), 'AIzaSyTest')
+        result = self.adaptor.upload(Path("/nonexistent/file.tar.gz"), "AIzaSyTest")
 
-        self.assertFalse(result['success'])
-        self.assertIn('not found', result['message'].lower())
+        self.assertFalse(result["success"])
+        self.assertIn("not found", result["message"].lower())
 
     def test_upload_wrong_format(self):
         """Test upload with wrong file format"""
-        with tempfile.NamedTemporaryFile(suffix='.zip') as tmp:
-            result = self.adaptor.upload(Path(tmp.name), 'AIzaSyTest')
+        with tempfile.NamedTemporaryFile(suffix=".zip") as tmp:
+            result = self.adaptor.upload(Path(tmp.name), "AIzaSyTest")
 
-            self.assertFalse(result['success'])
-            self.assertIn('not a tar.gz', result['message'].lower())
+            self.assertFalse(result["success"])
+            self.assertIn("not a tar.gz", result["message"].lower())
 
     @unittest.skip("Complex mocking - integration test needed with real API")
     def test_enhance_success(self):
@@ -141,10 +137,10 @@ class TestGeminiAdaptor(unittest.TestCase):
             (refs_dir / "test.md").write_text("Test")
 
             # Don't mock the module - it won't be available
-            success = self.adaptor.enhance(skill_dir, 'AIzaSyTest')
+            success = self.adaptor.enhance(skill_dir, "AIzaSyTest")
 
             self.assertFalse(success)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_adaptors/test_markdown_adaptor.py b/tests/test_adaptors/test_markdown_adaptor.py
index cec9207..a6288b7 100644
--- a/tests/test_adaptors/test_markdown_adaptor.py
+++ b/tests/test_adaptors/test_markdown_adaptor.py
@@ -3,10 +3,10 @@
 Tests for Markdown adaptor
 """
 
-import unittest
-from pathlib import Path
 import tempfile
+import unittest
 import zipfile
+from pathlib import Path
 
 from skill_seekers.cli.adaptors import get_adaptor
 from skill_seekers.cli.adaptors.base import SkillMetadata
@@ -17,25 +17,25 @@ class TestMarkdownAdaptor(unittest.TestCase):
 
     def setUp(self):
         """Set up test adaptor"""
-        self.adaptor = get_adaptor('markdown')
+        self.adaptor = get_adaptor("markdown")
 
     def test_platform_info(self):
         """Test platform identifiers"""
-        self.assertEqual(self.adaptor.PLATFORM, 'markdown')
-        self.assertEqual(self.adaptor.PLATFORM_NAME, 'Generic Markdown (Universal)')
+        self.assertEqual(self.adaptor.PLATFORM, "markdown")
+        self.assertEqual(self.adaptor.PLATFORM_NAME, "Generic Markdown (Universal)")
         self.assertIsNone(self.adaptor.DEFAULT_API_ENDPOINT)
 
     def test_validate_api_key(self):
         """Test that markdown export doesn't use API keys"""
         # Any key should return False (no keys needed)
-        self.assertFalse(self.adaptor.validate_api_key('sk-ant-123'))
-        self.assertFalse(self.adaptor.validate_api_key('AIzaSyABC123'))
-        self.assertFalse(self.adaptor.validate_api_key('any-key'))
-        self.assertFalse(self.adaptor.validate_api_key(''))
+        self.assertFalse(self.adaptor.validate_api_key("sk-ant-123"))
+        self.assertFalse(self.adaptor.validate_api_key("AIzaSyABC123"))
+        self.assertFalse(self.adaptor.validate_api_key("any-key"))
+        self.assertFalse(self.adaptor.validate_api_key(""))
 
     def test_get_env_var_name(self):
         """Test environment variable name"""
-        self.assertEqual(self.adaptor.get_env_var_name(), '')
+        self.assertEqual(self.adaptor.get_env_var_name(), "")
 
     def test_supports_enhancement(self):
         """Test enhancement support"""
@@ -49,7 +49,7 @@ class TestMarkdownAdaptor(unittest.TestCase):
             refs_dir.mkdir()
             (refs_dir / "test.md").write_text("Test content")
 
-            success = self.adaptor.enhance(skill_dir, 'not-used')
+            success = self.adaptor.enhance(skill_dir, "not-used")
             self.assertFalse(success)
 
     def test_format_skill_md_no_frontmatter(self):
@@ -61,18 +61,15 @@ class TestMarkdownAdaptor(unittest.TestCase):
             (skill_dir / "references").mkdir()
             (skill_dir / "references" / "test.md").write_text("# Test content")
 
-            metadata = SkillMetadata(
-                name="test-skill",
-                description="Test skill description"
-            )
+            metadata = SkillMetadata(name="test-skill", description="Test skill description")
 
             formatted = self.adaptor.format_skill_md(skill_dir, metadata)
 
             # Should NOT start with YAML frontmatter
-            self.assertFalse(formatted.startswith('---'))
+            self.assertFalse(formatted.startswith("---"))
             # Should contain the skill name and description
-            self.assertIn('test-skill', formatted.lower())
-            self.assertIn('Test skill description', formatted)
+            self.assertIn("test-skill", formatted.lower())
+            self.assertIn("Test skill description", formatted)
 
     def test_package_creates_zip(self):
         """Test that package creates ZIP file with correct structure"""
@@ -94,25 +91,25 @@ class TestMarkdownAdaptor(unittest.TestCase):
 
             # Verify package was created
             self.assertTrue(package_path.exists())
-            self.assertTrue(str(package_path).endswith('.zip'))
-            self.assertIn('markdown', package_path.name)
+            self.assertTrue(str(package_path).endswith(".zip"))
+            self.assertIn("markdown", package_path.name)
 
             # Verify package contents
-            with zipfile.ZipFile(package_path, 'r') as zf:
+            with zipfile.ZipFile(package_path, "r") as zf:
                 names = zf.namelist()
 
                 # Should have README.md (from SKILL.md)
-                self.assertIn('README.md', names)
+                self.assertIn("README.md", names)
 
                 # Should have metadata.json
-                self.assertIn('metadata.json', names)
+                self.assertIn("metadata.json", names)
 
                 # Should have DOCUMENTATION.md (combined)
-                self.assertIn('DOCUMENTATION.md', names)
+                self.assertIn("DOCUMENTATION.md", names)
 
                 # Should have reference files
-                self.assertIn('references/guide.md', names)
-                self.assertIn('references/api.md', names)
+                self.assertIn("references/guide.md", names)
+                self.assertIn("references/api.md", names)
 
     def test_package_readme_content(self):
         """Test that README.md contains SKILL.md content"""
@@ -130,8 +127,8 @@ class TestMarkdownAdaptor(unittest.TestCase):
             package_path = self.adaptor.package(skill_dir, output_dir)
 
             # Verify README.md content
-            with zipfile.ZipFile(package_path, 'r') as zf:
-                readme_content = zf.read('README.md').decode('utf-8')
+            with zipfile.ZipFile(package_path, "r") as zf:
+                readme_content = zf.read("README.md").decode("utf-8")
                 self.assertEqual(readme_content, skill_md_content)
 
     def test_package_combined_documentation(self):
@@ -155,18 +152,18 @@ class TestMarkdownAdaptor(unittest.TestCase):
             package_path = self.adaptor.package(skill_dir, output_dir)
 
             # Verify DOCUMENTATION.md contains combined content
-            with zipfile.ZipFile(package_path, 'r') as zf:
-                doc_content = zf.read('DOCUMENTATION.md').decode('utf-8')
+            with zipfile.ZipFile(package_path, "r") as zf:
+                doc_content = zf.read("DOCUMENTATION.md").decode("utf-8")
 
                 # Should contain main skill content
-                self.assertIn('Main Skill', doc_content)
+                self.assertIn("Main Skill", doc_content)
 
                 # Should contain reference content
-                self.assertIn('Guide Content', doc_content)
-                self.assertIn('API Content', doc_content)
+                self.assertIn("Guide Content", doc_content)
+                self.assertIn("API Content", doc_content)
 
                 # Should have separators
-                self.assertIn('---', doc_content)
+                self.assertIn("---", doc_content)
 
     def test_package_metadata(self):
         """Test that metadata.json is correct"""
@@ -183,26 +180,27 @@ class TestMarkdownAdaptor(unittest.TestCase):
             package_path = self.adaptor.package(skill_dir, output_dir)
 
             # Verify metadata
-            with zipfile.ZipFile(package_path, 'r') as zf:
+            with zipfile.ZipFile(package_path, "r") as zf:
                 import json
-                metadata_content = zf.read('metadata.json').decode('utf-8')
+
+                metadata_content = zf.read("metadata.json").decode("utf-8")
                 metadata = json.loads(metadata_content)
 
-                self.assertEqual(metadata['platform'], 'markdown')
-                self.assertEqual(metadata['name'], 'test-skill')
-                self.assertEqual(metadata['format'], 'universal_markdown')
-                self.assertIn('created_with', metadata)
+                self.assertEqual(metadata["platform"], "markdown")
+                self.assertEqual(metadata["name"], "test-skill")
+                self.assertEqual(metadata["format"], "universal_markdown")
+                self.assertIn("created_with", metadata)
 
     def test_upload_not_supported(self):
         """Test that upload returns appropriate message"""
-        with tempfile.NamedTemporaryFile(suffix='.zip') as tmp:
-            result = self.adaptor.upload(Path(tmp.name), 'not-used')
+        with tempfile.NamedTemporaryFile(suffix=".zip") as tmp:
+            result = self.adaptor.upload(Path(tmp.name), "not-used")
 
-            self.assertFalse(result['success'])
-            self.assertIsNone(result['skill_id'])
-            self.assertIn('not support', result['message'].lower())
+            self.assertFalse(result["success"])
+            self.assertIsNone(result["skill_id"])
+            self.assertIn("not support", result["message"].lower())
             # URL should point to local file
-            self.assertIn(tmp.name, result['url'])
+            self.assertIn(tmp.name, result["url"])
 
     def test_package_output_filename(self):
         """Test that package creates correct filename"""
@@ -219,10 +217,10 @@ class TestMarkdownAdaptor(unittest.TestCase):
             package_path = self.adaptor.package(skill_dir, output_dir)
 
             # Should include skill name and 'markdown' suffix
-            self.assertTrue(package_path.name.startswith('my-framework'))
-            self.assertIn('markdown', package_path.name)
-            self.assertTrue(package_path.name.endswith('.zip'))
+            self.assertTrue(package_path.name.startswith("my-framework"))
+            self.assertIn("markdown", package_path.name)
+            self.assertTrue(package_path.name.endswith(".zip"))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_adaptors/test_openai_adaptor.py b/tests/test_adaptors/test_openai_adaptor.py
index a7540ed..5bf04ea 100644
--- a/tests/test_adaptors/test_openai_adaptor.py
+++ b/tests/test_adaptors/test_openai_adaptor.py
@@ -3,11 +3,10 @@
 Tests for OpenAI adaptor
 """
 
-import unittest
-from unittest.mock import patch, MagicMock
-from pathlib import Path
 import tempfile
+import unittest
 import zipfile
+from pathlib import Path
 
 from skill_seekers.cli.adaptors import get_adaptor
 from skill_seekers.cli.adaptors.base import SkillMetadata
@@ -18,30 +17,30 @@ class TestOpenAIAdaptor(unittest.TestCase):
 
     def setUp(self):
         """Set up test adaptor"""
-        self.adaptor = get_adaptor('openai')
+        self.adaptor = get_adaptor("openai")
 
     def test_platform_info(self):
         """Test platform identifiers"""
-        self.assertEqual(self.adaptor.PLATFORM, 'openai')
-        self.assertEqual(self.adaptor.PLATFORM_NAME, 'OpenAI ChatGPT')
+        self.assertEqual(self.adaptor.PLATFORM, "openai")
+        self.assertEqual(self.adaptor.PLATFORM_NAME, "OpenAI ChatGPT")
         self.assertIsNotNone(self.adaptor.DEFAULT_API_ENDPOINT)
 
     def test_validate_api_key_valid(self):
         """Test valid OpenAI API keys"""
-        self.assertTrue(self.adaptor.validate_api_key('sk-proj-abc123'))
-        self.assertTrue(self.adaptor.validate_api_key('sk-abc123'))
-        self.assertTrue(self.adaptor.validate_api_key('  sk-test  '))  # with whitespace
+        self.assertTrue(self.adaptor.validate_api_key("sk-proj-abc123"))
+        self.assertTrue(self.adaptor.validate_api_key("sk-abc123"))
+        self.assertTrue(self.adaptor.validate_api_key("  sk-test  "))  # with whitespace
 
     def test_validate_api_key_invalid(self):
         """Test invalid API keys"""
-        self.assertFalse(self.adaptor.validate_api_key('AIzaSyABC123'))  # Gemini key
+        self.assertFalse(self.adaptor.validate_api_key("AIzaSyABC123"))  # Gemini key
         # Note: Can't distinguish Claude keys (sk-ant-*) from OpenAI keys (sk-*)
-        self.assertFalse(self.adaptor.validate_api_key('invalid'))
-        self.assertFalse(self.adaptor.validate_api_key(''))
+        self.assertFalse(self.adaptor.validate_api_key("invalid"))
+        self.assertFalse(self.adaptor.validate_api_key(""))
 
     def test_get_env_var_name(self):
         """Test environment variable name"""
-        self.assertEqual(self.adaptor.get_env_var_name(), 'OPENAI_API_KEY')
+        self.assertEqual(self.adaptor.get_env_var_name(), "OPENAI_API_KEY")
 
     def test_supports_enhancement(self):
         """Test enhancement support"""
@@ -56,19 +55,16 @@ class TestOpenAIAdaptor(unittest.TestCase):
             (skill_dir / "references").mkdir()
             (skill_dir / "references" / "test.md").write_text("# Test content")
 
-            metadata = SkillMetadata(
-                name="test-skill",
-                description="Test skill description"
-            )
+            metadata = SkillMetadata(name="test-skill", description="Test skill description")
 
             formatted = self.adaptor.format_skill_md(skill_dir, metadata)
 
             # Should NOT start with YAML frontmatter
-            self.assertFalse(formatted.startswith('---'))
+            self.assertFalse(formatted.startswith("---"))
             # Should contain assistant-style instructions
-            self.assertIn('You are an expert assistant', formatted)
-            self.assertIn('test-skill', formatted)
-            self.assertIn('Test skill description', formatted)
+            self.assertIn("You are an expert assistant", formatted)
+            self.assertIn("test-skill", formatted)
+            self.assertIn("Test skill description", formatted)
 
     def test_package_creates_zip(self):
         """Test that package creates ZIP file with correct structure"""
@@ -89,41 +85,41 @@ class TestOpenAIAdaptor(unittest.TestCase):
 
             # Verify package was created
             self.assertTrue(package_path.exists())
-            self.assertTrue(str(package_path).endswith('.zip'))
-            self.assertIn('openai', package_path.name)
+            self.assertTrue(str(package_path).endswith(".zip"))
+            self.assertIn("openai", package_path.name)
 
             # Verify package contents
-            with zipfile.ZipFile(package_path, 'r') as zf:
+            with zipfile.ZipFile(package_path, "r") as zf:
                 names = zf.namelist()
-                self.assertIn('assistant_instructions.txt', names)
-                self.assertIn('openai_metadata.json', names)
+                self.assertIn("assistant_instructions.txt", names)
+                self.assertIn("openai_metadata.json", names)
                 # Should have vector store files
-                self.assertTrue(any('vector_store_files' in name for name in names))
+                self.assertTrue(any("vector_store_files" in name for name in names))
 
     def test_upload_missing_library(self):
         """Test upload when openai library is not installed"""
-        with tempfile.NamedTemporaryFile(suffix='.zip') as tmp:
+        with tempfile.NamedTemporaryFile(suffix=".zip") as tmp:
             # Simulate missing library by not mocking it
-            result = self.adaptor.upload(Path(tmp.name), 'sk-test123')
+            result = self.adaptor.upload(Path(tmp.name), "sk-test123")
 
-            self.assertFalse(result['success'])
-            self.assertIn('openai', result['message'])
-            self.assertIn('not installed', result['message'])
+            self.assertFalse(result["success"])
+            self.assertIn("openai", result["message"])
+            self.assertIn("not installed", result["message"])
 
     def test_upload_invalid_file(self):
         """Test upload with invalid file"""
-        result = self.adaptor.upload(Path('/nonexistent/file.zip'), 'sk-test123')
+        result = self.adaptor.upload(Path("/nonexistent/file.zip"), "sk-test123")
 
-        self.assertFalse(result['success'])
-        self.assertIn('not found', result['message'].lower())
+        self.assertFalse(result["success"])
+        self.assertIn("not found", result["message"].lower())
 
     def test_upload_wrong_format(self):
         """Test upload with wrong file format"""
-        with tempfile.NamedTemporaryFile(suffix='.tar.gz') as tmp:
-            result = self.adaptor.upload(Path(tmp.name), 'sk-test123')
+        with tempfile.NamedTemporaryFile(suffix=".tar.gz") as tmp:
+            result = self.adaptor.upload(Path(tmp.name), "sk-test123")
 
-            self.assertFalse(result['success'])
-            self.assertIn('not a zip', result['message'].lower())
+            self.assertFalse(result["success"])
+            self.assertIn("not a zip", result["message"].lower())
 
     @unittest.skip("Complex mocking - integration test needed with real API")
     def test_upload_success(self):
@@ -144,7 +140,7 @@ class TestOpenAIAdaptor(unittest.TestCase):
             (refs_dir / "test.md").write_text("Test")
 
             # Don't mock the module - it won't be available
-            success = self.adaptor.enhance(skill_dir, 'sk-test123')
+            success = self.adaptor.enhance(skill_dir, "sk-test123")
 
             self.assertFalse(success)
 
@@ -170,22 +166,23 @@ class TestOpenAIAdaptor(unittest.TestCase):
             package_path = self.adaptor.package(skill_dir, output_dir)
 
             # Verify contents
-            with zipfile.ZipFile(package_path, 'r') as zf:
+            with zipfile.ZipFile(package_path, "r") as zf:
                 # Read instructions
-                instructions = zf.read('assistant_instructions.txt').decode('utf-8')
+                instructions = zf.read("assistant_instructions.txt").decode("utf-8")
                 self.assertEqual(instructions, skill_md_content)
 
                 # Verify vector store file
-                self.assertIn('vector_store_files/guide.md', zf.namelist())
+                self.assertIn("vector_store_files/guide.md", zf.namelist())
 
                 # Verify metadata
-                metadata_content = zf.read('openai_metadata.json').decode('utf-8')
+                metadata_content = zf.read("openai_metadata.json").decode("utf-8")
                 import json
+
                 metadata = json.loads(metadata_content)
-                self.assertEqual(metadata['platform'], 'openai')
-                self.assertEqual(metadata['name'], 'test-skill')
-                self.assertIn('file_search', metadata['tools'])
+                self.assertEqual(metadata["platform"], "openai")
+                self.assertEqual(metadata["name"], "test-skill")
+                self.assertIn("file_search", metadata["tools"])
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_api_reference_builder.py b/tests/test_api_reference_builder.py
index 85915a1..3c65de0 100644
--- a/tests/test_api_reference_builder.py
+++ b/tests/test_api_reference_builder.py
@@ -10,15 +10,15 @@ Test Coverage:
 - Integration with code analysis results
 """
 
-import unittest
-import tempfile
-import shutil
-from pathlib import Path
-import sys
 import os
+import shutil
+import sys
+import tempfile
+import unittest
+from pathlib import Path
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 from skill_seekers.cli.api_reference_builder import APIReferenceBuilder
 
@@ -38,28 +38,34 @@ class TestAPIReferenceBuilder(unittest.TestCase):
     def test_class_formatting(self):
         """Test markdown formatting for class signatures."""
         code_analysis = {
-            'files': [{
-                'file': 'test.py',
-                'language': 'Python',
-                'classes': [{
-                    'name': 'Calculator',
-                    'docstring': 'A simple calculator class.',
-                    'base_classes': ['object'],
-                    'methods': [{
-                        'name': 'add',
-                        'parameters': [
-                            {'name': 'a', 'type_hint': 'int', 'default': None},
-                            {'name': 'b', 'type_hint': 'int', 'default': None}
-                        ],
-                        'return_type': 'int',
-                        'docstring': 'Add two numbers.',
-                        'is_async': False,
-                        'is_method': True,
-                        'decorators': []
-                    }]
-                }],
-                'functions': []
-            }]
+            "files": [
+                {
+                    "file": "test.py",
+                    "language": "Python",
+                    "classes": [
+                        {
+                            "name": "Calculator",
+                            "docstring": "A simple calculator class.",
+                            "base_classes": ["object"],
+                            "methods": [
+                                {
+                                    "name": "add",
+                                    "parameters": [
+                                        {"name": "a", "type_hint": "int", "default": None},
+                                        {"name": "b", "type_hint": "int", "default": None},
+                                    ],
+                                    "return_type": "int",
+                                    "docstring": "Add two numbers.",
+                                    "is_async": False,
+                                    "is_method": True,
+                                    "decorators": [],
+                                }
+                            ],
+                        }
+                    ],
+                    "functions": [],
+                }
+            ]
         }
 
         builder = APIReferenceBuilder(code_analysis)
@@ -72,31 +78,33 @@ class TestAPIReferenceBuilder(unittest.TestCase):
 
         # Verify content
         content = output_file.read_text()
-        self.assertIn('### Calculator', content)
-        self.assertIn('A simple calculator class', content)
-        self.assertIn('**Inherits from**: object', content)
-        self.assertIn('##### add', content)
-        self.assertIn('Add two numbers', content)
+        self.assertIn("### Calculator", content)
+        self.assertIn("A simple calculator class", content)
+        self.assertIn("**Inherits from**: object", content)
+        self.assertIn("##### add", content)
+        self.assertIn("Add two numbers", content)
 
     def test_function_formatting(self):
         """Test markdown formatting for function signatures."""
         code_analysis = {
-            'files': [{
-                'file': 'utils.py',
-                'language': 'Python',
-                'classes': [],
-                'functions': [{
-                    'name': 'calculate_sum',
-                    'parameters': [
-                        {'name': 'numbers', 'type_hint': 'list', 'default': None}
+            "files": [
+                {
+                    "file": "utils.py",
+                    "language": "Python",
+                    "classes": [],
+                    "functions": [
+                        {
+                            "name": "calculate_sum",
+                            "parameters": [{"name": "numbers", "type_hint": "list", "default": None}],
+                            "return_type": "int",
+                            "docstring": "Calculate sum of numbers.",
+                            "is_async": False,
+                            "is_method": False,
+                            "decorators": [],
+                        }
                     ],
-                    'return_type': 'int',
-                    'docstring': 'Calculate sum of numbers.',
-                    'is_async': False,
-                    'is_method': False,
-                    'decorators': []
-                }]
-            }]
+                }
+            ]
         }
 
         builder = APIReferenceBuilder(code_analysis)
@@ -106,32 +114,36 @@ class TestAPIReferenceBuilder(unittest.TestCase):
         output_file = list(generated.values())[0]
         content = output_file.read_text()
 
-        self.assertIn('## Functions', content)
-        self.assertIn('### calculate_sum', content)
-        self.assertIn('Calculate sum of numbers', content)
-        self.assertIn('**Returns**: `int`', content)
+        self.assertIn("## Functions", content)
+        self.assertIn("### calculate_sum", content)
+        self.assertIn("Calculate sum of numbers", content)
+        self.assertIn("**Returns**: `int`", content)
 
     def test_parameter_table_generation(self):
         """Test parameter table formatting."""
         code_analysis = {
-            'files': [{
-                'file': 'test.py',
-                'language': 'Python',
-                'classes': [],
-                'functions': [{
-                    'name': 'create_user',
-                    'parameters': [
-                        {'name': 'name', 'type_hint': 'str', 'default': None},
-                        {'name': 'age', 'type_hint': 'int', 'default': '18'},
-                        {'name': 'active', 'type_hint': 'bool', 'default': 'True'}
+            "files": [
+                {
+                    "file": "test.py",
+                    "language": "Python",
+                    "classes": [],
+                    "functions": [
+                        {
+                            "name": "create_user",
+                            "parameters": [
+                                {"name": "name", "type_hint": "str", "default": None},
+                                {"name": "age", "type_hint": "int", "default": "18"},
+                                {"name": "active", "type_hint": "bool", "default": "True"},
+                            ],
+                            "return_type": "dict",
+                            "docstring": "Create a user object.",
+                            "is_async": False,
+                            "is_method": False,
+                            "decorators": [],
+                        }
                     ],
-                    'return_type': 'dict',
-                    'docstring': 'Create a user object.',
-                    'is_async': False,
-                    'is_method': False,
-                    'decorators': []
-                }]
-            }]
+                }
+            ]
         }
 
         builder = APIReferenceBuilder(code_analysis)
@@ -141,34 +153,33 @@ class TestAPIReferenceBuilder(unittest.TestCase):
         output_file = list(generated.values())[0]
         content = output_file.read_text()
 
-        self.assertIn('**Parameters**:', content)
-        self.assertIn('| Name | Type | Default | Description |', content)
-        self.assertIn('| name | str | - |', content)  # Parameters with no default show "-"
-        self.assertIn('| age | int | 18 |', content)
-        self.assertIn('| active | bool | True |', content)
+        self.assertIn("**Parameters**:", content)
+        self.assertIn("| Name | Type | Default | Description |", content)
+        self.assertIn("| name | str | - |", content)  # Parameters with no default show "-"
+        self.assertIn("| age | int | 18 |", content)
+        self.assertIn("| active | bool | True |", content)
 
     def test_markdown_output_structure(self):
         """Test overall markdown document structure."""
         code_analysis = {
-            'files': [{
-                'file': 'module.py',
-                'language': 'Python',
-                'classes': [{
-                    'name': 'TestClass',
-                    'docstring': 'Test class.',
-                    'base_classes': [],
-                    'methods': []
-                }],
-                'functions': [{
-                    'name': 'test_func',
-                    'parameters': [],
-                    'return_type': None,
-                    'docstring': 'Test function.',
-                    'is_async': False,
-                    'is_method': False,
-                    'decorators': []
-                }]
-            }]
+            "files": [
+                {
+                    "file": "module.py",
+                    "language": "Python",
+                    "classes": [{"name": "TestClass", "docstring": "Test class.", "base_classes": [], "methods": []}],
+                    "functions": [
+                        {
+                            "name": "test_func",
+                            "parameters": [],
+                            "return_type": None,
+                            "docstring": "Test function.",
+                            "is_async": False,
+                            "is_method": False,
+                            "decorators": [],
+                        }
+                    ],
+                }
+            ]
         }
 
         builder = APIReferenceBuilder(code_analysis)
@@ -179,13 +190,13 @@ class TestAPIReferenceBuilder(unittest.TestCase):
         content = output_file.read_text()
 
         # Check header
-        self.assertIn('# API Reference: module.py', content)
-        self.assertIn('**Language**: Python', content)
-        self.assertIn('**Source**: `module.py`', content)
+        self.assertIn("# API Reference: module.py", content)
+        self.assertIn("**Language**: Python", content)
+        self.assertIn("**Source**: `module.py`", content)
 
         # Check sections in order
-        classes_pos = content.find('## Classes')
-        functions_pos = content.find('## Functions')
+        classes_pos = content.find("## Classes")
+        functions_pos = content.find("## Functions")
 
         self.assertNotEqual(classes_pos, -1)
         self.assertNotEqual(functions_pos, -1)
@@ -195,48 +206,50 @@ class TestAPIReferenceBuilder(unittest.TestCase):
         """Test integration with actual code analyzer output format."""
         # Simulate real code analyzer output
         code_analysis = {
-            'files': [
+            "files": [
                 {
-                    'file': 'calculator.py',
-                    'language': 'Python',
-                    'classes': [{
-                        'name': 'Calculator',
-                        'base_classes': [],
-                        'methods': [
-                            {
-                                'name': 'add',
-                                'parameters': [
-                                    {'name': 'a', 'type_hint': 'float', 'default': None},
-                                    {'name': 'b', 'type_hint': 'float', 'default': None}
-                                ],
-                                'return_type': 'float',
-                                'docstring': 'Add two numbers.',
-                                'decorators': [],
-                                'is_async': False,
-                                'is_method': True
-                            }
-                        ],
-                        'docstring': 'Calculator class.',
-                        'line_number': 1
-                    }],
-                    'functions': []
+                    "file": "calculator.py",
+                    "language": "Python",
+                    "classes": [
+                        {
+                            "name": "Calculator",
+                            "base_classes": [],
+                            "methods": [
+                                {
+                                    "name": "add",
+                                    "parameters": [
+                                        {"name": "a", "type_hint": "float", "default": None},
+                                        {"name": "b", "type_hint": "float", "default": None},
+                                    ],
+                                    "return_type": "float",
+                                    "docstring": "Add two numbers.",
+                                    "decorators": [],
+                                    "is_async": False,
+                                    "is_method": True,
+                                }
+                            ],
+                            "docstring": "Calculator class.",
+                            "line_number": 1,
+                        }
+                    ],
+                    "functions": [],
                 },
                 {
-                    'file': 'utils.js',
-                    'language': 'JavaScript',
-                    'classes': [],
-                    'functions': [{
-                        'name': 'formatDate',
-                        'parameters': [
-                            {'name': 'date', 'type_hint': None, 'default': None}
-                        ],
-                        'return_type': None,
-                        'docstring': None,
-                        'is_async': False,
-                        'is_method': False,
-                        'decorators': []
-                    }]
-                }
+                    "file": "utils.js",
+                    "language": "JavaScript",
+                    "classes": [],
+                    "functions": [
+                        {
+                            "name": "formatDate",
+                            "parameters": [{"name": "date", "type_hint": None, "default": None}],
+                            "return_type": None,
+                            "docstring": None,
+                            "is_async": False,
+                            "is_method": False,
+                            "decorators": [],
+                        }
+                    ],
+                },
             ]
         }
 
@@ -248,40 +261,42 @@ class TestAPIReferenceBuilder(unittest.TestCase):
 
         # Verify filenames
         filenames = [f.name for f in generated.values()]
-        self.assertIn('calculator.md', filenames)
-        self.assertIn('utils.md', filenames)
+        self.assertIn("calculator.md", filenames)
+        self.assertIn("utils.md", filenames)
 
         # Verify Python file content
-        py_file = next(f for f in generated.values() if f.name == 'calculator.md')
+        py_file = next(f for f in generated.values() if f.name == "calculator.md")
         py_content = py_file.read_text()
-        self.assertIn('Calculator class', py_content)
-        self.assertIn('add(a: float, b: float) → float', py_content)
+        self.assertIn("Calculator class", py_content)
+        self.assertIn("add(a: float, b: float) → float", py_content)
 
         # Verify JavaScript file content
-        js_file = next(f for f in generated.values() if f.name == 'utils.md')
+        js_file = next(f for f in generated.values() if f.name == "utils.md")
         js_content = js_file.read_text()
-        self.assertIn('formatDate', js_content)
-        self.assertIn('**Language**: JavaScript', js_content)
+        self.assertIn("formatDate", js_content)
+        self.assertIn("**Language**: JavaScript", js_content)
 
     def test_async_function_indicator(self):
         """Test that async functions are marked in output."""
         code_analysis = {
-            'files': [{
-                'file': 'async_utils.py',
-                'language': 'Python',
-                'classes': [],
-                'functions': [{
-                    'name': 'fetch_data',
-                    'parameters': [
-                        {'name': 'url', 'type_hint': 'str', 'default': None}
+            "files": [
+                {
+                    "file": "async_utils.py",
+                    "language": "Python",
+                    "classes": [],
+                    "functions": [
+                        {
+                            "name": "fetch_data",
+                            "parameters": [{"name": "url", "type_hint": "str", "default": None}],
+                            "return_type": "dict",
+                            "docstring": "Fetch data from URL.",
+                            "is_async": True,
+                            "is_method": False,
+                            "decorators": [],
+                        }
                     ],
-                    'return_type': 'dict',
-                    'docstring': 'Fetch data from URL.',
-                    'is_async': True,
-                    'is_method': False,
-                    'decorators': []
-                }]
-            }]
+                }
+            ]
         }
 
         builder = APIReferenceBuilder(code_analysis)
@@ -291,33 +306,30 @@ class TestAPIReferenceBuilder(unittest.TestCase):
         output_file = list(generated.values())[0]
         content = output_file.read_text()
 
-        self.assertIn('**Async function**', content)
-        self.assertIn('fetch_data', content)
+        self.assertIn("**Async function**", content)
+        self.assertIn("fetch_data", content)
 
     def test_empty_analysis_skipped(self):
         """Test that files with no analysis are skipped."""
         code_analysis = {
-            'files': [
+            "files": [
+                {"file": "empty.py", "language": "Python", "classes": [], "functions": []},
                 {
-                    'file': 'empty.py',
-                    'language': 'Python',
-                    'classes': [],
-                    'functions': []
+                    "file": "valid.py",
+                    "language": "Python",
+                    "classes": [],
+                    "functions": [
+                        {
+                            "name": "test",
+                            "parameters": [],
+                            "return_type": None,
+                            "docstring": None,
+                            "is_async": False,
+                            "is_method": False,
+                            "decorators": [],
+                        }
+                    ],
                 },
-                {
-                    'file': 'valid.py',
-                    'language': 'Python',
-                    'classes': [],
-                    'functions': [{
-                        'name': 'test',
-                        'parameters': [],
-                        'return_type': None,
-                        'docstring': None,
-                        'is_async': False,
-                        'is_method': False,
-                        'decorators': []
-                    }]
-                }
             ]
         }
 
@@ -326,9 +338,9 @@ class TestAPIReferenceBuilder(unittest.TestCase):
 
         # Only valid.py should be generated
         self.assertEqual(len(generated), 1)
-        self.assertIn('valid.py', list(generated.keys())[0])
+        self.assertIn("valid.py", list(generated.keys())[0])
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Run tests with verbose output
     unittest.main(verbosity=2)
diff --git a/tests/test_architecture_scenarios.py b/tests/test_architecture_scenarios.py
index ae7286b..7cbed20 100644
--- a/tests/test_architecture_scenarios.py
+++ b/tests/test_architecture_scenarios.py
@@ -15,16 +15,21 @@ Validates:
 """
 
 import json
-import os
-import tempfile
-import pytest
 from pathlib import Path
-from unittest.mock import Mock, patch
+from unittest.mock import patch
+
+import pytest
 
-from skill_seekers.cli.unified_codebase_analyzer import UnifiedCodebaseAnalyzer, AnalysisResult
-from skill_seekers.cli.github_fetcher import GitHubThreeStreamFetcher, ThreeStreamData, CodeStream, DocsStream, InsightsStream
 from skill_seekers.cli.generate_router import RouterGenerator
+from skill_seekers.cli.github_fetcher import (
+    CodeStream,
+    DocsStream,
+    GitHubThreeStreamFetcher,
+    InsightsStream,
+    ThreeStreamData,
+)
 from skill_seekers.cli.merge_sources import RuleBasedMerger, categorize_issues_by_topic
+from skill_seekers.cli.unified_codebase_analyzer import AnalysisResult, UnifiedCodebaseAnalyzer
 
 
 class TestScenario1GitHubThreeStream:
@@ -138,56 +143,59 @@ How to use async tools.
     def mock_github_api_data(self):
         """Mock GitHub API responses."""
         return {
-            'metadata': {
-                'stars': 1234,
-                'forks': 56,
-                'open_issues': 12,
-                'language': 'Python',
-                'description': 'Python framework for building MCP servers'
+            "metadata": {
+                "stars": 1234,
+                "forks": 56,
+                "open_issues": 12,
+                "language": "Python",
+                "description": "Python framework for building MCP servers",
             },
-            'issues': [
+            "issues": [
                 {
-                    'number': 42,
-                    'title': 'OAuth setup fails with Google provider',
-                    'state': 'open',
-                    'labels': ['oauth', 'bug'],
-                    'comments': 15,
-                    'body': 'Redirect URI mismatch'
+                    "number": 42,
+                    "title": "OAuth setup fails with Google provider",
+                    "state": "open",
+                    "labels": ["oauth", "bug"],
+                    "comments": 15,
+                    "body": "Redirect URI mismatch",
                 },
                 {
-                    'number': 38,
-                    'title': 'Async tools not working',
-                    'state': 'open',
-                    'labels': ['async', 'question'],
-                    'comments': 8,
-                    'body': 'Getting timeout errors'
+                    "number": 38,
+                    "title": "Async tools not working",
+                    "state": "open",
+                    "labels": ["async", "question"],
+                    "comments": 8,
+                    "body": "Getting timeout errors",
                 },
                 {
-                    'number': 35,
-                    'title': 'Fixed OAuth redirect',
-                    'state': 'closed',
-                    'labels': ['oauth', 'bug'],
-                    'comments': 5,
-                    'body': 'Solution: Check redirect URI'
+                    "number": 35,
+                    "title": "Fixed OAuth redirect",
+                    "state": "closed",
+                    "labels": ["oauth", "bug"],
+                    "comments": 5,
+                    "body": "Solution: Check redirect URI",
                 },
                 {
-                    'number': 30,
-                    'title': 'Testing async functions',
-                    'state': 'open',
-                    'labels': ['testing', 'question'],
-                    'comments': 6,
-                    'body': 'How to test async tools'
-                }
-            ]
+                    "number": 30,
+                    "title": "Testing async functions",
+                    "state": "open",
+                    "labels": ["testing", "question"],
+                    "comments": 6,
+                    "body": "How to test async tools",
+                },
+            ],
         }
 
     def test_scenario_1_github_three_stream_fetcher(self, mock_github_repo, mock_github_api_data):
         """Test GitHub three-stream fetcher with mock data."""
         # Create fetcher with mock
-        with patch.object(GitHubThreeStreamFetcher, 'clone_repo', return_value=mock_github_repo), \
-             patch.object(GitHubThreeStreamFetcher, 'fetch_github_metadata', return_value=mock_github_api_data['metadata']), \
-             patch.object(GitHubThreeStreamFetcher, 'fetch_issues', return_value=mock_github_api_data['issues']):
-
+        with (
+            patch.object(GitHubThreeStreamFetcher, "clone_repo", return_value=mock_github_repo),
+            patch.object(
+                GitHubThreeStreamFetcher, "fetch_github_metadata", return_value=mock_github_api_data["metadata"]
+            ),
+            patch.object(GitHubThreeStreamFetcher, "fetch_issues", return_value=mock_github_api_data["issues"]),
+        ):
             fetcher = GitHubThreeStreamFetcher("https://github.com/jlowin/fastmcp")
             three_streams = fetcher.fetch()
 
@@ -203,132 +211,140 @@ How to use async tools.
 
             # Verify docs stream
             assert three_streams.docs_stream.readme is not None
-            assert 'FastMCP' in three_streams.docs_stream.readme
+            assert "FastMCP" in three_streams.docs_stream.readme
             assert three_streams.docs_stream.contributing is not None
             assert len(three_streams.docs_stream.docs_files) >= 2  # oauth.md, async.md
 
             # Verify insights stream
-            assert three_streams.insights_stream.metadata['stars'] == 1234
-            assert three_streams.insights_stream.metadata['language'] == 'Python'
+            assert three_streams.insights_stream.metadata["stars"] == 1234
+            assert three_streams.insights_stream.metadata["language"] == "Python"
             assert len(three_streams.insights_stream.common_problems) >= 2
             assert len(three_streams.insights_stream.known_solutions) >= 1
             assert len(three_streams.insights_stream.top_labels) >= 2
 
     def test_scenario_1_unified_analyzer_github(self, mock_github_repo, mock_github_api_data):
         """Test unified analyzer with GitHub source."""
-        with patch.object(GitHubThreeStreamFetcher, 'clone_repo', return_value=mock_github_repo), \
-             patch.object(GitHubThreeStreamFetcher, 'fetch_github_metadata', return_value=mock_github_api_data['metadata']), \
-             patch.object(GitHubThreeStreamFetcher, 'fetch_issues', return_value=mock_github_api_data['issues']), \
-             patch('skill_seekers.cli.unified_codebase_analyzer.UnifiedCodebaseAnalyzer.c3x_analysis') as mock_c3x:
-
+        with (
+            patch.object(GitHubThreeStreamFetcher, "clone_repo", return_value=mock_github_repo),
+            patch.object(
+                GitHubThreeStreamFetcher, "fetch_github_metadata", return_value=mock_github_api_data["metadata"]
+            ),
+            patch.object(GitHubThreeStreamFetcher, "fetch_issues", return_value=mock_github_api_data["issues"]),
+            patch("skill_seekers.cli.unified_codebase_analyzer.UnifiedCodebaseAnalyzer.c3x_analysis") as mock_c3x,
+        ):
             # Mock C3.x analysis to return sample data
             mock_c3x.return_value = {
-                'files': ['auth.py', 'async_tools.py'],
-                'analysis_type': 'c3x',
-                'c3_1_patterns': [
-                    {'name': 'Strategy', 'count': 5, 'file': 'auth.py'},
-                    {'name': 'Factory', 'count': 3, 'file': 'auth.py'}
+                "files": ["auth.py", "async_tools.py"],
+                "analysis_type": "c3x",
+                "c3_1_patterns": [
+                    {"name": "Strategy", "count": 5, "file": "auth.py"},
+                    {"name": "Factory", "count": 3, "file": "auth.py"},
                 ],
-                'c3_2_examples': [
-                    {'name': 'test_google_provider', 'file': 'test_auth.py'},
-                    {'name': 'test_azure_provider', 'file': 'test_auth.py'}
+                "c3_2_examples": [
+                    {"name": "test_google_provider", "file": "test_auth.py"},
+                    {"name": "test_azure_provider", "file": "test_auth.py"},
                 ],
-                'c3_2_examples_count': 2,
-                'c3_3_guides': [
-                    {'title': 'OAuth Setup Guide', 'file': 'docs/oauth.md'}
-                ],
-                'c3_4_configs': [],
-                'c3_7_architecture': [
-                    {'pattern': 'Service Layer', 'description': 'OAuth provider abstraction'}
-                ]
+                "c3_2_examples_count": 2,
+                "c3_3_guides": [{"title": "OAuth Setup Guide", "file": "docs/oauth.md"}],
+                "c3_4_configs": [],
+                "c3_7_architecture": [{"pattern": "Service Layer", "description": "OAuth provider abstraction"}],
             }
 
             analyzer = UnifiedCodebaseAnalyzer()
             result = analyzer.analyze(
-                source="https://github.com/jlowin/fastmcp",
-                depth="c3x",
-                fetch_github_metadata=True
+                source="https://github.com/jlowin/fastmcp", depth="c3x", fetch_github_metadata=True
             )
 
             # Verify result structure
             assert isinstance(result, AnalysisResult)
-            assert result.source_type == 'github'
-            assert result.analysis_depth == 'c3x'
+            assert result.source_type == "github"
+            assert result.analysis_depth == "c3x"
 
             # Verify code analysis (C3.x)
             assert result.code_analysis is not None
-            assert result.code_analysis['analysis_type'] == 'c3x'
-            assert len(result.code_analysis['c3_1_patterns']) >= 2
-            assert result.code_analysis['c3_2_examples_count'] >= 2
+            assert result.code_analysis["analysis_type"] == "c3x"
+            assert len(result.code_analysis["c3_1_patterns"]) >= 2
+            assert result.code_analysis["c3_2_examples_count"] >= 2
 
             # Verify GitHub docs
             assert result.github_docs is not None
-            assert 'FastMCP' in result.github_docs['readme']
+            assert "FastMCP" in result.github_docs["readme"]
 
             # Verify GitHub insights
             assert result.github_insights is not None
-            assert result.github_insights['metadata']['stars'] == 1234
-            assert len(result.github_insights['common_problems']) >= 2
+            assert result.github_insights["metadata"]["stars"] == 1234
+            assert len(result.github_insights["common_problems"]) >= 2
 
     def test_scenario_1_router_generation(self, tmp_path):
         """Test router generation with GitHub streams."""
         # Create mock sub-skill configs
         config1 = tmp_path / "fastmcp-oauth.json"
-        config1.write_text(json.dumps({
-            "name": "fastmcp-oauth",
-            "description": "OAuth authentication for FastMCP",
-            "categories": {
-                "oauth": ["oauth", "auth", "provider", "google", "azure"]
-            }
-        }))
+        config1.write_text(
+            json.dumps(
+                {
+                    "name": "fastmcp-oauth",
+                    "description": "OAuth authentication for FastMCP",
+                    "categories": {"oauth": ["oauth", "auth", "provider", "google", "azure"]},
+                }
+            )
+        )
 
         config2 = tmp_path / "fastmcp-async.json"
-        config2.write_text(json.dumps({
-            "name": "fastmcp-async",
-            "description": "Async patterns for FastMCP",
-            "categories": {
-                "async": ["async", "await", "asyncio"]
-            }
-        }))
+        config2.write_text(
+            json.dumps(
+                {
+                    "name": "fastmcp-async",
+                    "description": "Async patterns for FastMCP",
+                    "categories": {"async": ["async", "await", "asyncio"]},
+                }
+            )
+        )
 
         # Create mock GitHub streams
         mock_streams = ThreeStreamData(
-            code_stream=CodeStream(
-                directory=Path("/tmp/mock"),
-                files=[]
-            ),
+            code_stream=CodeStream(directory=Path("/tmp/mock"), files=[]),
             docs_stream=DocsStream(
                 readme="# FastMCP\n\nFastMCP is a Python framework...",
                 contributing="# Contributing\n\nPlease follow guidelines...",
-                docs_files=[]
+                docs_files=[],
             ),
             insights_stream=InsightsStream(
                 metadata={
-                    'stars': 1234,
-                    'forks': 56,
-                    'language': 'Python',
-                    'description': 'Python framework for MCP servers'
+                    "stars": 1234,
+                    "forks": 56,
+                    "language": "Python",
+                    "description": "Python framework for MCP servers",
                 },
                 common_problems=[
-                    {'number': 42, 'title': 'OAuth setup fails', 'labels': ['oauth'], 'comments': 15, 'state': 'open'},
-                    {'number': 38, 'title': 'Async tools not working', 'labels': ['async'], 'comments': 8, 'state': 'open'}
+                    {"number": 42, "title": "OAuth setup fails", "labels": ["oauth"], "comments": 15, "state": "open"},
+                    {
+                        "number": 38,
+                        "title": "Async tools not working",
+                        "labels": ["async"],
+                        "comments": 8,
+                        "state": "open",
+                    },
                 ],
                 known_solutions=[
-                    {'number': 35, 'title': 'Fixed OAuth redirect', 'labels': ['oauth'], 'comments': 5, 'state': 'closed'}
+                    {
+                        "number": 35,
+                        "title": "Fixed OAuth redirect",
+                        "labels": ["oauth"],
+                        "comments": 5,
+                        "state": "closed",
+                    }
                 ],
                 top_labels=[
-                    {'label': 'oauth', 'count': 15},
-                    {'label': 'async', 'count': 8},
-                    {'label': 'testing', 'count': 6}
-                ]
-            )
+                    {"label": "oauth", "count": 15},
+                    {"label": "async", "count": 8},
+                    {"label": "testing", "count": 6},
+                ],
+            ),
         )
 
         # Generate router
         generator = RouterGenerator(
-            config_paths=[str(config1), str(config2)],
-            router_name="fastmcp",
-            github_streams=mock_streams
+            config_paths=[str(config1), str(config2)], router_name="fastmcp", github_streams=mock_streams
         )
 
         skill_md = generator.generate_skill_md()
@@ -345,14 +361,18 @@ How to use async tools.
         assert "Quick Start" in skill_md or "FastMCP is a Python framework" in skill_md
 
         # Verify examples with converted questions (Fix 1) or Common Patterns section (Fix 4)
-        assert ("Examples" in skill_md and "how do i fix oauth" in skill_md.lower()) or "Common Patterns" in skill_md or "Common Issues" in skill_md
+        assert (
+            ("Examples" in skill_md and "how do i fix oauth" in skill_md.lower())
+            or "Common Patterns" in skill_md
+            or "Common Issues" in skill_md
+        )
 
         # Verify routing keywords include GitHub labels (2x weight)
         routing = generator.extract_routing_keywords()
-        assert 'fastmcp-oauth' in routing
-        oauth_keywords = routing['fastmcp-oauth']
+        assert "fastmcp-oauth" in routing
+        oauth_keywords = routing["fastmcp-oauth"]
         # Check that 'oauth' appears multiple times (2x weight)
-        oauth_count = oauth_keywords.count('oauth')
+        oauth_count = oauth_keywords.count("oauth")
         assert oauth_count >= 2  # Should appear at least twice for 2x weight
 
     def test_scenario_1_quality_metrics(self, tmp_path):
@@ -391,7 +411,7 @@ pip install fastmcp
 
         # Check size constraints (Architecture Section 8.1)
         # Target: Router 150 lines (±20)
-        lines = router_md.strip().split('\n')
+        lines = router_md.strip().split("\n")
         assert len(lines) <= 200, f"Router too large: {len(lines)} lines (max 200)"
 
         # Check GitHub overhead (Architecture Section 8.3)
@@ -450,56 +470,49 @@ class TestScenario2MultiSource:
     def test_scenario_2_issue_categorization(self):
         """Test categorizing GitHub issues by topic."""
         problems = [
-            {'number': 42, 'title': 'OAuth setup fails', 'labels': ['oauth', 'bug']},
-            {'number': 38, 'title': 'Async tools not working', 'labels': ['async', 'question']},
-            {'number': 35, 'title': 'Testing with pytest', 'labels': ['testing', 'question']},
-            {'number': 30, 'title': 'Google OAuth redirect', 'labels': ['oauth', 'question']}
+            {"number": 42, "title": "OAuth setup fails", "labels": ["oauth", "bug"]},
+            {"number": 38, "title": "Async tools not working", "labels": ["async", "question"]},
+            {"number": 35, "title": "Testing with pytest", "labels": ["testing", "question"]},
+            {"number": 30, "title": "Google OAuth redirect", "labels": ["oauth", "question"]},
         ]
 
         solutions = [
-            {'number': 25, 'title': 'Fixed OAuth redirect', 'labels': ['oauth', 'bug']},
-            {'number': 20, 'title': 'Async timeout solution', 'labels': ['async', 'bug']}
+            {"number": 25, "title": "Fixed OAuth redirect", "labels": ["oauth", "bug"]},
+            {"number": 20, "title": "Async timeout solution", "labels": ["async", "bug"]},
         ]
 
-        topics = ['oauth', 'async', 'testing']
+        topics = ["oauth", "async", "testing"]
 
         categorized = categorize_issues_by_topic(problems, solutions, topics)
 
         # Verify categorization
-        assert 'oauth' in categorized
-        assert 'async' in categorized
-        assert 'testing' in categorized
+        assert "oauth" in categorized
+        assert "async" in categorized
+        assert "testing" in categorized
 
         # Check OAuth issues
-        oauth_issues = categorized['oauth']
+        oauth_issues = categorized["oauth"]
         assert len(oauth_issues) >= 2  # #42, #30, #25
-        oauth_numbers = [i['number'] for i in oauth_issues]
+        oauth_numbers = [i["number"] for i in oauth_issues]
         assert 42 in oauth_numbers
 
         # Check async issues
-        async_issues = categorized['async']
+        async_issues = categorized["async"]
         assert len(async_issues) >= 2  # #38, #20
-        async_numbers = [i['number'] for i in async_issues]
+        async_numbers = [i["number"] for i in async_issues]
         assert 38 in async_numbers
 
         # Check testing issues
-        testing_issues = categorized['testing']
+        testing_issues = categorized["testing"]
         assert len(testing_issues) >= 1  # #35
 
     def test_scenario_2_conflict_detection(self):
         """Test conflict detection between docs and code."""
         # Mock API data from docs
-        api_data = {
-            'GoogleProvider': {
-                'params': ['app_id', 'app_secret'],
-                'source': 'html_docs'
-            }
-        }
+        api_data = {"GoogleProvider": {"params": ["app_id", "app_secret"], "source": "html_docs"}}
 
         # Mock GitHub docs
-        github_docs = {
-            'readme': 'Use client_id and client_secret for Google OAuth'
-        }
+        github_docs = {"readme": "Use client_id and client_secret for Google OAuth"}
 
         # In a real implementation, conflict detection would find:
         # - Docs say: app_id, app_secret
@@ -507,8 +520,8 @@ class TestScenario2MultiSource:
         # - This is a conflict!
 
         # For now, just verify the structure exists
-        assert 'GoogleProvider' in api_data
-        assert 'params' in api_data['GoogleProvider']
+        assert "GoogleProvider" in api_data
+        assert "params" in api_data["GoogleProvider"]
         assert github_docs is not None
 
     def test_scenario_2_multi_layer_merge(self):
@@ -520,43 +533,25 @@ class TestScenario2MultiSource:
         # Layer 4: GitHub insights (community knowledge)
 
         # Mock source 1 (HTML docs)
-        source1_data = {
-            'api': [
-                {'name': 'GoogleProvider', 'params': ['app_id', 'app_secret']}
-            ]
-        }
+        source1_data = {"api": [{"name": "GoogleProvider", "params": ["app_id", "app_secret"]}]}
 
         # Mock source 2 (GitHub C3.x)
-        source2_data = {
-            'api': [
-                {'name': 'GoogleProvider', 'params': ['client_id', 'client_secret']}
-            ]
-        }
+        source2_data = {"api": [{"name": "GoogleProvider", "params": ["client_id", "client_secret"]}]}
 
         # Mock GitHub streams
         github_streams = ThreeStreamData(
             code_stream=CodeStream(directory=Path("/tmp"), files=[]),
-            docs_stream=DocsStream(
-                readme="Use client_id and client_secret",
-                contributing=None,
-                docs_files=[]
-            ),
+            docs_stream=DocsStream(readme="Use client_id and client_secret", contributing=None, docs_files=[]),
             insights_stream=InsightsStream(
-                metadata={'stars': 1000},
-                common_problems=[
-                    {'number': 42, 'title': 'OAuth parameter confusion', 'labels': ['oauth']}
-                ],
+                metadata={"stars": 1000},
+                common_problems=[{"number": 42, "title": "OAuth parameter confusion", "labels": ["oauth"]}],
                 known_solutions=[],
-                top_labels=[]
-            )
+                top_labels=[],
+            ),
         )
 
         # Create merger with required arguments
-        merger = RuleBasedMerger(
-            docs_data=source1_data,
-            github_data=source2_data,
-            conflicts=[]
-        )
+        merger = RuleBasedMerger(docs_data=source1_data, github_data=source2_data, conflicts=[])
 
         # Merge using merge_all() method
         merged = merger.merge_all()
@@ -638,21 +633,17 @@ def test_connection():
         """Test basic analysis of local codebase."""
         analyzer = UnifiedCodebaseAnalyzer()
 
-        result = analyzer.analyze(
-            source=str(local_codebase),
-            depth="basic",
-            fetch_github_metadata=False
-        )
+        result = analyzer.analyze(source=str(local_codebase), depth="basic", fetch_github_metadata=False)
 
         # Verify result
         assert isinstance(result, AnalysisResult)
-        assert result.source_type == 'local'
-        assert result.analysis_depth == 'basic'
+        assert result.source_type == "local"
+        assert result.analysis_depth == "basic"
 
         # Verify code analysis
         assert result.code_analysis is not None
-        assert 'files' in result.code_analysis
-        assert len(result.code_analysis['files']) >= 2  # database.py, api.py
+        assert "files" in result.code_analysis
+        assert len(result.code_analysis["files"]) >= 2  # database.py, api.py
 
         # Verify no GitHub data
         assert result.github_docs is None
@@ -662,37 +653,29 @@ def test_connection():
         """Test C3.x analysis of local codebase."""
         analyzer = UnifiedCodebaseAnalyzer()
 
-        with patch('skill_seekers.cli.unified_codebase_analyzer.UnifiedCodebaseAnalyzer.c3x_analysis') as mock_c3x:
+        with patch("skill_seekers.cli.unified_codebase_analyzer.UnifiedCodebaseAnalyzer.c3x_analysis") as mock_c3x:
             # Mock C3.x to return sample data
             mock_c3x.return_value = {
-                'files': ['database.py', 'api.py'],
-                'analysis_type': 'c3x',
-                'c3_1_patterns': [
-                    {'name': 'Singleton', 'count': 1, 'file': 'database.py'}
-                ],
-                'c3_2_examples': [
-                    {'name': 'test_connection', 'file': 'test_database.py'}
-                ],
-                'c3_2_examples_count': 1,
-                'c3_3_guides': [],
-                'c3_4_configs': [],
-                'c3_7_architecture': []
+                "files": ["database.py", "api.py"],
+                "analysis_type": "c3x",
+                "c3_1_patterns": [{"name": "Singleton", "count": 1, "file": "database.py"}],
+                "c3_2_examples": [{"name": "test_connection", "file": "test_database.py"}],
+                "c3_2_examples_count": 1,
+                "c3_3_guides": [],
+                "c3_4_configs": [],
+                "c3_7_architecture": [],
             }
 
-            result = analyzer.analyze(
-                source=str(local_codebase),
-                depth="c3x",
-                fetch_github_metadata=False
-            )
+            result = analyzer.analyze(source=str(local_codebase), depth="c3x", fetch_github_metadata=False)
 
             # Verify result
-            assert result.source_type == 'local'
-            assert result.analysis_depth == 'c3x'
+            assert result.source_type == "local"
+            assert result.analysis_depth == "c3x"
 
             # Verify C3.x analysis ran
-            assert result.code_analysis['analysis_type'] == 'c3x'
-            assert 'c3_1_patterns' in result.code_analysis
-            assert 'c3_2_examples' in result.code_analysis
+            assert result.code_analysis["analysis_type"] == "c3x"
+            assert "c3_1_patterns" in result.code_analysis
+            assert "c3_2_examples" in result.code_analysis
 
             # Verify no GitHub data
             assert result.github_docs is None
@@ -702,24 +685,32 @@ def test_connection():
         """Test router generation without GitHub data."""
         # Create mock configs
         config1 = tmp_path / "internal-database.json"
-        config1.write_text(json.dumps({
-            "name": "internal-database",
-            "description": "Database layer",
-            "categories": {"database": ["db", "sql", "connection"]}
-        }))
+        config1.write_text(
+            json.dumps(
+                {
+                    "name": "internal-database",
+                    "description": "Database layer",
+                    "categories": {"database": ["db", "sql", "connection"]},
+                }
+            )
+        )
 
         config2 = tmp_path / "internal-api.json"
-        config2.write_text(json.dumps({
-            "name": "internal-api",
-            "description": "API endpoints",
-            "categories": {"api": ["api", "endpoint", "route"]}
-        }))
+        config2.write_text(
+            json.dumps(
+                {
+                    "name": "internal-api",
+                    "description": "API endpoints",
+                    "categories": {"api": ["api", "endpoint", "route"]},
+                }
+            )
+        )
 
         # Generate router WITHOUT GitHub streams
         generator = RouterGenerator(
             config_paths=[str(config1), str(config2)],
             router_name="internal-tool",
-            github_streams=None  # No GitHub data
+            github_streams=None,  # No GitHub data
         )
 
         skill_md = generator.generate_skill_md()
@@ -816,38 +807,38 @@ Based on analysis of GitHub issues:
         in_quick_start = False
         in_common_issues = False
 
-        for line in router_with_github.split('\n'):
+        for line in router_with_github.split("\n"):
             # Repository Info section (3-5 lines)
-            if '## Repository Info' in line:
+            if "## Repository Info" in line:
                 in_repo_info = True
                 github_overhead += 1
                 continue
             if in_repo_info:
-                if line.startswith('**') or 'github.com' in line or '⭐' in line or 'FastMCP is' in line:
+                if line.startswith("**") or "github.com" in line or "⭐" in line or "FastMCP is" in line:
                     github_overhead += 1
-                if line.startswith('##'):
+                if line.startswith("##"):
                     in_repo_info = False
 
             # Quick Start from README section (8-12 lines)
-            if '## Quick Start' in line and 'README' in line:
+            if "## Quick Start" in line and "README" in line:
                 in_quick_start = True
                 github_overhead += 1
                 continue
             if in_quick_start:
                 if line.strip():  # Non-empty lines in quick start
                     github_overhead += 1
-                if line.startswith('##'):
+                if line.startswith("##"):
                     in_quick_start = False
 
             # Common Issues section (15-25 lines)
-            if '## Common Issues' in line and 'GitHub' in line:
+            if "## Common Issues" in line and "GitHub" in line:
                 in_common_issues = True
                 github_overhead += 1
                 continue
             if in_common_issues:
-                if 'Issue #' in line or 'comments)' in line or 'skill' in line:
+                if "Issue #" in line or "comments)" in line or "skill" in line:
                     github_overhead += 1
-                if line.startswith('##'):
+                if line.startswith("##"):
                     in_common_issues = False
 
         print(f"\nGitHub overhead: {github_overhead} lines")
@@ -902,24 +893,23 @@ provider = GitHubProvider(client_id="...", client_secret="...")
 """
 
         # Check minimum 3 code examples
-        code_blocks = sub_skill_md.count('```')
+        code_blocks = sub_skill_md.count("```")
         assert code_blocks >= 6, f"Need at least 3 code examples (6 markers), found {code_blocks // 2}"
 
         # Check language tags
-        assert '```python' in sub_skill_md, "Code blocks must have language tags"
+        assert "```python" in sub_skill_md, "Code blocks must have language tags"
 
         # Check no placeholders
-        assert 'TODO' not in sub_skill_md, "No TODO placeholders allowed"
-        assert '[Add' not in sub_skill_md, "No [Add...] placeholders allowed"
+        assert "TODO" not in sub_skill_md, "No TODO placeholders allowed"
+        assert "[Add" not in sub_skill_md, "No [Add...] placeholders allowed"
 
         # Check minimum 2 GitHub issues
-        issue_refs = sub_skill_md.count('Issue #')
+        issue_refs = sub_skill_md.count("Issue #")
         assert issue_refs >= 2, f"Need at least 2 GitHub issues, found {issue_refs}"
 
         # Check solution indicators for closed issues
-        if 'closed' in sub_skill_md.lower():
-            assert '✅' in sub_skill_md or 'Solution' in sub_skill_md, \
-                "Closed issues should indicate solution found"
+        if "closed" in sub_skill_md.lower():
+            assert "✅" in sub_skill_md or "Solution" in sub_skill_md, "Closed issues should indicate solution found"
 
 
 class TestTokenEfficiencyCalculation:
@@ -946,19 +936,18 @@ class TestTokenEfficiencyCalculation:
         reduction = (monolithic_size - avg_router_query) / monolithic_size
         reduction_percent = reduction * 100
 
-        print(f"\n=== Token Efficiency Calculation ===")
+        print("\n=== Token Efficiency Calculation ===")
         print(f"Monolithic: {monolithic_size} lines")
         print(f"Router: {router_size} lines")
         print(f"Avg Sub-skill: {avg_subskill_with_github} lines")
         print(f"Avg Query: {avg_router_query} lines")
         print(f"Reduction: {reduction_percent:.1f}%")
-        print(f"Target: 35-40%")
+        print("Target: 35-40%")
 
         # With selective loading and caching, achieve 35-40%
         # Even conservative estimate shows 29.5%, actual usage patterns show 35-40%
-        assert reduction_percent >= 29, \
-            f"Token reduction {reduction_percent:.1f}% below 29% (conservative target)"
+        assert reduction_percent >= 29, f"Token reduction {reduction_percent:.1f}% below 29% (conservative target)"
 
 
-if __name__ == '__main__':
-    pytest.main([__file__, '-v', '--tb=short'])
+if __name__ == "__main__":
+    pytest.main([__file__, "-v", "--tb=short"])
diff --git a/tests/test_async_scraping.py b/tests/test_async_scraping.py
index b5ee9f2..369eb7e 100644
--- a/tests/test_async_scraping.py
+++ b/tests/test_async_scraping.py
@@ -4,14 +4,11 @@ Tests for async scraping functionality
 Tests the async/await implementation for parallel web scraping
 """
 
-import sys
-import os
-import unittest
 import asyncio
+import os
 import tempfile
-from pathlib import Path
-from unittest.mock import Mock, patch, AsyncMock, MagicMock
-from collections import deque
+import unittest
+from unittest.mock import AsyncMock, patch
 
 from skill_seekers.cli.doc_scraper import DocToSkillConverter
 
@@ -30,10 +27,10 @@ class TestAsyncConfiguration(unittest.TestCase):
     def test_async_mode_default_false(self):
         """Test async mode is disabled by default"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": 10,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -47,11 +44,11 @@ class TestAsyncConfiguration(unittest.TestCase):
     def test_async_mode_enabled_from_config(self):
         """Test async mode can be enabled via config"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': 10,
-            'async_mode': True
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": 10,
+            "async_mode": True,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -65,11 +62,11 @@ class TestAsyncConfiguration(unittest.TestCase):
     def test_async_mode_with_workers(self):
         """Test async mode works with multiple workers"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'workers': 4,
-            'async_mode': True
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "workers": 4,
+            "async_mode": True,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -95,34 +92,26 @@ class TestAsyncScrapeMethods(unittest.TestCase):
 
     def test_scrape_page_async_exists(self):
         """Test scrape_page_async method exists"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'}
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "selectors": {"main_content": "article"}}
 
         with tempfile.TemporaryDirectory() as tmpdir:
             try:
                 os.chdir(tmpdir)
                 converter = DocToSkillConverter(config, dry_run=True)
-                self.assertTrue(hasattr(converter, 'scrape_page_async'))
+                self.assertTrue(hasattr(converter, "scrape_page_async"))
                 self.assertTrue(asyncio.iscoroutinefunction(converter.scrape_page_async))
             finally:
                 os.chdir(self.original_cwd)
 
     def test_scrape_all_async_exists(self):
         """Test scrape_all_async method exists"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'}
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "selectors": {"main_content": "article"}}
 
         with tempfile.TemporaryDirectory() as tmpdir:
             try:
                 os.chdir(tmpdir)
                 converter = DocToSkillConverter(config, dry_run=True)
-                self.assertTrue(hasattr(converter, 'scrape_all_async'))
+                self.assertTrue(hasattr(converter, "scrape_all_async"))
                 self.assertTrue(asyncio.iscoroutinefunction(converter.scrape_all_async))
             finally:
                 os.chdir(self.original_cwd)
@@ -142,11 +131,11 @@ class TestAsyncRouting(unittest.TestCase):
     def test_scrape_all_routes_to_async_when_enabled(self):
         """Test scrape_all calls async version when async_mode=True"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': True,
-            'max_pages': 1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": True,
+            "max_pages": 1,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -155,7 +144,7 @@ class TestAsyncRouting(unittest.TestCase):
                 converter = DocToSkillConverter(config, dry_run=True)
 
                 # Mock scrape_all_async to verify it gets called
-                with patch.object(converter, 'scrape_all_async', new_callable=AsyncMock) as mock_async:
+                with patch.object(converter, "scrape_all_async", new_callable=AsyncMock) as mock_async:
                     converter.scrape_all()
                     # Verify async version was called
                     mock_async.assert_called_once()
@@ -165,11 +154,11 @@ class TestAsyncRouting(unittest.TestCase):
     def test_scrape_all_uses_sync_when_async_disabled(self):
         """Test scrape_all uses sync version when async_mode=False"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': False,
-            'max_pages': 1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": False,
+            "max_pages": 1,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -178,8 +167,8 @@ class TestAsyncRouting(unittest.TestCase):
                 converter = DocToSkillConverter(config, dry_run=True)
 
                 # Mock scrape_all_async to verify it does NOT get called
-                with patch.object(converter, 'scrape_all_async', new_callable=AsyncMock) as mock_async:
-                    with patch.object(converter, '_try_llms_txt', return_value=False):
+                with patch.object(converter, "scrape_all_async", new_callable=AsyncMock) as mock_async:
+                    with patch.object(converter, "_try_llms_txt", return_value=False):
                         converter.scrape_all()
                         # Verify async version was NOT called
                         mock_async.assert_not_called()
@@ -201,11 +190,11 @@ class TestAsyncDryRun(unittest.TestCase):
     def test_async_dry_run_completes(self):
         """Test async dry run completes without errors"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': True,
-            'max_pages': 5
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": True,
+            "max_pages": 5,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -214,7 +203,7 @@ class TestAsyncDryRun(unittest.TestCase):
                 converter = DocToSkillConverter(config, dry_run=True)
 
                 # Mock _try_llms_txt to skip llms.txt detection
-                with patch.object(converter, '_try_llms_txt', return_value=False):
+                with patch.object(converter, "_try_llms_txt", return_value=False):
                     # Should complete without errors
                     converter.scrape_all()
                     # Verify dry run mode was used
@@ -237,12 +226,12 @@ class TestAsyncErrorHandling(unittest.TestCase):
     def test_async_handles_http_errors(self):
         """Test async scraping handles HTTP errors gracefully"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': True,
-            'workers': 2,
-            'max_pages': 1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": True,
+            "workers": 2,
+            "max_pages": 1,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -258,9 +247,9 @@ class TestAsyncErrorHandling(unittest.TestCase):
 
                     async with httpx.AsyncClient() as client:
                         # Mock client.get to raise exception
-                        with patch.object(client, 'get', side_effect=httpx.HTTPError("Test error")):
+                        with patch.object(client, "get", side_effect=httpx.HTTPError("Test error")):
                             # Should not raise exception, just log error
-                            await converter.scrape_page_async('https://example.com/test', semaphore, client)
+                            await converter.scrape_page_async("https://example.com/test", semaphore, client)
 
                 # Run async test
                 asyncio.run(run_test())
@@ -275,11 +264,11 @@ class TestAsyncPerformance(unittest.TestCase):
     def test_async_uses_semaphore_for_concurrency_control(self):
         """Test async mode uses semaphore instead of threading lock"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': True,
-            'workers': 4
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": True,
+            "workers": 4,
         }
 
         original_cwd = os.getcwd()
@@ -301,10 +290,10 @@ class TestAsyncLlmsTxtIntegration(unittest.TestCase):
     def test_async_respects_llms_txt(self):
         """Test async mode respects llms.txt and skips HTML scraping"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': True
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": True,
         }
 
         original_cwd = os.getcwd()
@@ -314,8 +303,8 @@ class TestAsyncLlmsTxtIntegration(unittest.TestCase):
                 converter = DocToSkillConverter(config, dry_run=False)
 
                 # Mock _try_llms_txt to return True (llms.txt found)
-                with patch.object(converter, '_try_llms_txt', return_value=True):
-                    with patch.object(converter, 'save_summary'):
+                with patch.object(converter, "_try_llms_txt", return_value=True):
+                    with patch.object(converter, "save_summary"):
                         converter.scrape_all()
                         # If llms.txt succeeded, async scraping should be skipped
                         # Verify by checking that pages were not scraped
@@ -324,5 +313,5 @@ class TestAsyncLlmsTxtIntegration(unittest.TestCase):
                 os.chdir(original_cwd)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_c3_integration.py b/tests/test_c3_integration.py
index 46c6439..9c3ffb0 100644
--- a/tests/test_c3_integration.py
+++ b/tests/test_c3_integration.py
@@ -10,18 +10,19 @@ Tests the integration of C3.x codebase analysis features into unified skills:
 - Graceful degradation on failures
 """
 
-import os
 import json
-import pytest
-import tempfile
+import os
 import shutil
-from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
+import tempfile
+from unittest.mock import patch
+
+import pytest
+
+from skill_seekers.cli.config_validator import ConfigValidator
 
 # Import modules to test
 from skill_seekers.cli.unified_scraper import UnifiedScraper
 from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
-from skill_seekers.cli.config_validator import ConfigValidator
 
 
 class TestC3Integration:
@@ -38,278 +39,235 @@ class TestC3Integration:
     def mock_config(self, temp_dir):
         """Create mock unified config with GitHub source."""
         return {
-            'name': 'test-c3',
-            'description': 'Test C3.5 integration',
-            'merge_mode': 'rule-based',
-            'sources': [
+            "name": "test-c3",
+            "description": "Test C3.5 integration",
+            "merge_mode": "rule-based",
+            "sources": [
                 {
-                    'type': 'github',
-                    'repo': 'test/repo',
-                    'local_repo_path': temp_dir,
-                    'enable_codebase_analysis': True,
-                    'ai_mode': 'none'
+                    "type": "github",
+                    "repo": "test/repo",
+                    "local_repo_path": temp_dir,
+                    "enable_codebase_analysis": True,
+                    "ai_mode": "none",
                 }
-            ]
+            ],
         }
 
     @pytest.fixture
     def mock_c3_data(self):
         """Create mock C3.x analysis data."""
         return {
-            'patterns': [
+            "patterns": [
                 {
-                    'file_path': 'src/factory.py',
-                    'patterns': [
+                    "file_path": "src/factory.py",
+                    "patterns": [
                         {
-                            'pattern_type': 'Factory',
-                            'class_name': 'WidgetFactory',
-                            'confidence': 0.95,
-                            'indicators': ['create_method', 'product_interface']
+                            "pattern_type": "Factory",
+                            "class_name": "WidgetFactory",
+                            "confidence": 0.95,
+                            "indicators": ["create_method", "product_interface"],
                         }
-                    ]
+                    ],
                 }
             ],
-            'test_examples': {
-                'total_examples': 15,
-                'high_value_count': 9,
-                'examples': [
+            "test_examples": {
+                "total_examples": 15,
+                "high_value_count": 9,
+                "examples": [
                     {
-                        'description': 'Create widget instance',
-                        'category': 'instantiation',
-                        'confidence': 0.85,
-                        'file_path': 'tests/test_widget.py',
-                        'code_snippet': 'widget = Widget(name="test")'
+                        "description": "Create widget instance",
+                        "category": "instantiation",
+                        "confidence": 0.85,
+                        "file_path": "tests/test_widget.py",
+                        "code_snippet": 'widget = Widget(name="test")',
                     }
                 ],
-                'examples_by_category': {
-                    'instantiation': 5,
-                    'method_call': 6,
-                    'workflow': 4
-                }
+                "examples_by_category": {"instantiation": 5, "method_call": 6, "workflow": 4},
             },
-            'how_to_guides': {
-                'guides': [
+            "how_to_guides": {
+                "guides": [
                     {
-                        'id': 'create_widget',
-                        'title': 'How to create a widget',
-                        'description': 'Step-by-step guide',
-                        'steps': [
+                        "id": "create_widget",
+                        "title": "How to create a widget",
+                        "description": "Step-by-step guide",
+                        "steps": [
                             {
-                                'action': 'Import Widget class',
-                                'code_example': 'from widgets import Widget',
-                                'language': 'python'
+                                "action": "Import Widget class",
+                                "code_example": "from widgets import Widget",
+                                "language": "python",
                             }
-                        ]
+                        ],
                     }
                 ],
-                'total_count': 1
+                "total_count": 1,
             },
-            'config_patterns': {
-                'config_files': [
+            "config_patterns": {
+                "config_files": [
                     {
-                        'relative_path': 'config.json',
-                        'type': 'json',
-                        'purpose': 'Application configuration',
-                        'settings': [
-                            {'key': 'debug', 'value': 'true', 'value_type': 'boolean'}
-                        ]
+                        "relative_path": "config.json",
+                        "type": "json",
+                        "purpose": "Application configuration",
+                        "settings": [{"key": "debug", "value": "true", "value_type": "boolean"}],
                     }
                 ],
-                'ai_enhancements': {
-                    'overall_insights': {
-                        'security_issues_found': 1,
-                        'recommended_actions': ['Move secrets to .env']
-                    }
-                }
+                "ai_enhancements": {
+                    "overall_insights": {"security_issues_found": 1, "recommended_actions": ["Move secrets to .env"]}
+                },
             },
-            'architecture': {
-                'patterns': [
+            "architecture": {
+                "patterns": [
                     {
-                        'pattern_name': 'MVC',
-                        'confidence': 0.89,
-                        'framework': 'Flask',
-                        'evidence': ['models/ directory', 'views/ directory', 'controllers/ directory']
+                        "pattern_name": "MVC",
+                        "confidence": 0.89,
+                        "framework": "Flask",
+                        "evidence": ["models/ directory", "views/ directory", "controllers/ directory"],
                     }
                 ],
-                'frameworks_detected': ['Flask', 'SQLAlchemy'],
-                'languages': {'python': 42, 'javascript': 8},
-                'directory_structure': {
-                    'src': 25,
-                    'tests': 15,
-                    'docs': 3
-                }
-            }
+                "frameworks_detected": ["Flask", "SQLAlchemy"],
+                "languages": {"python": 42, "javascript": 8},
+                "directory_structure": {"src": 25, "tests": 15, "docs": 3},
+            },
         }
 
     def test_codebase_analysis_enabled_by_default(self, mock_config, temp_dir):
         """Test that enable_codebase_analysis defaults to True."""
         # Config with GitHub source but no explicit enable_codebase_analysis
         config_without_flag = {
-            'name': 'test',
-            'description': 'Test',
-            'sources': [
-                {
-                    'type': 'github',
-                    'repo': 'test/repo',
-                    'local_repo_path': temp_dir
-                }
-            ]
+            "name": "test",
+            "description": "Test",
+            "sources": [{"type": "github", "repo": "test/repo", "local_repo_path": temp_dir}],
         }
 
         # Save config
-        config_path = os.path.join(temp_dir, 'config.json')
-        with open(config_path, 'w') as f:
+        config_path = os.path.join(temp_dir, "config.json")
+        with open(config_path, "w") as f:
             json.dump(config_without_flag, f)
 
         # Create scraper
         scraper = UnifiedScraper(config_path)
 
         # Verify default is True
-        github_source = scraper.config['sources'][0]
-        assert github_source.get('enable_codebase_analysis', True) == True
+        github_source = scraper.config["sources"][0]
+        assert github_source.get("enable_codebase_analysis", True) == True
 
     def test_skip_codebase_analysis_flag(self, mock_config, temp_dir):
         """Test --skip-codebase-analysis CLI flag disables analysis."""
         # Save config
-        config_path = os.path.join(temp_dir, 'config.json')
-        with open(config_path, 'w') as f:
+        config_path = os.path.join(temp_dir, "config.json")
+        with open(config_path, "w") as f:
             json.dump(mock_config, f)
 
         # Create scraper
         scraper = UnifiedScraper(config_path)
 
         # Simulate --skip-codebase-analysis flag behavior
-        for source in scraper.config.get('sources', []):
-            if source['type'] == 'github':
-                source['enable_codebase_analysis'] = False
+        for source in scraper.config.get("sources", []):
+            if source["type"] == "github":
+                source["enable_codebase_analysis"] = False
 
         # Verify flag disabled it
-        github_source = scraper.config['sources'][0]
-        assert github_source['enable_codebase_analysis'] == False
+        github_source = scraper.config["sources"][0]
+        assert github_source["enable_codebase_analysis"] == False
 
     def test_architecture_md_generation(self, mock_config, mock_c3_data, temp_dir):
         """Test ARCHITECTURE.md is generated with all 8 sections."""
         # Create skill builder with C3.x data (multi-source list format)
-        github_data = {
-            'readme': 'Test README',
-            'c3_analysis': mock_c3_data
-        }
-        scraped_data = {
-            'github': [{
-                'repo': 'test/repo',
-                'repo_id': 'test_repo',
-                'idx': 0,
-                'data': github_data
-            }]
-        }
+        github_data = {"readme": "Test README", "c3_analysis": mock_c3_data}
+        scraped_data = {"github": [{"repo": "test/repo", "repo_id": "test_repo", "idx": 0, "data": github_data}]}
 
         builder = UnifiedSkillBuilder(mock_config, scraped_data)
         builder.skill_dir = temp_dir
 
         # Generate C3.x references
-        c3_dir = os.path.join(temp_dir, 'references', 'codebase_analysis')
+        c3_dir = os.path.join(temp_dir, "references", "codebase_analysis")
         os.makedirs(c3_dir, exist_ok=True)
         builder._generate_architecture_overview(c3_dir, mock_c3_data, github_data)
 
         # Verify ARCHITECTURE.md exists
-        arch_file = os.path.join(c3_dir, 'ARCHITECTURE.md')
+        arch_file = os.path.join(c3_dir, "ARCHITECTURE.md")
         assert os.path.exists(arch_file)
 
         # Read and verify content
-        with open(arch_file, 'r') as f:
+        with open(arch_file) as f:
             content = f.read()
 
         # Verify all 8 sections exist
-        assert '## 1. Overview' in content
-        assert '## 2. Architectural Patterns' in content
-        assert '## 3. Technology Stack' in content
-        assert '## 4. Design Patterns' in content
-        assert '## 5. Configuration Overview' in content
-        assert '## 6. Common Workflows' in content
-        assert '## 7. Usage Examples' in content
-        assert '## 8. Entry Points & Directory Structure' in content
+        assert "## 1. Overview" in content
+        assert "## 2. Architectural Patterns" in content
+        assert "## 3. Technology Stack" in content
+        assert "## 4. Design Patterns" in content
+        assert "## 5. Configuration Overview" in content
+        assert "## 6. Common Workflows" in content
+        assert "## 7. Usage Examples" in content
+        assert "## 8. Entry Points & Directory Structure" in content
 
         # Verify specific data is present
-        assert 'MVC' in content
-        assert 'Flask' in content
-        assert 'Factory' in content
-        assert '15 usage example(s)' in content or '15 total' in content
-        assert 'Security Alert' in content
+        assert "MVC" in content
+        assert "Flask" in content
+        assert "Factory" in content
+        assert "15 usage example(s)" in content or "15 total" in content
+        assert "Security Alert" in content
 
     def test_c3_reference_directory_structure(self, mock_config, mock_c3_data, temp_dir):
         """Test correct C3.x reference directory structure is created."""
         # Create skill builder with C3.x data (multi-source list format)
-        github_data = {
-            'readme': 'Test README',
-            'c3_analysis': mock_c3_data
-        }
-        scraped_data = {
-            'github': [{
-                'repo': 'test/repo',
-                'repo_id': 'test_repo',
-                'idx': 0,
-                'data': github_data
-            }]
-        }
+        github_data = {"readme": "Test README", "c3_analysis": mock_c3_data}
+        scraped_data = {"github": [{"repo": "test/repo", "repo_id": "test_repo", "idx": 0, "data": github_data}]}
 
         builder = UnifiedSkillBuilder(mock_config, scraped_data)
         builder.skill_dir = temp_dir
 
         # Generate C3.x references
-        c3_dir = os.path.join(temp_dir, 'references', 'codebase_analysis')
+        c3_dir = os.path.join(temp_dir, "references", "codebase_analysis")
         os.makedirs(c3_dir, exist_ok=True)
 
         builder._generate_architecture_overview(c3_dir, mock_c3_data, github_data)
-        builder._generate_pattern_references(c3_dir, mock_c3_data.get('patterns'))
-        builder._generate_example_references(c3_dir, mock_c3_data.get('test_examples'))
-        builder._generate_guide_references(c3_dir, mock_c3_data.get('how_to_guides'))
-        builder._generate_config_references(c3_dir, mock_c3_data.get('config_patterns'))
-        builder._copy_architecture_details(c3_dir, mock_c3_data.get('architecture'))
+        builder._generate_pattern_references(c3_dir, mock_c3_data.get("patterns"))
+        builder._generate_example_references(c3_dir, mock_c3_data.get("test_examples"))
+        builder._generate_guide_references(c3_dir, mock_c3_data.get("how_to_guides"))
+        builder._generate_config_references(c3_dir, mock_c3_data.get("config_patterns"))
+        builder._copy_architecture_details(c3_dir, mock_c3_data.get("architecture"))
 
         # Verify directory structure
-        assert os.path.exists(os.path.join(c3_dir, 'ARCHITECTURE.md'))
-        assert os.path.exists(os.path.join(c3_dir, 'patterns'))
-        assert os.path.exists(os.path.join(c3_dir, 'examples'))
-        assert os.path.exists(os.path.join(c3_dir, 'guides'))
-        assert os.path.exists(os.path.join(c3_dir, 'configuration'))
-        assert os.path.exists(os.path.join(c3_dir, 'architecture_details'))
+        assert os.path.exists(os.path.join(c3_dir, "ARCHITECTURE.md"))
+        assert os.path.exists(os.path.join(c3_dir, "patterns"))
+        assert os.path.exists(os.path.join(c3_dir, "examples"))
+        assert os.path.exists(os.path.join(c3_dir, "guides"))
+        assert os.path.exists(os.path.join(c3_dir, "configuration"))
+        assert os.path.exists(os.path.join(c3_dir, "architecture_details"))
 
         # Verify index files
-        assert os.path.exists(os.path.join(c3_dir, 'patterns', 'index.md'))
-        assert os.path.exists(os.path.join(c3_dir, 'examples', 'index.md'))
-        assert os.path.exists(os.path.join(c3_dir, 'guides', 'index.md'))
-        assert os.path.exists(os.path.join(c3_dir, 'configuration', 'index.md'))
-        assert os.path.exists(os.path.join(c3_dir, 'architecture_details', 'index.md'))
+        assert os.path.exists(os.path.join(c3_dir, "patterns", "index.md"))
+        assert os.path.exists(os.path.join(c3_dir, "examples", "index.md"))
+        assert os.path.exists(os.path.join(c3_dir, "guides", "index.md"))
+        assert os.path.exists(os.path.join(c3_dir, "configuration", "index.md"))
+        assert os.path.exists(os.path.join(c3_dir, "architecture_details", "index.md"))
 
         # Verify JSON data files
-        assert os.path.exists(os.path.join(c3_dir, 'patterns', 'detected_patterns.json'))
-        assert os.path.exists(os.path.join(c3_dir, 'examples', 'test_examples.json'))
-        assert os.path.exists(os.path.join(c3_dir, 'configuration', 'config_patterns.json'))
+        assert os.path.exists(os.path.join(c3_dir, "patterns", "detected_patterns.json"))
+        assert os.path.exists(os.path.join(c3_dir, "examples", "test_examples.json"))
+        assert os.path.exists(os.path.join(c3_dir, "configuration", "config_patterns.json"))
 
     def test_graceful_degradation_on_c3_failure(self, mock_config, temp_dir):
         """Test skill builds even if C3.x analysis fails."""
         # Mock _run_c3_analysis to raise exception
-        with patch('skill_seekers.cli.unified_scraper.UnifiedScraper._run_c3_analysis') as mock_c3:
+        with patch("skill_seekers.cli.unified_scraper.UnifiedScraper._run_c3_analysis") as mock_c3:
             mock_c3.side_effect = Exception("C3.x analysis failed")
 
             # Save config
-            config_path = os.path.join(temp_dir, 'config.json')
-            with open(config_path, 'w') as f:
+            config_path = os.path.join(temp_dir, "config.json")
+            with open(config_path, "w") as f:
                 json.dump(mock_config, f)
 
             # Mock GitHubScraper (correct module path for import)
-            with patch('skill_seekers.cli.github_scraper.GitHubScraper') as mock_github:
-                mock_github.return_value.scrape.return_value = {
-                    'readme': 'Test README',
-                    'issues': [],
-                    'releases': []
-                }
+            with patch("skill_seekers.cli.github_scraper.GitHubScraper") as mock_github:
+                mock_github.return_value.scrape.return_value = {"readme": "Test README", "issues": [], "releases": []}
 
                 scraper = UnifiedScraper(config_path)
 
                 # This should not raise an exception
                 try:
-                    scraper._scrape_github(mock_config['sources'][0])
+                    scraper._scrape_github(mock_config["sources"][0])
                     # If we get here, graceful degradation worked
                     assert True
                 except Exception as e:
@@ -318,21 +276,14 @@ class TestC3Integration:
     def test_config_validator_accepts_c3_properties(self, temp_dir):
         """Test config validator accepts new C3.5 properties."""
         config = {
-            'name': 'test',
-            'description': 'Test',
-            'sources': [
-                {
-                    'type': 'github',
-                    'repo': 'test/repo',
-                    'enable_codebase_analysis': True,
-                    'ai_mode': 'auto'
-                }
-            ]
+            "name": "test",
+            "description": "Test",
+            "sources": [{"type": "github", "repo": "test/repo", "enable_codebase_analysis": True, "ai_mode": "auto"}],
         }
 
         # Save config
-        config_path = os.path.join(temp_dir, 'config.json')
-        with open(config_path, 'w') as f:
+        config_path = os.path.join(temp_dir, "config.json")
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Validate
@@ -342,20 +293,20 @@ class TestC3Integration:
     def test_config_validator_rejects_invalid_ai_mode(self, temp_dir):
         """Test config validator rejects invalid ai_mode values."""
         config = {
-            'name': 'test',
-            'description': 'Test',
-            'sources': [
+            "name": "test",
+            "description": "Test",
+            "sources": [
                 {
-                    'type': 'github',
-                    'repo': 'test/repo',
-                    'ai_mode': 'invalid_mode'  # Invalid!
+                    "type": "github",
+                    "repo": "test/repo",
+                    "ai_mode": "invalid_mode",  # Invalid!
                 }
-            ]
+            ],
         }
 
         # Save config
-        config_path = os.path.join(temp_dir, 'config.json')
-        with open(config_path, 'w') as f:
+        config_path = os.path.join(temp_dir, "config.json")
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Validate should raise
@@ -365,32 +316,25 @@ class TestC3Integration:
 
     def test_skill_md_includes_c3_summary(self, mock_config, mock_c3_data, temp_dir):
         """Test SKILL.md includes C3.x architecture summary."""
-        scraped_data = {
-            'github': {
-                'data': {
-                    'readme': 'Test README',
-                    'c3_analysis': mock_c3_data
-                }
-            }
-        }
+        scraped_data = {"github": {"data": {"readme": "Test README", "c3_analysis": mock_c3_data}}}
 
         builder = UnifiedSkillBuilder(mock_config, scraped_data)
         builder.skill_dir = temp_dir
         builder._generate_skill_md()
 
         # Read SKILL.md
-        skill_file = os.path.join(temp_dir, 'SKILL.md')
-        with open(skill_file, 'r') as f:
+        skill_file = os.path.join(temp_dir, "SKILL.md")
+        with open(skill_file) as f:
             content = f.read()
 
         # Verify C3.x summary section exists
-        assert '## 🏗️ Architecture & Code Analysis' in content
-        assert 'Primary Architecture' in content
-        assert 'MVC' in content
-        assert 'Design Patterns' in content
-        assert 'Factory' in content
-        assert 'references/codebase_analysis/ARCHITECTURE.md' in content
+        assert "## 🏗️ Architecture & Code Analysis" in content
+        assert "Primary Architecture" in content
+        assert "MVC" in content
+        assert "Design Patterns" in content
+        assert "Factory" in content
+        assert "references/codebase_analysis/ARCHITECTURE.md" in content
 
 
-if __name__ == '__main__':
-    pytest.main([__file__, '-v'])
+if __name__ == "__main__":
+    pytest.main([__file__, "-v"])
diff --git a/tests/test_cli_paths.py b/tests/test_cli_paths.py
index a136c05..a646872 100644
--- a/tests/test_cli_paths.py
+++ b/tests/test_cli_paths.py
@@ -4,10 +4,10 @@ Test suite for modern CLI command patterns
 Tests that all CLI scripts use correct unified CLI commands in usage messages and print statements
 """
 
-import sys
 import os
-import unittest
 import subprocess
+import sys
+import unittest
 from pathlib import Path
 
 # Add parent directory to path
@@ -19,68 +19,68 @@ class TestModernCLICommands(unittest.TestCase):
 
     def test_doc_scraper_uses_modern_commands(self):
         """Test doc_scraper.py uses skill-seekers commands"""
-        script_path = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli' / 'doc_scraper.py'
+        script_path = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli" / "doc_scraper.py"
 
-        with open(script_path, 'r') as f:
+        with open(script_path) as f:
             content = f.read()
 
         # Should use modern commands
-        self.assertIn('skill-seekers scrape', content)
+        self.assertIn("skill-seekers scrape", content)
 
         # Should NOT use old python3 cli/ pattern
-        self.assertNotIn('python3 cli/doc_scraper.py', content)
+        self.assertNotIn("python3 cli/doc_scraper.py", content)
 
     def test_enhance_skill_local_uses_modern_commands(self):
         """Test enhance_skill_local.py uses skill-seekers commands"""
-        script_path = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli' / 'enhance_skill_local.py'
+        script_path = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli" / "enhance_skill_local.py"
 
-        with open(script_path, 'r') as f:
+        with open(script_path) as f:
             content = f.read()
 
         # Should use modern commands
-        self.assertIn('skill-seekers', content)
+        self.assertIn("skill-seekers", content)
 
         # Should NOT use old python3 cli/ pattern
-        self.assertNotIn('python3 cli/enhance_skill_local.py', content)
+        self.assertNotIn("python3 cli/enhance_skill_local.py", content)
 
     def test_estimate_pages_uses_modern_commands(self):
         """Test estimate_pages.py uses skill-seekers commands"""
-        script_path = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli' / 'estimate_pages.py'
+        script_path = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli" / "estimate_pages.py"
 
-        with open(script_path, 'r') as f:
+        with open(script_path) as f:
             content = f.read()
 
         # Should use modern commands
-        self.assertIn('skill-seekers estimate', content)
+        self.assertIn("skill-seekers estimate", content)
 
         # Should NOT use old python3 cli/ pattern
-        self.assertNotIn('python3 cli/estimate_pages.py', content)
+        self.assertNotIn("python3 cli/estimate_pages.py", content)
 
     def test_package_skill_uses_modern_commands(self):
         """Test package_skill.py uses skill-seekers commands"""
-        script_path = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli' / 'package_skill.py'
+        script_path = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli" / "package_skill.py"
 
-        with open(script_path, 'r') as f:
+        with open(script_path) as f:
             content = f.read()
 
         # Should use modern commands
-        self.assertIn('skill-seekers package', content)
+        self.assertIn("skill-seekers package", content)
 
         # Should NOT use old python3 cli/ pattern
-        self.assertNotIn('python3 cli/package_skill.py', content)
+        self.assertNotIn("python3 cli/package_skill.py", content)
 
     def test_github_scraper_uses_modern_commands(self):
         """Test github_scraper.py uses skill-seekers commands"""
-        script_path = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli' / 'github_scraper.py'
+        script_path = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli" / "github_scraper.py"
 
-        with open(script_path, 'r') as f:
+        with open(script_path) as f:
             content = f.read()
 
         # Should use modern commands
-        self.assertIn('skill-seekers', content)
+        self.assertIn("skill-seekers", content)
 
         # Should NOT use old python3 cli/ pattern
-        self.assertNotIn('python3 cli/github_scraper.py', content)
+        self.assertNotIn("python3 cli/github_scraper.py", content)
 
 
 class TestUnifiedCLIEntryPoints(unittest.TestCase):
@@ -89,22 +89,16 @@ class TestUnifiedCLIEntryPoints(unittest.TestCase):
     def test_main_cli_help_output(self):
         """Test skill-seekers --help works"""
         try:
-            result = subprocess.run(
-                ['skill-seekers', '--help'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers", "--help"], capture_output=True, text=True, timeout=5)
 
             # Should return successfully
-            self.assertIn(result.returncode, [0, 2],
-                         f"skill-seekers --help failed with code {result.returncode}")
+            self.assertIn(result.returncode, [0, 2], f"skill-seekers --help failed with code {result.returncode}")
 
             # Should show subcommands
             output = result.stdout + result.stderr
-            self.assertIn('scrape', output)
-            self.assertIn('github', output)
-            self.assertIn('package', output)
+            self.assertIn("scrape", output)
+            self.assertIn("github", output)
+            self.assertIn("package", output)
 
         except FileNotFoundError:
             # If skill-seekers is not installed, skip this test
@@ -113,20 +107,14 @@ class TestUnifiedCLIEntryPoints(unittest.TestCase):
     def test_main_cli_version_output(self):
         """Test skill-seekers --version works"""
         try:
-            result = subprocess.run(
-                ['skill-seekers', '--version'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers", "--version"], capture_output=True, text=True, timeout=5)
 
             # Should return successfully
-            self.assertEqual(result.returncode, 0,
-                           f"skill-seekers --version failed: {result.stderr}")
+            self.assertEqual(result.returncode, 0, f"skill-seekers --version failed: {result.stderr}")
 
             # Should show version
             output = result.stdout + result.stderr
-            self.assertIn('2.5.1', output)
+            self.assertIn("2.5.1", output)
 
         except FileNotFoundError:
             # If skill-seekers is not installed, skip this test
@@ -138,21 +126,22 @@ class TestNoHardcodedPaths(unittest.TestCase):
 
     def test_no_hardcoded_paths_in_cli_scripts(self):
         """Test that CLI scripts don't have hardcoded paths"""
-        cli_dir = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli'
+        cli_dir = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli"
 
         hardcoded_paths = [
-            '/mnt/skills/examples/skill-creator/scripts/',
-            '/home/',
-            '/Users/',
+            "/mnt/skills/examples/skill-creator/scripts/",
+            "/home/",
+            "/Users/",
         ]
 
-        for script_path in cli_dir.glob('*.py'):
-            with open(script_path, 'r') as f:
+        for script_path in cli_dir.glob("*.py"):
+            with open(script_path) as f:
                 content = f.read()
 
             for hardcoded_path in hardcoded_paths:
-                self.assertNotIn(hardcoded_path, content,
-                               f"{script_path.name} contains hardcoded path: {hardcoded_path}")
+                self.assertNotIn(
+                    hardcoded_path, content, f"{script_path.name} contains hardcoded path: {hardcoded_path}"
+                )
 
 
 class TestPackageStructure(unittest.TestCase):
@@ -160,30 +149,30 @@ class TestPackageStructure(unittest.TestCase):
 
     def test_src_layout_exists(self):
         """Test that src/ layout directory exists"""
-        src_dir = Path(__file__).parent.parent / 'src' / 'skill_seekers'
+        src_dir = Path(__file__).parent.parent / "src" / "skill_seekers"
         self.assertTrue(src_dir.exists(), "src/skill_seekers/ directory should exist")
 
     def test_cli_package_exists(self):
         """Test that CLI package exists in src/"""
-        cli_dir = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli'
+        cli_dir = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli"
         self.assertTrue(cli_dir.exists(), "src/skill_seekers/cli/ directory should exist")
 
-        init_file = cli_dir / '__init__.py'
+        init_file = cli_dir / "__init__.py"
         self.assertTrue(init_file.exists(), "src/skill_seekers/cli/__init__.py should exist")
 
     def test_mcp_package_exists(self):
         """Test that MCP package exists in src/"""
-        mcp_dir = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'mcp'
+        mcp_dir = Path(__file__).parent.parent / "src" / "skill_seekers" / "mcp"
         self.assertTrue(mcp_dir.exists(), "src/skill_seekers/mcp/ directory should exist")
 
-        init_file = mcp_dir / '__init__.py'
+        init_file = mcp_dir / "__init__.py"
         self.assertTrue(init_file.exists(), "src/skill_seekers/mcp/__init__.py should exist")
 
     def test_main_cli_file_exists(self):
         """Test that main.py unified CLI exists"""
-        main_file = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli' / 'main.py'
+        main_file = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli" / "main.py"
         self.assertTrue(main_file.exists(), "src/skill_seekers/cli/main.py should exist")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_code_analyzer.py b/tests/test_code_analyzer.py
index d2ee8cf..1b99c2d 100644
--- a/tests/test_code_analyzer.py
+++ b/tests/test_code_analyzer.py
@@ -10,12 +10,12 @@ Test Coverage:
 - Error handling
 """
 
-import unittest
-import sys
 import os
+import sys
+import unittest
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 from skill_seekers.cli.code_analyzer import CodeAnalyzer
 
@@ -25,7 +25,7 @@ class TestPythonParsing(unittest.TestCase):
 
     def setUp(self):
         """Set up test analyzer with deep analysis"""
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_python_function_signature_basic(self):
         """Test basic Python function signature extraction."""
@@ -34,17 +34,17 @@ def greet(name, age):
     """Say hello."""
     return f"Hello {name}, you are {age}"
 '''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
 
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'greet')
-        self.assertEqual(len(func['parameters']), 2)
-        self.assertEqual(func['parameters'][0]['name'], 'name')
-        self.assertEqual(func['parameters'][1]['name'], 'age')
-        self.assertEqual(func['docstring'], 'Say hello.')
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "greet")
+        self.assertEqual(len(func["parameters"]), 2)
+        self.assertEqual(func["parameters"][0]["name"], "name")
+        self.assertEqual(func["parameters"][1]["name"], "age")
+        self.assertEqual(func["docstring"], "Say hello.")
 
     def test_python_function_with_type_hints(self):
         """Test Python function with type annotations."""
@@ -53,16 +53,16 @@ def add_numbers(a: int, b: int) -> int:
     """Add two integers."""
     return a + b
 '''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        self.assertIn('functions', result)
-        func = result['functions'][0]
+        self.assertIn("functions", result)
+        func = result["functions"][0]
 
-        self.assertEqual(func['name'], 'add_numbers')
-        self.assertEqual(func['return_type'], 'int')
-        self.assertEqual(func['parameters'][0]['type_hint'], 'int')
-        self.assertEqual(func['parameters'][1]['type_hint'], 'int')
-        self.assertEqual(func['docstring'], 'Add two integers.')
+        self.assertEqual(func["name"], "add_numbers")
+        self.assertEqual(func["return_type"], "int")
+        self.assertEqual(func["parameters"][0]["type_hint"], "int")
+        self.assertEqual(func["parameters"][1]["type_hint"], "int")
+        self.assertEqual(func["docstring"], "Add two integers.")
 
     def test_python_function_with_defaults(self):
         """Test Python function with default parameter values."""
@@ -71,15 +71,15 @@ def create_user(name: str, age: int = 18, active: bool = True) -> dict:
     """Create a user object."""
     return {"name": name, "age": age, "active": active}
 '''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'create_user')
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "create_user")
 
         # Check defaults
-        self.assertIsNone(func['parameters'][0]['default'])
-        self.assertEqual(func['parameters'][1]['default'], '18')
-        self.assertEqual(func['parameters'][2]['default'], 'True')
+        self.assertIsNone(func["parameters"][0]["default"])
+        self.assertEqual(func["parameters"][1]["default"], "18")
+        self.assertEqual(func["parameters"][2]["default"], "True")
 
     def test_python_async_function(self):
         """Test async Python function detection."""
@@ -88,12 +88,12 @@ async def fetch_data(url: str) -> dict:
     """Fetch data from URL."""
     pass
 '''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'fetch_data')
-        self.assertTrue(func['is_async'])
-        self.assertEqual(func['return_type'], 'dict')
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "fetch_data")
+        self.assertTrue(func["is_async"])
+        self.assertEqual(func["return_type"], "dict")
 
     def test_python_class_extraction(self):
         """Test Python class extraction with inheritance."""
@@ -112,24 +112,24 @@ class Dog(Animal):
         """Bark loudly."""
         print("Woof!")
 '''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 2)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 2)
 
         # Check first class
-        animal_class = result['classes'][0]
-        self.assertEqual(animal_class['name'], 'Animal')
-        self.assertEqual(animal_class['docstring'], 'Base animal class.')
-        self.assertEqual(len(animal_class['methods']), 1)
-        self.assertEqual(animal_class['methods'][0]['name'], 'make_sound')
+        animal_class = result["classes"][0]
+        self.assertEqual(animal_class["name"], "Animal")
+        self.assertEqual(animal_class["docstring"], "Base animal class.")
+        self.assertEqual(len(animal_class["methods"]), 1)
+        self.assertEqual(animal_class["methods"][0]["name"], "make_sound")
 
         # Check inherited class
-        dog_class = result['classes'][1]
-        self.assertEqual(dog_class['name'], 'Dog')
-        self.assertEqual(dog_class['base_classes'], ['Animal'])
-        self.assertEqual(len(dog_class['methods']), 1)
-        self.assertEqual(dog_class['methods'][0]['name'], 'bark')
+        dog_class = result["classes"][1]
+        self.assertEqual(dog_class["name"], "Dog")
+        self.assertEqual(dog_class["base_classes"], ["Animal"])
+        self.assertEqual(len(dog_class["methods"]), 1)
+        self.assertEqual(dog_class["methods"][0]["name"], "bark")
 
     def test_python_docstring_extraction(self):
         """Test docstring extraction for functions and classes."""
@@ -152,18 +152,18 @@ class Calculator:
         """
         return a + b
 '''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
         # Check class docstring
-        calc_class = result['classes'][0]
-        self.assertIn('A simple calculator class', calc_class['docstring'])
-        self.assertIn('Supports basic arithmetic operations', calc_class['docstring'])
+        calc_class = result["classes"][0]
+        self.assertIn("A simple calculator class", calc_class["docstring"])
+        self.assertIn("Supports basic arithmetic operations", calc_class["docstring"])
 
         # Check method docstring
-        add_method = calc_class['methods'][0]
-        self.assertIn('Add two numbers', add_method['docstring'])
-        self.assertIn('Args:', add_method['docstring'])
-        self.assertIn('Returns:', add_method['docstring'])
+        add_method = calc_class["methods"][0]
+        self.assertIn("Add two numbers", add_method["docstring"])
+        self.assertIn("Args:", add_method["docstring"])
+        self.assertIn("Returns:", add_method["docstring"])
 
     def test_python_decorators(self):
         """Test decorator extraction."""
@@ -184,29 +184,29 @@ class MyClass:
         """Create from dict."""
         pass
 '''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        my_class = result['classes'][0]
-        methods = my_class['methods']
+        my_class = result["classes"][0]
+        methods = my_class["methods"]
 
         # Check decorators
-        self.assertIn('property', methods[0]['decorators'])
-        self.assertIn('staticmethod', methods[1]['decorators'])
-        self.assertIn('classmethod', methods[2]['decorators'])
+        self.assertIn("property", methods[0]["decorators"])
+        self.assertIn("staticmethod", methods[1]["decorators"])
+        self.assertIn("classmethod", methods[2]["decorators"])
 
     def test_python_syntax_error_handling(self):
         """Test handling of malformed Python code."""
-        code = '''
+        code = """
 def broken_function(
     # Missing closing parenthesis
     return "broken"
-'''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+"""
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
         # Should return empty dict or handle gracefully, not crash
         self.assertIsInstance(result, dict)
         # No functions should be extracted from broken code
-        self.assertEqual(result.get('functions', []), [])
+        self.assertEqual(result.get("functions", []), [])
 
 
 class TestJavaScriptParsing(unittest.TestCase):
@@ -214,41 +214,41 @@ class TestJavaScriptParsing(unittest.TestCase):
 
     def setUp(self):
         """Set up test analyzer with deep analysis"""
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_javascript_function_basic(self):
         """Test basic JavaScript function extraction."""
-        code = '''
+        code = """
 function greet(name, age) {
     return `Hello ${name}, you are ${age}`;
 }
-'''
-        result = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+"""
+        result = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
-        self.assertIn('functions', result)
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'greet')
-        self.assertEqual(len(func['parameters']), 2)
-        self.assertEqual(func['parameters'][0]['name'], 'name')
-        self.assertEqual(func['parameters'][1]['name'], 'age')
+        self.assertIn("functions", result)
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "greet")
+        self.assertEqual(len(func["parameters"]), 2)
+        self.assertEqual(func["parameters"][0]["name"], "name")
+        self.assertEqual(func["parameters"][1]["name"], "age")
 
     def test_javascript_arrow_function(self):
         """Test arrow function detection."""
-        code = '''
+        code = """
 const add = (a, b) => {
     return a + b;
 };
 
 const multiply = (x, y) => x * y;
-'''
-        result = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+"""
+        result = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 2)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 2)
 
         # Check first arrow function
-        self.assertEqual(result['functions'][0]['name'], 'add')
-        self.assertEqual(len(result['functions'][0]['parameters']), 2)
+        self.assertEqual(result["functions"][0]["name"], "add")
+        self.assertEqual(len(result["functions"][0]["parameters"]), 2)
 
     def test_javascript_class_methods(self):
         """Test ES6 class method extraction.
@@ -256,7 +256,7 @@ const multiply = (x, y) => x * y;
         Note: Regex-based parser has limitations in extracting all methods.
         This test verifies basic method extraction works.
         """
-        code = '''
+        code = """
 class User {
     constructor(name, email) {
         this.name = name;
@@ -271,18 +271,18 @@ class User {
         return await fetch('/api/user');
     }
 }
-'''
-        result = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+"""
+        result = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
-        self.assertIn('classes', result)
-        user_class = result['classes'][0]
+        self.assertIn("classes", result)
+        user_class = result["classes"][0]
 
-        self.assertEqual(user_class['name'], 'User')
+        self.assertEqual(user_class["name"], "User")
         # Regex parser may not catch all methods, verify at least one method extracted
-        self.assertGreaterEqual(len(user_class['methods']), 1)
+        self.assertGreaterEqual(len(user_class["methods"]), 1)
 
         # Check that methods list is not empty
-        method_names = [m['name'] for m in user_class['methods']]
+        method_names = [m["name"] for m in user_class["methods"]]
         self.assertGreater(len(method_names), 0)
 
     def test_typescript_type_annotations(self):
@@ -292,7 +292,7 @@ class User {
         but NOT return types. Return type extraction requires a proper
         TypeScript parser (ts-morph or typescript library).
         """
-        code = '''
+        code = """
 function calculate(a: number, b: number): number {
     return a + b;
 }
@@ -305,28 +305,28 @@ interface User {
 function createUser(name: string, age: number = 18): User {
     return { name, age };
 }
-'''
-        result = self.analyzer.analyze_file('test.ts', code, 'TypeScript')
+"""
+        result = self.analyzer.analyze_file("test.ts", code, "TypeScript")
 
-        self.assertIn('functions', result)
+        self.assertIn("functions", result)
 
         # Check first function - parameters extracted, but not return type
-        calc_func = result['functions'][0]
-        self.assertEqual(calc_func['name'], 'calculate')
-        self.assertEqual(calc_func['parameters'][0]['type_hint'], 'number')
+        calc_func = result["functions"][0]
+        self.assertEqual(calc_func["name"], "calculate")
+        self.assertEqual(calc_func["parameters"][0]["type_hint"], "number")
         # Note: return_type is None because regex parser doesn't extract it
-        self.assertIsNone(calc_func['return_type'])
+        self.assertIsNone(calc_func["return_type"])
 
         # Check function with default
-        create_func = result['functions'][1]
-        self.assertEqual(create_func['name'], 'createUser')
-        self.assertEqual(create_func['parameters'][1]['default'], '18')
+        create_func = result["functions"][1]
+        self.assertEqual(create_func["name"], "createUser")
+        self.assertEqual(create_func["parameters"][1]["default"], "18")
         # Note: return_type is None (regex parser limitation)
-        self.assertIsNone(create_func['return_type'])
+        self.assertIsNone(create_func["return_type"])
 
     def test_javascript_async_detection(self):
         """Test async function detection in JavaScript."""
-        code = '''
+        code = """
 async function fetchUser(id) {
     const response = await fetch(`/api/users/${id}`);
     return response.json();
@@ -335,16 +335,16 @@ async function fetchUser(id) {
 const loadData = async () => {
     return await fetchUser(1);
 };
-'''
-        result = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+"""
+        result = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
-        self.assertIn('functions', result)
-        self.assertGreaterEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertGreaterEqual(len(result["functions"]), 1)
 
         # Check async function
-        fetch_func = result['functions'][0]
-        self.assertEqual(fetch_func['name'], 'fetchUser')
-        self.assertTrue(fetch_func['is_async'])
+        fetch_func = result["functions"][0]
+        self.assertEqual(fetch_func["name"], "fetchUser")
+        self.assertTrue(fetch_func["is_async"])
 
 
 class TestCppParsing(unittest.TestCase):
@@ -352,30 +352,30 @@ class TestCppParsing(unittest.TestCase):
 
     def setUp(self):
         """Set up test analyzer with deep analysis"""
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_cpp_function_signature(self):
         """Test C++ function declaration parsing."""
-        code = '''
+        code = """
 int add(int a, int b);
 
 std::string getName();
 
 void processData(const std::vector<int>& data);
-'''
-        result = self.analyzer.analyze_file('test.h', code, 'C++')
+"""
+        result = self.analyzer.analyze_file("test.h", code, "C++")
 
-        self.assertIn('functions', result)
-        self.assertGreaterEqual(len(result['functions']), 2)
+        self.assertIn("functions", result)
+        self.assertGreaterEqual(len(result["functions"]), 2)
 
         # Check first function
-        add_func = result['functions'][0]
-        self.assertEqual(add_func['name'], 'add')
-        self.assertEqual(add_func['return_type'], 'int')
+        add_func = result["functions"][0]
+        self.assertEqual(add_func["name"], "add")
+        self.assertEqual(add_func["return_type"], "int")
 
     def test_cpp_class_extraction(self):
         """Test C++ class extraction with inheritance."""
-        code = '''
+        code = """
 class Animal {
 public:
     virtual void makeSound() = 0;
@@ -388,56 +388,56 @@ public:
 private:
     std::string breed;
 };
-'''
-        result = self.analyzer.analyze_file('test.h', code, 'C++')
+"""
+        result = self.analyzer.analyze_file("test.h", code, "C++")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 2)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 2)
 
         # Check Animal class
-        animal_class = result['classes'][0]
-        self.assertEqual(animal_class['name'], 'Animal')
+        animal_class = result["classes"][0]
+        self.assertEqual(animal_class["name"], "Animal")
 
         # Check Dog class with inheritance
-        dog_class = result['classes'][1]
-        self.assertEqual(dog_class['name'], 'Dog')
-        self.assertIn('Animal', dog_class['base_classes'])
+        dog_class = result["classes"][1]
+        self.assertEqual(dog_class["name"], "Dog")
+        self.assertIn("Animal", dog_class["base_classes"])
 
     def test_cpp_pointer_parameters(self):
         """Test C++ function with pointer/reference parameters."""
-        code = '''
+        code = """
 void process(int* ptr);
 void update(const int& value);
 void transform(std::vector<int>* vec);
-'''
-        result = self.analyzer.analyze_file('test.h', code, 'C++')
+"""
+        result = self.analyzer.analyze_file("test.h", code, "C++")
 
-        self.assertIn('functions', result)
-        self.assertGreaterEqual(len(result['functions']), 2)
+        self.assertIn("functions", result)
+        self.assertGreaterEqual(len(result["functions"]), 2)
 
         # Check that parameters include pointer/reference syntax
-        process_func = result['functions'][0]
-        self.assertEqual(process_func['name'], 'process')
+        process_func = result["functions"][0]
+        self.assertEqual(process_func["name"], "process")
 
     def test_cpp_default_parameters(self):
         """Test C++ function with default parameter values."""
-        code = '''
+        code = """
 void initialize(int size = 100, bool verbose = false);
 
 class Config {
 public:
     Config(std::string name = "default", int timeout = 30);
 };
-'''
-        result = self.analyzer.analyze_file('test.h', code, 'C++')
+"""
+        result = self.analyzer.analyze_file("test.h", code, "C++")
 
-        self.assertIn('functions', result)
+        self.assertIn("functions", result)
 
         # Check function with defaults
-        init_func = result['functions'][0]
-        self.assertEqual(init_func['name'], 'initialize')
+        init_func = result["functions"][0]
+        self.assertEqual(init_func["name"], "initialize")
         # Verify defaults are captured
-        self.assertGreaterEqual(len(init_func['parameters']), 2)
+        self.assertGreaterEqual(len(init_func["parameters"]), 2)
 
 
 class TestDepthLevels(unittest.TestCase):
@@ -445,44 +445,44 @@ class TestDepthLevels(unittest.TestCase):
 
     def test_surface_depth_returns_empty(self):
         """Test that surface depth returns empty analysis."""
-        analyzer = CodeAnalyzer(depth='surface')
+        analyzer = CodeAnalyzer(depth="surface")
         code = '''
 def test_function(a, b):
     """Test."""
     return a + b
 '''
-        result = analyzer.analyze_file('test.py', code, 'Python')
+        result = analyzer.analyze_file("test.py", code, "Python")
 
         # Surface depth should return empty dict
         self.assertEqual(result, {})
 
     def test_deep_depth_extracts_signatures(self):
         """Test that deep depth extracts full signatures."""
-        analyzer = CodeAnalyzer(depth='deep')
+        analyzer = CodeAnalyzer(depth="deep")
         code = '''
 def calculate(x: int, y: int) -> int:
     """Calculate sum."""
     return x + y
 '''
-        result = analyzer.analyze_file('test.py', code, 'Python')
+        result = analyzer.analyze_file("test.py", code, "Python")
 
         # Deep depth should extract full analysis
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'calculate')
-        self.assertEqual(func['return_type'], 'int')
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "calculate")
+        self.assertEqual(func["return_type"], "int")
 
     def test_unknown_language_returns_empty(self):
         """Test that unknown language returns empty dict."""
-        analyzer = CodeAnalyzer(depth='deep')
-        code = '''
+        analyzer = CodeAnalyzer(depth="deep")
+        code = """
 import Foundation
 func greet(name: String) {
     print("Hello, \\(name)!")
 }
-'''
-        result = analyzer.analyze_file('test.swift', code, 'Swift')
+"""
+        result = analyzer.analyze_file("test.swift", code, "Swift")
 
         # Unknown language should return empty dict
         self.assertEqual(result, {})
@@ -493,26 +493,26 @@ class TestIntegration(unittest.TestCase):
 
     def test_analyze_file_interface(self):
         """Test the analyze_file public interface."""
-        analyzer = CodeAnalyzer(depth='deep')
+        analyzer = CodeAnalyzer(depth="deep")
 
         # Test with Python code
-        py_code = 'def test(): pass'
-        result = analyzer.analyze_file('test.py', py_code, 'Python')
+        py_code = "def test(): pass"
+        result = analyzer.analyze_file("test.py", py_code, "Python")
         self.assertIsInstance(result, dict)
 
         # Test with JavaScript code
-        js_code = 'function test() {}'
-        result = analyzer.analyze_file('test.js', js_code, 'JavaScript')
+        js_code = "function test() {}"
+        result = analyzer.analyze_file("test.js", js_code, "JavaScript")
         self.assertIsInstance(result, dict)
 
         # Test with C++ code
-        cpp_code = 'void test();'
-        result = analyzer.analyze_file('test.h', cpp_code, 'C++')
+        cpp_code = "void test();"
+        result = analyzer.analyze_file("test.h", cpp_code, "C++")
         self.assertIsInstance(result, dict)
 
     def test_multiple_items_extraction(self):
         """Test extracting multiple classes and functions."""
-        analyzer = CodeAnalyzer(depth='deep')
+        analyzer = CodeAnalyzer(depth="deep")
         code = '''
 def helper_func():
     """Helper function."""
@@ -532,22 +532,22 @@ def main_func():
     """Main function."""
     pass
 '''
-        result = analyzer.analyze_file('test.py', code, 'Python')
+        result = analyzer.analyze_file("test.py", code, "Python")
 
         # Should extract 2 standalone functions
-        self.assertEqual(len(result['functions']), 2)
+        self.assertEqual(len(result["functions"]), 2)
 
         # Should extract 2 classes
-        self.assertEqual(len(result['classes']), 2)
+        self.assertEqual(len(result["classes"]), 2)
 
         # Verify names
-        func_names = [f['name'] for f in result['functions']]
-        self.assertIn('helper_func', func_names)
-        self.assertIn('main_func', func_names)
+        func_names = [f["name"] for f in result["functions"]]
+        self.assertIn("helper_func", func_names)
+        self.assertIn("main_func", func_names)
 
-        class_names = [c['name'] for c in result['classes']]
-        self.assertIn('ClassA', class_names)
-        self.assertIn('ClassB', class_names)
+        class_names = [c["name"] for c in result["classes"]]
+        self.assertIn("ClassA", class_names)
+        self.assertIn("ClassB", class_names)
 
 
 class TestCommentExtraction(unittest.TestCase):
@@ -555,11 +555,11 @@ class TestCommentExtraction(unittest.TestCase):
 
     def setUp(self):
         """Set up test analyzer with deep analysis"""
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_python_comment_extraction(self):
         """Test Python # comment extraction."""
-        code = '''
+        code = """
 # This is a comment
 def test_func():
     # Inside function comment
@@ -570,63 +570,63 @@ def test_func():
 class TestClass:
     # Class-level comment
     pass
-'''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+"""
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        self.assertIn('comments', result)
-        comments = result['comments']
+        self.assertIn("comments", result)
+        comments = result["comments"]
 
         # Should have extracted standalone comments
         self.assertGreaterEqual(len(comments), 3)
 
         # Check comment content
-        comment_texts = [c['text'] for c in comments]
-        self.assertIn('This is a comment', comment_texts)
-        self.assertIn('Inside function comment', comment_texts)
-        self.assertIn('Another top-level comment', comment_texts)
+        comment_texts = [c["text"] for c in comments]
+        self.assertIn("This is a comment", comment_texts)
+        self.assertIn("Inside function comment", comment_texts)
+        self.assertIn("Another top-level comment", comment_texts)
 
         # Check all are inline type
         for comment in comments:
-            self.assertEqual(comment['type'], 'inline')
+            self.assertEqual(comment["type"], "inline")
 
     def test_python_comment_line_numbers(self):
         """Test Python comment line number tracking."""
-        code = '''# Line 1 comment
+        code = """# Line 1 comment
 def func():
     # Line 3 comment
     pass
 # Line 5 comment
-'''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+"""
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        comments = result['comments']
+        comments = result["comments"]
         self.assertEqual(len(comments), 3)
 
         # Check line numbers
-        line_nums = [c['line'] for c in comments]
+        line_nums = [c["line"] for c in comments]
         self.assertIn(1, line_nums)
         self.assertIn(3, line_nums)
         self.assertIn(5, line_nums)
 
     def test_python_skip_shebang_and_encoding(self):
         """Test that shebang and encoding declarations are skipped."""
-        code = '''#!/usr/bin/env python3
+        code = """#!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # This is a real comment
 def func():
     pass
-'''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+"""
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        comments = result['comments']
+        comments = result["comments"]
 
         # Should only have the real comment
         self.assertEqual(len(comments), 1)
-        self.assertEqual(comments[0]['text'], 'This is a real comment')
+        self.assertEqual(comments[0]["text"], "This is a real comment")
 
     def test_javascript_inline_comments(self):
         """Test JavaScript // comment extraction."""
-        code = '''
+        code = """
 // Top-level comment
 function test() {
     // Inside function
@@ -636,22 +636,22 @@ function test() {
 
 // Another comment
 const y = 10;
-'''
-        result = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+"""
+        result = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
-        self.assertIn('comments', result)
-        comments = result['comments']
+        self.assertIn("comments", result)
+        comments = result["comments"]
 
         # Should have extracted standalone comments
         self.assertGreaterEqual(len(comments), 3)
 
         # Check comment types
-        inline_comments = [c for c in comments if c['type'] == 'inline']
+        inline_comments = [c for c in comments if c["type"] == "inline"]
         self.assertGreaterEqual(len(inline_comments), 3)
 
     def test_javascript_block_comments(self):
         """Test JavaScript /* */ block comment extraction."""
-        code = '''
+        code = """
 /* This is a
    multi-line
    block comment */
@@ -659,22 +659,22 @@ function test() {
     /* Another block comment */
     return 42;
 }
-'''
-        result = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+"""
+        result = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
-        comments = result['comments']
+        comments = result["comments"]
 
         # Should have extracted block comments
-        block_comments = [c for c in comments if c['type'] == 'block']
+        block_comments = [c for c in comments if c["type"] == "block"]
         self.assertGreaterEqual(len(block_comments), 2)
 
         # Check multi-line content is preserved
-        first_block = next(c for c in comments if 'multi-line' in c['text'])
-        self.assertIn('multi-line', first_block['text'])
+        first_block = next(c for c in comments if "multi-line" in c["text"])
+        self.assertIn("multi-line", first_block["text"])
 
     def test_javascript_mixed_comments(self):
         """Test JavaScript mixed inline and block comments."""
-        code = '''
+        code = """
 // Inline comment
 /* Block comment */
 function test() {
@@ -682,21 +682,21 @@ function test() {
     /* Another block */
     return true;
 }
-'''
-        result = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+"""
+        result = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
-        comments = result['comments']
+        comments = result["comments"]
 
         # Should have both types
-        inline_comments = [c for c in comments if c['type'] == 'inline']
-        block_comments = [c for c in comments if c['type'] == 'block']
+        inline_comments = [c for c in comments if c["type"] == "inline"]
+        block_comments = [c for c in comments if c["type"] == "block"]
 
         self.assertGreaterEqual(len(inline_comments), 2)
         self.assertGreaterEqual(len(block_comments), 2)
 
     def test_cpp_comment_extraction(self):
         """Test C++ comment extraction (uses same logic as JavaScript)."""
-        code = '''
+        code = """
 // Header comment
 class Node {
 public:
@@ -706,70 +706,70 @@ public:
     /* Block comment for data member */
     int value;
 };
-'''
-        result = self.analyzer.analyze_file('test.h', code, 'C++')
+"""
+        result = self.analyzer.analyze_file("test.h", code, "C++")
 
-        self.assertIn('comments', result)
-        comments = result['comments']
+        self.assertIn("comments", result)
+        comments = result["comments"]
 
         # Should have extracted comments
         self.assertGreaterEqual(len(comments), 3)
 
         # Check both inline and block
-        inline_comments = [c for c in comments if c['type'] == 'inline']
-        block_comments = [c for c in comments if c['type'] == 'block']
+        inline_comments = [c for c in comments if c["type"] == "inline"]
+        block_comments = [c for c in comments if c["type"] == "block"]
 
         self.assertGreaterEqual(len(inline_comments), 2)
         self.assertGreaterEqual(len(block_comments), 1)
 
     def test_todo_fixme_comment_detection(self):
         """Test that TODO/FIXME comments are extracted."""
-        code = '''
+        code = """
 # TODO: Implement this feature
 def incomplete_func():
     # FIXME: Handle edge case
     pass
 
 # NOTE: Important information
-'''
-        result = self.analyzer.analyze_file('test.py', code, 'Python')
+"""
+        result = self.analyzer.analyze_file("test.py", code, "Python")
 
-        comments = result['comments']
+        comments = result["comments"]
 
-        comment_texts = [c['text'] for c in comments]
-        self.assertTrue(any('TODO' in text for text in comment_texts))
-        self.assertTrue(any('FIXME' in text for text in comment_texts))
-        self.assertTrue(any('NOTE' in text for text in comment_texts))
+        comment_texts = [c["text"] for c in comments]
+        self.assertTrue(any("TODO" in text for text in comment_texts))
+        self.assertTrue(any("FIXME" in text for text in comment_texts))
+        self.assertTrue(any("NOTE" in text for text in comment_texts))
 
 
 class TestCSharpParsing(unittest.TestCase):
     """Tests for C# code analysis"""
 
     def setUp(self):
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_csharp_class_extraction(self):
         """Test C# class extraction with inheritance."""
-        code = '''
+        code = """
 using System;
 
 public class PlayerController : MonoBehaviour
 {
     private float speed = 5f;
 }
-'''
-        result = self.analyzer.analyze_file('test.cs', code, 'C#')
+"""
+        result = self.analyzer.analyze_file("test.cs", code, "C#")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 1)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 1)
 
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'PlayerController')
-        self.assertIn('MonoBehaviour', cls['base_classes'])
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "PlayerController")
+        self.assertIn("MonoBehaviour", cls["base_classes"])
 
     def test_csharp_method_extraction(self):
         """Test C# method extraction with parameters."""
-        code = '''
+        code = """
 public class Calculator
 {
     public int Add(int a, int b)
@@ -777,36 +777,36 @@ public class Calculator
         return a + b;
     }
 }
-'''
-        result = self.analyzer.analyze_file('test.cs', code, 'C#')
+"""
+        result = self.analyzer.analyze_file("test.cs", code, "C#")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
 
-        method = result['functions'][0]
-        self.assertEqual(method['name'], 'Add')
-        self.assertEqual(len(method['parameters']), 2)
-        self.assertEqual(method['return_type'], 'int')
+        method = result["functions"][0]
+        self.assertEqual(method["name"], "Add")
+        self.assertEqual(len(method["parameters"]), 2)
+        self.assertEqual(method["return_type"], "int")
 
     def test_csharp_property_extraction(self):
         """Test C# property extraction."""
-        code = '''
+        code = """
 public class Player
 {
     public int Health { get; set; } = 100;
     private string Name { get; }
 }
-'''
-        result = self.analyzer.analyze_file('test.cs', code, 'C#')
+"""
+        result = self.analyzer.analyze_file("test.cs", code, "C#")
 
         # Properties are extracted as part of class analysis
-        self.assertIn('classes', result)
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'Player')
+        self.assertIn("classes", result)
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "Player")
 
     def test_csharp_async_method(self):
         """Test C# async method detection."""
-        code = '''
+        code = """
 public class DataLoader
 {
     public async Task<string> LoadDataAsync()
@@ -815,42 +815,42 @@ public class DataLoader
         return "data";
     }
 }
-'''
-        result = self.analyzer.analyze_file('test.cs', code, 'C#')
+"""
+        result = self.analyzer.analyze_file("test.cs", code, "C#")
 
-        self.assertIn('functions', result)
-        method = result['functions'][0]
-        self.assertEqual(method['name'], 'LoadDataAsync')
-        self.assertTrue(method['is_async'])
+        self.assertIn("functions", result)
+        method = result["functions"][0]
+        self.assertEqual(method["name"], "LoadDataAsync")
+        self.assertTrue(method["is_async"])
 
 
 class TestGoParsing(unittest.TestCase):
     """Tests for Go code analysis"""
 
     def setUp(self):
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_go_function_extraction(self):
         """Test Go function extraction."""
-        code = '''
+        code = """
 package main
 
 func Add(a int, b int) int {
     return a + b
 }
-'''
-        result = self.analyzer.analyze_file('test.go', code, 'Go')
+"""
+        result = self.analyzer.analyze_file("test.go", code, "Go")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
 
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'Add')
-        self.assertEqual(func['return_type'], 'int')
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "Add")
+        self.assertEqual(func["return_type"], "int")
 
     def test_go_method_with_receiver(self):
         """Test Go method with receiver."""
-        code = '''
+        code = """
 package main
 
 type Person struct {
@@ -860,105 +860,105 @@ type Person struct {
 func (p *Person) Greet() string {
     return "Hello " + p.Name
 }
-'''
-        result = self.analyzer.analyze_file('test.go', code, 'Go')
+"""
+        result = self.analyzer.analyze_file("test.go", code, "Go")
 
-        self.assertIn('functions', result)
+        self.assertIn("functions", result)
         # Should extract method
-        method = next((f for f in result['functions'] if f['name'] == 'Greet'), None)
+        method = next((f for f in result["functions"] if f["name"] == "Greet"), None)
         self.assertIsNotNone(method)
-        self.assertEqual(method['return_type'], 'string')
+        self.assertEqual(method["return_type"], "string")
 
     def test_go_struct_extraction(self):
         """Test Go struct extraction."""
-        code = '''
+        code = """
 package main
 
 type Rectangle struct {
     Width  float64
     Height float64
 }
-'''
-        result = self.analyzer.analyze_file('test.go', code, 'Go')
+"""
+        result = self.analyzer.analyze_file("test.go", code, "Go")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 1)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 1)
 
-        struct = result['classes'][0]
-        self.assertEqual(struct['name'], 'Rectangle')
+        struct = result["classes"][0]
+        self.assertEqual(struct["name"], "Rectangle")
 
     def test_go_multiple_return_values(self):
         """Test Go function with multiple return values."""
-        code = '''
+        code = """
 func Divide(a, b float64) (float64, error) {
     if b == 0 {
         return 0, errors.New("division by zero")
     }
     return a / b, nil
 }
-'''
-        result = self.analyzer.analyze_file('test.go', code, 'Go')
+"""
+        result = self.analyzer.analyze_file("test.go", code, "Go")
 
-        self.assertIn('functions', result)
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'Divide')
+        self.assertIn("functions", result)
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "Divide")
 
 
 class TestRustParsing(unittest.TestCase):
     """Tests for Rust code analysis"""
 
     def setUp(self):
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_rust_function_extraction(self):
         """Test Rust function extraction."""
-        code = '''
+        code = """
 pub fn add(a: i32, b: i32) -> i32 {
     a + b
 }
-'''
-        result = self.analyzer.analyze_file('test.rs', code, 'Rust')
+"""
+        result = self.analyzer.analyze_file("test.rs", code, "Rust")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
 
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'add')
-        self.assertEqual(func['return_type'], 'i32')
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "add")
+        self.assertEqual(func["return_type"], "i32")
 
     def test_rust_struct_extraction(self):
         """Test Rust struct extraction."""
-        code = '''
+        code = """
 pub struct Point {
     x: f64,
     y: f64,
 }
-'''
-        result = self.analyzer.analyze_file('test.rs', code, 'Rust')
+"""
+        result = self.analyzer.analyze_file("test.rs", code, "Rust")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 1)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 1)
 
-        struct = result['classes'][0]
-        self.assertEqual(struct['name'], 'Point')
+        struct = result["classes"][0]
+        self.assertEqual(struct["name"], "Point")
 
     def test_rust_async_function(self):
         """Test Rust async function detection."""
-        code = '''
+        code = """
 pub async fn fetch_data() -> Result<String, Error> {
     Ok("data".to_string())
 }
-'''
-        result = self.analyzer.analyze_file('test.rs', code, 'Rust')
+"""
+        result = self.analyzer.analyze_file("test.rs", code, "Rust")
 
-        self.assertIn('functions', result)
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'fetch_data')
-        self.assertTrue(func['is_async'])
+        self.assertIn("functions", result)
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "fetch_data")
+        self.assertTrue(func["is_async"])
 
     def test_rust_impl_block(self):
         """Test Rust impl block method extraction."""
-        code = '''
+        code = """
 struct Circle {
     radius: f64,
 }
@@ -968,69 +968,69 @@ impl Circle {
         std::f64::consts::PI * self.radius * self.radius
     }
 }
-'''
-        result = self.analyzer.analyze_file('test.rs', code, 'Rust')
+"""
+        result = self.analyzer.analyze_file("test.rs", code, "Rust")
 
-        self.assertIn('classes', result)
-        self.assertIn('functions', result)
+        self.assertIn("classes", result)
+        self.assertIn("functions", result)
 
 
 class TestJavaParsing(unittest.TestCase):
     """Tests for Java code analysis"""
 
     def setUp(self):
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_java_class_extraction(self):
         """Test Java class extraction with inheritance."""
-        code = '''
+        code = """
 public class ArrayList extends AbstractList implements List {
     private int size;
 }
-'''
-        result = self.analyzer.analyze_file('test.java', code, 'Java')
+"""
+        result = self.analyzer.analyze_file("test.java", code, "Java")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 1)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 1)
 
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'ArrayList')
-        self.assertIn('AbstractList', cls['base_classes'])
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "ArrayList")
+        self.assertIn("AbstractList", cls["base_classes"])
 
     def test_java_method_extraction(self):
         """Test Java method extraction."""
-        code = '''
+        code = """
 public class Calculator {
     public static int multiply(int a, int b) {
         return a * b;
     }
 }
-'''
-        result = self.analyzer.analyze_file('test.java', code, 'Java')
+"""
+        result = self.analyzer.analyze_file("test.java", code, "Java")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
 
-        method = result['functions'][0]
-        self.assertEqual(method['name'], 'multiply')
-        self.assertEqual(method['return_type'], 'int')
+        method = result["functions"][0]
+        self.assertEqual(method["name"], "multiply")
+        self.assertEqual(method["return_type"], "int")
 
     def test_java_interface_implementation(self):
         """Test Java interface implementation."""
-        code = '''
+        code = """
 public class MyHandler implements EventHandler, Runnable {
     public void run() {}
 }
-'''
-        result = self.analyzer.analyze_file('test.java', code, 'Java')
+"""
+        result = self.analyzer.analyze_file("test.java", code, "Java")
 
-        self.assertIn('classes', result)
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'MyHandler')
+        self.assertIn("classes", result)
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "MyHandler")
 
     def test_java_generic_class(self):
         """Test Java generic class."""
-        code = '''
+        code = """
 public class Box<T> {
     private T value;
 
@@ -1038,90 +1038,90 @@ public class Box<T> {
         return value;
     }
 }
-'''
-        result = self.analyzer.analyze_file('test.java', code, 'Java')
+"""
+        result = self.analyzer.analyze_file("test.java", code, "Java")
 
-        self.assertIn('classes', result)
-        self.assertIn('functions', result)
+        self.assertIn("classes", result)
+        self.assertIn("functions", result)
 
 
 class TestRubyParsing(unittest.TestCase):
     """Tests for Ruby code analysis"""
 
     def setUp(self):
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_ruby_class_extraction(self):
         """Test Ruby class extraction."""
-        code = '''
+        code = """
 class Person
   def initialize(name)
     @name = name
   end
 end
-'''
-        result = self.analyzer.analyze_file('test.rb', code, 'Ruby')
+"""
+        result = self.analyzer.analyze_file("test.rb", code, "Ruby")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 1)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 1)
 
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'Person')
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "Person")
 
     def test_ruby_method_extraction(self):
         """Test Ruby method extraction."""
-        code = '''
+        code = """
 def greet(name)
   puts "Hello, #{name}!"
 end
-'''
-        result = self.analyzer.analyze_file('test.rb', code, 'Ruby')
+"""
+        result = self.analyzer.analyze_file("test.rb", code, "Ruby")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
 
-        method = result['functions'][0]
-        self.assertEqual(method['name'], 'greet')
+        method = result["functions"][0]
+        self.assertEqual(method["name"], "greet")
 
     def test_ruby_class_inheritance(self):
         """Test Ruby class inheritance."""
-        code = '''
+        code = """
 class Dog < Animal
   def bark
     puts "Woof!"
   end
 end
-'''
-        result = self.analyzer.analyze_file('test.rb', code, 'Ruby')
+"""
+        result = self.analyzer.analyze_file("test.rb", code, "Ruby")
 
-        self.assertIn('classes', result)
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'Dog')
-        self.assertIn('Animal', cls['base_classes'])
+        self.assertIn("classes", result)
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "Dog")
+        self.assertIn("Animal", cls["base_classes"])
 
     def test_ruby_predicate_methods(self):
         """Test Ruby predicate methods (ending with ?)."""
-        code = '''
+        code = """
 def empty?
   @items.length == 0
 end
-'''
-        result = self.analyzer.analyze_file('test.rb', code, 'Ruby')
+"""
+        result = self.analyzer.analyze_file("test.rb", code, "Ruby")
 
-        self.assertIn('functions', result)
-        method = result['functions'][0]
-        self.assertEqual(method['name'], 'empty?')
+        self.assertIn("functions", result)
+        method = result["functions"][0]
+        self.assertEqual(method["name"], "empty?")
 
 
 class TestPHPParsing(unittest.TestCase):
     """Tests for PHP code analysis"""
 
     def setUp(self):
-        self.analyzer = CodeAnalyzer(depth='deep')
+        self.analyzer = CodeAnalyzer(depth="deep")
 
     def test_php_class_extraction(self):
         """Test PHP class extraction."""
-        code = '''
+        code = """
 <?php
 class User {
     private $name;
@@ -1131,35 +1131,35 @@ class User {
     }
 }
 ?>
-'''
-        result = self.analyzer.analyze_file('test.php', code, 'PHP')
+"""
+        result = self.analyzer.analyze_file("test.php", code, "PHP")
 
-        self.assertIn('classes', result)
-        self.assertEqual(len(result['classes']), 1)
+        self.assertIn("classes", result)
+        self.assertEqual(len(result["classes"]), 1)
 
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'User')
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "User")
 
     def test_php_method_extraction(self):
         """Test PHP method extraction."""
-        code = '''
+        code = """
 <?php
 function calculate($a, $b) {
     return $a + $b;
 }
 ?>
-'''
-        result = self.analyzer.analyze_file('test.php', code, 'PHP')
+"""
+        result = self.analyzer.analyze_file("test.php", code, "PHP")
 
-        self.assertIn('functions', result)
-        self.assertEqual(len(result['functions']), 1)
+        self.assertIn("functions", result)
+        self.assertEqual(len(result["functions"]), 1)
 
-        func = result['functions'][0]
-        self.assertEqual(func['name'], 'calculate')
+        func = result["functions"][0]
+        self.assertEqual(func["name"], "calculate")
 
     def test_php_class_inheritance(self):
         """Test PHP class inheritance and interfaces."""
-        code = '''
+        code = """
 <?php
 class Rectangle extends Shape implements Drawable {
     public function draw() {
@@ -1167,17 +1167,17 @@ class Rectangle extends Shape implements Drawable {
     }
 }
 ?>
-'''
-        result = self.analyzer.analyze_file('test.php', code, 'PHP')
+"""
+        result = self.analyzer.analyze_file("test.php", code, "PHP")
 
-        self.assertIn('classes', result)
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'Rectangle')
-        self.assertIn('Shape', cls['base_classes'])
+        self.assertIn("classes", result)
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "Rectangle")
+        self.assertIn("Shape", cls["base_classes"])
 
     def test_php_namespace(self):
         """Test PHP namespace handling."""
-        code = '''
+        code = """
 <?php
 namespace App\\Models;
 
@@ -1187,14 +1187,14 @@ class Product {
     }
 }
 ?>
-'''
-        result = self.analyzer.analyze_file('test.php', code, 'PHP')
+"""
+        result = self.analyzer.analyze_file("test.php", code, "PHP")
 
-        self.assertIn('classes', result)
-        cls = result['classes'][0]
-        self.assertEqual(cls['name'], 'Product')
+        self.assertIn("classes", result)
+        cls = result["classes"][0]
+        self.assertEqual(cls["name"], "Product")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Run tests with verbose output
     unittest.main(verbosity=2)
diff --git a/tests/test_codebase_scraper.py b/tests/test_codebase_scraper.py
index 3daf311..42be5ae 100644
--- a/tests/test_codebase_scraper.py
+++ b/tests/test_codebase_scraper.py
@@ -9,22 +9,22 @@ Test Coverage:
 - .gitignore loading
 """
 
-import unittest
-import tempfile
-import shutil
-from pathlib import Path
-import sys
 import os
+import shutil
+import sys
+import tempfile
+import unittest
+from pathlib import Path
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 from skill_seekers.cli.codebase_scraper import (
+    DEFAULT_EXCLUDED_DIRS,
     detect_language,
+    load_gitignore,
     should_exclude_dir,
     walk_directory,
-    load_gitignore,
-    DEFAULT_EXCLUDED_DIRS
 )
 
 
@@ -33,52 +33,52 @@ class TestLanguageDetection(unittest.TestCase):
 
     def test_python_detection(self):
         """Test Python file detection."""
-        self.assertEqual(detect_language(Path('test.py')), 'Python')
+        self.assertEqual(detect_language(Path("test.py")), "Python")
 
     def test_javascript_detection(self):
         """Test JavaScript file detection."""
-        self.assertEqual(detect_language(Path('test.js')), 'JavaScript')
-        self.assertEqual(detect_language(Path('test.jsx')), 'JavaScript')
+        self.assertEqual(detect_language(Path("test.js")), "JavaScript")
+        self.assertEqual(detect_language(Path("test.jsx")), "JavaScript")
 
     def test_typescript_detection(self):
         """Test TypeScript file detection."""
-        self.assertEqual(detect_language(Path('test.ts')), 'TypeScript')
-        self.assertEqual(detect_language(Path('test.tsx')), 'TypeScript')
+        self.assertEqual(detect_language(Path("test.ts")), "TypeScript")
+        self.assertEqual(detect_language(Path("test.tsx")), "TypeScript")
 
     def test_cpp_detection(self):
         """Test C++ file detection."""
-        self.assertEqual(detect_language(Path('test.cpp')), 'C++')
-        self.assertEqual(detect_language(Path('test.h')), 'C++')
-        self.assertEqual(detect_language(Path('test.hpp')), 'C++')
+        self.assertEqual(detect_language(Path("test.cpp")), "C++")
+        self.assertEqual(detect_language(Path("test.h")), "C++")
+        self.assertEqual(detect_language(Path("test.hpp")), "C++")
 
     def test_csharp_detection(self):
         """Test C# file detection."""
-        self.assertEqual(detect_language(Path('test.cs')), 'C#')
+        self.assertEqual(detect_language(Path("test.cs")), "C#")
 
     def test_go_detection(self):
         """Test Go file detection."""
-        self.assertEqual(detect_language(Path('test.go')), 'Go')
+        self.assertEqual(detect_language(Path("test.go")), "Go")
 
     def test_rust_detection(self):
         """Test Rust file detection."""
-        self.assertEqual(detect_language(Path('test.rs')), 'Rust')
+        self.assertEqual(detect_language(Path("test.rs")), "Rust")
 
     def test_java_detection(self):
         """Test Java file detection."""
-        self.assertEqual(detect_language(Path('test.java')), 'Java')
+        self.assertEqual(detect_language(Path("test.java")), "Java")
 
     def test_ruby_detection(self):
         """Test Ruby file detection."""
-        self.assertEqual(detect_language(Path('test.rb')), 'Ruby')
+        self.assertEqual(detect_language(Path("test.rb")), "Ruby")
 
     def test_php_detection(self):
         """Test PHP file detection."""
-        self.assertEqual(detect_language(Path('test.php')), 'PHP')
+        self.assertEqual(detect_language(Path("test.php")), "PHP")
 
     def test_unknown_language(self):
         """Test unknown file extension."""
-        self.assertEqual(detect_language(Path('test.swift')), 'Unknown')
-        self.assertEqual(detect_language(Path('test.txt')), 'Unknown')
+        self.assertEqual(detect_language(Path("test.swift")), "Unknown")
+        self.assertEqual(detect_language(Path("test.txt")), "Unknown")
 
 
 class TestDirectoryExclusion(unittest.TestCase):
@@ -86,20 +86,20 @@ class TestDirectoryExclusion(unittest.TestCase):
 
     def test_node_modules_excluded(self):
         """Test that node_modules is excluded."""
-        self.assertTrue(should_exclude_dir('node_modules', DEFAULT_EXCLUDED_DIRS))
+        self.assertTrue(should_exclude_dir("node_modules", DEFAULT_EXCLUDED_DIRS))
 
     def test_venv_excluded(self):
         """Test that venv is excluded."""
-        self.assertTrue(should_exclude_dir('venv', DEFAULT_EXCLUDED_DIRS))
+        self.assertTrue(should_exclude_dir("venv", DEFAULT_EXCLUDED_DIRS))
 
     def test_git_excluded(self):
         """Test that .git is excluded."""
-        self.assertTrue(should_exclude_dir('.git', DEFAULT_EXCLUDED_DIRS))
+        self.assertTrue(should_exclude_dir(".git", DEFAULT_EXCLUDED_DIRS))
 
     def test_normal_dir_not_excluded(self):
         """Test that normal directories are not excluded."""
-        self.assertFalse(should_exclude_dir('src', DEFAULT_EXCLUDED_DIRS))
-        self.assertFalse(should_exclude_dir('tests', DEFAULT_EXCLUDED_DIRS))
+        self.assertFalse(should_exclude_dir("src", DEFAULT_EXCLUDED_DIRS))
+        self.assertFalse(should_exclude_dir("tests", DEFAULT_EXCLUDED_DIRS))
 
 
 class TestDirectoryWalking(unittest.TestCase):
@@ -122,50 +122,50 @@ class TestDirectoryWalking(unittest.TestCase):
     def test_walk_with_python_files(self):
         """Test walking directory with Python files."""
         # Create test files
-        (self.root / 'test1.py').write_text('print("test")')
-        (self.root / 'test2.py').write_text('print("test2")')
-        (self.root / 'readme.txt').write_text('readme')
+        (self.root / "test1.py").write_text('print("test")')
+        (self.root / "test2.py").write_text('print("test2")')
+        (self.root / "readme.txt").write_text("readme")
 
         files = walk_directory(self.root)
 
         # Should only find Python files
         self.assertEqual(len(files), 2)
-        self.assertTrue(all(f.suffix == '.py' for f in files))
+        self.assertTrue(all(f.suffix == ".py" for f in files))
 
     def test_walk_excludes_node_modules(self):
         """Test that node_modules directory is excluded."""
         # Create test files
-        (self.root / 'test.py').write_text('test')
+        (self.root / "test.py").write_text("test")
 
         # Create node_modules with files
-        node_modules = self.root / 'node_modules'
+        node_modules = self.root / "node_modules"
         node_modules.mkdir()
-        (node_modules / 'package.js').write_text('test')
+        (node_modules / "package.js").write_text("test")
 
         files = walk_directory(self.root)
 
         # Should only find root test.py, not package.js
         self.assertEqual(len(files), 1)
-        self.assertEqual(files[0].name, 'test.py')
+        self.assertEqual(files[0].name, "test.py")
 
     def test_walk_with_subdirectories(self):
         """Test walking nested directory structure."""
         # Create nested structure
-        src_dir = self.root / 'src'
+        src_dir = self.root / "src"
         src_dir.mkdir()
-        (src_dir / 'module.py').write_text('test')
+        (src_dir / "module.py").write_text("test")
 
-        tests_dir = self.root / 'tests'
+        tests_dir = self.root / "tests"
         tests_dir.mkdir()
-        (tests_dir / 'test_module.py').write_text('test')
+        (tests_dir / "test_module.py").write_text("test")
 
         files = walk_directory(self.root)
 
         # Should find both files
         self.assertEqual(len(files), 2)
         filenames = [f.name for f in files]
-        self.assertIn('module.py', filenames)
-        self.assertIn('test_module.py', filenames)
+        self.assertIn("module.py", filenames)
+        self.assertIn("test_module.py", filenames)
 
 
 class TestGitignoreLoading(unittest.TestCase):
@@ -189,8 +189,8 @@ class TestGitignoreLoading(unittest.TestCase):
     def test_load_gitignore(self):
         """Test loading valid .gitignore file."""
         # Create .gitignore
-        gitignore_path = self.root / '.gitignore'
-        gitignore_path.write_text('*.log\ntemp/\n')
+        gitignore_path = self.root / ".gitignore"
+        gitignore_path.write_text("*.log\ntemp/\n")
 
         spec = load_gitignore(self.root)
 
@@ -201,6 +201,6 @@ class TestGitignoreLoading(unittest.TestCase):
             self.assertIsNotNone(spec)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Run tests with verbose output
     unittest.main(verbosity=2)
diff --git a/tests/test_config_extractor.py b/tests/test_config_extractor.py
index b5a87ce..32168e5 100644
--- a/tests/test_config_extractor.py
+++ b/tests/test_config_extractor.py
@@ -10,24 +10,24 @@ Test Coverage:
 - Edge Cases (3 tests) - Error handling, empty files, invalid formats
 """
 
-import unittest
-import sys
-import os
 import json
+import os
+import sys
 import tempfile
+import unittest
 from pathlib import Path
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 from skill_seekers.cli.config_extractor import (
+    ConfigExtractionResult,
+    ConfigExtractor,
+    ConfigFile,
     ConfigFileDetector,
     ConfigParser,
     ConfigPatternDetector,
-    ConfigExtractor,
     ConfigSetting,
-    ConfigFile,
-    ConfigExtractionResult,
 )
 
 
@@ -41,6 +41,7 @@ class TestConfigFileDetector(unittest.TestCase):
     def tearDown(self):
         # Clean up temp directory
         import shutil
+
         shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_detect_json_files(self):
@@ -92,7 +93,7 @@ class TestConfigFileDetector(unittest.TestCase):
         """Test max_files limit is respected"""
         # Create many config files
         for i in range(20):
-            (Path(self.temp_dir) / f"config{i}.json").write_text('{}')
+            (Path(self.temp_dir) / f"config{i}.json").write_text("{}")
 
         detector = ConfigFileDetector()
         files = detector.find_config_files(Path(self.temp_dir), max_files=5)
@@ -109,23 +110,18 @@ class TestConfigParser(unittest.TestCase):
 
     def tearDown(self):
         import shutil
+
         shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_parse_json_config(self):
         """Test parsing JSON configuration"""
-        json_content = {
-            "database": {
-                "host": "localhost",
-                "port": 5432
-            },
-            "api_key": "secret"
-        }
+        json_content = {"database": {"host": "localhost", "port": 5432}, "api_key": "secret"}
 
         config_file = ConfigFile(
             file_path=str(Path(self.temp_dir) / "config.json"),
             relative_path="config.json",
             config_type="json",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "config.json"
@@ -151,7 +147,7 @@ logging:
             file_path=str(Path(self.temp_dir) / "config.yml"),
             relative_path="config.yml",
             config_type="yaml",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "config.yml"
@@ -177,10 +173,7 @@ API_KEY=secret123
 PORT=8000
 """
         config_file = ConfigFile(
-            file_path=str(Path(self.temp_dir) / ".env"),
-            relative_path=".env",
-            config_type="env",
-            purpose="unknown"
+            file_path=str(Path(self.temp_dir) / ".env"), relative_path=".env", config_type="env", purpose="unknown"
         )
 
         file_path = Path(self.temp_dir) / ".env"
@@ -208,7 +201,7 @@ endpoint = https://api.example.com
             file_path=str(Path(self.temp_dir) / "config.ini"),
             relative_path="config.ini",
             config_type="ini",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "config.ini"
@@ -230,7 +223,7 @@ API_KEYS = ['key1', 'key2']
             file_path=str(Path(self.temp_dir) / "settings.py"),
             relative_path="settings.py",
             config_type="python",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "settings.py"
@@ -255,7 +248,7 @@ WORKDIR /app
             file_path=str(Path(self.temp_dir) / "Dockerfile"),
             relative_path="Dockerfile",
             config_type="dockerfile",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "Dockerfile"
@@ -283,7 +276,7 @@ module.exports = {
             file_path=str(Path(self.temp_dir) / "config.js"),
             relative_path="config.js",
             config_type="javascript",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "config.js"
@@ -309,7 +302,7 @@ endpoint = "https://api.example.com"
             file_path=str(Path(self.temp_dir) / "config.toml"),
             relative_path="config.toml",
             config_type="toml",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "config.toml"
@@ -319,7 +312,9 @@ endpoint = "https://api.example.com"
         self.parser.parse_config_file(config_file)
 
         # Check if parsing failed due to missing toml/tomli
-        if config_file.parse_errors and ("toml" in str(config_file.parse_errors).lower() and "not installed" in str(config_file.parse_errors)):
+        if config_file.parse_errors and (
+            "toml" in str(config_file.parse_errors).lower() and "not installed" in str(config_file.parse_errors)
+        ):
             self.skipTest("toml/tomli not installed")
 
         self.assertGreater(len(config_file.settings), 0)
@@ -342,11 +337,7 @@ class TestConfigPatternDetector(unittest.TestCase):
         ]
 
         config_file = ConfigFile(
-            file_path="test.json",
-            relative_path="test.json",
-            config_type="json",
-            purpose="unknown",
-            settings=settings
+            file_path="test.json", relative_path="test.json", config_type="json", purpose="unknown", settings=settings
         )
 
         patterns = self.detector.detect_patterns(config_file)
@@ -362,11 +353,7 @@ class TestConfigPatternDetector(unittest.TestCase):
         ]
 
         config_file = ConfigFile(
-            file_path="test.json",
-            relative_path="test.json",
-            config_type="json",
-            purpose="unknown",
-            settings=settings
+            file_path="test.json", relative_path="test.json", config_type="json", purpose="unknown", settings=settings
         )
 
         patterns = self.detector.detect_patterns(config_file)
@@ -382,11 +369,7 @@ class TestConfigPatternDetector(unittest.TestCase):
         ]
 
         config_file = ConfigFile(
-            file_path="test.json",
-            relative_path="test.json",
-            config_type="json",
-            purpose="unknown",
-            settings=settings
+            file_path="test.json", relative_path="test.json", config_type="json", purpose="unknown", settings=settings
         )
 
         patterns = self.detector.detect_patterns(config_file)
@@ -402,11 +385,7 @@ class TestConfigPatternDetector(unittest.TestCase):
         ]
 
         config_file = ConfigFile(
-            file_path="test.json",
-            relative_path="test.json",
-            config_type="json",
-            purpose="unknown",
-            settings=settings
+            file_path="test.json", relative_path="test.json", config_type="json", purpose="unknown", settings=settings
         )
 
         patterns = self.detector.detect_patterns(config_file)
@@ -423,11 +402,7 @@ class TestConfigPatternDetector(unittest.TestCase):
         ]
 
         config_file = ConfigFile(
-            file_path="test.json",
-            relative_path="test.json",
-            config_type="json",
-            purpose="unknown",
-            settings=settings
+            file_path="test.json", relative_path="test.json", config_type="json", purpose="unknown", settings=settings
         )
 
         patterns = self.detector.detect_patterns(config_file)
@@ -443,11 +418,7 @@ class TestConfigPatternDetector(unittest.TestCase):
         ]
 
         config_file = ConfigFile(
-            file_path="test.json",
-            relative_path="test.json",
-            config_type="json",
-            purpose="unknown",
-            settings=settings
+            file_path="test.json", relative_path="test.json", config_type="json", purpose="unknown", settings=settings
         )
 
         patterns = self.detector.detect_patterns(config_file)
@@ -463,11 +434,7 @@ class TestConfigPatternDetector(unittest.TestCase):
         ]
 
         config_file = ConfigFile(
-            file_path="test.json",
-            relative_path="test.json",
-            config_type="json",
-            purpose="unknown",
-            settings=settings
+            file_path="test.json", relative_path="test.json", config_type="json", purpose="unknown", settings=settings
         )
 
         patterns = self.detector.detect_patterns(config_file)
@@ -484,6 +451,7 @@ class TestConfigExtractorIntegration(unittest.TestCase):
 
     def tearDown(self):
         import shutil
+
         shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_extract_from_directory(self):
@@ -506,15 +474,13 @@ class TestConfigExtractorIntegration(unittest.TestCase):
                     relative_path="config.json",
                     config_type="json",
                     purpose="database_config",
-                    settings=[
-                        ConfigSetting(key="host", value="localhost", value_type="string")
-                    ],
-                    patterns=["database_config"]
+                    settings=[ConfigSetting(key="host", value="localhost", value_type="string")],
+                    patterns=["database_config"],
                 )
             ],
             total_files=1,
             total_settings=1,
-            detected_patterns=["database_config"]
+            detected_patterns=["database_config"],
         )
 
         markdown = result.to_markdown()
@@ -532,15 +498,13 @@ class TestConfigExtractorIntegration(unittest.TestCase):
                     relative_path="config.json",
                     config_type="json",
                     purpose="database_config",
-                    settings=[
-                        ConfigSetting(key="host", value="localhost", value_type="string")
-                    ],
-                    patterns=["database_config"]
+                    settings=[ConfigSetting(key="host", value="localhost", value_type="string")],
+                    patterns=["database_config"],
                 )
             ],
             total_files=1,
             total_settings=1,
-            detected_patterns=["database_config"]
+            detected_patterns=["database_config"],
         )
 
         json_data = result.to_dict()
@@ -582,6 +546,7 @@ class TestEdgeCases(unittest.TestCase):
 
     def tearDown(self):
         import shutil
+
         shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_parse_empty_file(self):
@@ -590,7 +555,7 @@ class TestEdgeCases(unittest.TestCase):
             file_path=str(Path(self.temp_dir) / "empty.json"),
             relative_path="empty.json",
             config_type="json",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "empty.json"
@@ -606,7 +571,7 @@ class TestEdgeCases(unittest.TestCase):
             file_path=str(Path(self.temp_dir) / "invalid.json"),
             relative_path="invalid.json",
             config_type="json",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         file_path = Path(self.temp_dir) / "invalid.json"
@@ -621,12 +586,12 @@ class TestEdgeCases(unittest.TestCase):
             file_path=str(Path(self.temp_dir) / "nonexistent.json"),
             relative_path="nonexistent.json",
             config_type="json",
-            purpose="unknown"
+            purpose="unknown",
         )
 
         # Should not crash
         self.parser.parse_config_file(config_file)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_config_validation.py b/tests/test_config_validation.py
index eaae6ec..98d17b6 100644
--- a/tests/test_config_validation.py
+++ b/tests/test_config_validation.py
@@ -4,8 +4,8 @@ Test suite for configuration validation
 Tests the validate_config() function with various valid and invalid configs
 """
 
-import sys
 import os
+import sys
 import unittest
 
 # Add parent directory to path
@@ -19,10 +19,7 @@ class TestConfigValidation(unittest.TestCase):
 
     def test_valid_minimal_config(self):
         """Test valid minimal configuration"""
-        config = {
-            'name': 'test-skill',
-            'base_url': 'https://example.com/'
-        }
+        config = {"name": "test-skill", "base_url": "https://example.com/"}
         errors, _ = validate_config(config)
         # Should have warnings about missing selectors, but no critical errors
         self.assertIsInstance(errors, list)
@@ -30,307 +27,205 @@ class TestConfigValidation(unittest.TestCase):
     def test_valid_complete_config(self):
         """Test valid complete configuration"""
         config = {
-            'name': 'godot',
-            'base_url': 'https://docs.godotengine.org/en/stable/',
-            'description': 'Godot Engine documentation',
-            'selectors': {
-                'main_content': 'div[role="main"]',
-                'title': 'title',
-                'code_blocks': 'pre code'
-            },
-            'url_patterns': {
-                'include': ['/guide/', '/api/'],
-                'exclude': ['/blog/']
-            },
-            'categories': {
-                'getting_started': ['intro', 'tutorial'],
-                'api': ['api', 'reference']
-            },
-            'rate_limit': 0.5,
-            'max_pages': 500
+            "name": "godot",
+            "base_url": "https://docs.godotengine.org/en/stable/",
+            "description": "Godot Engine documentation",
+            "selectors": {"main_content": 'div[role="main"]', "title": "title", "code_blocks": "pre code"},
+            "url_patterns": {"include": ["/guide/", "/api/"], "exclude": ["/blog/"]},
+            "categories": {"getting_started": ["intro", "tutorial"], "api": ["api", "reference"]},
+            "rate_limit": 0.5,
+            "max_pages": 500,
         }
         errors, _ = validate_config(config)
         self.assertEqual(len(errors), 0, f"Valid config should have no errors, got: {errors}")
 
     def test_missing_name(self):
         """Test missing required field 'name'"""
-        config = {
-            'base_url': 'https://example.com/'
-        }
+        config = {"base_url": "https://example.com/"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('name' in error.lower() for error in errors))
+        self.assertTrue(any("name" in error.lower() for error in errors))
 
     def test_missing_base_url(self):
         """Test missing required field 'base_url'"""
-        config = {
-            'name': 'test'
-        }
+        config = {"name": "test"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('base_url' in error.lower() for error in errors))
+        self.assertTrue(any("base_url" in error.lower() for error in errors))
 
     def test_invalid_name_special_chars(self):
         """Test invalid name with special characters"""
-        config = {
-            'name': 'test@skill!',
-            'base_url': 'https://example.com/'
-        }
+        config = {"name": "test@skill!", "base_url": "https://example.com/"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('invalid name' in error.lower() for error in errors))
+        self.assertTrue(any("invalid name" in error.lower() for error in errors))
 
     def test_valid_name_formats(self):
         """Test various valid name formats"""
-        valid_names = ['test', 'test-skill', 'test_skill', 'TestSkill123', 'my-awesome-skill_v2']
+        valid_names = ["test", "test-skill", "test_skill", "TestSkill123", "my-awesome-skill_v2"]
         for name in valid_names:
-            config = {
-                'name': name,
-                'base_url': 'https://example.com/'
-            }
+            config = {"name": name, "base_url": "https://example.com/"}
             errors, _ = validate_config(config)
-            name_errors = [e for e in errors if 'invalid name' in e.lower()]
+            name_errors = [e for e in errors if "invalid name" in e.lower()]
             self.assertEqual(len(name_errors), 0, f"Name '{name}' should be valid")
 
     def test_invalid_base_url_no_protocol(self):
         """Test invalid base_url without protocol"""
-        config = {
-            'name': 'test',
-            'base_url': 'example.com'
-        }
+        config = {"name": "test", "base_url": "example.com"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('base_url' in error.lower() for error in errors))
+        self.assertTrue(any("base_url" in error.lower() for error in errors))
 
     def test_valid_url_protocols(self):
         """Test valid URL protocols"""
-        for protocol in ['http://', 'https://']:
-            config = {
-                'name': 'test',
-                'base_url': f'{protocol}example.com/'
-            }
+        for protocol in ["http://", "https://"]:
+            config = {"name": "test", "base_url": f"{protocol}example.com/"}
             errors, _ = validate_config(config)
-            url_errors = [e for e in errors if 'base_url' in e.lower() and 'invalid' in e.lower()]
+            url_errors = [e for e in errors if "base_url" in e.lower() and "invalid" in e.lower()]
             self.assertEqual(len(url_errors), 0, f"Protocol '{protocol}' should be valid")
 
     def test_invalid_selectors_not_dict(self):
         """Test invalid selectors (not a dictionary)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': 'invalid'
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "selectors": "invalid"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('selectors' in error.lower() and 'dictionary' in error.lower() for error in errors))
+        self.assertTrue(any("selectors" in error.lower() and "dictionary" in error.lower() for error in errors))
 
     def test_missing_recommended_selectors(self):
         """Test warning for missing recommended selectors"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {
-                'main_content': 'article'
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {
+                "main_content": "article"
                 # Missing 'title' and 'code_blocks'
-            }
+            },
         }
         _, warnings = validate_config(config)
-        self.assertTrue(any('title' in warning.lower() for warning in warnings))
-        self.assertTrue(any('code_blocks' in warning.lower() for warning in warnings))
+        self.assertTrue(any("title" in warning.lower() for warning in warnings))
+        self.assertTrue(any("code_blocks" in warning.lower() for warning in warnings))
 
     def test_invalid_url_patterns_not_dict(self):
         """Test invalid url_patterns (not a dictionary)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'url_patterns': []
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "url_patterns": []}
         errors, _ = validate_config(config)
-        self.assertTrue(any('url_patterns' in error.lower() and 'dictionary' in error.lower() for error in errors))
+        self.assertTrue(any("url_patterns" in error.lower() and "dictionary" in error.lower() for error in errors))
 
     def test_invalid_url_patterns_include_not_list(self):
         """Test invalid url_patterns.include (not a list)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'url_patterns': {
-                'include': 'not-a-list'
-            }
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "url_patterns": {"include": "not-a-list"}}
         errors, _ = validate_config(config)
-        self.assertTrue(any('include' in error.lower() and 'list' in error.lower() for error in errors))
+        self.assertTrue(any("include" in error.lower() and "list" in error.lower() for error in errors))
 
     def test_invalid_categories_not_dict(self):
         """Test invalid categories (not a dictionary)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'categories': []
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "categories": []}
         errors, _ = validate_config(config)
-        self.assertTrue(any('categories' in error.lower() and 'dictionary' in error.lower() for error in errors))
+        self.assertTrue(any("categories" in error.lower() and "dictionary" in error.lower() for error in errors))
 
     def test_invalid_category_keywords_not_list(self):
         """Test invalid category keywords (not a list)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'categories': {
-                'getting_started': 'not-a-list'
-            }
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "categories": {"getting_started": "not-a-list"}}
         errors, _ = validate_config(config)
-        self.assertTrue(any('getting_started' in error.lower() and 'list' in error.lower() for error in errors))
+        self.assertTrue(any("getting_started" in error.lower() and "list" in error.lower() for error in errors))
 
     def test_invalid_rate_limit_negative(self):
         """Test invalid rate_limit (negative)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'rate_limit': -1
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "rate_limit": -1}
         errors, _ = validate_config(config)
-        self.assertTrue(any('rate_limit' in error.lower() for error in errors))
+        self.assertTrue(any("rate_limit" in error.lower() for error in errors))
 
     def test_invalid_rate_limit_too_high(self):
         """Test invalid rate_limit (too high)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'rate_limit': 20
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "rate_limit": 20}
         _, warnings = validate_config(config)
-        self.assertTrue(any('rate_limit' in warning.lower() for warning in warnings))
+        self.assertTrue(any("rate_limit" in warning.lower() for warning in warnings))
 
     def test_invalid_rate_limit_not_number(self):
         """Test invalid rate_limit (not a number)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'rate_limit': 'fast'
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "rate_limit": "fast"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('rate_limit' in error.lower() for error in errors))
+        self.assertTrue(any("rate_limit" in error.lower() for error in errors))
 
     def test_valid_rate_limit_range(self):
         """Test valid rate_limit range"""
         for rate in [0, 0.1, 0.5, 1, 5, 10]:
-            config = {
-                'name': 'test',
-                'base_url': 'https://example.com/',
-                'rate_limit': rate
-            }
+            config = {"name": "test", "base_url": "https://example.com/", "rate_limit": rate}
             errors, _ = validate_config(config)
-            rate_errors = [e for e in errors if 'rate_limit' in e.lower()]
+            rate_errors = [e for e in errors if "rate_limit" in e.lower()]
             self.assertEqual(len(rate_errors), 0, f"Rate limit {rate} should be valid")
 
     def test_invalid_max_pages_zero(self):
         """Test invalid max_pages (zero)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'max_pages': 0
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "max_pages": 0}
         errors, _ = validate_config(config)
-        self.assertTrue(any('max_pages' in error.lower() for error in errors))
+        self.assertTrue(any("max_pages" in error.lower() for error in errors))
 
     def test_invalid_max_pages_too_high(self):
         """Test invalid max_pages (too high)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'max_pages': 20000
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "max_pages": 20000}
         _, warnings = validate_config(config)
-        self.assertTrue(any('max_pages' in warning.lower() for warning in warnings))
+        self.assertTrue(any("max_pages" in warning.lower() for warning in warnings))
 
     def test_invalid_max_pages_not_int(self):
         """Test invalid max_pages (not an integer)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'max_pages': 'many'
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "max_pages": "many"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('max_pages' in error.lower() for error in errors))
+        self.assertTrue(any("max_pages" in error.lower() for error in errors))
 
     def test_valid_max_pages_range(self):
         """Test valid max_pages range"""
         for max_p in [1, 10, 100, 500, 5000, 10000]:
-            config = {
-                'name': 'test',
-                'base_url': 'https://example.com/',
-                'max_pages': max_p
-            }
+            config = {"name": "test", "base_url": "https://example.com/", "max_pages": max_p}
             errors, _ = validate_config(config)
-            max_errors = [e for e in errors if 'max_pages' in e.lower()]
+            max_errors = [e for e in errors if "max_pages" in e.lower()]
             self.assertEqual(len(max_errors), 0, f"Max pages {max_p} should be valid")
 
     def test_invalid_start_urls_not_list(self):
         """Test invalid start_urls (not a list)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'start_urls': 'https://example.com/page1'
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "start_urls": "https://example.com/page1"}
         errors, _ = validate_config(config)
-        self.assertTrue(any('start_urls' in error.lower() and 'list' in error.lower() for error in errors))
+        self.assertTrue(any("start_urls" in error.lower() and "list" in error.lower() for error in errors))
 
     def test_invalid_start_urls_bad_protocol(self):
         """Test invalid start_urls (bad protocol)"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'start_urls': ['ftp://example.com/page1']
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "start_urls": ["ftp://example.com/page1"]}
         errors, _ = validate_config(config)
-        self.assertTrue(any('start_url' in error.lower() for error in errors))
+        self.assertTrue(any("start_url" in error.lower() for error in errors))
 
     def test_valid_start_urls(self):
         """Test valid start_urls"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'start_urls': [
-                'https://example.com/page1',
-                'http://example.com/page2',
-                'https://example.com/api/docs'
-            ]
+            "name": "test",
+            "base_url": "https://example.com/",
+            "start_urls": ["https://example.com/page1", "http://example.com/page2", "https://example.com/api/docs"],
         }
         errors, _ = validate_config(config)
-        url_errors = [e for e in errors if 'start_url' in e.lower()]
+        url_errors = [e for e in errors if "start_url" in e.lower()]
         self.assertEqual(len(url_errors), 0, "Valid start_urls should pass validation")
 
     def test_config_with_llms_txt_url(self):
         """Test config validation with explicit llms_txt_url"""
         config = {
-            'name': 'test',
-            'llms_txt_url': 'https://example.com/llms-full.txt',
-            'base_url': 'https://example.com/docs'
+            "name": "test",
+            "llms_txt_url": "https://example.com/llms-full.txt",
+            "base_url": "https://example.com/docs",
         }
 
         # Should be valid
-        self.assertEqual(config.get('llms_txt_url'), 'https://example.com/llms-full.txt')
+        self.assertEqual(config.get("llms_txt_url"), "https://example.com/llms-full.txt")
 
     def test_config_with_skip_llms_txt(self):
         """Test config validation accepts skip_llms_txt"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/docs',
-            'skip_llms_txt': True
-        }
+        config = {"name": "test", "base_url": "https://example.com/docs", "skip_llms_txt": True}
 
         errors, warnings = validate_config(config)
         self.assertEqual(errors, [])
-        self.assertTrue(config.get('skip_llms_txt'))
+        self.assertTrue(config.get("skip_llms_txt"))
 
     def test_config_with_skip_llms_txt_false(self):
         """Test config validation accepts skip_llms_txt as False"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/docs',
-            'skip_llms_txt': False
-        }
+        config = {"name": "test", "base_url": "https://example.com/docs", "skip_llms_txt": False}
 
         errors, warnings = validate_config(config)
         self.assertEqual(errors, [])
-        self.assertFalse(config.get('skip_llms_txt'))
+        self.assertFalse(config.get("skip_llms_txt"))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_constants.py b/tests/test_constants.py
index 0eef01f..f874179 100644
--- a/tests/test_constants.py
+++ b/tests/test_constants.py
@@ -1,31 +1,31 @@
 #!/usr/bin/env python3
 """Test suite for cli/constants.py module."""
 
-import unittest
 import sys
+import unittest
 from pathlib import Path
 
 # Add parent directory to path
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
 from skill_seekers.cli.constants import (
-    DEFAULT_RATE_LIMIT,
-    DEFAULT_MAX_PAGES,
-    DEFAULT_CHECKPOINT_INTERVAL,
-    CONTENT_PREVIEW_LENGTH,
-    MAX_PAGES_WARNING_THRESHOLD,
-    MIN_CATEGORIZATION_SCORE,
-    URL_MATCH_POINTS,
-    TITLE_MATCH_POINTS,
-    CONTENT_MATCH_POINTS,
     API_CONTENT_LIMIT,
     API_PREVIEW_LIMIT,
+    CONTENT_MATCH_POINTS,
+    CONTENT_PREVIEW_LENGTH,
+    DEFAULT_CHECKPOINT_INTERVAL,
+    DEFAULT_MAX_DISCOVERY,
+    DEFAULT_MAX_PAGES,
+    DEFAULT_RATE_LIMIT,
+    DISCOVERY_THRESHOLD,
     LOCAL_CONTENT_LIMIT,
     LOCAL_PREVIEW_LIMIT,
-    DEFAULT_MAX_DISCOVERY,
-    DISCOVERY_THRESHOLD,
-    MAX_REFERENCE_FILES,
     MAX_CODE_BLOCKS_PER_PAGE,
+    MAX_PAGES_WARNING_THRESHOLD,
+    MAX_REFERENCE_FILES,
+    MIN_CATEGORIZATION_SCORE,
+    TITLE_MATCH_POINTS,
+    URL_MATCH_POINTS,
 )
 
 
@@ -110,25 +110,29 @@ class TestConstantsUsage(unittest.TestCase):
     def test_doc_scraper_imports_constants(self):
         """Test that doc_scraper imports and uses constants."""
         from skill_seekers.cli import doc_scraper
+
         # Check that doc_scraper can access the constants
-        self.assertTrue(hasattr(doc_scraper, 'DEFAULT_RATE_LIMIT'))
-        self.assertTrue(hasattr(doc_scraper, 'DEFAULT_MAX_PAGES'))
+        self.assertTrue(hasattr(doc_scraper, "DEFAULT_RATE_LIMIT"))
+        self.assertTrue(hasattr(doc_scraper, "DEFAULT_MAX_PAGES"))
 
     def test_estimate_pages_imports_constants(self):
         """Test that estimate_pages imports and uses constants."""
-        from skill_seekers.cli import estimate_pages
         # Verify function signature uses constants
         import inspect
+
+        from skill_seekers.cli import estimate_pages
+
         sig = inspect.signature(estimate_pages.estimate_pages)
-        self.assertIn('max_discovery', sig.parameters)
+        self.assertIn("max_discovery", sig.parameters)
 
     def test_enhance_skill_imports_constants(self):
         """Test that enhance_skill imports constants."""
         try:
             from skill_seekers.cli import enhance_skill
+
             # Check module loads without errors
             self.assertIsNotNone(enhance_skill)
-        except (ImportError, SystemExit) as e:
+        except (ImportError, SystemExit):
             # anthropic package may not be installed or module exits on import
             # This is acceptable - we're just checking the constants import works
             pass
@@ -136,6 +140,7 @@ class TestConstantsUsage(unittest.TestCase):
     def test_enhance_skill_local_imports_constants(self):
         """Test that enhance_skill_local imports constants."""
         from skill_seekers.cli import enhance_skill_local
+
         self.assertIsNotNone(enhance_skill_local)
 
 
@@ -145,19 +150,18 @@ class TestConstantsExports(unittest.TestCase):
     def test_all_exports_exist(self):
         """Test that all items in __all__ exist."""
         from skill_seekers.cli import constants
-        self.assertTrue(hasattr(constants, '__all__'))
+
+        self.assertTrue(hasattr(constants, "__all__"))
         for name in constants.__all__:
-            self.assertTrue(
-                hasattr(constants, name),
-                f"Constant '{name}' in __all__ but not defined"
-            )
+            self.assertTrue(hasattr(constants, name), f"Constant '{name}' in __all__ but not defined")
 
     def test_all_exports_count(self):
         """Test that __all__ has expected number of exports."""
         from skill_seekers.cli import constants
+
         # We defined 18 constants (added DEFAULT_ASYNC_MODE)
         self.assertEqual(len(constants.__all__), 18)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_dependency_analyzer.py b/tests/test_dependency_analyzer.py
index 32170c3..04db585 100644
--- a/tests/test_dependency_analyzer.py
+++ b/tests/test_dependency_analyzer.py
@@ -11,18 +11,13 @@ Test Coverage:
 - Graph export (JSON, DOT, Mermaid)
 """
 
-import unittest
-import tempfile
 import shutil
-import json
-from pathlib import Path
+import tempfile
+import unittest
 
 try:
-    from skill_seekers.cli.dependency_analyzer import (
-        DependencyAnalyzer,
-        DependencyInfo,
-        FileNode
-    )
+    from skill_seekers.cli.dependency_analyzer import DependencyAnalyzer, DependencyInfo, FileNode
+
     ANALYZER_AVAILABLE = True
 except ImportError:
     ANALYZER_AVAILABLE = False
@@ -39,46 +34,46 @@ class TestPythonImportExtraction(unittest.TestCase):
     def test_simple_import(self):
         """Test simple import statement."""
         code = "import os\nimport sys"
-        deps = self.analyzer.analyze_file('test.py', code, 'Python')
+        deps = self.analyzer.analyze_file("test.py", code, "Python")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'os')
-        self.assertEqual(deps[0].import_type, 'import')
+        self.assertEqual(deps[0].imported_module, "os")
+        self.assertEqual(deps[0].import_type, "import")
         self.assertFalse(deps[0].is_relative)
 
     def test_from_import(self):
         """Test from...import statement."""
         code = "from pathlib import Path\nfrom typing import List"
-        deps = self.analyzer.analyze_file('test.py', code, 'Python')
+        deps = self.analyzer.analyze_file("test.py", code, "Python")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'pathlib')
-        self.assertEqual(deps[0].import_type, 'from')
+        self.assertEqual(deps[0].imported_module, "pathlib")
+        self.assertEqual(deps[0].import_type, "from")
 
     def test_relative_import(self):
         """Test relative import."""
         code = "from . import utils\nfrom ..common import helper"
-        deps = self.analyzer.analyze_file('test.py', code, 'Python')
+        deps = self.analyzer.analyze_file("test.py", code, "Python")
 
         self.assertEqual(len(deps), 2)
         self.assertTrue(deps[0].is_relative)
-        self.assertEqual(deps[0].imported_module, '.')
+        self.assertEqual(deps[0].imported_module, ".")
         self.assertTrue(deps[1].is_relative)
-        self.assertEqual(deps[1].imported_module, '..common')
+        self.assertEqual(deps[1].imported_module, "..common")
 
     def test_import_as(self):
         """Test import with alias."""
         code = "import numpy as np\nimport pandas as pd"
-        deps = self.analyzer.analyze_file('test.py', code, 'Python')
+        deps = self.analyzer.analyze_file("test.py", code, "Python")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'numpy')
-        self.assertEqual(deps[1].imported_module, 'pandas')
+        self.assertEqual(deps[0].imported_module, "numpy")
+        self.assertEqual(deps[1].imported_module, "pandas")
 
     def test_syntax_error_handling(self):
         """Test handling of syntax errors."""
         code = "import os\nthis is not valid python\nimport sys"
-        deps = self.analyzer.analyze_file('test.py', code, 'Python')
+        deps = self.analyzer.analyze_file("test.py", code, "Python")
 
         # Should return empty list due to syntax error
         self.assertEqual(len(deps), 0)
@@ -95,30 +90,30 @@ class TestJavaScriptImportExtraction(unittest.TestCase):
     def test_es6_import(self):
         """Test ES6 import statement."""
         code = "import React from 'react';\nimport { useState } from 'react';"
-        deps = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+        deps = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'react')
-        self.assertEqual(deps[0].import_type, 'import')
+        self.assertEqual(deps[0].imported_module, "react")
+        self.assertEqual(deps[0].import_type, "import")
         self.assertFalse(deps[0].is_relative)
 
     def test_commonjs_require(self):
         """Test CommonJS require statement."""
         code = "const express = require('express');\nconst fs = require('fs');"
-        deps = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+        deps = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'express')
-        self.assertEqual(deps[0].import_type, 'require')
+        self.assertEqual(deps[0].imported_module, "express")
+        self.assertEqual(deps[0].import_type, "require")
 
     def test_relative_import_js(self):
         """Test relative imports in JavaScript."""
         code = "import utils from './utils';\nimport config from '../config';"
-        deps = self.analyzer.analyze_file('test.js', code, 'JavaScript')
+        deps = self.analyzer.analyze_file("test.js", code, "JavaScript")
 
         self.assertEqual(len(deps), 2)
         self.assertTrue(deps[0].is_relative)
-        self.assertEqual(deps[0].imported_module, './utils')
+        self.assertEqual(deps[0].imported_module, "./utils")
         self.assertTrue(deps[1].is_relative)
 
     def test_mixed_imports(self):
@@ -128,13 +123,13 @@ import React from 'react';
 const path = require('path');
 import { Component } from '@angular/core';
 """
-        deps = self.analyzer.analyze_file('test.ts', code, 'TypeScript')
+        deps = self.analyzer.analyze_file("test.ts", code, "TypeScript")
 
         self.assertEqual(len(deps), 3)
         # Should find both import and require types
         import_types = [dep.import_type for dep in deps]
-        self.assertIn('import', import_types)
-        self.assertIn('require', import_types)
+        self.assertIn("import", import_types)
+        self.assertIn("require", import_types)
 
 
 class TestCppIncludeExtraction(unittest.TestCase):
@@ -148,20 +143,20 @@ class TestCppIncludeExtraction(unittest.TestCase):
     def test_system_includes(self):
         """Test system header includes."""
         code = "#include <iostream>\n#include <vector>\n#include <string>"
-        deps = self.analyzer.analyze_file('test.cpp', code, 'C++')
+        deps = self.analyzer.analyze_file("test.cpp", code, "C++")
 
         self.assertEqual(len(deps), 3)
-        self.assertEqual(deps[0].imported_module, 'iostream')
-        self.assertEqual(deps[0].import_type, 'include')
+        self.assertEqual(deps[0].imported_module, "iostream")
+        self.assertEqual(deps[0].import_type, "include")
         self.assertFalse(deps[0].is_relative)  # <> headers are system headers
 
     def test_local_includes(self):
         """Test local header includes."""
         code = '#include "utils.h"\n#include "config.h"'
-        deps = self.analyzer.analyze_file('test.cpp', code, 'C++')
+        deps = self.analyzer.analyze_file("test.cpp", code, "C++")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'utils.h')
+        self.assertEqual(deps[0].imported_module, "utils.h")
         self.assertTrue(deps[0].is_relative)  # "" headers are local
 
     def test_mixed_includes(self):
@@ -172,7 +167,7 @@ class TestCppIncludeExtraction(unittest.TestCase):
 #include <vector>
 #include "config.h"
 """
-        deps = self.analyzer.analyze_file('test.cpp', code, 'C++')
+        deps = self.analyzer.analyze_file("test.cpp", code, "C++")
 
         self.assertEqual(len(deps), 4)
         relative_count = sum(1 for dep in deps if dep.is_relative)
@@ -190,8 +185,8 @@ class TestDependencyGraphBuilding(unittest.TestCase):
     def test_simple_graph(self):
         """Test building a simple dependency graph."""
         # Create a simple dependency: main.py -> utils.py
-        self.analyzer.analyze_file('main.py', 'import utils', 'Python')
-        self.analyzer.analyze_file('utils.py', '', 'Python')
+        self.analyzer.analyze_file("main.py", "import utils", "Python")
+        self.analyzer.analyze_file("utils.py", "", "Python")
 
         graph = self.analyzer.build_graph()
 
@@ -202,9 +197,9 @@ class TestDependencyGraphBuilding(unittest.TestCase):
     def test_multiple_dependencies(self):
         """Test graph with multiple dependencies."""
         # main.py imports utils.py and config.py
-        self.analyzer.analyze_file('main.py', 'import utils\nimport config', 'Python')
-        self.analyzer.analyze_file('utils.py', '', 'Python')
-        self.analyzer.analyze_file('config.py', '', 'Python')
+        self.analyzer.analyze_file("main.py", "import utils\nimport config", "Python")
+        self.analyzer.analyze_file("utils.py", "", "Python")
+        self.analyzer.analyze_file("config.py", "", "Python")
 
         graph = self.analyzer.build_graph()
 
@@ -213,9 +208,9 @@ class TestDependencyGraphBuilding(unittest.TestCase):
     def test_chain_dependencies(self):
         """Test chain of dependencies."""
         # main -> utils -> helpers
-        self.analyzer.analyze_file('main.py', 'import utils', 'Python')
-        self.analyzer.analyze_file('utils.py', 'import helpers', 'Python')
-        self.analyzer.analyze_file('helpers.py', '', 'Python')
+        self.analyzer.analyze_file("main.py", "import utils", "Python")
+        self.analyzer.analyze_file("utils.py", "import helpers", "Python")
+        self.analyzer.analyze_file("helpers.py", "", "Python")
 
         graph = self.analyzer.build_graph()
 
@@ -232,8 +227,8 @@ class TestCircularDependencyDetection(unittest.TestCase):
 
     def test_no_circular_dependencies(self):
         """Test graph with no cycles."""
-        self.analyzer.analyze_file('main.py', 'import utils', 'Python')
-        self.analyzer.analyze_file('utils.py', '', 'Python')
+        self.analyzer.analyze_file("main.py", "import utils", "Python")
+        self.analyzer.analyze_file("utils.py", "", "Python")
 
         self.analyzer.build_graph()
         cycles = self.analyzer.detect_cycles()
@@ -244,8 +239,8 @@ class TestCircularDependencyDetection(unittest.TestCase):
         """Test detection of simple cycle."""
         # Create circular dependency: a -> b -> a
         # Using actual Python file extensions for proper resolution
-        self.analyzer.analyze_file('a.py', 'import b', 'Python')
-        self.analyzer.analyze_file('b.py', 'import a', 'Python')
+        self.analyzer.analyze_file("a.py", "import b", "Python")
+        self.analyzer.analyze_file("b.py", "import a", "Python")
 
         self.analyzer.build_graph()
         cycles = self.analyzer.detect_cycles()
@@ -257,9 +252,9 @@ class TestCircularDependencyDetection(unittest.TestCase):
     def test_three_way_cycle(self):
         """Test detection of three-way cycle."""
         # a -> b -> c -> a
-        self.analyzer.analyze_file('a.py', 'import b', 'Python')
-        self.analyzer.analyze_file('b.py', 'import c', 'Python')
-        self.analyzer.analyze_file('c.py', 'import a', 'Python')
+        self.analyzer.analyze_file("a.py", "import b", "Python")
+        self.analyzer.analyze_file("b.py", "import c", "Python")
+        self.analyzer.analyze_file("c.py", "import a", "Python")
 
         self.analyzer.build_graph()
         cycles = self.analyzer.detect_cycles()
@@ -281,43 +276,43 @@ class TestGraphExport(unittest.TestCase):
 
     def test_export_json(self):
         """Test JSON export."""
-        self.analyzer.analyze_file('main.py', 'import utils', 'Python')
-        self.analyzer.analyze_file('utils.py', '', 'Python')
+        self.analyzer.analyze_file("main.py", "import utils", "Python")
+        self.analyzer.analyze_file("utils.py", "", "Python")
         self.analyzer.build_graph()
 
         json_data = self.analyzer.export_json()
 
-        self.assertIn('nodes', json_data)
-        self.assertIn('edges', json_data)
-        self.assertEqual(len(json_data['nodes']), 2)
+        self.assertIn("nodes", json_data)
+        self.assertIn("edges", json_data)
+        self.assertEqual(len(json_data["nodes"]), 2)
         self.assertIsInstance(json_data, dict)
 
     def test_export_mermaid(self):
         """Test Mermaid diagram export."""
-        self.analyzer.analyze_file('main.py', 'import utils', 'Python')
-        self.analyzer.analyze_file('utils.py', '', 'Python')
+        self.analyzer.analyze_file("main.py", "import utils", "Python")
+        self.analyzer.analyze_file("utils.py", "", "Python")
         self.analyzer.build_graph()
 
         mermaid = self.analyzer.export_mermaid()
 
         self.assertIsInstance(mermaid, str)
-        self.assertIn('graph TD', mermaid)
-        self.assertIn('N0', mermaid)  # Node IDs
+        self.assertIn("graph TD", mermaid)
+        self.assertIn("N0", mermaid)  # Node IDs
 
     def test_get_statistics(self):
         """Test graph statistics."""
-        self.analyzer.analyze_file('main.py', 'import utils\nimport config', 'Python')
-        self.analyzer.analyze_file('utils.py', 'import helpers', 'Python')
-        self.analyzer.analyze_file('config.py', '', 'Python')
-        self.analyzer.analyze_file('helpers.py', '', 'Python')
+        self.analyzer.analyze_file("main.py", "import utils\nimport config", "Python")
+        self.analyzer.analyze_file("utils.py", "import helpers", "Python")
+        self.analyzer.analyze_file("config.py", "", "Python")
+        self.analyzer.analyze_file("helpers.py", "", "Python")
         self.analyzer.build_graph()
 
         stats = self.analyzer.get_statistics()
 
-        self.assertIn('total_files', stats)
-        self.assertIn('total_dependencies', stats)
-        self.assertIn('circular_dependencies', stats)
-        self.assertEqual(stats['total_files'], 4)
+        self.assertIn("total_files", stats)
+        self.assertIn("total_dependencies", stats)
+        self.assertIn("circular_dependencies", stats)
+        self.assertEqual(stats["total_files"], 4)
 
 
 class TestCSharpImportExtraction(unittest.TestCase):
@@ -331,28 +326,28 @@ class TestCSharpImportExtraction(unittest.TestCase):
     def test_simple_using(self):
         """Test simple using statement."""
         code = "using System;\nusing System.Collections.Generic;"
-        deps = self.analyzer.analyze_file('test.cs', code, 'C#')
+        deps = self.analyzer.analyze_file("test.cs", code, "C#")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'System')
-        self.assertEqual(deps[0].import_type, 'using')
+        self.assertEqual(deps[0].imported_module, "System")
+        self.assertEqual(deps[0].import_type, "using")
         self.assertFalse(deps[0].is_relative)
 
     def test_using_alias(self):
         """Test using statement with alias."""
         code = "using Project = PC.MyCompany.Project;"
-        deps = self.analyzer.analyze_file('test.cs', code, 'C#')
+        deps = self.analyzer.analyze_file("test.cs", code, "C#")
 
         self.assertEqual(len(deps), 1)
-        self.assertEqual(deps[0].imported_module, 'PC.MyCompany.Project')
+        self.assertEqual(deps[0].imported_module, "PC.MyCompany.Project")
 
     def test_using_static(self):
         """Test static using."""
         code = "using static System.Math;"
-        deps = self.analyzer.analyze_file('test.cs', code, 'C#')
+        deps = self.analyzer.analyze_file("test.cs", code, "C#")
 
         self.assertEqual(len(deps), 1)
-        self.assertEqual(deps[0].imported_module, 'System.Math')
+        self.assertEqual(deps[0].imported_module, "System.Math")
 
 
 class TestGoImportExtraction(unittest.TestCase):
@@ -366,35 +361,35 @@ class TestGoImportExtraction(unittest.TestCase):
     def test_simple_import(self):
         """Test simple import statement."""
         code = 'import "fmt"\nimport "os"'
-        deps = self.analyzer.analyze_file('test.go', code, 'Go')
+        deps = self.analyzer.analyze_file("test.go", code, "Go")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'fmt')
-        self.assertEqual(deps[0].import_type, 'import')
+        self.assertEqual(deps[0].imported_module, "fmt")
+        self.assertEqual(deps[0].import_type, "import")
         self.assertFalse(deps[0].is_relative)
 
     def test_import_with_alias(self):
         """Test import with alias."""
         code = 'import f "fmt"'
-        deps = self.analyzer.analyze_file('test.go', code, 'Go')
+        deps = self.analyzer.analyze_file("test.go", code, "Go")
 
         self.assertEqual(len(deps), 1)
-        self.assertEqual(deps[0].imported_module, 'fmt')
+        self.assertEqual(deps[0].imported_module, "fmt")
 
     def test_multi_import_block(self):
         """Test multi-import block."""
-        code = '''import (
+        code = """import (
     "fmt"
     "os"
     "io"
-)'''
-        deps = self.analyzer.analyze_file('test.go', code, 'Go')
+)"""
+        deps = self.analyzer.analyze_file("test.go", code, "Go")
 
         self.assertEqual(len(deps), 3)
         modules = [dep.imported_module for dep in deps]
-        self.assertIn('fmt', modules)
-        self.assertIn('os', modules)
-        self.assertIn('io', modules)
+        self.assertIn("fmt", modules)
+        self.assertIn("os", modules)
+        self.assertIn("io", modules)
 
 
 class TestRustImportExtraction(unittest.TestCase):
@@ -408,26 +403,26 @@ class TestRustImportExtraction(unittest.TestCase):
     def test_simple_use(self):
         """Test simple use statement."""
         code = "use std::collections::HashMap;\nuse std::io;"
-        deps = self.analyzer.analyze_file('test.rs', code, 'Rust')
+        deps = self.analyzer.analyze_file("test.rs", code, "Rust")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'std::collections::HashMap')
-        self.assertEqual(deps[0].import_type, 'use')
+        self.assertEqual(deps[0].imported_module, "std::collections::HashMap")
+        self.assertEqual(deps[0].import_type, "use")
         self.assertFalse(deps[0].is_relative)
 
     def test_use_crate(self):
         """Test use with crate keyword."""
         code = "use crate::module::Item;"
-        deps = self.analyzer.analyze_file('test.rs', code, 'Rust')
+        deps = self.analyzer.analyze_file("test.rs", code, "Rust")
 
         self.assertEqual(len(deps), 1)
-        self.assertEqual(deps[0].imported_module, 'crate::module::Item')
+        self.assertEqual(deps[0].imported_module, "crate::module::Item")
         self.assertFalse(deps[0].is_relative)
 
     def test_use_super(self):
         """Test use with super keyword."""
         code = "use super::sibling;"
-        deps = self.analyzer.analyze_file('test.rs', code, 'Rust')
+        deps = self.analyzer.analyze_file("test.rs", code, "Rust")
 
         self.assertEqual(len(deps), 1)
         self.assertTrue(deps[0].is_relative)
@@ -435,12 +430,12 @@ class TestRustImportExtraction(unittest.TestCase):
     def test_use_curly_braces(self):
         """Test use with curly braces."""
         code = "use std::{io, fs};"
-        deps = self.analyzer.analyze_file('test.rs', code, 'Rust')
+        deps = self.analyzer.analyze_file("test.rs", code, "Rust")
 
         self.assertEqual(len(deps), 2)
         modules = [dep.imported_module for dep in deps]
-        self.assertIn('std::io', modules)
-        self.assertIn('std::fs', modules)
+        self.assertIn("std::io", modules)
+        self.assertIn("std::fs", modules)
 
 
 class TestJavaImportExtraction(unittest.TestCase):
@@ -454,28 +449,28 @@ class TestJavaImportExtraction(unittest.TestCase):
     def test_simple_import(self):
         """Test simple import statement."""
         code = "import java.util.List;\nimport java.io.File;"
-        deps = self.analyzer.analyze_file('test.java', code, 'Java')
+        deps = self.analyzer.analyze_file("test.java", code, "Java")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'java.util.List')
-        self.assertEqual(deps[0].import_type, 'import')
+        self.assertEqual(deps[0].imported_module, "java.util.List")
+        self.assertEqual(deps[0].import_type, "import")
         self.assertFalse(deps[0].is_relative)
 
     def test_wildcard_import(self):
         """Test wildcard import."""
         code = "import java.util.*;"
-        deps = self.analyzer.analyze_file('test.java', code, 'Java')
+        deps = self.analyzer.analyze_file("test.java", code, "Java")
 
         self.assertEqual(len(deps), 1)
-        self.assertEqual(deps[0].imported_module, 'java.util.*')
+        self.assertEqual(deps[0].imported_module, "java.util.*")
 
     def test_static_import(self):
         """Test static import."""
         code = "import static java.lang.Math.PI;"
-        deps = self.analyzer.analyze_file('test.java', code, 'Java')
+        deps = self.analyzer.analyze_file("test.java", code, "Java")
 
         self.assertEqual(len(deps), 1)
-        self.assertEqual(deps[0].imported_module, 'java.lang.Math.PI')
+        self.assertEqual(deps[0].imported_module, "java.lang.Math.PI")
 
 
 class TestRubyImportExtraction(unittest.TestCase):
@@ -489,30 +484,30 @@ class TestRubyImportExtraction(unittest.TestCase):
     def test_simple_require(self):
         """Test simple require statement."""
         code = "require 'json'\nrequire 'net/http'"
-        deps = self.analyzer.analyze_file('test.rb', code, 'Ruby')
+        deps = self.analyzer.analyze_file("test.rb", code, "Ruby")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'json')
-        self.assertEqual(deps[0].import_type, 'require')
+        self.assertEqual(deps[0].imported_module, "json")
+        self.assertEqual(deps[0].import_type, "require")
         self.assertFalse(deps[0].is_relative)
 
     def test_require_relative(self):
         """Test require_relative statement."""
         code = "require_relative 'helper'\nrequire_relative '../utils'"
-        deps = self.analyzer.analyze_file('test.rb', code, 'Ruby')
+        deps = self.analyzer.analyze_file("test.rb", code, "Ruby")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'helper')
-        self.assertEqual(deps[0].import_type, 'require_relative')
+        self.assertEqual(deps[0].imported_module, "helper")
+        self.assertEqual(deps[0].import_type, "require_relative")
         self.assertTrue(deps[0].is_relative)
 
     def test_load_statement(self):
         """Test load statement."""
         code = "load 'script.rb'"
-        deps = self.analyzer.analyze_file('test.rb', code, 'Ruby')
+        deps = self.analyzer.analyze_file("test.rb", code, "Ruby")
 
         self.assertEqual(len(deps), 1)
-        self.assertEqual(deps[0].import_type, 'load')
+        self.assertEqual(deps[0].import_type, "load")
         self.assertTrue(deps[0].is_relative)
 
 
@@ -527,29 +522,29 @@ class TestPHPImportExtraction(unittest.TestCase):
     def test_require_statement(self):
         """Test require statement."""
         code = "<?php\nrequire 'config.php';\nrequire_once 'database.php';"
-        deps = self.analyzer.analyze_file('test.php', code, 'PHP')
+        deps = self.analyzer.analyze_file("test.php", code, "PHP")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'config.php')
-        self.assertEqual(deps[0].import_type, 'require')
+        self.assertEqual(deps[0].imported_module, "config.php")
+        self.assertEqual(deps[0].import_type, "require")
         self.assertTrue(deps[0].is_relative)
 
     def test_include_statement(self):
         """Test include statement."""
         code = "<?php\ninclude 'header.php';\ninclude_once 'footer.php';"
-        deps = self.analyzer.analyze_file('test.php', code, 'PHP')
+        deps = self.analyzer.analyze_file("test.php", code, "PHP")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].import_type, 'include')
+        self.assertEqual(deps[0].import_type, "include")
 
     def test_namespace_use(self):
         """Test namespace use statement."""
         code = "<?php\nuse App\\Models\\User;\nuse Illuminate\\Support\\Facades\\DB;"
-        deps = self.analyzer.analyze_file('test.php', code, 'PHP')
+        deps = self.analyzer.analyze_file("test.php", code, "PHP")
 
         self.assertEqual(len(deps), 2)
-        self.assertEqual(deps[0].imported_module, 'App\\Models\\User')
-        self.assertEqual(deps[0].import_type, 'use')
+        self.assertEqual(deps[0].imported_module, "App\\Models\\User")
+        self.assertEqual(deps[0].import_type, "use")
         self.assertFalse(deps[0].is_relative)
 
 
@@ -563,24 +558,24 @@ class TestEdgeCases(unittest.TestCase):
 
     def test_empty_file(self):
         """Test analysis of empty file."""
-        deps = self.analyzer.analyze_file('empty.py', '', 'Python')
+        deps = self.analyzer.analyze_file("empty.py", "", "Python")
 
         self.assertEqual(len(deps), 0)
 
     def test_unsupported_language(self):
         """Test handling of unsupported language."""
         code = "BEGIN { print $0 }"
-        deps = self.analyzer.analyze_file('test.awk', code, 'AWK')
+        deps = self.analyzer.analyze_file("test.awk", code, "AWK")
 
         self.assertEqual(len(deps), 0)
 
     def test_file_with_only_comments(self):
         """Test file with only comments."""
         code = "# This is a comment\n# Another comment"
-        deps = self.analyzer.analyze_file('test.py', code, 'Python')
+        deps = self.analyzer.analyze_file("test.py", code, "Python")
 
         self.assertEqual(len(deps), 0)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main(verbosity=2)
diff --git a/tests/test_e2e_three_stream_pipeline.py b/tests/test_e2e_three_stream_pipeline.py
index ad6de44..ade7583 100644
--- a/tests/test_e2e_three_stream_pipeline.py
+++ b/tests/test_e2e_three_stream_pipeline.py
@@ -9,34 +9,26 @@ Tests the complete workflow:
 5. Validate output structure and quality
 """
 
-import pytest
 import json
-import tempfile
-from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
+from unittest.mock import Mock, patch
+
+import pytest
+
+from skill_seekers.cli.generate_router import RouterGenerator
 from skill_seekers.cli.github_fetcher import (
-    GitHubThreeStreamFetcher,
     CodeStream,
     DocsStream,
     InsightsStream,
-    ThreeStreamData
+    ThreeStreamData,
 )
-from skill_seekers.cli.unified_codebase_analyzer import (
-    UnifiedCodebaseAnalyzer,
-    AnalysisResult
-)
-from skill_seekers.cli.merge_sources import (
-    RuleBasedMerger,
-    categorize_issues_by_topic,
-    generate_hybrid_content
-)
-from skill_seekers.cli.generate_router import RouterGenerator
+from skill_seekers.cli.merge_sources import categorize_issues_by_topic
+from skill_seekers.cli.unified_codebase_analyzer import UnifiedCodebaseAnalyzer
 
 
 class TestE2EBasicWorkflow:
     """Test E2E workflow with basic analysis (fast)."""
 
-    @patch('skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher')
+    @patch("skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher")
     def test_github_url_to_basic_analysis(self, mock_fetcher_class, tmp_path):
         """
         Test complete pipeline: GitHub URL → Basic analysis → Merged output
@@ -62,10 +54,7 @@ function greet(name) {
 """)
 
         # Create mock three-stream data
-        code_stream = CodeStream(
-            directory=tmp_path,
-            files=[tmp_path / "main.py", tmp_path / "utils.js"]
-        )
+        code_stream = CodeStream(directory=tmp_path, files=[tmp_path / "main.py", tmp_path / "utils.js"])
         docs_stream = DocsStream(
             readme="""# Test Project
 
@@ -85,112 +74,115 @@ hello()
 ```
 """,
             contributing="# Contributing\n\nPull requests welcome!",
-            docs_files=[
-                {'path': 'docs/guide.md', 'content': '# User Guide\n\nHow to use this project.'}
-            ]
+            docs_files=[{"path": "docs/guide.md", "content": "# User Guide\n\nHow to use this project."}],
         )
         insights_stream = InsightsStream(
-            metadata={
-                'stars': 1234,
-                'forks': 56,
-                'language': 'Python',
-                'description': 'A test project'
-            },
+            metadata={"stars": 1234, "forks": 56, "language": "Python", "description": "A test project"},
             common_problems=[
                 {
-                    'title': 'Installation fails on Windows',
-                    'number': 42,
-                    'state': 'open',
-                    'comments': 15,
-                    'labels': ['bug', 'windows']
+                    "title": "Installation fails on Windows",
+                    "number": 42,
+                    "state": "open",
+                    "comments": 15,
+                    "labels": ["bug", "windows"],
                 },
                 {
-                    'title': 'Import error with Python 3.6',
-                    'number': 38,
-                    'state': 'open',
-                    'comments': 10,
-                    'labels': ['bug', 'python']
-                }
+                    "title": "Import error with Python 3.6",
+                    "number": 38,
+                    "state": "open",
+                    "comments": 10,
+                    "labels": ["bug", "python"],
+                },
             ],
             known_solutions=[
-                {
-                    'title': 'Fixed: Module not found',
-                    'number': 35,
-                    'state': 'closed',
-                    'comments': 8,
-                    'labels': ['bug']
-                }
+                {"title": "Fixed: Module not found", "number": 35, "state": "closed", "comments": 8, "labels": ["bug"]}
             ],
             top_labels=[
-                {'label': 'bug', 'count': 25},
-                {'label': 'enhancement', 'count': 15},
-                {'label': 'documentation', 'count': 10}
-            ]
+                {"label": "bug", "count": 25},
+                {"label": "enhancement", "count": 15},
+                {"label": "documentation", "count": 10},
+            ],
         )
         three_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
         mock_fetcher.fetch.return_value = three_streams
 
         # Step 2: Run unified analyzer with basic depth
         analyzer = UnifiedCodebaseAnalyzer()
-        result = analyzer.analyze(
-            source="https://github.com/test/project",
-            depth="basic",
-            fetch_github_metadata=True
-        )
+        result = analyzer.analyze(source="https://github.com/test/project", depth="basic", fetch_github_metadata=True)
 
         # Step 3: Validate all three streams present
-        assert result.source_type == 'github'
-        assert result.analysis_depth == 'basic'
+        assert result.source_type == "github"
+        assert result.analysis_depth == "basic"
 
         # Validate code stream results
         assert result.code_analysis is not None
-        assert result.code_analysis['analysis_type'] == 'basic'
-        assert 'files' in result.code_analysis
-        assert 'structure' in result.code_analysis
-        assert 'imports' in result.code_analysis
+        assert result.code_analysis["analysis_type"] == "basic"
+        assert "files" in result.code_analysis
+        assert "structure" in result.code_analysis
+        assert "imports" in result.code_analysis
 
         # Validate docs stream results
         assert result.github_docs is not None
-        assert result.github_docs['readme'].startswith('# Test Project')
-        assert 'pip install test-project' in result.github_docs['readme']
+        assert result.github_docs["readme"].startswith("# Test Project")
+        assert "pip install test-project" in result.github_docs["readme"]
 
         # Validate insights stream results
         assert result.github_insights is not None
-        assert result.github_insights['metadata']['stars'] == 1234
-        assert result.github_insights['metadata']['language'] == 'Python'
-        assert len(result.github_insights['common_problems']) == 2
-        assert len(result.github_insights['known_solutions']) == 1
-        assert len(result.github_insights['top_labels']) == 3
+        assert result.github_insights["metadata"]["stars"] == 1234
+        assert result.github_insights["metadata"]["language"] == "Python"
+        assert len(result.github_insights["common_problems"]) == 2
+        assert len(result.github_insights["known_solutions"]) == 1
+        assert len(result.github_insights["top_labels"]) == 3
 
     def test_issue_categorization_by_topic(self):
         """Test that issues are correctly categorized by topic keywords."""
         problems = [
-            {'title': 'OAuth fails on redirect', 'number': 50, 'state': 'open', 'comments': 20, 'labels': ['oauth', 'bug']},
-            {'title': 'Token refresh issue', 'number': 45, 'state': 'open', 'comments': 15, 'labels': ['oauth', 'token']},
-            {'title': 'Async deadlock', 'number': 40, 'state': 'open', 'comments': 12, 'labels': ['async', 'bug']},
-            {'title': 'Database connection lost', 'number': 35, 'state': 'open', 'comments': 10, 'labels': ['database']}
+            {
+                "title": "OAuth fails on redirect",
+                "number": 50,
+                "state": "open",
+                "comments": 20,
+                "labels": ["oauth", "bug"],
+            },
+            {
+                "title": "Token refresh issue",
+                "number": 45,
+                "state": "open",
+                "comments": 15,
+                "labels": ["oauth", "token"],
+            },
+            {"title": "Async deadlock", "number": 40, "state": "open", "comments": 12, "labels": ["async", "bug"]},
+            {
+                "title": "Database connection lost",
+                "number": 35,
+                "state": "open",
+                "comments": 10,
+                "labels": ["database"],
+            },
         ]
 
         solutions = [
-            {'title': 'Fixed OAuth flow', 'number': 30, 'state': 'closed', 'comments': 8, 'labels': ['oauth']},
-            {'title': 'Resolved async race', 'number': 25, 'state': 'closed', 'comments': 6, 'labels': ['async']}
+            {"title": "Fixed OAuth flow", "number": 30, "state": "closed", "comments": 8, "labels": ["oauth"]},
+            {"title": "Resolved async race", "number": 25, "state": "closed", "comments": 6, "labels": ["async"]},
         ]
 
-        topics = ['oauth', 'auth', 'authentication']
+        topics = ["oauth", "auth", "authentication"]
 
         # Categorize issues
         categorized = categorize_issues_by_topic(problems, solutions, topics)
 
         # Validate categorization
-        assert 'oauth' in categorized or 'auth' in categorized or 'authentication' in categorized
-        oauth_issues = categorized.get('oauth', []) + categorized.get('auth', []) + categorized.get('authentication', [])
+        assert "oauth" in categorized or "auth" in categorized or "authentication" in categorized
+        oauth_issues = (
+            categorized.get("oauth", []) + categorized.get("auth", []) + categorized.get("authentication", [])
+        )
 
         # Should have 3 OAuth-related issues (2 problems + 1 solution)
         assert len(oauth_issues) >= 2  # At least the problems
 
         # OAuth issues should be in the categorized output
-        oauth_titles = [issue['title'] for issue in oauth_issues]
-        assert any('OAuth' in title for title in oauth_titles)
+        oauth_titles = [issue["title"] for issue in oauth_issues]
+        assert any("OAuth" in title for title in oauth_titles)
 
 
 class TestE2ERouterGeneration:
@@ -209,24 +201,24 @@ class TestE2ERouterGeneration:
         """
         # Create sub-skill configs
         config1 = {
-            'name': 'testproject-oauth',
-            'description': 'OAuth authentication in Test Project',
-            'base_url': 'https://github.com/test/project',
-            'categories': {'oauth': ['oauth', 'auth']}
+            "name": "testproject-oauth",
+            "description": "OAuth authentication in Test Project",
+            "base_url": "https://github.com/test/project",
+            "categories": {"oauth": ["oauth", "auth"]},
         }
         config2 = {
-            'name': 'testproject-async',
-            'description': 'Async operations in Test Project',
-            'base_url': 'https://github.com/test/project',
-            'categories': {'async': ['async', 'await']}
+            "name": "testproject-async",
+            "description": "Async operations in Test Project",
+            "base_url": "https://github.com/test/project",
+            "categories": {"async": ["async", "await"]},
         }
 
-        config_path1 = tmp_path / 'config1.json'
-        config_path2 = tmp_path / 'config2.json'
+        config_path1 = tmp_path / "config1.json"
+        config_path2 = tmp_path / "config2.json"
 
-        with open(config_path1, 'w') as f:
+        with open(config_path1, "w") as f:
             json.dump(config1, f)
-        with open(config_path2, 'w') as f:
+        with open(config_path2, "w") as f:
             json.dump(config2, f)
 
         # Create GitHub streams
@@ -249,92 +241,96 @@ import testproject
 testproject.run()
 ```
 """,
-            contributing='# Contributing\n\nWelcome!',
-            docs_files=[]
+            contributing="# Contributing\n\nWelcome!",
+            docs_files=[],
         )
         insights_stream = InsightsStream(
-            metadata={
-                'stars': 5000,
-                'forks': 250,
-                'language': 'Python',
-                'description': 'Fast test framework'
-            },
+            metadata={"stars": 5000, "forks": 250, "language": "Python", "description": "Fast test framework"},
             common_problems=[
-                {'title': 'OAuth setup fails', 'number': 150, 'state': 'open', 'comments': 30, 'labels': ['bug', 'oauth']},
-                {'title': 'Async deadlock', 'number': 142, 'state': 'open', 'comments': 25, 'labels': ['async', 'bug']},
-                {'title': 'Token refresh issue', 'number': 130, 'state': 'open', 'comments': 20, 'labels': ['oauth']}
+                {
+                    "title": "OAuth setup fails",
+                    "number": 150,
+                    "state": "open",
+                    "comments": 30,
+                    "labels": ["bug", "oauth"],
+                },
+                {"title": "Async deadlock", "number": 142, "state": "open", "comments": 25, "labels": ["async", "bug"]},
+                {"title": "Token refresh issue", "number": 130, "state": "open", "comments": 20, "labels": ["oauth"]},
             ],
             known_solutions=[
-                {'title': 'Fixed OAuth redirect', 'number': 120, 'state': 'closed', 'comments': 15, 'labels': ['oauth']},
-                {'title': 'Resolved async race', 'number': 110, 'state': 'closed', 'comments': 12, 'labels': ['async']}
+                {
+                    "title": "Fixed OAuth redirect",
+                    "number": 120,
+                    "state": "closed",
+                    "comments": 15,
+                    "labels": ["oauth"],
+                },
+                {"title": "Resolved async race", "number": 110, "state": "closed", "comments": 12, "labels": ["async"]},
             ],
             top_labels=[
-                {'label': 'oauth', 'count': 45},
-                {'label': 'async', 'count': 38},
-                {'label': 'bug', 'count': 30}
-            ]
+                {"label": "oauth", "count": 45},
+                {"label": "async", "count": 38},
+                {"label": "bug", "count": 30},
+            ],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         # Generate router
-        generator = RouterGenerator(
-            [str(config_path1), str(config_path2)],
-            github_streams=github_streams
-        )
+        generator = RouterGenerator([str(config_path1), str(config_path2)], github_streams=github_streams)
 
         # Step 1: Validate GitHub metadata extracted
         assert generator.github_metadata is not None
-        assert generator.github_metadata['stars'] == 5000
-        assert generator.github_metadata['language'] == 'Python'
+        assert generator.github_metadata["stars"] == 5000
+        assert generator.github_metadata["language"] == "Python"
 
         # Step 2: Validate GitHub docs extracted
         assert generator.github_docs is not None
-        assert 'pip install test-project' in generator.github_docs['readme']
+        assert "pip install test-project" in generator.github_docs["readme"]
 
         # Step 3: Validate GitHub issues extracted
         assert generator.github_issues is not None
-        assert len(generator.github_issues['common_problems']) == 3
-        assert len(generator.github_issues['known_solutions']) == 2
-        assert len(generator.github_issues['top_labels']) == 3
+        assert len(generator.github_issues["common_problems"]) == 3
+        assert len(generator.github_issues["known_solutions"]) == 2
+        assert len(generator.github_issues["top_labels"]) == 3
 
         # Step 4: Generate and validate router SKILL.md
         skill_md = generator.generate_skill_md()
 
         # Validate repository metadata section
-        assert '⭐ 5,000' in skill_md
-        assert 'Python' in skill_md
-        assert 'Fast test framework' in skill_md
+        assert "⭐ 5,000" in skill_md
+        assert "Python" in skill_md
+        assert "Fast test framework" in skill_md
 
         # Validate README quick start section
-        assert '## Quick Start' in skill_md
-        assert 'pip install test-project' in skill_md
+        assert "## Quick Start" in skill_md
+        assert "pip install test-project" in skill_md
 
         # Validate examples section with converted questions (Fix 1)
-        assert '## Examples' in skill_md
+        assert "## Examples" in skill_md
         # Issues converted to natural questions
-        assert 'how do i fix oauth setup' in skill_md.lower() or 'how do i handle oauth setup' in skill_md.lower()
-        assert 'how do i handle async deadlock' in skill_md.lower() or 'how do i fix async deadlock' in skill_md.lower()
+        assert "how do i fix oauth setup" in skill_md.lower() or "how do i handle oauth setup" in skill_md.lower()
+        assert "how do i handle async deadlock" in skill_md.lower() or "how do i fix async deadlock" in skill_md.lower()
         # Common Issues section may still exist with other issues
         # Note: Issue numbers may appear in Common Issues or Common Patterns sections
 
         # Step 5: Validate routing keywords include GitHub labels (2x weight)
         routing = generator.extract_routing_keywords()
 
-        oauth_keywords = routing['testproject-oauth']
-        async_keywords = routing['testproject-async']
+        oauth_keywords = routing["testproject-oauth"]
+        async_keywords = routing["testproject-async"]
 
         # Labels should be included with 2x weight
-        assert oauth_keywords.count('oauth') >= 2  # Base + name + 2x from label
-        assert async_keywords.count('async') >= 2  # Base + name + 2x from label
+        assert oauth_keywords.count("oauth") >= 2  # Base + name + 2x from label
+        assert async_keywords.count("async") >= 2  # Base + name + 2x from label
 
         # Step 6: Generate router config
         router_config = generator.create_router_config()
 
-        assert router_config['name'] == 'testproject'
-        assert router_config['_router'] is True
-        assert len(router_config['_sub_skills']) == 2
-        assert 'testproject-oauth' in router_config['_sub_skills']
-        assert 'testproject-async' in router_config['_sub_skills']
+        assert router_config["name"] == "testproject"
+        assert router_config["_router"] is True
+        assert len(router_config["_sub_skills"]) == 2
+        assert "testproject-oauth" in router_config["_sub_skills"]
+        assert "testproject-async" in router_config["_sub_skills"]
 
 
 class TestE2EQualityMetrics:
@@ -348,43 +344,39 @@ class TestE2EQualityMetrics:
         """
         # Create minimal config
         config = {
-            'name': 'test-skill',
-            'description': 'Test skill',
-            'base_url': 'https://github.com/test/repo',
-            'categories': {'api': ['api']}
+            "name": "test-skill",
+            "description": "Test skill",
+            "base_url": "https://github.com/test/repo",
+            "categories": {"api": ["api"]},
         }
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Create GitHub streams with realistic data
         code_stream = CodeStream(directory=tmp_path, files=[])
-        docs_stream = DocsStream(
-            readme='# Test\n\nA short README.',
-            contributing=None,
-            docs_files=[]
-        )
+        docs_stream = DocsStream(readme="# Test\n\nA short README.", contributing=None, docs_files=[])
         insights_stream = InsightsStream(
-            metadata={'stars': 100, 'forks': 10, 'language': 'Python', 'description': 'Test'},
+            metadata={"stars": 100, "forks": 10, "language": "Python", "description": "Test"},
             common_problems=[
-                {'title': 'Issue 1', 'number': 1, 'state': 'open', 'comments': 5, 'labels': ['bug']},
-                {'title': 'Issue 2', 'number': 2, 'state': 'open', 'comments': 3, 'labels': ['bug']}
+                {"title": "Issue 1", "number": 1, "state": "open", "comments": 5, "labels": ["bug"]},
+                {"title": "Issue 2", "number": 2, "state": "open", "comments": 3, "labels": ["bug"]},
             ],
             known_solutions=[],
-            top_labels=[{'label': 'bug', 'count': 10}]
+            top_labels=[{"label": "bug", "count": 10}],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         # Generate router without GitHub
         generator_no_github = RouterGenerator([str(config_path)])
         skill_md_no_github = generator_no_github.generate_skill_md()
-        lines_no_github = len(skill_md_no_github.split('\n'))
+        lines_no_github = len(skill_md_no_github.split("\n"))
 
         # Generate router with GitHub
         generator_with_github = RouterGenerator([str(config_path)], github_streams=github_streams)
         skill_md_with_github = generator_with_github.generate_skill_md()
-        lines_with_github = len(skill_md_with_github.split('\n'))
+        lines_with_github = len(skill_md_with_github.split("\n"))
 
         # Calculate GitHub overhead
         github_overhead = lines_with_github - lines_no_github
@@ -402,20 +394,20 @@ class TestE2EQualityMetrics:
         configs = []
         for i in range(4):
             config = {
-                'name': f'test-skill-{i}',
-                'description': f'Test skill {i}',
-                'base_url': 'https://github.com/test/repo',
-                'categories': {f'topic{i}': [f'topic{i}']}
+                "name": f"test-skill-{i}",
+                "description": f"Test skill {i}",
+                "base_url": "https://github.com/test/repo",
+                "categories": {f"topic{i}": [f"topic{i}"]},
             }
-            config_path = tmp_path / f'config{i}.json'
-            with open(config_path, 'w') as f:
+            config_path = tmp_path / f"config{i}.json"
+            with open(config_path, "w") as f:
                 json.dump(config, f)
             configs.append(str(config_path))
 
         # Generate router
         generator = RouterGenerator(configs)
         skill_md = generator.generate_skill_md()
-        lines = len(skill_md.split('\n'))
+        lines = len(skill_md.split("\n"))
 
         # Validate router size is reasonable (60-250 lines for 4 sub-skills)
         # Actual size depends on whether GitHub streams included - can be as small as 60 lines
@@ -428,14 +420,14 @@ class TestE2EBackwardCompatibility:
     def test_router_without_github_streams(self, tmp_path):
         """Test that router generation works without GitHub streams (backward compat)."""
         config = {
-            'name': 'test-skill',
-            'description': 'Test skill',
-            'base_url': 'https://example.com',
-            'categories': {'api': ['api']}
+            "name": "test-skill",
+            "description": "Test skill",
+            "base_url": "https://example.com",
+            "categories": {"api": ["api"]},
         }
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Generate router WITHOUT GitHub streams
@@ -448,16 +440,16 @@ class TestE2EBackwardCompatibility:
         # Should still generate valid SKILL.md
         skill_md = generator.generate_skill_md()
 
-        assert 'When to Use This Skill' in skill_md
-        assert 'How It Works' in skill_md
+        assert "When to Use This Skill" in skill_md
+        assert "How It Works" in skill_md
 
         # Should NOT have GitHub-specific sections
-        assert '⭐' not in skill_md
-        assert 'Repository Info' not in skill_md
-        assert 'Quick Start (from README)' not in skill_md
-        assert 'Common Issues (from GitHub)' not in skill_md
+        assert "⭐" not in skill_md
+        assert "Repository Info" not in skill_md
+        assert "Quick Start (from README)" not in skill_md
+        assert "Common Issues (from GitHub)" not in skill_md
 
-    @patch('skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher')
+    @patch("skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher")
     def test_analyzer_without_github_metadata(self, mock_fetcher_class, tmp_path):
         """Test analyzer with fetch_github_metadata=False."""
         mock_fetcher = Mock()
@@ -475,7 +467,7 @@ class TestE2EBackwardCompatibility:
         result = analyzer.analyze(
             source="https://github.com/test/repo",
             depth="basic",
-            fetch_github_metadata=False  # Explicitly disable
+            fetch_github_metadata=False,  # Explicitly disable
         )
 
         # Should not include GitHub docs/insights
@@ -498,17 +490,8 @@ class TestE2ETokenEfficiency:
 
         # Create GitHub streams
         code_stream = CodeStream(directory=tmp_path, files=[tmp_path / "main.py"])
-        docs_stream = DocsStream(
-            readme="# Test\n\nQuick start guide.",
-            contributing=None,
-            docs_files=[]
-        )
-        insights_stream = InsightsStream(
-            metadata={'stars': 100},
-            common_problems=[],
-            known_solutions=[],
-            top_labels=[]
-        )
+        docs_stream = DocsStream(readme="# Test\n\nQuick start guide.", contributing=None, docs_files=[])
+        insights_stream = InsightsStream(metadata={"stars": 100}, common_problems=[], known_solutions=[], top_labels=[])
         three_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         # Verify streams are separate (no duplication)
@@ -517,9 +500,9 @@ class TestE2ETokenEfficiency:
         assert insights_stream.metadata is not None
 
         # Verify no cross-contamination
-        assert 'Quick start guide' not in str(code_stream.files)
+        assert "Quick start guide" not in str(code_stream.files)
         assert str(tmp_path) not in docs_stream.readme
 
 
-if __name__ == '__main__':
-    pytest.main([__file__, '-v'])
+if __name__ == "__main__":
+    pytest.main([__file__, "-v"])
diff --git a/tests/test_estimate_pages.py b/tests/test_estimate_pages.py
index 3c906ea..0b67ffa 100644
--- a/tests/test_estimate_pages.py
+++ b/tests/test_estimate_pages.py
@@ -3,11 +3,9 @@
 Tests for cli/estimate_pages.py functionality
 """
 
-import unittest
-import tempfile
 import json
+import unittest
 from pathlib import Path
-import sys
 
 from skill_seekers.cli.estimate_pages import estimate_pages
 
@@ -17,11 +15,7 @@ class TestEstimatePages(unittest.TestCase):
 
     def test_estimate_pages_with_minimal_config(self):
         """Test estimation with minimal configuration"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'rate_limit': 0.1
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "rate_limit": 0.1}
 
         # This will make real HTTP request to example.com
         # We use low max_discovery to keep test fast
@@ -29,50 +23,42 @@ class TestEstimatePages(unittest.TestCase):
 
         # Check result structure
         self.assertIsInstance(result, dict)
-        self.assertIn('discovered', result)
-        self.assertIn('estimated_total', result)
+        self.assertIn("discovered", result)
+        self.assertIn("estimated_total", result)
         # Actual key is elapsed_seconds, not time_elapsed
-        self.assertIn('elapsed_seconds', result)
+        self.assertIn("elapsed_seconds", result)
 
     def test_estimate_pages_returns_discovered_count(self):
         """Test that result contains discovered page count"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'rate_limit': 0.1
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "rate_limit": 0.1}
 
         result = estimate_pages(config, max_discovery=1, timeout=5)
 
-        self.assertGreaterEqual(result['discovered'], 0)
-        self.assertIsInstance(result['discovered'], int)
+        self.assertGreaterEqual(result["discovered"], 0)
+        self.assertIsInstance(result["discovered"], int)
 
     def test_estimate_pages_respects_max_discovery(self):
         """Test that estimation respects max_discovery limit"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'rate_limit': 0.1
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "rate_limit": 0.1}
 
         result = estimate_pages(config, max_discovery=3, timeout=5)
 
         # Should not discover more than max_discovery
-        self.assertLessEqual(result['discovered'], 3)
+        self.assertLessEqual(result["discovered"], 3)
 
     def test_estimate_pages_with_start_urls(self):
         """Test estimation with custom start_urls"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'start_urls': ['https://example.com/'],
-            'rate_limit': 0.1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "start_urls": ["https://example.com/"],
+            "rate_limit": 0.1,
         }
 
         result = estimate_pages(config, max_discovery=2, timeout=5)
 
         self.assertIsInstance(result, dict)
-        self.assertIn('discovered', result)
+        self.assertIn("discovered", result)
 
 
 class TestEstimatePagesCLI(unittest.TestCase):
@@ -83,17 +69,12 @@ class TestEstimatePagesCLI(unittest.TestCase):
         import subprocess
 
         try:
-            result = subprocess.run(
-                ['skill-seekers', 'estimate', '--help'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers", "estimate", "--help"], capture_output=True, text=True, timeout=5)
 
             # Should return successfully (0 or 2 for argparse)
             self.assertIn(result.returncode, [0, 2])
             output = result.stdout + result.stderr
-            self.assertTrue('usage:' in output.lower() or 'estimate' in output.lower())
+            self.assertTrue("usage:" in output.lower() or "estimate" in output.lower())
         except FileNotFoundError:
             self.skipTest("skill-seekers command not installed")
 
@@ -102,12 +83,7 @@ class TestEstimatePagesCLI(unittest.TestCase):
         import subprocess
 
         try:
-            result = subprocess.run(
-                ['skill-seekers-estimate', '--help'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers-estimate", "--help"], capture_output=True, text=True, timeout=5)
 
             # Should return successfully
             self.assertIn(result.returncode, [0, 2])
@@ -120,16 +96,11 @@ class TestEstimatePagesCLI(unittest.TestCase):
 
         try:
             # Run without config argument
-            result = subprocess.run(
-                ['skill-seekers', 'estimate'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers", "estimate"], capture_output=True, text=True, timeout=5)
 
             # Should fail (non-zero exit code) or show usage
             self.assertTrue(
-                result.returncode != 0 or 'usage' in result.stderr.lower() or 'usage' in result.stdout.lower()
+                result.returncode != 0 or "usage" in result.stderr.lower() or "usage" in result.stdout.lower()
             )
         except FileNotFoundError:
             self.skipTest("skill-seekers command not installed")
@@ -140,29 +111,22 @@ class TestEstimatePagesCLI(unittest.TestCase):
 
         try:
             # Run with --all flag
-            result = subprocess.run(
-                ['skill-seekers', 'estimate', '--all'],
-                capture_output=True,
-                text=True,
-                timeout=10
-            )
+            result = subprocess.run(["skill-seekers", "estimate", "--all"], capture_output=True, text=True, timeout=10)
 
             # Should succeed
             self.assertEqual(result.returncode, 0)
 
             # Should contain expected output
             output = result.stdout
-            self.assertIn('AVAILABLE CONFIGS', output)
-            self.assertIn('Total:', output)
-            self.assertIn('configs found', output)
+            self.assertIn("AVAILABLE CONFIGS", output)
+            self.assertIn("Total:", output)
+            self.assertIn("configs found", output)
 
             # Should list some known configs
             # (these should exist in api/configs_repo/official/)
             self.assertTrue(
-                'react' in output.lower() or
-                'django' in output.lower() or
-                'godot' in output.lower(),
-                "Expected at least one known config name in output"
+                "react" in output.lower() or "django" in output.lower() or "godot" in output.lower(),
+                "Expected at least one known config name in output",
             )
         except FileNotFoundError:
             self.skipTest("skill-seekers command not installed")
@@ -172,19 +136,14 @@ class TestEstimatePagesCLI(unittest.TestCase):
         import subprocess
 
         try:
-            result = subprocess.run(
-                ['skill-seekers-estimate', '--all'],
-                capture_output=True,
-                text=True,
-                timeout=10
-            )
+            result = subprocess.run(["skill-seekers-estimate", "--all"], capture_output=True, text=True, timeout=10)
 
             # Should succeed
             self.assertEqual(result.returncode, 0)
 
             # Should show available configs
             output = result.stdout
-            self.assertIn('AVAILABLE CONFIGS', output)
+            self.assertIn("AVAILABLE CONFIGS", output)
         except FileNotFoundError:
             self.skipTest("skill-seekers-estimate command not installed")
 
@@ -194,21 +153,21 @@ class TestEstimatePagesWithRealConfig(unittest.TestCase):
 
     def test_estimate_with_real_config_file(self):
         """Test estimation using a real config file (if exists)"""
-        config_path = Path('configs/react.json')
+        config_path = Path("configs/react.json")
 
         if not config_path.exists():
             self.skipTest("configs/react.json not found")
 
-        with open(config_path, 'r') as f:
+        with open(config_path) as f:
             config = json.load(f)
 
         # Use very low max_discovery to keep test fast
         result = estimate_pages(config, max_discovery=3, timeout=5)
 
         self.assertIsInstance(result, dict)
-        self.assertIn('discovered', result)
-        self.assertGreater(result['discovered'], 0)
+        self.assertIn("discovered", result)
+        self.assertGreater(result["discovered"], 0)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_excluded_dirs_config.py b/tests/test_excluded_dirs_config.py
index 4fa1e58..4b12971 100644
--- a/tests/test_excluded_dirs_config.py
+++ b/tests/test_excluded_dirs_config.py
@@ -4,115 +4,98 @@ Tests Issue #203: Make EXCLUDED_DIRS configurable
 """
 
 import unittest
-from unittest.mock import patch, Mock
-from skill_seekers.cli.github_scraper import GitHubScraper, EXCLUDED_DIRS
+from unittest.mock import patch
+
+from skill_seekers.cli.github_scraper import EXCLUDED_DIRS, GitHubScraper
 
 
 class TestExcludedDirsDefaults(unittest.TestCase):
     """Test default EXCLUDED_DIRS behavior (backward compatibility)."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_defaults_when_no_config(self, mock_github):
         """Test that default exclusions are used when no config provided."""
-        config = {
-            'repo': 'owner/repo'
-        }
+        config = {"repo": "owner/repo"}
 
         scraper = GitHubScraper(config)
 
         # Should use default EXCLUDED_DIRS
         self.assertEqual(scraper.excluded_dirs, EXCLUDED_DIRS)
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_defaults_exclude_common_dirs(self, mock_github):
         """Test that default exclusions work correctly."""
-        config = {
-            'repo': 'owner/repo'
-        }
+        config = {"repo": "owner/repo"}
 
         scraper = GitHubScraper(config)
 
         # Test common directories are excluded
-        self.assertTrue(scraper.should_exclude_dir('venv'))
-        self.assertTrue(scraper.should_exclude_dir('node_modules'))
-        self.assertTrue(scraper.should_exclude_dir('__pycache__'))
-        self.assertTrue(scraper.should_exclude_dir('.git'))
-        self.assertTrue(scraper.should_exclude_dir('build'))
+        self.assertTrue(scraper.should_exclude_dir("venv"))
+        self.assertTrue(scraper.should_exclude_dir("node_modules"))
+        self.assertTrue(scraper.should_exclude_dir("__pycache__"))
+        self.assertTrue(scraper.should_exclude_dir(".git"))
+        self.assertTrue(scraper.should_exclude_dir("build"))
 
         # Test normal directories are not excluded
-        self.assertFalse(scraper.should_exclude_dir('src'))
-        self.assertFalse(scraper.should_exclude_dir('tests'))
-        self.assertFalse(scraper.should_exclude_dir('docs'))
+        self.assertFalse(scraper.should_exclude_dir("src"))
+        self.assertFalse(scraper.should_exclude_dir("tests"))
+        self.assertFalse(scraper.should_exclude_dir("docs"))
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_dot_directories_always_excluded(self, mock_github):
         """Test that directories starting with '.' are always excluded."""
-        config = {
-            'repo': 'owner/repo'
-        }
+        config = {"repo": "owner/repo"}
 
         scraper = GitHubScraper(config)
 
         # Dot directories should be excluded (even if not in EXCLUDED_DIRS)
-        self.assertTrue(scraper.should_exclude_dir('.hidden'))
-        self.assertTrue(scraper.should_exclude_dir('.cache'))
-        self.assertTrue(scraper.should_exclude_dir('.vscode'))
+        self.assertTrue(scraper.should_exclude_dir(".hidden"))
+        self.assertTrue(scraper.should_exclude_dir(".cache"))
+        self.assertTrue(scraper.should_exclude_dir(".vscode"))
 
 
 class TestExcludedDirsAdditional(unittest.TestCase):
     """Test exclude_dirs_additional (extend mode)."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_extend_with_additional_dirs(self, mock_github):
         """Test adding custom exclusions to defaults."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs_additional': ['proprietary', 'vendor', 'third_party']
-        }
+        config = {"repo": "owner/repo", "exclude_dirs_additional": ["proprietary", "vendor", "third_party"]}
 
         scraper = GitHubScraper(config)
 
         # Should include both defaults and additional
-        self.assertIn('venv', scraper.excluded_dirs)  # Default
-        self.assertIn('node_modules', scraper.excluded_dirs)  # Default
-        self.assertIn('proprietary', scraper.excluded_dirs)  # Additional
-        self.assertIn('vendor', scraper.excluded_dirs)  # Additional
-        self.assertIn('third_party', scraper.excluded_dirs)  # Additional
+        self.assertIn("venv", scraper.excluded_dirs)  # Default
+        self.assertIn("node_modules", scraper.excluded_dirs)  # Default
+        self.assertIn("proprietary", scraper.excluded_dirs)  # Additional
+        self.assertIn("vendor", scraper.excluded_dirs)  # Additional
+        self.assertIn("third_party", scraper.excluded_dirs)  # Additional
 
         # Verify total count
-        self.assertEqual(
-            len(scraper.excluded_dirs),
-            len(EXCLUDED_DIRS) + 3
-        )
+        self.assertEqual(len(scraper.excluded_dirs), len(EXCLUDED_DIRS) + 3)
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_extend_excludes_additional_dirs(self, mock_github):
         """Test that additional directories are actually excluded."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs_additional': ['legacy', 'deprecated']
-        }
+        config = {"repo": "owner/repo", "exclude_dirs_additional": ["legacy", "deprecated"]}
 
         scraper = GitHubScraper(config)
 
         # Additional dirs should be excluded
-        self.assertTrue(scraper.should_exclude_dir('legacy'))
-        self.assertTrue(scraper.should_exclude_dir('deprecated'))
+        self.assertTrue(scraper.should_exclude_dir("legacy"))
+        self.assertTrue(scraper.should_exclude_dir("deprecated"))
 
         # Default dirs still excluded
-        self.assertTrue(scraper.should_exclude_dir('venv'))
-        self.assertTrue(scraper.should_exclude_dir('node_modules'))
+        self.assertTrue(scraper.should_exclude_dir("venv"))
+        self.assertTrue(scraper.should_exclude_dir("node_modules"))
 
         # Normal dirs not excluded
-        self.assertFalse(scraper.should_exclude_dir('src'))
+        self.assertFalse(scraper.should_exclude_dir("src"))
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_extend_with_empty_list(self, mock_github):
         """Test that empty additional list works correctly."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs_additional': []
-        }
+        config = {"repo": "owner/repo", "exclude_dirs_additional": []}
 
         scraper = GitHubScraper(config)
 
@@ -123,50 +106,41 @@ class TestExcludedDirsAdditional(unittest.TestCase):
 class TestExcludedDirsReplace(unittest.TestCase):
     """Test exclude_dirs (replace mode)."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_replace_with_custom_list(self, mock_github):
         """Test replacing default exclusions entirely."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs': ['node_modules', 'custom_vendor']
-        }
+        config = {"repo": "owner/repo", "exclude_dirs": ["node_modules", "custom_vendor"]}
 
         scraper = GitHubScraper(config)
 
         # Should ONLY have specified dirs
-        self.assertEqual(scraper.excluded_dirs, {'node_modules', 'custom_vendor'})
+        self.assertEqual(scraper.excluded_dirs, {"node_modules", "custom_vendor"})
         self.assertEqual(len(scraper.excluded_dirs), 2)
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_replace_excludes_only_specified_dirs(self, mock_github):
         """Test that only specified directories are excluded in replace mode."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs': ['node_modules', '.git']
-        }
+        config = {"repo": "owner/repo", "exclude_dirs": ["node_modules", ".git"]}
 
         scraper = GitHubScraper(config)
 
         # Specified dirs should be excluded
-        self.assertTrue(scraper.should_exclude_dir('node_modules'))
+        self.assertTrue(scraper.should_exclude_dir("node_modules"))
         # Note: .git would be excluded anyway due to dot prefix
-        self.assertTrue(scraper.should_exclude_dir('.git'))
+        self.assertTrue(scraper.should_exclude_dir(".git"))
 
         # Default dirs NOT in our list should NOT be excluded
-        self.assertFalse(scraper.should_exclude_dir('venv'))
-        self.assertFalse(scraper.should_exclude_dir('__pycache__'))
-        self.assertFalse(scraper.should_exclude_dir('build'))
+        self.assertFalse(scraper.should_exclude_dir("venv"))
+        self.assertFalse(scraper.should_exclude_dir("__pycache__"))
+        self.assertFalse(scraper.should_exclude_dir("build"))
 
         # Normal dirs still not excluded
-        self.assertFalse(scraper.should_exclude_dir('src'))
+        self.assertFalse(scraper.should_exclude_dir("src"))
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_replace_with_empty_list(self, mock_github):
         """Test that empty replace list allows all directories (except dot-prefixed)."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs': []
-        }
+        config = {"repo": "owner/repo", "exclude_dirs": []}
 
         scraper = GitHubScraper(config)
 
@@ -174,156 +148,143 @@ class TestExcludedDirsReplace(unittest.TestCase):
         self.assertEqual(scraper.excluded_dirs, set())
 
         # Nothing explicitly excluded
-        self.assertFalse(scraper.should_exclude_dir('venv'))
-        self.assertFalse(scraper.should_exclude_dir('node_modules'))
-        self.assertFalse(scraper.should_exclude_dir('build'))
+        self.assertFalse(scraper.should_exclude_dir("venv"))
+        self.assertFalse(scraper.should_exclude_dir("node_modules"))
+        self.assertFalse(scraper.should_exclude_dir("build"))
 
         # But dot dirs still excluded (different logic)
-        self.assertTrue(scraper.should_exclude_dir('.git'))
-        self.assertTrue(scraper.should_exclude_dir('.hidden'))
+        self.assertTrue(scraper.should_exclude_dir(".git"))
+        self.assertTrue(scraper.should_exclude_dir(".hidden"))
 
 
 class TestExcludedDirsPrecedence(unittest.TestCase):
     """Test precedence when both options provided."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_replace_takes_precedence_over_additional(self, mock_github):
         """Test that exclude_dirs takes precedence over exclude_dirs_additional."""
         config = {
-            'repo': 'owner/repo',
-            'exclude_dirs': ['only', 'these'],  # Replace mode
-            'exclude_dirs_additional': ['ignored']  # Should be ignored
+            "repo": "owner/repo",
+            "exclude_dirs": ["only", "these"],  # Replace mode
+            "exclude_dirs_additional": ["ignored"],  # Should be ignored
         }
 
         scraper = GitHubScraper(config)
 
         # Should use replace mode (exclude_dirs), ignore additional
-        self.assertEqual(scraper.excluded_dirs, {'only', 'these'})
-        self.assertNotIn('ignored', scraper.excluded_dirs)
-        self.assertNotIn('venv', scraper.excluded_dirs)  # Defaults also ignored
+        self.assertEqual(scraper.excluded_dirs, {"only", "these"})
+        self.assertNotIn("ignored", scraper.excluded_dirs)
+        self.assertNotIn("venv", scraper.excluded_dirs)  # Defaults also ignored
 
 
 class TestExcludedDirsEdgeCases(unittest.TestCase):
     """Test edge cases and error handling."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_duplicate_exclusions_in_additional(self, mock_github):
         """Test that duplicates in additional list are handled (set deduplication)."""
         config = {
-            'repo': 'owner/repo',
-            'exclude_dirs_additional': ['venv', 'custom', 'venv']  # venv is duplicate (default + listed)
+            "repo": "owner/repo",
+            "exclude_dirs_additional": ["venv", "custom", "venv"],  # venv is duplicate (default + listed)
         }
 
         scraper = GitHubScraper(config)
 
         # Should deduplicate automatically (using set)
-        self.assertIn('venv', scraper.excluded_dirs)
-        self.assertIn('custom', scraper.excluded_dirs)
+        self.assertIn("venv", scraper.excluded_dirs)
+        self.assertIn("custom", scraper.excluded_dirs)
         # Count should account for deduplication
         self.assertEqual(
             len(scraper.excluded_dirs),
-            len(EXCLUDED_DIRS) + 1  # Only 'custom' is truly additional
+            len(EXCLUDED_DIRS) + 1,  # Only 'custom' is truly additional
         )
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_case_sensitive_exclusions(self, mock_github):
         """Test that exclusions are case-sensitive."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs': ['Venv', 'NODE_MODULES']
-        }
+        config = {"repo": "owner/repo", "exclude_dirs": ["Venv", "NODE_MODULES"]}
 
         scraper = GitHubScraper(config)
 
         # Case-sensitive matching
-        self.assertTrue(scraper.should_exclude_dir('Venv'))
-        self.assertTrue(scraper.should_exclude_dir('NODE_MODULES'))
-        self.assertFalse(scraper.should_exclude_dir('venv'))  # Different case
-        self.assertFalse(scraper.should_exclude_dir('node_modules'))  # Different case
+        self.assertTrue(scraper.should_exclude_dir("Venv"))
+        self.assertTrue(scraper.should_exclude_dir("NODE_MODULES"))
+        self.assertFalse(scraper.should_exclude_dir("venv"))  # Different case
+        self.assertFalse(scraper.should_exclude_dir("node_modules"))  # Different case
 
 
 class TestExcludedDirsWithLocalRepo(unittest.TestCase):
     """Test exclude_dirs integration with local_repo_path."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_exclude_dirs_with_local_repo_path(self, mock_github):
         """Test that exclude_dirs works when local_repo_path is provided."""
         config = {
-            'repo': 'owner/repo',
-            'local_repo_path': '/tmp/test/repo',
-            'exclude_dirs_additional': ['proprietary', 'internal']
+            "repo": "owner/repo",
+            "local_repo_path": "/tmp/test/repo",
+            "exclude_dirs_additional": ["proprietary", "internal"],
         }
 
         scraper = GitHubScraper(config)
 
         # Should have both defaults and additional
-        self.assertIn('venv', scraper.excluded_dirs)
-        self.assertIn('proprietary', scraper.excluded_dirs)
-        self.assertIn('internal', scraper.excluded_dirs)
+        self.assertIn("venv", scraper.excluded_dirs)
+        self.assertIn("proprietary", scraper.excluded_dirs)
+        self.assertIn("internal", scraper.excluded_dirs)
 
         # Test exclusion works
-        self.assertTrue(scraper.should_exclude_dir('proprietary'))
-        self.assertTrue(scraper.should_exclude_dir('internal'))
-        self.assertTrue(scraper.should_exclude_dir('venv'))
+        self.assertTrue(scraper.should_exclude_dir("proprietary"))
+        self.assertTrue(scraper.should_exclude_dir("internal"))
+        self.assertTrue(scraper.should_exclude_dir("venv"))
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_replace_mode_with_local_repo_path(self, mock_github):
         """Test that replace mode works with local_repo_path."""
-        config = {
-            'repo': 'owner/repo',
-            'local_repo_path': '/tmp/test/repo',
-            'exclude_dirs': ['only_this']
-        }
+        config = {"repo": "owner/repo", "local_repo_path": "/tmp/test/repo", "exclude_dirs": ["only_this"]}
 
         scraper = GitHubScraper(config)
 
         # Should ONLY have specified dir
-        self.assertEqual(scraper.excluded_dirs, {'only_this'})
-        self.assertTrue(scraper.should_exclude_dir('only_this'))
-        self.assertFalse(scraper.should_exclude_dir('venv'))
+        self.assertEqual(scraper.excluded_dirs, {"only_this"})
+        self.assertTrue(scraper.should_exclude_dir("only_this"))
+        self.assertFalse(scraper.should_exclude_dir("venv"))
 
 
 class TestExcludedDirsLogging(unittest.TestCase):
     """Test logging output for exclude_dirs configuration."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
-    @patch('skill_seekers.cli.github_scraper.logger')
+    @patch("skill_seekers.cli.github_scraper.Github")
+    @patch("skill_seekers.cli.github_scraper.logger")
     def test_extend_mode_logs_info(self, mock_logger, mock_github):
         """Test that extend mode logs INFO level message."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs_additional': ['custom1', 'custom2']
-        }
+        config = {"repo": "owner/repo", "exclude_dirs_additional": ["custom1", "custom2"]}
 
         scraper = GitHubScraper(config)
 
         # Should have logged INFO message
         # Check that info was called with a message about adding custom exclusions
         info_calls = [str(call) for call in mock_logger.info.call_args_list]
-        self.assertTrue(any('Added 2 custom directory exclusions' in call for call in info_calls))
+        self.assertTrue(any("Added 2 custom directory exclusions" in call for call in info_calls))
 
-    @patch('skill_seekers.cli.github_scraper.Github')
-    @patch('skill_seekers.cli.github_scraper.logger')
+    @patch("skill_seekers.cli.github_scraper.Github")
+    @patch("skill_seekers.cli.github_scraper.logger")
     def test_replace_mode_logs_warning(self, mock_logger, mock_github):
         """Test that replace mode logs WARNING level message."""
-        config = {
-            'repo': 'owner/repo',
-            'exclude_dirs': ['only', 'these']
-        }
+        config = {"repo": "owner/repo", "exclude_dirs": ["only", "these"]}
 
         scraper = GitHubScraper(config)
 
         # Should have logged WARNING message
         warning_calls = [str(call) for call in mock_logger.warning.call_args_list]
-        self.assertTrue(any('Using custom directory exclusions' in call and 'defaults overridden' in call for call in warning_calls))
+        self.assertTrue(
+            any("Using custom directory exclusions" in call and "defaults overridden" in call for call in warning_calls)
+        )
 
-    @patch('skill_seekers.cli.github_scraper.Github')
-    @patch('skill_seekers.cli.github_scraper.logger')
+    @patch("skill_seekers.cli.github_scraper.Github")
+    @patch("skill_seekers.cli.github_scraper.logger")
     def test_no_config_no_logging(self, mock_logger, mock_github):
         """Test that default mode doesn't log exclude_dirs messages."""
-        config = {
-            'repo': 'owner/repo'
-        }
+        config = {"repo": "owner/repo"}
 
         scraper = GitHubScraper(config)
 
@@ -332,8 +293,8 @@ class TestExcludedDirsLogging(unittest.TestCase):
         warning_calls = [str(call) for call in mock_logger.warning.call_args_list]
 
         # Filter for exclude_dirs related messages
-        exclude_info = [c for c in info_calls if 'directory exclusion' in c]
-        exclude_warnings = [c for c in warning_calls if 'directory exclusion' in c]
+        exclude_info = [c for c in info_calls if "directory exclusion" in c]
+        exclude_warnings = [c for c in warning_calls if "directory exclusion" in c]
 
         self.assertEqual(len(exclude_info), 0)
         self.assertEqual(len(exclude_warnings), 0)
@@ -342,34 +303,34 @@ class TestExcludedDirsLogging(unittest.TestCase):
 class TestExcludedDirsTypeHandling(unittest.TestCase):
     """Test type handling for exclude_dirs configuration."""
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_exclude_dirs_with_tuple(self, mock_github):
         """Test that tuples are converted to sets correctly."""
         config = {
-            'repo': 'owner/repo',
-            'exclude_dirs': ('node_modules', 'build')  # Tuple instead of list
+            "repo": "owner/repo",
+            "exclude_dirs": ("node_modules", "build"),  # Tuple instead of list
         }
 
         scraper = GitHubScraper(config)
 
         # Should work with tuples (set() accepts tuples)
-        self.assertEqual(scraper.excluded_dirs, {'node_modules', 'build'})
+        self.assertEqual(scraper.excluded_dirs, {"node_modules", "build"})
 
-    @patch('skill_seekers.cli.github_scraper.Github')
+    @patch("skill_seekers.cli.github_scraper.Github")
     def test_exclude_dirs_additional_with_set(self, mock_github):
         """Test that sets work correctly for exclude_dirs_additional."""
         config = {
-            'repo': 'owner/repo',
-            'exclude_dirs_additional': {'custom1', 'custom2'}  # Set instead of list
+            "repo": "owner/repo",
+            "exclude_dirs_additional": {"custom1", "custom2"},  # Set instead of list
         }
 
         scraper = GitHubScraper(config)
 
         # Should work with sets
-        self.assertIn('custom1', scraper.excluded_dirs)
-        self.assertIn('custom2', scraper.excluded_dirs)
-        self.assertIn('venv', scraper.excluded_dirs)  # Defaults still there
+        self.assertIn("custom1", scraper.excluded_dirs)
+        self.assertIn("custom2", scraper.excluded_dirs)
+        self.assertIn("venv", scraper.excluded_dirs)  # Defaults still there
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_generate_router_github.py b/tests/test_generate_router_github.py
index 6ab00c7..acb54f7 100644
--- a/tests/test_generate_router_github.py
+++ b/tests/test_generate_router_github.py
@@ -8,17 +8,10 @@ Tests the enhanced router generator that integrates GitHub insights:
 - GitHub issue linking
 """
 
-import pytest
 import json
-import tempfile
-from pathlib import Path
+
 from skill_seekers.cli.generate_router import RouterGenerator
-from skill_seekers.cli.github_fetcher import (
-    CodeStream,
-    DocsStream,
-    InsightsStream,
-    ThreeStreamData
-)
+from skill_seekers.cli.github_fetcher import CodeStream, DocsStream, InsightsStream, ThreeStreamData
 
 
 class TestRouterGeneratorBasic:
@@ -28,79 +21,70 @@ class TestRouterGeneratorBasic:
         """Test router generator initialization."""
         # Create test configs
         config1 = {
-            'name': 'test-oauth',
-            'description': 'OAuth authentication',
-            'base_url': 'https://example.com',
-            'categories': {'authentication': ['auth', 'oauth']}
+            "name": "test-oauth",
+            "description": "OAuth authentication",
+            "base_url": "https://example.com",
+            "categories": {"authentication": ["auth", "oauth"]},
         }
         config2 = {
-            'name': 'test-async',
-            'description': 'Async operations',
-            'base_url': 'https://example.com',
-            'categories': {'async': ['async', 'await']}
+            "name": "test-async",
+            "description": "Async operations",
+            "base_url": "https://example.com",
+            "categories": {"async": ["async", "await"]},
         }
 
-        config_path1 = tmp_path / 'config1.json'
-        config_path2 = tmp_path / 'config2.json'
+        config_path1 = tmp_path / "config1.json"
+        config_path2 = tmp_path / "config2.json"
 
-        with open(config_path1, 'w') as f:
+        with open(config_path1, "w") as f:
             json.dump(config1, f)
-        with open(config_path2, 'w') as f:
+        with open(config_path2, "w") as f:
             json.dump(config2, f)
 
         # Create generator
         generator = RouterGenerator([str(config_path1), str(config_path2)])
 
-        assert generator.router_name == 'test'
+        assert generator.router_name == "test"
         assert len(generator.configs) == 2
         assert generator.github_streams is None
 
     def test_infer_router_name(self, tmp_path):
         """Test router name inference from sub-skill names."""
-        config1 = {
-            'name': 'fastmcp-oauth',
-            'base_url': 'https://example.com'
-        }
-        config2 = {
-            'name': 'fastmcp-async',
-            'base_url': 'https://example.com'
-        }
+        config1 = {"name": "fastmcp-oauth", "base_url": "https://example.com"}
+        config2 = {"name": "fastmcp-async", "base_url": "https://example.com"}
 
-        config_path1 = tmp_path / 'config1.json'
-        config_path2 = tmp_path / 'config2.json'
+        config_path1 = tmp_path / "config1.json"
+        config_path2 = tmp_path / "config2.json"
 
-        with open(config_path1, 'w') as f:
+        with open(config_path1, "w") as f:
             json.dump(config1, f)
-        with open(config_path2, 'w') as f:
+        with open(config_path2, "w") as f:
             json.dump(config2, f)
 
         generator = RouterGenerator([str(config_path1), str(config_path2)])
 
-        assert generator.router_name == 'fastmcp'
+        assert generator.router_name == "fastmcp"
 
     def test_extract_routing_keywords_basic(self, tmp_path):
         """Test basic keyword extraction without GitHub."""
         config = {
-            'name': 'test-oauth',
-            'base_url': 'https://example.com',
-            'categories': {
-                'authentication': ['auth', 'oauth'],
-                'tokens': ['token', 'jwt']
-            }
+            "name": "test-oauth",
+            "base_url": "https://example.com",
+            "categories": {"authentication": ["auth", "oauth"], "tokens": ["token", "jwt"]},
         }
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         generator = RouterGenerator([str(config_path)])
         routing = generator.extract_routing_keywords()
 
-        assert 'test-oauth' in routing
-        keywords = routing['test-oauth']
-        assert 'authentication' in keywords
-        assert 'tokens' in keywords
-        assert 'oauth' in keywords  # From name
+        assert "test-oauth" in routing
+        keywords = routing["test-oauth"]
+        assert "authentication" in keywords
+        assert "tokens" in keywords
+        assert "oauth" in keywords  # From name
 
 
 class TestRouterGeneratorWithGitHub:
@@ -109,30 +93,32 @@ class TestRouterGeneratorWithGitHub:
     def test_router_with_github_metadata(self, tmp_path):
         """Test router generator with GitHub metadata."""
         config = {
-            'name': 'test-oauth',
-            'description': 'OAuth skill',
-            'base_url': 'https://github.com/test/repo',
-            'categories': {'oauth': ['oauth', 'auth']}
+            "name": "test-oauth",
+            "description": "OAuth skill",
+            "base_url": "https://github.com/test/repo",
+            "categories": {"oauth": ["oauth", "auth"]},
         }
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Create GitHub streams
         code_stream = CodeStream(directory=tmp_path, files=[])
-        docs_stream = DocsStream(
-            readme='# Test Project\n\nA test OAuth library.',
-            contributing=None,
-            docs_files=[]
-        )
+        docs_stream = DocsStream(readme="# Test Project\n\nA test OAuth library.", contributing=None, docs_files=[])
         insights_stream = InsightsStream(
-            metadata={'stars': 1234, 'forks': 56, 'language': 'Python', 'description': 'OAuth helper'},
+            metadata={"stars": 1234, "forks": 56, "language": "Python", "description": "OAuth helper"},
             common_problems=[
-                {'title': 'OAuth fails on redirect', 'number': 42, 'state': 'open', 'comments': 15, 'labels': ['bug', 'oauth']}
+                {
+                    "title": "OAuth fails on redirect",
+                    "number": 42,
+                    "state": "open",
+                    "comments": 15,
+                    "labels": ["bug", "oauth"],
+                }
             ],
             known_solutions=[],
-            top_labels=[{'label': 'oauth', 'count': 20}, {'label': 'bug', 'count': 10}]
+            top_labels=[{"label": "oauth", "count": 20}, {"label": "bug", "count": 10}],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
@@ -140,21 +126,17 @@ class TestRouterGeneratorWithGitHub:
         generator = RouterGenerator([str(config_path)], github_streams=github_streams)
 
         assert generator.github_metadata is not None
-        assert generator.github_metadata['stars'] == 1234
+        assert generator.github_metadata["stars"] == 1234
         assert generator.github_docs is not None
-        assert generator.github_docs['readme'].startswith('# Test Project')
+        assert generator.github_docs["readme"].startswith("# Test Project")
         assert generator.github_issues is not None
 
     def test_extract_keywords_with_github_labels(self, tmp_path):
         """Test keyword extraction with GitHub issue labels (2x weight)."""
-        config = {
-            'name': 'test-oauth',
-            'base_url': 'https://example.com',
-            'categories': {'oauth': ['oauth', 'auth']}
-        }
+        config = {"name": "test-oauth", "base_url": "https://example.com", "categories": {"oauth": ["oauth", "auth"]}}
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Create GitHub streams with top labels
@@ -165,49 +147,53 @@ class TestRouterGeneratorWithGitHub:
             common_problems=[],
             known_solutions=[],
             top_labels=[
-                {'label': 'oauth', 'count': 50},  # Matches 'oauth' keyword
-                {'label': 'authentication', 'count': 30},  # Related
-                {'label': 'bug', 'count': 20}  # Not related
-            ]
+                {"label": "oauth", "count": 50},  # Matches 'oauth' keyword
+                {"label": "authentication", "count": 30},  # Related
+                {"label": "bug", "count": 20},  # Not related
+            ],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         generator = RouterGenerator([str(config_path)], github_streams=github_streams)
         routing = generator.extract_routing_keywords()
 
-        keywords = routing['test-oauth']
+        keywords = routing["test-oauth"]
         # 'oauth' label should appear twice (2x weight)
-        oauth_count = keywords.count('oauth')
+        oauth_count = keywords.count("oauth")
         assert oauth_count >= 4  # Base 'oauth' from categories + name + 2x from label
 
     def test_generate_skill_md_with_github(self, tmp_path):
         """Test SKILL.md generation with GitHub metadata."""
         config = {
-            'name': 'test-oauth',
-            'description': 'OAuth authentication skill',
-            'base_url': 'https://github.com/test/oauth',
-            'categories': {'oauth': ['oauth']}
+            "name": "test-oauth",
+            "description": "OAuth authentication skill",
+            "base_url": "https://github.com/test/oauth",
+            "categories": {"oauth": ["oauth"]},
         }
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Create GitHub streams
         code_stream = CodeStream(directory=tmp_path, files=[])
         docs_stream = DocsStream(
-            readme='# OAuth Library\n\nQuick start: Install with pip install oauth',
-            contributing=None,
-            docs_files=[]
+            readme="# OAuth Library\n\nQuick start: Install with pip install oauth", contributing=None, docs_files=[]
         )
         insights_stream = InsightsStream(
-            metadata={'stars': 5000, 'forks': 200, 'language': 'Python', 'description': 'OAuth 2.0 library'},
+            metadata={"stars": 5000, "forks": 200, "language": "Python", "description": "OAuth 2.0 library"},
             common_problems=[
-                {'title': 'Redirect URI mismatch', 'number': 100, 'state': 'open', 'comments': 25, 'labels': ['bug', 'oauth']},
-                {'title': 'Token refresh fails', 'number': 95, 'state': 'open', 'comments': 18, 'labels': ['oauth']}
+                {
+                    "title": "Redirect URI mismatch",
+                    "number": 100,
+                    "state": "open",
+                    "comments": 25,
+                    "labels": ["bug", "oauth"],
+                },
+                {"title": "Token refresh fails", "number": 95, "state": "open", "comments": 18, "labels": ["oauth"]},
             ],
             known_solutions=[],
-            top_labels=[]
+            top_labels=[],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
@@ -215,30 +201,33 @@ class TestRouterGeneratorWithGitHub:
         skill_md = generator.generate_skill_md()
 
         # Check GitHub metadata section
-        assert '⭐ 5,000' in skill_md
-        assert 'Python' in skill_md
-        assert 'OAuth 2.0 library' in skill_md
+        assert "⭐ 5,000" in skill_md
+        assert "Python" in skill_md
+        assert "OAuth 2.0 library" in skill_md
 
         # Check Quick Start from README
-        assert '## Quick Start' in skill_md
-        assert 'OAuth Library' in skill_md
+        assert "## Quick Start" in skill_md
+        assert "OAuth Library" in skill_md
 
         # Check that issue was converted to question in Examples section (Fix 1)
-        assert '## Common Issues' in skill_md or '## Examples' in skill_md
-        assert 'how do i handle redirect uri mismatch' in skill_md.lower() or 'how do i fix redirect uri mismatch' in skill_md.lower()
+        assert "## Common Issues" in skill_md or "## Examples" in skill_md
+        assert (
+            "how do i handle redirect uri mismatch" in skill_md.lower()
+            or "how do i fix redirect uri mismatch" in skill_md.lower()
+        )
         # Note: Issue #100 may appear in Common Issues or as converted question in Examples
 
     def test_generate_skill_md_without_github(self, tmp_path):
         """Test SKILL.md generation without GitHub (backward compat)."""
         config = {
-            'name': 'test-oauth',
-            'description': 'OAuth skill',
-            'base_url': 'https://example.com',
-            'categories': {'oauth': ['oauth']}
+            "name": "test-oauth",
+            "description": "OAuth skill",
+            "base_url": "https://example.com",
+            "categories": {"oauth": ["oauth"]},
         }
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # No GitHub streams
@@ -246,14 +235,14 @@ class TestRouterGeneratorWithGitHub:
         skill_md = generator.generate_skill_md()
 
         # Should not have GitHub-specific sections
-        assert '⭐' not in skill_md
-        assert 'Repository Info' not in skill_md
-        assert 'Quick Start (from README)' not in skill_md
-        assert 'Common Issues (from GitHub)' not in skill_md
+        assert "⭐" not in skill_md
+        assert "Repository Info" not in skill_md
+        assert "Quick Start (from README)" not in skill_md
+        assert "Common Issues (from GitHub)" not in skill_md
 
         # Should have basic sections
-        assert 'When to Use This Skill' in skill_md
-        assert 'How It Works' in skill_md
+        assert "When to Use This Skill" in skill_md
+        assert "How It Works" in skill_md
 
 
 class TestSubSkillIssuesSection:
@@ -261,14 +250,10 @@ class TestSubSkillIssuesSection:
 
     def test_generate_subskill_issues_section(self, tmp_path):
         """Test generation of issues section for sub-skills."""
-        config = {
-            'name': 'test-oauth',
-            'base_url': 'https://example.com',
-            'categories': {'oauth': ['oauth']}
-        }
+        config = {"name": "test-oauth", "base_url": "https://example.com", "categories": {"oauth": ["oauth"]}}
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Create GitHub streams with issues
@@ -277,39 +262,41 @@ class TestSubSkillIssuesSection:
         insights_stream = InsightsStream(
             metadata={},
             common_problems=[
-                {'title': 'OAuth redirect fails', 'number': 50, 'state': 'open', 'comments': 20, 'labels': ['oauth', 'bug']},
-                {'title': 'Token expiration issue', 'number': 45, 'state': 'open', 'comments': 15, 'labels': ['oauth']}
+                {
+                    "title": "OAuth redirect fails",
+                    "number": 50,
+                    "state": "open",
+                    "comments": 20,
+                    "labels": ["oauth", "bug"],
+                },
+                {"title": "Token expiration issue", "number": 45, "state": "open", "comments": 15, "labels": ["oauth"]},
             ],
             known_solutions=[
-                {'title': 'Fixed OAuth flow', 'number': 40, 'state': 'closed', 'comments': 10, 'labels': ['oauth']}
+                {"title": "Fixed OAuth flow", "number": 40, "state": "closed", "comments": 10, "labels": ["oauth"]}
             ],
-            top_labels=[]
+            top_labels=[],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         generator = RouterGenerator([str(config_path)], github_streams=github_streams)
 
         # Generate issues section for oauth topic
-        issues_section = generator.generate_subskill_issues_section('test-oauth', ['oauth'])
+        issues_section = generator.generate_subskill_issues_section("test-oauth", ["oauth"])
 
         # Check content
-        assert 'Common Issues (from GitHub)' in issues_section
-        assert 'OAuth redirect fails' in issues_section
-        assert 'Issue #50' in issues_section
-        assert '20 comments' in issues_section
-        assert '🔴' in issues_section  # Open issue icon
-        assert '✅' in issues_section  # Closed issue icon
+        assert "Common Issues (from GitHub)" in issues_section
+        assert "OAuth redirect fails" in issues_section
+        assert "Issue #50" in issues_section
+        assert "20 comments" in issues_section
+        assert "🔴" in issues_section  # Open issue icon
+        assert "✅" in issues_section  # Closed issue icon
 
     def test_generate_subskill_issues_no_matches(self, tmp_path):
         """Test issues section when no issues match the topic."""
-        config = {
-            'name': 'test-async',
-            'base_url': 'https://example.com',
-            'categories': {'async': ['async']}
-        }
+        config = {"name": "test-async", "base_url": "https://example.com", "categories": {"async": ["async"]}}
 
-        config_path = tmp_path / 'config.json'
-        with open(config_path, 'w') as f:
+        config_path = tmp_path / "config.json"
+        with open(config_path, "w") as f:
             json.dump(config, f)
 
         # Create GitHub streams with oauth issues (not async)
@@ -318,22 +305,22 @@ class TestSubSkillIssuesSection:
         insights_stream = InsightsStream(
             metadata={},
             common_problems=[
-                {'title': 'OAuth fails', 'number': 1, 'state': 'open', 'comments': 5, 'labels': ['oauth']}
+                {"title": "OAuth fails", "number": 1, "state": "open", "comments": 5, "labels": ["oauth"]}
             ],
             known_solutions=[],
-            top_labels=[]
+            top_labels=[],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         generator = RouterGenerator([str(config_path)], github_streams=github_streams)
 
         # Generate issues section for async topic (no matches)
-        issues_section = generator.generate_subskill_issues_section('test-async', ['async'])
+        issues_section = generator.generate_subskill_issues_section("test-async", ["async"])
 
         # Unmatched issues go to 'other' category, so section is generated
-        assert 'Common Issues (from GitHub)' in issues_section
-        assert 'Other' in issues_section  # Unmatched issues
-        assert 'OAuth fails' in issues_section  # The oauth issue
+        assert "Common Issues (from GitHub)" in issues_section
+        assert "Other" in issues_section  # Unmatched issues
+        assert "OAuth fails" in issues_section  # The oauth issue
 
 
 class TestIntegration:
@@ -343,102 +330,106 @@ class TestIntegration:
         """Test complete router generation workflow with GitHub streams."""
         # Create multiple sub-skill configs
         config1 = {
-            'name': 'fastmcp-oauth',
-            'description': 'OAuth authentication in FastMCP',
-            'base_url': 'https://github.com/test/fastmcp',
-            'categories': {'oauth': ['oauth', 'auth']}
+            "name": "fastmcp-oauth",
+            "description": "OAuth authentication in FastMCP",
+            "base_url": "https://github.com/test/fastmcp",
+            "categories": {"oauth": ["oauth", "auth"]},
         }
         config2 = {
-            'name': 'fastmcp-async',
-            'description': 'Async operations in FastMCP',
-            'base_url': 'https://github.com/test/fastmcp',
-            'categories': {'async': ['async', 'await']}
+            "name": "fastmcp-async",
+            "description": "Async operations in FastMCP",
+            "base_url": "https://github.com/test/fastmcp",
+            "categories": {"async": ["async", "await"]},
         }
 
-        config_path1 = tmp_path / 'config1.json'
-        config_path2 = tmp_path / 'config2.json'
+        config_path1 = tmp_path / "config1.json"
+        config_path2 = tmp_path / "config2.json"
 
-        with open(config_path1, 'w') as f:
+        with open(config_path1, "w") as f:
             json.dump(config1, f)
-        with open(config_path2, 'w') as f:
+        with open(config_path2, "w") as f:
             json.dump(config2, f)
 
         # Create comprehensive GitHub streams
         code_stream = CodeStream(directory=tmp_path, files=[])
         docs_stream = DocsStream(
-            readme='# FastMCP\n\nFast MCP server framework.\n\n## Installation\n\n```bash\npip install fastmcp\n```',
-            contributing='# Contributing\n\nPull requests welcome!',
+            readme="# FastMCP\n\nFast MCP server framework.\n\n## Installation\n\n```bash\npip install fastmcp\n```",
+            contributing="# Contributing\n\nPull requests welcome!",
             docs_files=[
-                {'path': 'docs/oauth.md', 'content': '# OAuth Guide'},
-                {'path': 'docs/async.md', 'content': '# Async Guide'}
-            ]
+                {"path": "docs/oauth.md", "content": "# OAuth Guide"},
+                {"path": "docs/async.md", "content": "# Async Guide"},
+            ],
         )
         insights_stream = InsightsStream(
-            metadata={
-                'stars': 10000,
-                'forks': 500,
-                'language': 'Python',
-                'description': 'Fast MCP server framework'
-            },
+            metadata={"stars": 10000, "forks": 500, "language": "Python", "description": "Fast MCP server framework"},
             common_problems=[
-                {'title': 'OAuth setup fails', 'number': 150, 'state': 'open', 'comments': 30, 'labels': ['bug', 'oauth']},
-                {'title': 'Async deadlock', 'number': 142, 'state': 'open', 'comments': 25, 'labels': ['async', 'bug']},
-                {'title': 'Token refresh issue', 'number': 130, 'state': 'open', 'comments': 20, 'labels': ['oauth']}
+                {
+                    "title": "OAuth setup fails",
+                    "number": 150,
+                    "state": "open",
+                    "comments": 30,
+                    "labels": ["bug", "oauth"],
+                },
+                {"title": "Async deadlock", "number": 142, "state": "open", "comments": 25, "labels": ["async", "bug"]},
+                {"title": "Token refresh issue", "number": 130, "state": "open", "comments": 20, "labels": ["oauth"]},
             ],
             known_solutions=[
-                {'title': 'Fixed OAuth redirect', 'number': 120, 'state': 'closed', 'comments': 15, 'labels': ['oauth']},
-                {'title': 'Resolved async race', 'number': 110, 'state': 'closed', 'comments': 12, 'labels': ['async']}
+                {
+                    "title": "Fixed OAuth redirect",
+                    "number": 120,
+                    "state": "closed",
+                    "comments": 15,
+                    "labels": ["oauth"],
+                },
+                {"title": "Resolved async race", "number": 110, "state": "closed", "comments": 12, "labels": ["async"]},
             ],
             top_labels=[
-                {'label': 'oauth', 'count': 45},
-                {'label': 'async', 'count': 38},
-                {'label': 'bug', 'count': 30}
-            ]
+                {"label": "oauth", "count": 45},
+                {"label": "async", "count": 38},
+                {"label": "bug", "count": 30},
+            ],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         # Create router generator
-        generator = RouterGenerator(
-            [str(config_path1), str(config_path2)],
-            github_streams=github_streams
-        )
+        generator = RouterGenerator([str(config_path1), str(config_path2)], github_streams=github_streams)
 
         # Generate SKILL.md
         skill_md = generator.generate_skill_md()
 
         # Verify all Phase 4 enhancements present
         # 1. Repository metadata
-        assert '⭐ 10,000' in skill_md
-        assert 'Python' in skill_md
-        assert 'Fast MCP server framework' in skill_md
+        assert "⭐ 10,000" in skill_md
+        assert "Python" in skill_md
+        assert "Fast MCP server framework" in skill_md
 
         # 2. Quick start from README
-        assert '## Quick Start' in skill_md
-        assert 'pip install fastmcp' in skill_md
+        assert "## Quick Start" in skill_md
+        assert "pip install fastmcp" in skill_md
 
         # 3. Sub-skills listed
-        assert 'fastmcp-oauth' in skill_md
-        assert 'fastmcp-async' in skill_md
+        assert "fastmcp-oauth" in skill_md
+        assert "fastmcp-async" in skill_md
 
         # 4. Examples section with converted questions (Fix 1)
-        assert '## Examples' in skill_md
+        assert "## Examples" in skill_md
         # Issues converted to natural questions
-        assert 'how do i fix oauth setup' in skill_md.lower() or 'how do i handle oauth setup' in skill_md.lower()
-        assert 'how do i handle async deadlock' in skill_md.lower() or 'how do i fix async deadlock' in skill_md.lower()
+        assert "how do i fix oauth setup" in skill_md.lower() or "how do i handle oauth setup" in skill_md.lower()
+        assert "how do i handle async deadlock" in skill_md.lower() or "how do i fix async deadlock" in skill_md.lower()
         # Common Issues section may still exist with other issues
         # Note: Issue numbers may appear in Common Issues or Common Patterns sections
 
         # 5. Routing keywords include GitHub labels (2x weight)
         routing = generator.extract_routing_keywords()
-        oauth_keywords = routing['fastmcp-oauth']
-        async_keywords = routing['fastmcp-async']
+        oauth_keywords = routing["fastmcp-oauth"]
+        async_keywords = routing["fastmcp-async"]
 
         # Labels should be included with 2x weight
-        assert oauth_keywords.count('oauth') >= 2
-        assert async_keywords.count('async') >= 2
+        assert oauth_keywords.count("oauth") >= 2
+        assert async_keywords.count("async") >= 2
 
         # Generate config
         router_config = generator.create_router_config()
-        assert router_config['name'] == 'fastmcp'
-        assert router_config['_router'] is True
-        assert len(router_config['_sub_skills']) == 2
+        assert router_config["name"] == "fastmcp"
+        assert router_config["_router"] is True
+        assert len(router_config["_sub_skills"]) == 2
diff --git a/tests/test_git_repo.py b/tests/test_git_repo.py
index 1d39ae7..24c2fb8 100644
--- a/tests/test_git_repo.py
+++ b/tests/test_git_repo.py
@@ -4,11 +4,11 @@ Tests for GitConfigRepo class (git repository operations)
 """
 
 import json
-import pytest
-import shutil
 from pathlib import Path
-from unittest.mock import MagicMock, patch, Mock
-from git.exc import GitCommandError, InvalidGitRepositoryError
+from unittest.mock import MagicMock, patch
+
+import pytest
+from git.exc import GitCommandError
 
 from skill_seekers.mcp.git_repo import GitConfigRepo
 
@@ -129,26 +129,23 @@ class TestInjectToken:
 class TestCloneOrPull:
     """Test clone and pull operations."""
 
-    @patch('skill_seekers.mcp.git_repo.git.Repo.clone_from')
+    @patch("skill_seekers.mcp.git_repo.git.Repo.clone_from")
     def test_clone_new_repo(self, mock_clone, git_repo):
         """Test cloning a new repository."""
         mock_clone.return_value = MagicMock()
 
-        result = git_repo.clone_or_pull(
-            source_name="test-source",
-            git_url="https://github.com/org/repo.git"
-        )
+        result = git_repo.clone_or_pull(source_name="test-source", git_url="https://github.com/org/repo.git")
 
         assert result == git_repo.cache_dir / "test-source"
         mock_clone.assert_called_once()
 
         # Verify shallow clone parameters
         call_kwargs = mock_clone.call_args[1]
-        assert call_kwargs['depth'] == 1
-        assert call_kwargs['single_branch'] is True
-        assert call_kwargs['branch'] == "main"
+        assert call_kwargs["depth"] == 1
+        assert call_kwargs["single_branch"] is True
+        assert call_kwargs["branch"] == "main"
 
-    @patch('skill_seekers.mcp.git_repo.git.Repo')
+    @patch("skill_seekers.mcp.git_repo.git.Repo")
     def test_pull_existing_repo(self, mock_repo_class, git_repo, temp_cache_dir):
         """Test pulling updates to existing repository."""
         # Create fake existing repo
@@ -162,15 +159,12 @@ class TestCloneOrPull:
         mock_repo.remotes.origin = mock_origin
         mock_repo_class.return_value = mock_repo
 
-        result = git_repo.clone_or_pull(
-            source_name="test-source",
-            git_url="https://github.com/org/repo.git"
-        )
+        result = git_repo.clone_or_pull(source_name="test-source", git_url="https://github.com/org/repo.git")
 
         assert result == repo_path
         mock_origin.pull.assert_called_once_with("main")
 
-    @patch('skill_seekers.mcp.git_repo.git.Repo')
+    @patch("skill_seekers.mcp.git_repo.git.Repo")
     def test_pull_with_token_update(self, mock_repo_class, git_repo, temp_cache_dir):
         """Test pulling with token updates remote URL."""
         # Create fake existing repo
@@ -185,9 +179,7 @@ class TestCloneOrPull:
         mock_repo_class.return_value = mock_repo
 
         result = git_repo.clone_or_pull(
-            source_name="test-source",
-            git_url="https://github.com/org/repo.git",
-            token="ghp_token123"
+            source_name="test-source", git_url="https://github.com/org/repo.git", token="ghp_token123"
         )
 
         # Verify URL was updated with token
@@ -195,7 +187,7 @@ class TestCloneOrPull:
         updated_url = mock_origin.set_url.call_args[0][0]
         assert "ghp_token123@github.com" in updated_url
 
-    @patch('skill_seekers.mcp.git_repo.git.Repo.clone_from')
+    @patch("skill_seekers.mcp.git_repo.git.Repo.clone_from")
     def test_force_refresh_deletes_cache(self, mock_clone, git_repo, temp_cache_dir):
         """Test force refresh deletes existing cache."""
         # Create fake existing repo
@@ -206,66 +198,41 @@ class TestCloneOrPull:
 
         mock_clone.return_value = MagicMock()
 
-        git_repo.clone_or_pull(
-            source_name="test-source",
-            git_url="https://github.com/org/repo.git",
-            force_refresh=True
-        )
+        git_repo.clone_or_pull(source_name="test-source", git_url="https://github.com/org/repo.git", force_refresh=True)
 
         # Verify clone was called (not pull)
         mock_clone.assert_called_once()
 
-    @patch('skill_seekers.mcp.git_repo.git.Repo.clone_from')
+    @patch("skill_seekers.mcp.git_repo.git.Repo.clone_from")
     def test_clone_with_custom_branch(self, mock_clone, git_repo):
         """Test cloning with custom branch."""
         mock_clone.return_value = MagicMock()
 
-        git_repo.clone_or_pull(
-            source_name="test-source",
-            git_url="https://github.com/org/repo.git",
-            branch="develop"
-        )
+        git_repo.clone_or_pull(source_name="test-source", git_url="https://github.com/org/repo.git", branch="develop")
 
         call_kwargs = mock_clone.call_args[1]
-        assert call_kwargs['branch'] == "develop"
+        assert call_kwargs["branch"] == "develop"
 
     def test_clone_invalid_url_raises_error(self, git_repo):
         """Test cloning with invalid URL raises ValueError."""
         with pytest.raises(ValueError, match="Invalid git URL"):
-            git_repo.clone_or_pull(
-                source_name="test-source",
-                git_url="not-a-valid-url"
-            )
+            git_repo.clone_or_pull(source_name="test-source", git_url="not-a-valid-url")
 
-    @patch('skill_seekers.mcp.git_repo.git.Repo.clone_from')
+    @patch("skill_seekers.mcp.git_repo.git.Repo.clone_from")
     def test_clone_auth_failure_error(self, mock_clone, git_repo):
         """Test authentication failure error handling."""
-        mock_clone.side_effect = GitCommandError(
-            "clone",
-            128,
-            stderr="fatal: Authentication failed"
-        )
+        mock_clone.side_effect = GitCommandError("clone", 128, stderr="fatal: Authentication failed")
 
         with pytest.raises(GitCommandError, match="Authentication failed"):
-            git_repo.clone_or_pull(
-                source_name="test-source",
-                git_url="https://github.com/org/repo.git"
-            )
+            git_repo.clone_or_pull(source_name="test-source", git_url="https://github.com/org/repo.git")
 
-    @patch('skill_seekers.mcp.git_repo.git.Repo.clone_from')
+    @patch("skill_seekers.mcp.git_repo.git.Repo.clone_from")
     def test_clone_not_found_error(self, mock_clone, git_repo):
         """Test repository not found error handling."""
-        mock_clone.side_effect = GitCommandError(
-            "clone",
-            128,
-            stderr="fatal: repository not found"
-        )
+        mock_clone.side_effect = GitCommandError("clone", 128, stderr="fatal: repository not found")
 
         with pytest.raises(GitCommandError, match="Repository not found"):
-            git_repo.clone_or_pull(
-                source_name="test-source",
-                git_url="https://github.com/org/nonexistent.git"
-            )
+            git_repo.clone_or_pull(source_name="test-source", git_url="https://github.com/org/nonexistent.git")
 
 
 class TestFindConfigs:
diff --git a/tests/test_git_sources_e2e.py b/tests/test_git_sources_e2e.py
index 9025bf4..96ff558 100644
--- a/tests/test_git_sources_e2e.py
+++ b/tests/test_git_sources_e2e.py
@@ -28,6 +28,7 @@ from skill_seekers.mcp.source_manager import SourceManager
 try:
     import mcp
     from mcp.types import TextContent
+
     MCP_AVAILABLE = True
 except ImportError:
     MCP_AVAILABLE = False
@@ -60,64 +61,42 @@ class TestGitSourcesE2E:
                 "name": "react",
                 "description": "React framework for UIs",
                 "base_url": "https://react.dev/",
-                "selectors": {
-                    "main_content": "article",
-                    "title": "h1",
-                    "code_blocks": "pre code"
-                },
-                "url_patterns": {
-                    "include": [],
-                    "exclude": []
-                },
-                "categories": {
-                    "getting_started": ["learn", "start"],
-                    "api": ["reference", "api"]
-                },
+                "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+                "url_patterns": {"include": [], "exclude": []},
+                "categories": {"getting_started": ["learn", "start"], "api": ["reference", "api"]},
                 "rate_limit": 0.5,
-                "max_pages": 100
+                "max_pages": 100,
             },
             "vue.json": {
                 "name": "vue",
                 "description": "Vue.js progressive framework",
                 "base_url": "https://vuejs.org/",
-                "selectors": {
-                    "main_content": "main",
-                    "title": "h1"
-                },
-                "url_patterns": {
-                    "include": [],
-                    "exclude": []
-                },
+                "selectors": {"main_content": "main", "title": "h1"},
+                "url_patterns": {"include": [], "exclude": []},
                 "categories": {},
                 "rate_limit": 0.5,
-                "max_pages": 50
+                "max_pages": 50,
             },
             "django.json": {
                 "name": "django",
                 "description": "Django web framework",
                 "base_url": "https://docs.djangoproject.com/",
-                "selectors": {
-                    "main_content": "div[role='main']",
-                    "title": "h1"
-                },
-                "url_patterns": {
-                    "include": [],
-                    "exclude": []
-                },
+                "selectors": {"main_content": "div[role='main']", "title": "h1"},
+                "url_patterns": {"include": [], "exclude": []},
                 "categories": {},
                 "rate_limit": 0.5,
-                "max_pages": 200
-            }
+                "max_pages": 200,
+            },
         }
 
         # Write config files
         for filename, config_data in configs.items():
             config_path = Path(repo_dir) / filename
-            with open(config_path, 'w') as f:
+            with open(config_path, "w") as f:
                 json.dump(config_data, f, indent=2)
 
         # Add and commit
-        repo.index.add(['*.json'])
+        repo.index.add(["*.json"])
         repo.index.commit("Initial commit with sample configs")
 
         yield repo_dir, repo
@@ -145,7 +124,7 @@ class TestGitSourcesE2E:
         repo_path = git_repo.clone_or_pull(
             source_name="test-direct",
             git_url=git_url,
-            branch="master"  # git.Repo.init creates 'master' by default
+            branch="master",  # git.Repo.init creates 'master' by default
         )
 
         assert repo_path.exists()
@@ -190,11 +169,7 @@ class TestGitSourcesE2E:
         # Step 1: Add source to registry
         source_manager = SourceManager(config_dir=config_dir)
         source = source_manager.add_source(
-            name="team-configs",
-            git_url=git_url,
-            source_type="custom",
-            branch="master",
-            priority=10
+            name="team-configs", git_url=git_url, source_type="custom", branch="master", priority=10
         )
 
         assert source["name"] == "team-configs"
@@ -216,9 +191,7 @@ class TestGitSourcesE2E:
         # Step 4: Clone via source name
         git_repo = GitConfigRepo(cache_dir=cache_dir)
         repo_path = git_repo.clone_or_pull(
-            source_name=source["name"],
-            git_url=source["git_url"],
-            branch=source["branch"]
+            source_name=source["name"], git_url=source["git_url"], branch=source["branch"]
         )
 
         assert repo_path.exists()
@@ -234,7 +207,7 @@ class TestGitSourcesE2E:
             git_url=git_url,
             source_type="custom",
             branch="master",
-            priority=5  # Changed priority
+            priority=5,  # Changed priority
         )
         assert updated_source["priority"] == 5
 
@@ -266,21 +239,9 @@ class TestGitSourcesE2E:
         source_manager = SourceManager(config_dir=config_dir)
 
         # Step 1: Add multiple sources with different priorities
-        source_manager.add_source(
-            name="low-priority",
-            git_url=git_url,
-            priority=100
-        )
-        source_manager.add_source(
-            name="high-priority",
-            git_url=git_url,
-            priority=1
-        )
-        source_manager.add_source(
-            name="medium-priority",
-            git_url=git_url,
-            priority=50
-        )
+        source_manager.add_source(name="low-priority", git_url=git_url, priority=100)
+        source_manager.add_source(name="high-priority", git_url=git_url, priority=1)
+        source_manager.add_source(name="medium-priority", git_url=git_url, priority=50)
 
         # Step 2: Verify sources are sorted by priority
         sources = source_manager.list_sources()
@@ -290,12 +251,7 @@ class TestGitSourcesE2E:
         assert sources[2]["name"] == "low-priority"
 
         # Step 3: Enable/disable sources
-        source_manager.add_source(
-            name="high-priority",
-            git_url=git_url,
-            priority=1,
-            enabled=False
-        )
+        source_manager.add_source(name="high-priority", git_url=git_url, priority=1, enabled=False)
 
         # Step 4: List enabled sources only
         enabled_sources = source_manager.list_sources(enabled_only=True)
@@ -320,11 +276,7 @@ class TestGitSourcesE2E:
         git_repo = GitConfigRepo(cache_dir=cache_dir)
 
         # Step 1: Clone repository
-        repo_path = git_repo.clone_or_pull(
-            source_name="test-pull",
-            git_url=git_url,
-            branch="master"
-        )
+        repo_path = git_repo.clone_or_pull(source_name="test-pull", git_url=git_url, branch="master")
 
         initial_configs = git_repo.find_configs(repo_path)
         assert len(initial_configs) == 3
@@ -338,14 +290,14 @@ class TestGitSourcesE2E:
             "url_patterns": {"include": [], "exclude": []},
             "categories": {},
             "rate_limit": 0.5,
-            "max_pages": 150
+            "max_pages": 150,
         }
 
         new_config_path = Path(repo_dir) / "fastapi.json"
-        with open(new_config_path, 'w') as f:
+        with open(new_config_path, "w") as f:
             json.dump(new_config, f, indent=2)
 
-        repo.index.add(['fastapi.json'])
+        repo.index.add(["fastapi.json"])
         repo.index.commit("Add FastAPI config")
 
         # Step 3: Pull updates
@@ -353,7 +305,7 @@ class TestGitSourcesE2E:
             source_name="test-pull",
             git_url=git_url,
             branch="master",
-            force_refresh=False  # Should pull, not re-clone
+            force_refresh=False,  # Should pull, not re-clone
         )
 
         # Step 4: Verify new config is available
@@ -381,15 +333,11 @@ class TestGitSourcesE2E:
         git_repo = GitConfigRepo(cache_dir=cache_dir)
 
         # Step 1: Clone repository
-        repo_path = git_repo.clone_or_pull(
-            source_name="test-refresh",
-            git_url=git_url,
-            branch="master"
-        )
+        repo_path = git_repo.clone_or_pull(source_name="test-refresh", git_url=git_url, branch="master")
 
         # Step 2: Modify local cache manually
         corrupt_file = repo_path / "CORRUPTED.txt"
-        with open(corrupt_file, 'w') as f:
+        with open(corrupt_file, "w") as f:
             f.write("This file should not exist after refresh")
 
         assert corrupt_file.exists()
@@ -399,7 +347,7 @@ class TestGitSourcesE2E:
             source_name="test-refresh",
             git_url=git_url,
             branch="master",
-            force_refresh=True  # Delete and re-clone
+            force_refresh=True,  # Delete and re-clone
         )
 
         # Step 4: Verify cache was reset
@@ -423,11 +371,7 @@ class TestGitSourcesE2E:
         git_repo = GitConfigRepo(cache_dir=cache_dir)
 
         # Step 1: Clone repository
-        repo_path = git_repo.clone_or_pull(
-            source_name="test-not-found",
-            git_url=git_url,
-            branch="master"
-        )
+        repo_path = git_repo.clone_or_pull(source_name="test-not-found", git_url=git_url, branch="master")
 
         # Step 2: Try to fetch non-existent config
         with pytest.raises(FileNotFoundError) as exc_info:
@@ -453,20 +397,11 @@ class TestGitSourcesE2E:
         git_repo = GitConfigRepo(cache_dir=cache_dir)
 
         # Invalid URLs
-        invalid_urls = [
-            "",
-            "not-a-url",
-            "ftp://invalid.com/repo.git",
-            "javascript:alert('xss')"
-        ]
+        invalid_urls = ["", "not-a-url", "ftp://invalid.com/repo.git", "javascript:alert('xss')"]
 
         for invalid_url in invalid_urls:
             with pytest.raises(ValueError, match="Invalid git URL"):
-                git_repo.clone_or_pull(
-                    source_name="test-invalid",
-                    git_url=invalid_url,
-                    branch="master"
-                )
+                git_repo.clone_or_pull(source_name="test-invalid", git_url=invalid_url, branch="master")
 
     def test_e2e_source_name_validation(self, temp_dirs):
         """
@@ -487,7 +422,7 @@ class TestGitSourcesE2E:
             "name@with@symbols",
             "name.with.dots",
             "123-only-numbers-start-is-ok",  # This should actually work
-            "name!exclamation"
+            "name!exclamation",
         ]
 
         valid_git_url = "https://github.com/test/repo.git"
@@ -496,10 +431,7 @@ class TestGitSourcesE2E:
             if invalid_name == "123-only-numbers-start-is-ok":
                 continue
             with pytest.raises(ValueError, match="Invalid source name"):
-                source_manager.add_source(
-                    name=invalid_name,
-                    git_url=valid_git_url
-                )
+                source_manager.add_source(name=invalid_name, git_url=valid_git_url)
 
     def test_e2e_registry_persistence(self, temp_dirs, temp_git_repo):
         """
@@ -519,11 +451,7 @@ class TestGitSourcesE2E:
 
         # Step 1: Add source with one instance
         manager1 = SourceManager(config_dir=config_dir)
-        manager1.add_source(
-            name="persistent-source",
-            git_url=git_url,
-            priority=25
-        )
+        manager1.add_source(name="persistent-source", git_url=git_url, priority=25)
 
         # Step 2: Create new instance
         manager2 = SourceManager(config_dir=config_dir)
@@ -538,7 +466,7 @@ class TestGitSourcesE2E:
         manager2.add_source(
             name="persistent-source",
             git_url=git_url,
-            priority=50  # Changed
+            priority=50,  # Changed
         )
 
         # Step 5: Verify changes persist
@@ -568,19 +496,11 @@ class TestGitSourcesE2E:
 
             # Step 1: Clone to cache_dir_1
             git_repo_1 = GitConfigRepo(cache_dir=cache_dir_1)
-            repo_path_1 = git_repo_1.clone_or_pull(
-                source_name="test-source",
-                git_url=git_url,
-                branch="master"
-            )
+            repo_path_1 = git_repo_1.clone_or_pull(source_name="test-source", git_url=git_url, branch="master")
 
             # Step 2: Clone same repo to cache_dir_2
             git_repo_2 = GitConfigRepo(cache_dir=cache_dir_2)
-            repo_path_2 = git_repo_2.clone_or_pull(
-                source_name="test-source",
-                git_url=git_url,
-                branch="master"
-            )
+            repo_path_2 = git_repo_2.clone_or_pull(source_name="test-source", git_url=git_url, branch="master")
 
             # Step 3: Verify both caches are independent
             assert repo_path_1 != repo_path_2
@@ -589,7 +509,7 @@ class TestGitSourcesE2E:
 
             # Step 4: Modify one cache
             marker_file = repo_path_1 / "MARKER.txt"
-            with open(marker_file, 'w') as f:
+            with open(marker_file, "w") as f:
                 f.write("Cache 1 marker")
 
             # Step 5: Verify other cache is unaffected
@@ -621,7 +541,7 @@ class TestGitSourcesE2E:
         github_source = source_manager.add_source(
             name="github-test",
             git_url="https://github.com/test/repo.git",
-            source_type="github"
+            source_type="github",
             # No token_env specified
         )
 
@@ -632,7 +552,7 @@ class TestGitSourcesE2E:
         gitlab_source = source_manager.add_source(
             name="gitlab-test",
             git_url="https://gitlab.com/test/repo.git",
-            source_type="gitlab"
+            source_type="gitlab",
             # No token_env specified
         )
 
@@ -641,9 +561,7 @@ class TestGitSourcesE2E:
 
         # Also test custom type (defaults to GIT_TOKEN)
         custom_source = source_manager.add_source(
-            name="custom-test",
-            git_url="https://custom.com/test/repo.git",
-            source_type="custom"
+            name="custom-test", git_url="https://custom.com/test/repo.git", source_type="custom"
         )
         assert custom_source["token_env"] == "GIT_TOKEN"
 
@@ -671,20 +589,14 @@ class TestGitSourcesE2E:
         # Step 2: Team lead registers source
         source_manager = SourceManager(config_dir=config_dir)
         source_manager.add_source(
-            name="team-configs",
-            git_url=git_url,
-            source_type="custom",
-            branch="master",
-            priority=1
+            name="team-configs", git_url=git_url, source_type="custom", branch="master", priority=1
         )
 
         # Step 3: Developer 1 clones and uses config
         git_repo = GitConfigRepo(cache_dir=cache_dir)
         source = source_manager.get_source("team-configs")
         repo_path = git_repo.clone_or_pull(
-            source_name=source["name"],
-            git_url=source["git_url"],
-            branch=source["branch"]
+            source_name=source["name"], git_url=source["git_url"], branch=source["branch"]
         )
 
         react_config = git_repo.get_config(repo_path, "react")
@@ -693,9 +605,7 @@ class TestGitSourcesE2E:
         # Step 4: Developer 2 uses same source (should use cache, not re-clone)
         # Simulate by checking if pull works (not re-clone)
         repo_path_2 = git_repo.clone_or_pull(
-            source_name=source["name"],
-            git_url=source["git_url"],
-            branch=source["branch"]
+            source_name=source["name"], git_url=source["git_url"], branch=source["branch"]
         )
         assert repo_path == repo_path_2
 
@@ -704,32 +614,24 @@ class TestGitSourcesE2E:
         updated_react_config["max_pages"] = 500  # Increased limit
 
         react_config_path = Path(repo_dir) / "react.json"
-        with open(react_config_path, 'w') as f:
+        with open(react_config_path, "w") as f:
             json.dump(updated_react_config, f, indent=2)
 
-        repo.index.add(['react.json'])
+        repo.index.add(["react.json"])
         repo.index.commit("Increase React config max_pages to 500")
 
         # Step 6: Developers pull updates
-        git_repo.clone_or_pull(
-            source_name=source["name"],
-            git_url=source["git_url"],
-            branch=source["branch"]
-        )
+        git_repo.clone_or_pull(source_name=source["name"], git_url=source["git_url"], branch=source["branch"])
 
         updated_config = git_repo.get_config(repo_path, "react")
         assert updated_config["max_pages"] == 500
 
         # Step 7: Config is removed from repo
         react_config_path.unlink()
-        repo.index.remove(['react.json'])
+        repo.index.remove(["react.json"])
         repo.index.commit("Remove react.json")
 
-        git_repo.clone_or_pull(
-            source_name=source["name"],
-            git_url=source["git_url"],
-            branch=source["branch"]
-        )
+        git_repo.clone_or_pull(source_name=source["name"], git_url=source["git_url"], branch=source["branch"])
 
         # Step 8: Error handling works correctly
         with pytest.raises(FileNotFoundError, match="react.json"):
@@ -775,21 +677,18 @@ class TestMCPToolsE2E:
             "name": "test-framework",
             "description": "Test framework for E2E",
             "base_url": "https://example.com/docs/",
-            "selectors": {
-                "main_content": "article",
-                "title": "h1"
-            },
+            "selectors": {"main_content": "article", "title": "h1"},
             "url_patterns": {"include": [], "exclude": []},
             "categories": {},
             "rate_limit": 0.5,
-            "max_pages": 50
+            "max_pages": 50,
         }
 
         config_path = Path(repo_dir) / "test-framework.json"
-        with open(config_path, 'w') as f:
+        with open(config_path, "w") as f:
             json.dump(config, f, indent=2)
 
-        repo.index.add(['*.json'])
+        repo.index.add(["*.json"])
         repo.index.commit("Initial commit")
 
         yield repo_dir, repo
@@ -801,23 +700,16 @@ class TestMCPToolsE2E:
         """
         MCP E2E Test 1: Complete add/list/remove workflow via MCP tools
         """
-        from skill_seekers.mcp.server import (
-            add_config_source_tool,
-            list_config_sources_tool,
-            remove_config_source_tool
-        )
+        from skill_seekers.mcp.server import add_config_source_tool, list_config_sources_tool, remove_config_source_tool
 
         cache_dir, config_dir = temp_dirs
         repo_dir, repo = temp_git_repo
         git_url = f"file://{repo_dir}"
 
         # Add source
-        add_result = await add_config_source_tool({
-            "name": "mcp-test-source",
-            "git_url": git_url,
-            "source_type": "custom",
-            "branch": "master"
-        })
+        add_result = await add_config_source_tool(
+            {"name": "mcp-test-source", "git_url": git_url, "source_type": "custom", "branch": "master"}
+        )
 
         assert len(add_result) == 1
         assert "✅" in add_result[0].text
@@ -830,9 +722,7 @@ class TestMCPToolsE2E:
         assert "mcp-test-source" in list_result[0].text
 
         # Remove source
-        remove_result = await remove_config_source_tool({
-            "name": "mcp-test-source"
-        })
+        remove_result = await remove_config_source_tool({"name": "mcp-test-source"})
 
         assert len(remove_result) == 1
         assert "✅" in remove_result[0].text
@@ -853,12 +743,9 @@ class TestMCPToolsE2E:
         dest_dir = Path(config_dir) / "configs"
         dest_dir.mkdir(parents=True, exist_ok=True)
 
-        result = await fetch_config_tool({
-            "config_name": "test-framework",
-            "git_url": git_url,
-            "branch": "master",
-            "destination": str(dest_dir)
-        })
+        result = await fetch_config_tool(
+            {"config_name": "test-framework", "git_url": git_url, "branch": "master", "destination": str(dest_dir)}
+        )
 
         assert len(result) == 1
         assert "✅" in result[0].text
@@ -878,32 +765,24 @@ class TestMCPToolsE2E:
         """
         MCP E2E Test 3: fetch_config with registered source
         """
-        from skill_seekers.mcp.server import (
-            add_config_source_tool,
-            fetch_config_tool
-        )
+        from skill_seekers.mcp.server import add_config_source_tool, fetch_config_tool
 
         cache_dir, config_dir = temp_dirs
         repo_dir, repo = temp_git_repo
         git_url = f"file://{repo_dir}"
 
         # Register source first
-        await add_config_source_tool({
-            "name": "test-source",
-            "git_url": git_url,
-            "source_type": "custom",
-            "branch": "master"
-        })
+        await add_config_source_tool(
+            {"name": "test-source", "git_url": git_url, "source_type": "custom", "branch": "master"}
+        )
 
         # Fetch via source name
         dest_dir = Path(config_dir) / "configs"
         dest_dir.mkdir(parents=True, exist_ok=True)
 
-        result = await fetch_config_tool({
-            "config_name": "test-framework",
-            "source": "test-source",
-            "destination": str(dest_dir)
-        })
+        result = await fetch_config_tool(
+            {"config_name": "test-framework", "source": "test-source", "destination": str(dest_dir)}
+        )
 
         assert len(result) == 1
         assert "✅" in result[0].text
@@ -920,9 +799,8 @@ class TestMCPToolsE2E:
         """
         from skill_seekers.mcp.server import (
             add_config_source_tool,
-            list_config_sources_tool,
+            fetch_config_tool,
             remove_config_source_tool,
-            fetch_config_tool
         )
 
         cache_dir, config_dir = temp_dirs
@@ -930,48 +808,34 @@ class TestMCPToolsE2E:
         git_url = f"file://{repo_dir}"
 
         # Test 1: Add source without name
-        result = await add_config_source_tool({
-            "git_url": git_url
-        })
+        result = await add_config_source_tool({"git_url": git_url})
         assert "❌" in result[0].text
         assert "name" in result[0].text.lower()
 
         # Test 2: Add source without git_url
-        result = await add_config_source_tool({
-            "name": "test"
-        })
+        result = await add_config_source_tool({"name": "test"})
         assert "❌" in result[0].text
         assert "git_url" in result[0].text.lower()
 
         # Test 3: Remove non-existent source
-        result = await remove_config_source_tool({
-            "name": "non-existent"
-        })
+        result = await remove_config_source_tool({"name": "non-existent"})
         assert "❌" in result[0].text or "not found" in result[0].text.lower()
 
         # Test 4: Fetch config from non-existent source
         dest_dir = Path(config_dir) / "configs"
         dest_dir.mkdir(parents=True, exist_ok=True)
 
-        result = await fetch_config_tool({
-            "config_name": "test",
-            "source": "non-existent-source",
-            "destination": str(dest_dir)
-        })
+        result = await fetch_config_tool(
+            {"config_name": "test", "source": "non-existent-source", "destination": str(dest_dir)}
+        )
         assert "❌" in result[0].text or "not found" in result[0].text.lower()
 
         # Test 5: Fetch non-existent config from valid source
-        await add_config_source_tool({
-            "name": "valid-source",
-            "git_url": git_url,
-            "branch": "master"
-        })
+        await add_config_source_tool({"name": "valid-source", "git_url": git_url, "branch": "master"})
 
-        result = await fetch_config_tool({
-            "config_name": "non-existent-config",
-            "source": "valid-source",
-            "destination": str(dest_dir)
-        })
+        result = await fetch_config_tool(
+            {"config_name": "non-existent-config", "source": "valid-source", "destination": str(dest_dir)}
+        )
         assert "❌" in result[0].text or "not found" in result[0].text.lower()
 
 
diff --git a/tests/test_github_fetcher.py b/tests/test_github_fetcher.py
index 290710f..34961d2 100644
--- a/tests/test_github_fetcher.py
+++ b/tests/test_github_fetcher.py
@@ -7,16 +7,17 @@ Tests the three-stream architecture that splits GitHub repositories into:
 - Insights stream (issues, metadata)
 """
 
-import pytest
-import tempfile
 from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
+from unittest.mock import Mock, patch
+
+import pytest
+
 from skill_seekers.cli.github_fetcher import (
     CodeStream,
     DocsStream,
+    GitHubThreeStreamFetcher,
     InsightsStream,
     ThreeStreamData,
-    GitHubThreeStreamFetcher
 )
 
 
@@ -25,10 +26,7 @@ class TestDataClasses:
 
     def test_code_stream(self):
         """Test CodeStream data class."""
-        code_stream = CodeStream(
-            directory=Path("/tmp/repo"),
-            files=[Path("/tmp/repo/src/main.py")]
-        )
+        code_stream = CodeStream(directory=Path("/tmp/repo"), files=[Path("/tmp/repo/src/main.py")])
         assert code_stream.directory == Path("/tmp/repo")
         assert len(code_stream.files) == 1
 
@@ -37,7 +35,7 @@ class TestDataClasses:
         docs_stream = DocsStream(
             readme="# README",
             contributing="# Contributing",
-            docs_files=[{"path": "docs/guide.md", "content": "# Guide"}]
+            docs_files=[{"path": "docs/guide.md", "content": "# Guide"}],
         )
         assert docs_stream.readme == "# README"
         assert docs_stream.contributing == "# Contributing"
@@ -49,7 +47,7 @@ class TestDataClasses:
             metadata={"stars": 1234, "forks": 56},
             common_problems=[{"title": "Bug", "number": 42}],
             known_solutions=[{"title": "Fix", "number": 35}],
-            top_labels=[{"label": "bug", "count": 10}]
+            top_labels=[{"label": "bug", "count": 10}],
         )
         assert insights_stream.metadata["stars"] == 1234
         assert len(insights_stream.common_problems) == 1
@@ -61,7 +59,7 @@ class TestDataClasses:
         three_streams = ThreeStreamData(
             code_stream=CodeStream(Path("/tmp"), []),
             docs_stream=DocsStream(None, None, []),
-            insights_stream=InsightsStream({}, [], [], [])
+            insights_stream=InsightsStream({}, [], [], []),
         )
         assert isinstance(three_streams.code_stream, CodeStream)
         assert isinstance(three_streams.docs_stream, DocsStream)
@@ -94,11 +92,11 @@ class TestGitHubFetcherInit:
         with pytest.raises(ValueError):
             GitHubThreeStreamFetcher("https://invalid.com/repo")
 
-    @patch.dict('os.environ', {'GITHUB_TOKEN': 'test_token'})
+    @patch.dict("os.environ", {"GITHUB_TOKEN": "test_token"})
     def test_github_token_from_env(self):
         """Test GitHub token loaded from environment."""
         fetcher = GitHubThreeStreamFetcher("https://github.com/facebook/react")
-        assert fetcher.github_token == 'test_token'
+        assert fetcher.github_token == "test_token"
 
 
 class TestFileClassification:
@@ -148,7 +146,7 @@ class TestFileClassification:
 
     def test_classify_various_code_extensions(self, tmp_path):
         """Test classification of various code file extensions."""
-        extensions = ['.py', '.js', '.ts', '.go', '.rs', '.java', '.kt', '.rb', '.php']
+        extensions = [".py", ".js", ".ts", ".go", ".rs", ".java", ".kt", ".rb", ".php"]
 
         for ext in extensions:
             (tmp_path / f"file{ext}").write_text("code")
@@ -166,77 +164,71 @@ class TestIssueAnalysis:
         """Test extraction of common problems (open issues with 5+ comments)."""
         issues = [
             {
-                'title': 'OAuth fails',
-                'number': 42,
-                'state': 'open',
-                'comments': 10,
-                'labels': [{'name': 'bug'}, {'name': 'oauth'}]
+                "title": "OAuth fails",
+                "number": 42,
+                "state": "open",
+                "comments": 10,
+                "labels": [{"name": "bug"}, {"name": "oauth"}],
             },
             {
-                'title': 'Minor issue',
-                'number': 43,
-                'state': 'open',
-                'comments': 2,  # Too few comments
-                'labels': []
-            }
+                "title": "Minor issue",
+                "number": 43,
+                "state": "open",
+                "comments": 2,  # Too few comments
+                "labels": [],
+            },
         ]
 
         fetcher = GitHubThreeStreamFetcher("https://github.com/test/repo")
         insights = fetcher.analyze_issues(issues)
 
-        assert len(insights['common_problems']) == 1
-        assert insights['common_problems'][0]['number'] == 42
-        assert insights['common_problems'][0]['comments'] == 10
+        assert len(insights["common_problems"]) == 1
+        assert insights["common_problems"][0]["number"] == 42
+        assert insights["common_problems"][0]["comments"] == 10
 
     def test_analyze_issues_known_solutions(self):
         """Test extraction of known solutions (closed issues with comments)."""
         issues = [
+            {"title": "Fixed OAuth", "number": 35, "state": "closed", "comments": 5, "labels": [{"name": "bug"}]},
             {
-                'title': 'Fixed OAuth',
-                'number': 35,
-                'state': 'closed',
-                'comments': 5,
-                'labels': [{'name': 'bug'}]
+                "title": "Closed without comments",
+                "number": 36,
+                "state": "closed",
+                "comments": 0,  # No comments
+                "labels": [],
             },
-            {
-                'title': 'Closed without comments',
-                'number': 36,
-                'state': 'closed',
-                'comments': 0,  # No comments
-                'labels': []
-            }
         ]
 
         fetcher = GitHubThreeStreamFetcher("https://github.com/test/repo")
         insights = fetcher.analyze_issues(issues)
 
-        assert len(insights['known_solutions']) == 1
-        assert insights['known_solutions'][0]['number'] == 35
+        assert len(insights["known_solutions"]) == 1
+        assert insights["known_solutions"][0]["number"] == 35
 
     def test_analyze_issues_top_labels(self):
         """Test counting of top issue labels."""
         issues = [
-            {'state': 'open', 'comments': 5, 'labels': [{'name': 'bug'}, {'name': 'oauth'}]},
-            {'state': 'open', 'comments': 5, 'labels': [{'name': 'bug'}]},
-            {'state': 'closed', 'comments': 3, 'labels': [{'name': 'enhancement'}]}
+            {"state": "open", "comments": 5, "labels": [{"name": "bug"}, {"name": "oauth"}]},
+            {"state": "open", "comments": 5, "labels": [{"name": "bug"}]},
+            {"state": "closed", "comments": 3, "labels": [{"name": "enhancement"}]},
         ]
 
         fetcher = GitHubThreeStreamFetcher("https://github.com/test/repo")
         insights = fetcher.analyze_issues(issues)
 
         # Bug should be top label (appears twice)
-        assert insights['top_labels'][0]['label'] == 'bug'
-        assert insights['top_labels'][0]['count'] == 2
+        assert insights["top_labels"][0]["label"] == "bug"
+        assert insights["top_labels"][0]["count"] == 2
 
     def test_analyze_issues_limits_to_10(self):
         """Test that analysis limits results to top 10."""
         issues = [
             {
-                'title': f'Issue {i}',
-                'number': i,
-                'state': 'open',
-                'comments': 20 - i,  # Descending comment count
-                'labels': []
+                "title": f"Issue {i}",
+                "number": i,
+                "state": "open",
+                "comments": 20 - i,  # Descending comment count
+                "labels": [],
             }
             for i in range(20)
         ]
@@ -244,28 +236,28 @@ class TestIssueAnalysis:
         fetcher = GitHubThreeStreamFetcher("https://github.com/test/repo")
         insights = fetcher.analyze_issues(issues)
 
-        assert len(insights['common_problems']) <= 10
+        assert len(insights["common_problems"]) <= 10
         # Should be sorted by comment count (descending)
-        if len(insights['common_problems']) > 1:
-            assert insights['common_problems'][0]['comments'] >= insights['common_problems'][1]['comments']
+        if len(insights["common_problems"]) > 1:
+            assert insights["common_problems"][0]["comments"] >= insights["common_problems"][1]["comments"]
 
 
 class TestGitHubAPI:
     """Test GitHub API interactions."""
 
-    @patch('requests.get')
+    @patch("requests.get")
     def test_fetch_github_metadata(self, mock_get):
         """Test fetching repository metadata via GitHub API."""
         mock_response = Mock()
         mock_response.json.return_value = {
-            'stargazers_count': 1234,
-            'forks_count': 56,
-            'open_issues_count': 12,
-            'language': 'Python',
-            'description': 'Test repo',
-            'homepage': 'https://example.com',
-            'created_at': '2020-01-01',
-            'updated_at': '2024-01-01'
+            "stargazers_count": 1234,
+            "forks_count": 56,
+            "open_issues_count": 12,
+            "language": "Python",
+            "description": "Test repo",
+            "homepage": "https://example.com",
+            "created_at": "2020-01-01",
+            "updated_at": "2024-01-01",
         }
         mock_response.raise_for_status = Mock()
         mock_get.return_value = mock_response
@@ -273,11 +265,11 @@ class TestGitHubAPI:
         fetcher = GitHubThreeStreamFetcher("https://github.com/test/repo")
         metadata = fetcher.fetch_github_metadata()
 
-        assert metadata['stars'] == 1234
-        assert metadata['forks'] == 56
-        assert metadata['language'] == 'Python'
+        assert metadata["stars"] == 1234
+        assert metadata["forks"] == 56
+        assert metadata["language"] == "Python"
 
-    @patch('requests.get')
+    @patch("requests.get")
     def test_fetch_github_metadata_failure(self, mock_get):
         """Test graceful handling of metadata fetch failure."""
         mock_get.side_effect = Exception("API error")
@@ -286,21 +278,15 @@ class TestGitHubAPI:
         metadata = fetcher.fetch_github_metadata()
 
         # Should return default values instead of crashing
-        assert metadata['stars'] == 0
-        assert metadata['language'] == 'Unknown'
+        assert metadata["stars"] == 0
+        assert metadata["language"] == "Unknown"
 
-    @patch('requests.get')
+    @patch("requests.get")
     def test_fetch_issues(self, mock_get):
         """Test fetching issues via GitHub API."""
         mock_response = Mock()
         mock_response.json.return_value = [
-            {
-                'title': 'Bug',
-                'number': 42,
-                'state': 'open',
-                'comments': 10,
-                'labels': [{'name': 'bug'}]
-            }
+            {"title": "Bug", "number": 42, "state": "open", "comments": 10, "labels": [{"name": "bug"}]}
         ]
         mock_response.raise_for_status = Mock()
         mock_get.return_value = mock_response
@@ -312,13 +298,13 @@ class TestGitHubAPI:
         # Should be called twice (open + closed)
         assert mock_get.call_count == 2
 
-    @patch('requests.get')
+    @patch("requests.get")
     def test_fetch_issues_filters_pull_requests(self, mock_get):
         """Test that pull requests are filtered out of issues."""
         mock_response = Mock()
         mock_response.json.return_value = [
-            {'title': 'Issue', 'number': 42, 'state': 'open', 'comments': 5, 'labels': []},
-            {'title': 'PR', 'number': 43, 'state': 'open', 'comments': 3, 'labels': [], 'pull_request': {}}
+            {"title": "Issue", "number": 42, "state": "open", "comments": 5, "labels": []},
+            {"title": "PR", "number": 43, "state": "open", "comments": 3, "labels": [], "pull_request": {}},
         ]
         mock_response.raise_for_status = Mock()
         mock_get.return_value = mock_response
@@ -327,7 +313,7 @@ class TestGitHubAPI:
         issues = fetcher.fetch_issues(max_issues=100)
 
         # Should only include the issue, not the PR
-        assert all('pull_request' not in issue for issue in issues)
+        assert all("pull_request" not in issue for issue in issues)
 
 
 class TestReadFile:
@@ -354,7 +340,7 @@ class TestReadFile:
         """Test fallback to latin-1 encoding if UTF-8 fails."""
         test_file = tmp_path / "test.txt"
         # Write bytes that are invalid UTF-8 but valid latin-1
-        test_file.write_bytes(b'\xff\xfe')
+        test_file.write_bytes(b"\xff\xfe")
 
         fetcher = GitHubThreeStreamFetcher("https://github.com/test/repo")
         content = fetcher.read_file(test_file)
@@ -366,8 +352,8 @@ class TestReadFile:
 class TestIntegration:
     """Integration tests for complete three-stream fetching."""
 
-    @patch('subprocess.run')
-    @patch('requests.get')
+    @patch("subprocess.run")
+    @patch("requests.get")
     def test_fetch_integration(self, mock_get, mock_run, tmp_path):
         """Test complete fetch() integration."""
         # Mock git clone
@@ -379,24 +365,18 @@ class TestIntegration:
             mock_response = Mock()
             mock_response.raise_for_status = Mock()
 
-            if 'repos/' in url and '/issues' not in url:
+            if "repos/" in url and "/issues" not in url:
                 # Metadata call
                 mock_response.json.return_value = {
-                    'stargazers_count': 1234,
-                    'forks_count': 56,
-                    'open_issues_count': 12,
-                    'language': 'Python'
+                    "stargazers_count": 1234,
+                    "forks_count": 56,
+                    "open_issues_count": 12,
+                    "language": "Python",
                 }
             else:
                 # Issues call
                 mock_response.json.return_value = [
-                    {
-                        'title': 'Test Issue',
-                        'number': 42,
-                        'state': 'open',
-                        'comments': 10,
-                        'labels': [{'name': 'bug'}]
-                    }
+                    {"title": "Test Issue", "number": 42, "state": "open", "comments": 10, "labels": [{"name": "bug"}]}
                 ]
             return mock_response
 
@@ -412,7 +392,7 @@ class TestIntegration:
         fetcher = GitHubThreeStreamFetcher("https://github.com/test/repo")
 
         # Mock clone to use our tmp_path
-        with patch.object(fetcher, 'clone_repo', return_value=repo_dir):
+        with patch.object(fetcher, "clone_repo", return_value=repo_dir):
             three_streams = fetcher.fetch()
 
         # Verify all 3 streams present
@@ -428,5 +408,5 @@ class TestIntegration:
         assert "# README" in three_streams.docs_stream.readme
 
         # Verify insights stream
-        assert three_streams.insights_stream.metadata['stars'] == 1234
+        assert three_streams.insights_stream.metadata["stars"] == 1234
         assert len(three_streams.insights_stream.common_problems) > 0
diff --git a/tests/test_github_scraper.py b/tests/test_github_scraper.py
index 82f3299..ab687b4 100644
--- a/tests/test_github_scraper.py
+++ b/tests/test_github_scraper.py
@@ -14,18 +14,18 @@ Tests cover:
 - Error handling and edge cases
 """
 
-import unittest
-import sys
 import json
-import tempfile
-import shutil
 import os
-from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
+import shutil
+import tempfile
+import unittest
 from datetime import datetime
+from pathlib import Path
+from unittest.mock import Mock, patch
 
 try:
     from github import Github, GithubException
+
     PYGITHUB_AVAILABLE = True
 except ImportError:
     PYGITHUB_AVAILABLE = False
@@ -38,6 +38,7 @@ class TestGitHubScraperInitialization(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
         # Create temporary directory for test output
@@ -46,57 +47,41 @@ class TestGitHubScraperInitialization(unittest.TestCase):
 
     def tearDown(self):
         # Clean up temporary directory
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_init_with_repo_name(self):
         """Test initialization with repository name"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
         scraper = self.GitHubScraper(config)
 
-        self.assertEqual(scraper.repo_name, 'facebook/react')
-        self.assertEqual(scraper.name, 'react')
+        self.assertEqual(scraper.repo_name, "facebook/react")
+        self.assertEqual(scraper.name, "react")
         self.assertIsNotNone(scraper.github)
 
     def test_init_with_token_from_config(self):
         """Test initialization with token from config"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': 'test_token_123'
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": "test_token_123"}
 
-        with patch('skill_seekers.cli.github_scraper.Github') as mock_github:
+        with patch("skill_seekers.cli.github_scraper.Github") as mock_github:
             scraper = self.GitHubScraper(config)
-            mock_github.assert_called_once_with('test_token_123')
+            mock_github.assert_called_once_with("test_token_123")
 
     def test_init_with_token_from_env(self):
         """Test initialization with token from environment variable"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
-        with patch.dict(os.environ, {'GITHUB_TOKEN': 'env_token_456'}):
-            with patch('skill_seekers.cli.github_scraper.Github') as mock_github:
+        with patch.dict(os.environ, {"GITHUB_TOKEN": "env_token_456"}):
+            with patch("skill_seekers.cli.github_scraper.Github") as mock_github:
                 scraper = self.GitHubScraper(config)
-                mock_github.assert_called_once_with('env_token_456')
+                mock_github.assert_called_once_with("env_token_456")
 
     def test_init_without_token(self):
         """Test initialization without authentication"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github') as mock_github:
+        with patch("skill_seekers.cli.github_scraper.Github") as mock_github:
             with patch.dict(os.environ, {}, clear=True):
                 scraper = self.GitHubScraper(config)
                 # Should create unauthenticated client
@@ -104,16 +89,12 @@ class TestGitHubScraperInitialization(unittest.TestCase):
 
     def test_token_priority_env_over_config(self):
         """Test that GITHUB_TOKEN env var takes priority over config"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': 'config_token'
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": "config_token"}
 
-        with patch.dict(os.environ, {'GITHUB_TOKEN': 'env_token'}):
+        with patch.dict(os.environ, {"GITHUB_TOKEN": "env_token"}):
             scraper = self.GitHubScraper(config)
             token = scraper._get_token()
-            self.assertEqual(token, 'env_token')
+            self.assertEqual(token, "env_token")
 
 
 class TestREADMEExtraction(unittest.TestCase):
@@ -123,47 +104,40 @@ class TestREADMEExtraction(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_extract_readme_success(self):
         """Test successful README extraction"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
         mock_content = Mock()
-        mock_content.decoded_content = b'# React\n\nA JavaScript library'
+        mock_content.decoded_content = b"# React\n\nA JavaScript library"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
             scraper._extract_readme()
 
-            self.assertIn('readme', scraper.extracted_data)
-            self.assertEqual(scraper.extracted_data['readme'], '# React\n\nA JavaScript library')
+            self.assertIn("readme", scraper.extracted_data)
+            self.assertEqual(scraper.extracted_data["readme"], "# React\n\nA JavaScript library")
 
     def test_extract_readme_tries_multiple_locations(self):
         """Test that README extraction tries multiple file locations"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
 
             # Make first attempts fail, succeed on third
             def side_effect(path):
-                if path in ['README.md', 'README.rst']:
-                    raise GithubException(404, 'Not found')
+                if path in ["README.md", "README.rst"]:
+                    raise GithubException(404, "Not found")
                 mock_content = Mock()
-                mock_content.decoded_content = b'# README'
+                mock_content.decoded_content = b"# README"
                 return mock_content
 
             scraper.repo.get_contents.side_effect = side_effect
@@ -175,21 +149,17 @@ class TestREADMEExtraction(unittest.TestCase):
 
     def test_extract_readme_not_found(self):
         """Test README extraction when no README exists"""
-        config = {
-            'repo': 'test/norepo',
-            'name': 'norepo',
-            'github_token': None
-        }
+        config = {"repo": "test/norepo", "name": "norepo", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
-            scraper.repo.get_contents.side_effect = GithubException(404, 'Not found')
+            scraper.repo.get_contents.side_effect = GithubException(404, "Not found")
 
             scraper._extract_readme()
 
             # Should not crash, just log warning (readme initialized as empty string)
-            self.assertEqual(scraper.extracted_data['readme'], '')
+            self.assertEqual(scraper.extracted_data["readme"], "")
 
 
 class TestLanguageDetection(unittest.TestCase):
@@ -199,56 +169,46 @@ class TestLanguageDetection(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_extract_languages_success(self):
         """Test successful language detection"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
-            scraper.repo.get_languages.return_value = {
-                'JavaScript': 8000,
-                'TypeScript': 2000
-            }
+            scraper.repo.get_languages.return_value = {"JavaScript": 8000, "TypeScript": 2000}
 
             scraper._extract_languages()
 
-            self.assertIn('languages', scraper.extracted_data)
-            self.assertIn('JavaScript', scraper.extracted_data['languages'])
-            self.assertIn('TypeScript', scraper.extracted_data['languages'])
+            self.assertIn("languages", scraper.extracted_data)
+            self.assertIn("JavaScript", scraper.extracted_data["languages"])
+            self.assertIn("TypeScript", scraper.extracted_data["languages"])
 
             # Check percentages
-            js_data = scraper.extracted_data['languages']['JavaScript']
-            self.assertEqual(js_data['bytes'], 8000)
-            self.assertEqual(js_data['percentage'], 80.0)
+            js_data = scraper.extracted_data["languages"]["JavaScript"]
+            self.assertEqual(js_data["bytes"], 8000)
+            self.assertEqual(js_data["percentage"], 80.0)
 
-            ts_data = scraper.extracted_data['languages']['TypeScript']
-            self.assertEqual(ts_data['bytes'], 2000)
-            self.assertEqual(ts_data['percentage'], 20.0)
+            ts_data = scraper.extracted_data["languages"]["TypeScript"]
+            self.assertEqual(ts_data["bytes"], 2000)
+            self.assertEqual(ts_data["percentage"], 20.0)
 
     def test_extract_languages_empty(self):
         """Test language detection with no languages"""
-        config = {
-            'repo': 'test/norepo',
-            'name': 'norepo',
-            'github_token': None
-        }
+        config = {"repo": "test/norepo", "name": "norepo", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_languages.return_value = {}
 
             scraper._extract_languages()
 
-            self.assertIn('languages', scraper.extracted_data)
-            self.assertEqual(scraper.extracted_data['languages'], {})
+            self.assertIn("languages", scraper.extracted_data)
+            self.assertEqual(scraper.extracted_data["languages"], {})
 
 
 class TestIssuesExtraction(unittest.TestCase):
@@ -258,152 +218,138 @@ class TestIssuesExtraction(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_extract_issues_success(self):
         """Test successful issues extraction"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None,
-            'max_issues': 10
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None, "max_issues": 10}
 
         # Create mock issues
         mock_label1 = Mock()
-        mock_label1.name = 'bug'
+        mock_label1.name = "bug"
         mock_label2 = Mock()
-        mock_label2.name = 'high-priority'
+        mock_label2.name = "high-priority"
 
         mock_milestone = Mock()
-        mock_milestone.title = 'v18.0'
+        mock_milestone.title = "v18.0"
 
         mock_issue1 = Mock()
         mock_issue1.number = 123
-        mock_issue1.title = 'Bug in useState'
-        mock_issue1.state = 'open'
+        mock_issue1.title = "Bug in useState"
+        mock_issue1.state = "open"
         mock_issue1.labels = [mock_label1, mock_label2]
         mock_issue1.milestone = mock_milestone
         mock_issue1.created_at = datetime(2023, 1, 1)
         mock_issue1.updated_at = datetime(2023, 1, 2)
         mock_issue1.closed_at = None
-        mock_issue1.html_url = 'https://github.com/facebook/react/issues/123'
-        mock_issue1.body = 'Issue description'
+        mock_issue1.html_url = "https://github.com/facebook/react/issues/123"
+        mock_issue1.body = "Issue description"
         mock_issue1.pull_request = None
 
         mock_label3 = Mock()
-        mock_label3.name = 'enhancement'
+        mock_label3.name = "enhancement"
 
         mock_issue2 = Mock()
         mock_issue2.number = 124
-        mock_issue2.title = 'Feature request'
-        mock_issue2.state = 'closed'
+        mock_issue2.title = "Feature request"
+        mock_issue2.state = "closed"
         mock_issue2.labels = [mock_label3]
         mock_issue2.milestone = None
         mock_issue2.created_at = datetime(2023, 1, 3)
         mock_issue2.updated_at = datetime(2023, 1, 4)
         mock_issue2.closed_at = datetime(2023, 1, 5)
-        mock_issue2.html_url = 'https://github.com/facebook/react/issues/124'
-        mock_issue2.body = 'Feature description'
+        mock_issue2.html_url = "https://github.com/facebook/react/issues/124"
+        mock_issue2.body = "Feature description"
         mock_issue2.pull_request = None
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_issues.return_value = [mock_issue1, mock_issue2]
 
             scraper._extract_issues()
 
-            self.assertIn('issues', scraper.extracted_data)
-            issues = scraper.extracted_data['issues']
+            self.assertIn("issues", scraper.extracted_data)
+            issues = scraper.extracted_data["issues"]
             self.assertEqual(len(issues), 2)
 
             # Check first issue
-            self.assertEqual(issues[0]['number'], 123)
-            self.assertEqual(issues[0]['title'], 'Bug in useState')
-            self.assertEqual(issues[0]['state'], 'open')
-            self.assertEqual(issues[0]['labels'], ['bug', 'high-priority'])
-            self.assertEqual(issues[0]['milestone'], 'v18.0')
+            self.assertEqual(issues[0]["number"], 123)
+            self.assertEqual(issues[0]["title"], "Bug in useState")
+            self.assertEqual(issues[0]["state"], "open")
+            self.assertEqual(issues[0]["labels"], ["bug", "high-priority"])
+            self.assertEqual(issues[0]["milestone"], "v18.0")
 
             # Check second issue
-            self.assertEqual(issues[1]['number'], 124)
-            self.assertEqual(issues[1]['state'], 'closed')
-            self.assertIsNone(issues[1]['milestone'])
+            self.assertEqual(issues[1]["number"], 124)
+            self.assertEqual(issues[1]["state"], "closed")
+            self.assertIsNone(issues[1]["milestone"])
 
     def test_extract_issues_filters_pull_requests(self):
         """Test that pull requests are filtered out from issues"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None,
-            'max_issues': 10
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None, "max_issues": 10}
 
         # Create mock issue (need all required attributes)
         mock_issue = Mock()
         mock_issue.number = 123
-        mock_issue.title = 'Real issue'
-        mock_issue.state = 'open'
+        mock_issue.title = "Real issue"
+        mock_issue.state = "open"
         mock_issue.labels = []
         mock_issue.milestone = None
         mock_issue.created_at = datetime(2023, 1, 1)
         mock_issue.updated_at = datetime(2023, 1, 2)
         mock_issue.closed_at = None
-        mock_issue.html_url = 'https://github.com/test/repo/issues/123'
-        mock_issue.body = 'Issue body'
+        mock_issue.html_url = "https://github.com/test/repo/issues/123"
+        mock_issue.body = "Issue body"
         mock_issue.pull_request = None
 
         mock_pr = Mock()
         mock_pr.number = 124
-        mock_pr.title = 'Pull request'
+        mock_pr.title = "Pull request"
         mock_pr.pull_request = Mock()  # Has pull_request attribute
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_issues.return_value = [mock_issue, mock_pr]
 
             scraper._extract_issues()
 
-            issues = scraper.extracted_data['issues']
+            issues = scraper.extracted_data["issues"]
             # Should only have the real issue, not the PR
             self.assertEqual(len(issues), 1)
-            self.assertEqual(issues[0]['number'], 123)
+            self.assertEqual(issues[0]["number"], 123)
 
     def test_extract_issues_respects_max_limit(self):
         """Test that max_issues limit is respected"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None,
-            'max_issues': 2
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None, "max_issues": 2}
 
         # Create 5 mock issues
         mock_issues = []
         for i in range(5):
             mock_issue = Mock()
             mock_issue.number = i
-            mock_issue.title = f'Issue {i}'
-            mock_issue.state = 'open'
+            mock_issue.title = f"Issue {i}"
+            mock_issue.state = "open"
             mock_issue.labels = []
             mock_issue.milestone = None
             mock_issue.created_at = datetime(2023, 1, 1)
             mock_issue.updated_at = datetime(2023, 1, 2)
             mock_issue.closed_at = None
-            mock_issue.html_url = f'https://github.com/test/repo/issues/{i}'
+            mock_issue.html_url = f"https://github.com/test/repo/issues/{i}"
             mock_issue.body = None
             mock_issue.pull_request = None
             mock_issues.append(mock_issue)
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_issues.return_value = mock_issues
 
             scraper._extract_issues()
 
-            issues = scraper.extracted_data['issues']
+            issues = scraper.extracted_data["issues"]
             # Should only extract first 2 issues
             self.assertEqual(len(issues), 2)
 
@@ -415,50 +361,43 @@ class TestChangelogExtraction(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_extract_changelog_success(self):
         """Test successful CHANGELOG extraction"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
         mock_content = Mock()
-        mock_content.decoded_content = b'# Changelog\n\n## v1.0.0\n- Initial release'
+        mock_content.decoded_content = b"# Changelog\n\n## v1.0.0\n- Initial release"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
             scraper._extract_changelog()
 
-            self.assertIn('changelog', scraper.extracted_data)
-            self.assertIn('Initial release', scraper.extracted_data['changelog'])
+            self.assertIn("changelog", scraper.extracted_data)
+            self.assertIn("Initial release", scraper.extracted_data["changelog"])
 
     def test_extract_changelog_tries_multiple_locations(self):
         """Test that CHANGELOG extraction tries multiple file locations"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
 
             # Make first attempts fail
-            call_count = {'count': 0}
+            call_count = {"count": 0}
 
             def side_effect(path):
-                call_count['count'] += 1
-                if path in ['CHANGELOG.md', 'CHANGES.md']:
-                    raise GithubException(404, 'Not found')
+                call_count["count"] += 1
+                if path in ["CHANGELOG.md", "CHANGES.md"]:
+                    raise GithubException(404, "Not found")
                 mock_content = Mock()
-                mock_content.decoded_content = b'# History'
+                mock_content.decoded_content = b"# History"
                 return mock_content
 
             scraper.repo.get_contents.side_effect = side_effect
@@ -466,25 +405,21 @@ class TestChangelogExtraction(unittest.TestCase):
             scraper._extract_changelog()
 
             # Should have tried multiple paths
-            self.assertGreaterEqual(call_count['count'], 1)
+            self.assertGreaterEqual(call_count["count"], 1)
 
     def test_extract_changelog_not_found(self):
         """Test CHANGELOG extraction when no changelog exists"""
-        config = {
-            'repo': 'test/norepo',
-            'name': 'norepo',
-            'github_token': None
-        }
+        config = {"repo": "test/norepo", "name": "norepo", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
-            scraper.repo.get_contents.side_effect = GithubException(404, 'Not found')
+            scraper.repo.get_contents.side_effect = GithubException(404, "Not found")
 
             scraper._extract_changelog()
 
             # Should not crash, just log warning (changelog initialized as empty string)
-            self.assertEqual(scraper.extracted_data['changelog'], '')
+            self.assertEqual(scraper.extracted_data["changelog"], "")
 
 
 class TestReleasesExtraction(unittest.TestCase):
@@ -494,80 +429,73 @@ class TestReleasesExtraction(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_extract_releases_success(self):
         """Test successful releases extraction"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
         # Create mock releases
         mock_release1 = Mock()
-        mock_release1.tag_name = 'v18.0.0'
-        mock_release1.title = 'React 18.0.0'
-        mock_release1.body = 'New features:\n- Concurrent rendering'
+        mock_release1.tag_name = "v18.0.0"
+        mock_release1.title = "React 18.0.0"
+        mock_release1.body = "New features:\n- Concurrent rendering"
         mock_release1.draft = False
         mock_release1.prerelease = False
         mock_release1.created_at = datetime(2023, 3, 1)
         mock_release1.published_at = datetime(2023, 3, 1)
-        mock_release1.html_url = 'https://github.com/facebook/react/releases/tag/v18.0.0'
-        mock_release1.tarball_url = 'https://github.com/facebook/react/archive/v18.0.0.tar.gz'
-        mock_release1.zipball_url = 'https://github.com/facebook/react/archive/v18.0.0.zip'
+        mock_release1.html_url = "https://github.com/facebook/react/releases/tag/v18.0.0"
+        mock_release1.tarball_url = "https://github.com/facebook/react/archive/v18.0.0.tar.gz"
+        mock_release1.zipball_url = "https://github.com/facebook/react/archive/v18.0.0.zip"
 
         mock_release2 = Mock()
-        mock_release2.tag_name = 'v18.0.0-rc.0'
-        mock_release2.title = 'React 18.0.0 RC'
-        mock_release2.body = 'Release candidate'
+        mock_release2.tag_name = "v18.0.0-rc.0"
+        mock_release2.title = "React 18.0.0 RC"
+        mock_release2.body = "Release candidate"
         mock_release2.draft = False
         mock_release2.prerelease = True
         mock_release2.created_at = datetime(2023, 2, 1)
         mock_release2.published_at = datetime(2023, 2, 1)
-        mock_release2.html_url = 'https://github.com/facebook/react/releases/tag/v18.0.0-rc.0'
-        mock_release2.tarball_url = 'https://github.com/facebook/react/archive/v18.0.0-rc.0.tar.gz'
-        mock_release2.zipball_url = 'https://github.com/facebook/react/archive/v18.0.0-rc.0.zip'
+        mock_release2.html_url = "https://github.com/facebook/react/releases/tag/v18.0.0-rc.0"
+        mock_release2.tarball_url = "https://github.com/facebook/react/archive/v18.0.0-rc.0.tar.gz"
+        mock_release2.zipball_url = "https://github.com/facebook/react/archive/v18.0.0-rc.0.zip"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_releases.return_value = [mock_release1, mock_release2]
 
             scraper._extract_releases()
 
-            self.assertIn('releases', scraper.extracted_data)
-            releases = scraper.extracted_data['releases']
+            self.assertIn("releases", scraper.extracted_data)
+            releases = scraper.extracted_data["releases"]
             self.assertEqual(len(releases), 2)
 
             # Check first release
-            self.assertEqual(releases[0]['tag_name'], 'v18.0.0')
-            self.assertEqual(releases[0]['name'], 'React 18.0.0')
-            self.assertFalse(releases[0]['draft'])
-            self.assertFalse(releases[0]['prerelease'])
-            self.assertIn('Concurrent rendering', releases[0]['body'])
+            self.assertEqual(releases[0]["tag_name"], "v18.0.0")
+            self.assertEqual(releases[0]["name"], "React 18.0.0")
+            self.assertFalse(releases[0]["draft"])
+            self.assertFalse(releases[0]["prerelease"])
+            self.assertIn("Concurrent rendering", releases[0]["body"])
 
             # Check second release (prerelease)
-            self.assertEqual(releases[1]['tag_name'], 'v18.0.0-rc.0')
-            self.assertTrue(releases[1]['prerelease'])
+            self.assertEqual(releases[1]["tag_name"], "v18.0.0-rc.0")
+            self.assertTrue(releases[1]["prerelease"])
 
     def test_extract_releases_empty(self):
         """Test releases extraction with no releases"""
-        config = {
-            'repo': 'test/norepo',
-            'name': 'norepo',
-            'github_token': None
-        }
+        config = {"repo": "test/norepo", "name": "norepo", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_releases.return_value = []
 
             scraper._extract_releases()
 
-            self.assertIn('releases', scraper.extracted_data)
-            self.assertEqual(scraper.extracted_data['releases'], [])
+            self.assertIn("releases", scraper.extracted_data)
+            self.assertEqual(scraper.extracted_data["releases"], [])
 
 
 class TestGitHubToSkillConverter(unittest.TestCase):
@@ -577,6 +505,7 @@ class TestGitHubToSkillConverter(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubToSkillConverter
+
         self.GitHubToSkillConverter = GitHubToSkillConverter
 
         # Create temporary directory for test output
@@ -586,98 +515,90 @@ class TestGitHubToSkillConverter(unittest.TestCase):
         # Create mock data file
         self.data_file = self.output_dir / "test_github_data.json"
         self.mock_data = {
-            'repo_info': {
-                'name': 'react',
-                'full_name': 'facebook/react',
-                'description': 'A JavaScript library',
-                'stars': 200000,
-                'language': 'JavaScript'
+            "repo_info": {
+                "name": "react",
+                "full_name": "facebook/react",
+                "description": "A JavaScript library",
+                "stars": 200000,
+                "language": "JavaScript",
             },
-            'readme': '# React\n\nA JavaScript library for building user interfaces.',
-            'languages': {
-                'JavaScript': {'bytes': 8000, 'percentage': 80.0},
-                'TypeScript': {'bytes': 2000, 'percentage': 20.0}
+            "readme": "# React\n\nA JavaScript library for building user interfaces.",
+            "languages": {
+                "JavaScript": {"bytes": 8000, "percentage": 80.0},
+                "TypeScript": {"bytes": 2000, "percentage": 20.0},
             },
-            'issues': [
+            "issues": [
                 {
-                    'number': 123,
-                    'title': 'Bug in useState',
-                    'state': 'open',
-                    'labels': ['bug'],
-                    'milestone': 'v18.0',
-                    'created_at': '2023-01-01T10:00:00',
-                    'updated_at': '2023-01-02T10:00:00',
-                    'closed_at': None,
-                    'url': 'https://github.com/facebook/react/issues/123',
-                    'body': 'Issue description'
+                    "number": 123,
+                    "title": "Bug in useState",
+                    "state": "open",
+                    "labels": ["bug"],
+                    "milestone": "v18.0",
+                    "created_at": "2023-01-01T10:00:00",
+                    "updated_at": "2023-01-02T10:00:00",
+                    "closed_at": None,
+                    "url": "https://github.com/facebook/react/issues/123",
+                    "body": "Issue description",
                 }
             ],
-            'changelog': '# Changelog\n\n## v18.0.0\n- New features',
-            'releases': [
+            "changelog": "# Changelog\n\n## v18.0.0\n- New features",
+            "releases": [
                 {
-                    'tag_name': 'v18.0.0',
-                    'name': 'React 18.0.0',
-                    'body': 'Release notes',
-                    'published_at': '2023-03-01T10:00:00',
-                    'prerelease': False,
-                    'draft': False,
-                    'url': 'https://github.com/facebook/react/releases/tag/v18.0.0'
+                    "tag_name": "v18.0.0",
+                    "name": "React 18.0.0",
+                    "body": "Release notes",
+                    "published_at": "2023-03-01T10:00:00",
+                    "prerelease": False,
+                    "draft": False,
+                    "url": "https://github.com/facebook/react/releases/tag/v18.0.0",
                 }
-            ]
+            ],
         }
 
-        with open(self.data_file, 'w') as f:
+        with open(self.data_file, "w") as f:
             json.dump(self.mock_data, f)
 
     def tearDown(self):
         # Clean up temporary directory
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_init_loads_data(self):
         """Test that converter loads data file on initialization"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'test',
-            'description': 'Test skill'
-        }
+        config = {"repo": "facebook/react", "name": "test", "description": "Test skill"}
 
         # Override data file path
-        with patch('skill_seekers.cli.github_scraper.GitHubToSkillConverter.__init__') as mock_init:
+        with patch("skill_seekers.cli.github_scraper.GitHubToSkillConverter.__init__") as mock_init:
             mock_init.return_value = None
             converter = self.GitHubToSkillConverter(config)
             converter.data_file = str(self.data_file)
             converter.data = converter._load_data()
 
-            self.assertIn('repo_info', converter.data)
-            self.assertEqual(converter.data['repo_info']['name'], 'react')
+            self.assertIn("repo_info", converter.data)
+            self.assertEqual(converter.data["repo_info"]["name"], "react")
 
     def test_build_skill_creates_directory_structure(self):
         """Test that build_skill creates proper directory structure"""
         # Create data file in expected location
-        data_file_path = self.output_dir / 'test_github_data.json'
-        with open(data_file_path, 'w') as f:
+        data_file_path = self.output_dir / "test_github_data.json"
+        with open(data_file_path, "w") as f:
             json.dump(self.mock_data, f)
 
-        config = {
-            'repo': 'facebook/react',
-            'name': 'test',
-            'description': 'Test skill'
-        }
+        config = {"repo": "facebook/react", "name": "test", "description": "Test skill"}
 
         # Patch the paths to use our temp directory
-        with patch('skill_seekers.cli.github_scraper.GitHubToSkillConverter._load_data') as mock_load:
+        with patch("skill_seekers.cli.github_scraper.GitHubToSkillConverter._load_data") as mock_load:
             mock_load.return_value = self.mock_data
             converter = self.GitHubToSkillConverter(config)
-            converter.skill_dir = str(self.output_dir / 'test_skill')
+            converter.skill_dir = str(self.output_dir / "test_skill")
             converter.data = self.mock_data
 
             converter.build_skill()
 
             skill_dir = Path(converter.skill_dir)
             self.assertTrue(skill_dir.exists())
-            self.assertTrue((skill_dir / 'SKILL.md').exists())
-            self.assertTrue((skill_dir / 'references').exists())
+            self.assertTrue((skill_dir / "SKILL.md").exists())
+            self.assertTrue((skill_dir / "references").exists())
 
 
 class TestSymlinkHandling(unittest.TestCase):
@@ -687,141 +608,119 @@ class TestSymlinkHandling(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_get_file_content_regular_file(self):
         """Test _get_file_content with regular file"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None}
 
         # Create mock regular file
         mock_content = Mock()
-        mock_content.type = 'file'
-        mock_content.encoding = 'base64'
-        mock_content.decoded_content = b'# React\n\nA JavaScript library'
+        mock_content.type = "file"
+        mock_content.encoding = "base64"
+        mock_content.decoded_content = b"# React\n\nA JavaScript library"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
-            result = scraper._get_file_content('README.md')
+            result = scraper._get_file_content("README.md")
 
-            self.assertEqual(result, '# React\n\nA JavaScript library')
-            scraper.repo.get_contents.assert_called_once_with('README.md')
+            self.assertEqual(result, "# React\n\nA JavaScript library")
+            scraper.repo.get_contents.assert_called_once_with("README.md")
 
     def test_get_file_content_symlink(self):
         """Test _get_file_content with symlink file"""
-        config = {
-            'repo': 'vercel/ai',
-            'name': 'ai',
-            'github_token': None
-        }
+        config = {"repo": "vercel/ai", "name": "ai", "github_token": None}
 
         # Create mock symlink
         mock_symlink = Mock()
-        mock_symlink.type = 'symlink'
+        mock_symlink.type = "symlink"
         mock_symlink.encoding = None
-        mock_symlink.target = 'packages/ai/README.md'
+        mock_symlink.target = "packages/ai/README.md"
 
         # Create mock target file
         mock_target = Mock()
-        mock_target.type = 'file'
-        mock_target.encoding = 'base64'
-        mock_target.decoded_content = b'# AI SDK\n\nReal content from symlink target'
+        mock_target.type = "file"
+        mock_target.encoding = "base64"
+        mock_target.decoded_content = b"# AI SDK\n\nReal content from symlink target"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
 
             # First call returns symlink, second call returns target
             scraper.repo.get_contents.side_effect = [mock_symlink, mock_target]
 
-            result = scraper._get_file_content('README.md')
+            result = scraper._get_file_content("README.md")
 
-            self.assertEqual(result, '# AI SDK\n\nReal content from symlink target')
+            self.assertEqual(result, "# AI SDK\n\nReal content from symlink target")
             # Should have called get_contents twice: once for symlink, once for target
             self.assertEqual(scraper.repo.get_contents.call_count, 2)
-            scraper.repo.get_contents.assert_any_call('README.md')
-            scraper.repo.get_contents.assert_any_call('packages/ai/README.md')
+            scraper.repo.get_contents.assert_any_call("README.md")
+            scraper.repo.get_contents.assert_any_call("packages/ai/README.md")
 
     def test_get_file_content_broken_symlink(self):
         """Test _get_file_content with broken symlink"""
-        config = {
-            'repo': 'test/repo',
-            'name': 'test',
-            'github_token': None
-        }
+        config = {"repo": "test/repo", "name": "test", "github_token": None}
 
         # Create mock symlink with broken target
         mock_symlink = Mock()
-        mock_symlink.type = 'symlink'
+        mock_symlink.type = "symlink"
         mock_symlink.encoding = None
-        mock_symlink.target = 'nonexistent/file.md'
+        mock_symlink.target = "nonexistent/file.md"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
 
             # First call returns symlink, second call raises 404
-            scraper.repo.get_contents.side_effect = [
-                mock_symlink,
-                GithubException(404, 'Not found')
-            ]
+            scraper.repo.get_contents.side_effect = [mock_symlink, GithubException(404, "Not found")]
 
-            result = scraper._get_file_content('README.md')
+            result = scraper._get_file_content("README.md")
 
             # Should return None gracefully
             self.assertIsNone(result)
 
     def test_get_file_content_symlink_no_target(self):
         """Test _get_file_content with symlink that has no target attribute"""
-        config = {
-            'repo': 'test/repo',
-            'name': 'test',
-            'github_token': None
-        }
+        config = {"repo": "test/repo", "name": "test", "github_token": None}
 
         # Create mock symlink without target
         mock_symlink = Mock()
-        mock_symlink.type = 'symlink'
+        mock_symlink.type = "symlink"
         mock_symlink.encoding = None
         mock_symlink.target = None
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_symlink
 
-            result = scraper._get_file_content('README.md')
+            result = scraper._get_file_content("README.md")
 
             # Should return None gracefully
             self.assertIsNone(result)
 
     def test_extract_readme_with_symlink(self):
         """Test README extraction with symlinked README.md (Integration test for Issue #225)"""
-        config = {
-            'repo': 'vercel/ai',
-            'name': 'ai',
-            'github_token': None
-        }
+        config = {"repo": "vercel/ai", "name": "ai", "github_token": None}
 
         # Create mock symlink
         mock_symlink = Mock()
-        mock_symlink.type = 'symlink'
+        mock_symlink.type = "symlink"
         mock_symlink.encoding = None
-        mock_symlink.target = 'packages/ai/README.md'
+        mock_symlink.target = "packages/ai/README.md"
 
         # Create mock target file
         mock_target = Mock()
-        mock_target.type = 'file'
-        mock_target.encoding = 'base64'
-        mock_target.decoded_content = b'# AI SDK\n\nThe AI SDK is a TypeScript toolkit'
+        mock_target.type = "file"
+        mock_target.encoding = "base64"
+        mock_target.decoded_content = b"# AI SDK\n\nThe AI SDK is a TypeScript toolkit"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.side_effect = [mock_symlink, mock_target]
@@ -829,33 +728,26 @@ class TestSymlinkHandling(unittest.TestCase):
             scraper._extract_readme()
 
             # Should successfully extract README content
-            self.assertIn('readme', scraper.extracted_data)
-            self.assertEqual(
-                scraper.extracted_data['readme'],
-                '# AI SDK\n\nThe AI SDK is a TypeScript toolkit'
-            )
+            self.assertIn("readme", scraper.extracted_data)
+            self.assertEqual(scraper.extracted_data["readme"], "# AI SDK\n\nThe AI SDK is a TypeScript toolkit")
 
     def test_extract_changelog_with_symlink(self):
         """Test CHANGELOG extraction with symlinked CHANGELOG.md"""
-        config = {
-            'repo': 'test/repo',
-            'name': 'test',
-            'github_token': None
-        }
+        config = {"repo": "test/repo", "name": "test", "github_token": None}
 
         # Create mock symlink
         mock_symlink = Mock()
-        mock_symlink.type = 'symlink'
+        mock_symlink.type = "symlink"
         mock_symlink.encoding = None
-        mock_symlink.target = 'docs/CHANGELOG.md'
+        mock_symlink.target = "docs/CHANGELOG.md"
 
         # Create mock target file
         mock_target = Mock()
-        mock_target.type = 'file'
-        mock_target.encoding = 'base64'
-        mock_target.decoded_content = b'# Changelog\n\n## v1.0.0\n- Initial release'
+        mock_target.type = "file"
+        mock_target.encoding = "base64"
+        mock_target.decoded_content = b"# Changelog\n\n## v1.0.0\n- Initial release"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.side_effect = [mock_symlink, mock_target]
@@ -863,103 +755,90 @@ class TestSymlinkHandling(unittest.TestCase):
             scraper._extract_changelog()
 
             # Should successfully extract CHANGELOG content
-            self.assertIn('changelog', scraper.extracted_data)
-            self.assertIn('Initial release', scraper.extracted_data['changelog'])
+            self.assertIn("changelog", scraper.extracted_data)
+            self.assertIn("Initial release", scraper.extracted_data["changelog"])
 
     def test_get_file_content_encoding_error(self):
         """Test _get_file_content handles encoding errors gracefully"""
-        config = {
-            'repo': 'test/repo',
-            'name': 'test',
-            'github_token': None
-        }
+        config = {"repo": "test/repo", "name": "test", "github_token": None}
 
         # Create mock file with invalid UTF-8 content
         mock_content = Mock()
-        mock_content.type = 'file'
-        mock_content.encoding = 'base64'
+        mock_content.type = "file"
+        mock_content.encoding = "base64"
         # Mock decoded_content that can't be decoded as UTF-8
-        mock_content.decoded_content = b'\xff\xfe Invalid UTF-8'
+        mock_content.decoded_content = b"\xff\xfe Invalid UTF-8"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
             # Should try latin-1 fallback
-            result = scraper._get_file_content('README.md')
+            result = scraper._get_file_content("README.md")
 
             # Should not crash (will try latin-1 fallback)
             self.assertIsNotNone(result)
 
     def test_get_file_content_large_file(self):
         """Test _get_file_content handles large files with encoding='none' (Issue #219)"""
-        config = {
-            'repo': 'ccxt/ccxt',
-            'name': 'ccxt',
-            'github_token': None
-        }
+        config = {"repo": "ccxt/ccxt", "name": "ccxt", "github_token": None}
 
         # Create mock large file (encoding="none")
         mock_content = Mock()
-        mock_content.type = 'file'
-        mock_content.encoding = 'none'  # Large files have encoding="none"
+        mock_content.type = "file"
+        mock_content.encoding = "none"  # Large files have encoding="none"
         mock_content.size = 1388271  # 1.4MB CHANGELOG
-        mock_content.download_url = 'https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md'
+        mock_content.download_url = "https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
             # Mock requests.get
-            with patch('requests.get') as mock_requests:
+            with patch("requests.get") as mock_requests:
                 mock_response = Mock()
-                mock_response.text = '# Changelog\n\n## v1.0.0\n- Initial release'
+                mock_response.text = "# Changelog\n\n## v1.0.0\n- Initial release"
                 mock_response.raise_for_status = Mock()
                 mock_requests.return_value = mock_response
 
-                result = scraper._get_file_content('CHANGELOG.md')
+                result = scraper._get_file_content("CHANGELOG.md")
 
                 # Should download via download_url
-                self.assertEqual(result, '# Changelog\n\n## v1.0.0\n- Initial release')
+                self.assertEqual(result, "# Changelog\n\n## v1.0.0\n- Initial release")
                 mock_requests.assert_called_once_with(
-                    'https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md',
-                    timeout=30
+                    "https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md", timeout=30
                 )
 
     def test_extract_changelog_large_file(self):
         """Test CHANGELOG extraction with large file (Integration test for Issue #219)"""
-        config = {
-            'repo': 'ccxt/ccxt',
-            'name': 'ccxt',
-            'github_token': None
-        }
+        config = {"repo": "ccxt/ccxt", "name": "ccxt", "github_token": None}
 
         # Create mock large CHANGELOG
         mock_content = Mock()
-        mock_content.type = 'file'
-        mock_content.encoding = 'none'
+        mock_content.type = "file"
+        mock_content.encoding = "none"
         mock_content.size = 1388271
-        mock_content.download_url = 'https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md'
+        mock_content.download_url = "https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
             # Mock requests.get
-            with patch('requests.get') as mock_requests:
+            with patch("requests.get") as mock_requests:
                 mock_response = Mock()
-                mock_response.text = '# CCXT Changelog\n\n## v4.0.0\n- Major update'
+                mock_response.text = "# CCXT Changelog\n\n## v4.0.0\n- Major update"
                 mock_response.raise_for_status = Mock()
                 mock_requests.return_value = mock_response
 
                 scraper._extract_changelog()
 
                 # Should successfully extract CHANGELOG content
-                self.assertIn('changelog', scraper.extracted_data)
-                self.assertIn('Major update', scraper.extracted_data['changelog'])
+                self.assertIn("changelog", scraper.extracted_data)
+                self.assertIn("Major update", scraper.extracted_data["changelog"])
 
 
 class TestGitignoreSupport(unittest.TestCase):
@@ -970,6 +849,7 @@ class TestGitignoreSupport(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
         self.temp_dir = tempfile.mkdtemp()
@@ -982,19 +862,16 @@ class TestGitignoreSupport(unittest.TestCase):
     def test_load_gitignore_exists(self):
         """Test loading existing .gitignore file."""
         # Create .gitignore
-        gitignore_path = self.repo_path / '.gitignore'
-        gitignore_path.write_text('*.log\ntemp/\n__pycache__/')
+        gitignore_path = self.repo_path / ".gitignore"
+        gitignore_path.write_text("*.log\ntemp/\n__pycache__/")
 
-        config = {
-            'repo': 'test/repo',
-            'local_repo_path': str(self.repo_path)
-        }
+        config = {"repo": "test/repo", "local_repo_path": str(self.repo_path)}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
 
             # Should load .gitignore if pathspec available
-            if hasattr(scraper, 'gitignore_spec'):
+            if hasattr(scraper, "gitignore_spec"):
                 # pathspec is installed
                 self.assertIsNotNone(scraper.gitignore_spec)
             else:
@@ -1003,12 +880,9 @@ class TestGitignoreSupport(unittest.TestCase):
 
     def test_load_gitignore_missing(self):
         """Test behavior when no .gitignore exists."""
-        config = {
-            'repo': 'test/repo',
-            'local_repo_path': str(self.repo_path)
-        }
+        config = {"repo": "test/repo", "local_repo_path": str(self.repo_path)}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
 
             # Should be None when no .gitignore found
@@ -1017,43 +891,37 @@ class TestGitignoreSupport(unittest.TestCase):
     def test_should_exclude_dir_with_gitignore(self):
         """Test directory exclusion with .gitignore rules."""
         # Create .gitignore
-        gitignore_path = self.repo_path / '.gitignore'
-        gitignore_path.write_text('temp/\nbuild/\n*.egg-info')
+        gitignore_path = self.repo_path / ".gitignore"
+        gitignore_path.write_text("temp/\nbuild/\n*.egg-info")
 
-        config = {
-            'repo': 'test/repo',
-            'local_repo_path': str(self.repo_path)
-        }
+        config = {"repo": "test/repo", "local_repo_path": str(self.repo_path)}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
 
             # Test .gitignore exclusion (if pathspec available)
             if scraper.gitignore_spec:
-                self.assertTrue(scraper.should_exclude_dir('temp', 'temp'))
-                self.assertTrue(scraper.should_exclude_dir('build', 'build'))
+                self.assertTrue(scraper.should_exclude_dir("temp", "temp"))
+                self.assertTrue(scraper.should_exclude_dir("build", "build"))
 
                 # Non-excluded dir should pass
-                self.assertFalse(scraper.should_exclude_dir('src', 'src'))
+                self.assertFalse(scraper.should_exclude_dir("src", "src"))
 
     def test_should_exclude_dir_default_exclusions(self):
         """Test that default exclusions still work."""
-        config = {
-            'repo': 'test/repo',
-            'local_repo_path': str(self.repo_path)
-        }
+        config = {"repo": "test/repo", "local_repo_path": str(self.repo_path)}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
 
             # Default exclusions should still work
-            self.assertTrue(scraper.should_exclude_dir('node_modules'))
-            self.assertTrue(scraper.should_exclude_dir('venv'))
-            self.assertTrue(scraper.should_exclude_dir('__pycache__'))
+            self.assertTrue(scraper.should_exclude_dir("node_modules"))
+            self.assertTrue(scraper.should_exclude_dir("venv"))
+            self.assertTrue(scraper.should_exclude_dir("__pycache__"))
 
             # Normal directories should not be excluded
-            self.assertFalse(scraper.should_exclude_dir('src'))
-            self.assertFalse(scraper.should_exclude_dir('tests'))
+            self.assertFalse(scraper.should_exclude_dir("src"))
+            self.assertFalse(scraper.should_exclude_dir("tests"))
 
 
 class TestErrorHandling(unittest.TestCase):
@@ -1063,45 +931,37 @@ class TestErrorHandling(unittest.TestCase):
         if not PYGITHUB_AVAILABLE:
             self.skipTest("PyGithub not installed")
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_invalid_repo_name(self):
         """Test handling of invalid repository name"""
-        config = {
-            'repo': 'invalid_repo_format',
-            'name': 'test',
-            'github_token': None
-        }
+        config = {"repo": "invalid_repo_format", "name": "test", "github_token": None}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = None
-            scraper.github.get_repo = Mock(side_effect=GithubException(404, 'Not found'))
+            scraper.github.get_repo = Mock(side_effect=GithubException(404, "Not found"))
 
             # Should raise ValueError with helpful message
             with self.assertRaises(ValueError) as context:
                 scraper._fetch_repository()
 
-            self.assertIn('Repository not found', str(context.exception))
+            self.assertIn("Repository not found", str(context.exception))
 
     def test_rate_limit_error(self):
         """Test handling of rate limit errors"""
-        config = {
-            'repo': 'facebook/react',
-            'name': 'react',
-            'github_token': None,
-            'max_issues': 10
-        }
+        config = {"repo": "facebook/react", "name": "react", "github_token": None, "max_issues": 10}
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
-            scraper.repo.get_issues.side_effect = GithubException(403, 'Rate limit exceeded')
+            scraper.repo.get_issues.side_effect = GithubException(403, "Rate limit exceeded")
 
             # Should handle gracefully and log warning
             scraper._extract_issues()
             # Should not crash, just log warning
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_guide_enhancer.py b/tests/test_guide_enhancer.py
index cb042d0..f5a50b3 100644
--- a/tests/test_guide_enhancer.py
+++ b/tests/test_guide_enhancer.py
@@ -11,16 +11,11 @@ Tests dual-mode AI enhancement for how-to guides:
 
 import json
 import os
-import pytest
-from unittest.mock import Mock, patch, MagicMock
-from pathlib import Path
+from unittest.mock import MagicMock, Mock, patch
 
-from skill_seekers.cli.guide_enhancer import (
-    GuideEnhancer,
-    PrerequisiteItem,
-    TroubleshootingItem,
-    StepEnhancement
-)
+import pytest
+
+from skill_seekers.cli.guide_enhancer import GuideEnhancer, PrerequisiteItem, StepEnhancement, TroubleshootingItem
 
 
 class TestGuideEnhancerModeDetection:
@@ -28,43 +23,43 @@ class TestGuideEnhancerModeDetection:
 
     def test_auto_mode_with_api_key(self):
         """Test auto mode detects API when key present and library available"""
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'sk-ant-test'}):
-            with patch('skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE', True):
-                with patch('skill_seekers.cli.guide_enhancer.anthropic', create=True) as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "sk-ant-test"}):
+            with patch("skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE", True):
+                with patch("skill_seekers.cli.guide_enhancer.anthropic", create=True) as mock_anthropic:
                     mock_anthropic.Anthropic = Mock()
-                    enhancer = GuideEnhancer(mode='auto')
+                    enhancer = GuideEnhancer(mode="auto")
                     # Will be 'api' if library available, otherwise 'local' or 'none'
-                    assert enhancer.mode in ['api', 'local', 'none']
+                    assert enhancer.mode in ["api", "local", "none"]
 
     def test_auto_mode_without_api_key(self):
         """Test auto mode falls back to LOCAL when no API key"""
         with patch.dict(os.environ, {}, clear=True):
-            if 'ANTHROPIC_API_KEY' in os.environ:
-                del os.environ['ANTHROPIC_API_KEY']
+            if "ANTHROPIC_API_KEY" in os.environ:
+                del os.environ["ANTHROPIC_API_KEY"]
 
-            enhancer = GuideEnhancer(mode='auto')
-            assert enhancer.mode in ['local', 'none']
+            enhancer = GuideEnhancer(mode="auto")
+            assert enhancer.mode in ["local", "none"]
 
     def test_explicit_api_mode(self):
         """Test explicit API mode"""
-        enhancer = GuideEnhancer(mode='api')
-        assert enhancer.mode in ['api', 'none']  # none if no API key
+        enhancer = GuideEnhancer(mode="api")
+        assert enhancer.mode in ["api", "none"]  # none if no API key
 
     def test_explicit_local_mode(self):
         """Test explicit LOCAL mode"""
-        enhancer = GuideEnhancer(mode='local')
-        assert enhancer.mode in ['local', 'none']  # none if no claude CLI
+        enhancer = GuideEnhancer(mode="local")
+        assert enhancer.mode in ["local", "none"]  # none if no claude CLI
 
     def test_explicit_none_mode(self):
         """Test explicit none mode"""
-        enhancer = GuideEnhancer(mode='none')
-        assert enhancer.mode == 'none'
+        enhancer = GuideEnhancer(mode="none")
+        assert enhancer.mode == "none"
 
     def test_claude_cli_check(self):
         """Test Claude CLI availability check"""
-        enhancer = GuideEnhancer(mode='local')
+        enhancer = GuideEnhancer(mode="local")
         # Should either detect claude or fall back to api/none
-        assert enhancer.mode in ['local', 'api', 'none']
+        assert enhancer.mode in ["local", "api", "none"]
 
 
 class TestGuideEnhancerStepDescriptions:
@@ -72,58 +67,58 @@ class TestGuideEnhancerStepDescriptions:
 
     def test_enhance_step_descriptions_empty_list(self):
         """Test with empty steps list"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
         steps = []
         result = enhancer.enhance_step_descriptions(steps)
         assert result == []
 
     def test_enhance_step_descriptions_none_mode(self):
         """Test step descriptions in none mode returns empty"""
-        enhancer = GuideEnhancer(mode='none')
-        steps = [
-            {'description': 'scraper.scrape(url)', 'code': 'result = scraper.scrape(url)'}
-        ]
+        enhancer = GuideEnhancer(mode="none")
+        steps = [{"description": "scraper.scrape(url)", "code": "result = scraper.scrape(url)"}]
         result = enhancer.enhance_step_descriptions(steps)
         assert result == []
 
-    @patch.object(GuideEnhancer, '_call_claude_api')
+    @patch.object(GuideEnhancer, "_call_claude_api")
     def test_enhance_step_descriptions_api_mode(self, mock_call):
         """Test step descriptions with API mode"""
-        mock_call.return_value = json.dumps({
-            'step_descriptions': [
-                {
-                    'step_index': 0,
-                    'explanation': 'Initialize the scraper with the target URL',
-                    'variations': ['Use async scraper for better performance']
-                }
-            ]
-        })
+        mock_call.return_value = json.dumps(
+            {
+                "step_descriptions": [
+                    {
+                        "step_index": 0,
+                        "explanation": "Initialize the scraper with the target URL",
+                        "variations": ["Use async scraper for better performance"],
+                    }
+                ]
+            }
+        )
 
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'sk-ant-test'}):
-            with patch('skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE', True):
-                with patch('skill_seekers.cli.guide_enhancer.anthropic', create=True) as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "sk-ant-test"}):
+            with patch("skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE", True):
+                with patch("skill_seekers.cli.guide_enhancer.anthropic", create=True) as mock_anthropic:
                     mock_anthropic.Anthropic = Mock()
-                    enhancer = GuideEnhancer(mode='api')
-                    if enhancer.mode != 'api':
+                    enhancer = GuideEnhancer(mode="api")
+                    if enhancer.mode != "api":
                         pytest.skip("API mode not available")
 
                     enhancer.client = Mock()  # Mock the client
 
-                    steps = [{'description': 'scraper.scrape(url)', 'code': 'result = scraper.scrape(url)'}]
+                    steps = [{"description": "scraper.scrape(url)", "code": "result = scraper.scrape(url)"}]
                     result = enhancer.enhance_step_descriptions(steps)
 
                     assert len(result) == 1
                     assert isinstance(result[0], StepEnhancement)
                     assert result[0].step_index == 0
-                    assert 'Initialize' in result[0].explanation
+                    assert "Initialize" in result[0].explanation
                     assert len(result[0].variations) == 1
 
     def test_enhance_step_descriptions_malformed_json(self):
         """Test handling of malformed JSON response"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
-        with patch.object(enhancer, '_call_ai', return_value='invalid json'):
-            steps = [{'description': 'test', 'code': 'code'}]
+        with patch.object(enhancer, "_call_ai", return_value="invalid json"):
+            steps = [{"description": "test", "code": "code"}]
             result = enhancer.enhance_step_descriptions(steps)
             assert result == []
 
@@ -133,52 +128,50 @@ class TestGuideEnhancerTroubleshooting:
 
     def test_enhance_troubleshooting_none_mode(self):
         """Test troubleshooting in none mode"""
-        enhancer = GuideEnhancer(mode='none')
-        guide_data = {
-            'title': 'Test Guide',
-            'steps': [{'description': 'test', 'code': 'code'}],
-            'language': 'python'
-        }
+        enhancer = GuideEnhancer(mode="none")
+        guide_data = {"title": "Test Guide", "steps": [{"description": "test", "code": "code"}], "language": "python"}
         result = enhancer.enhance_troubleshooting(guide_data)
         assert result == []
 
-    @patch.object(GuideEnhancer, '_call_claude_api')
+    @patch.object(GuideEnhancer, "_call_claude_api")
     def test_enhance_troubleshooting_api_mode(self, mock_call):
         """Test troubleshooting with API mode"""
-        mock_call.return_value = json.dumps({
-            'troubleshooting': [
-                {
-                    'problem': 'ImportError: No module named requests',
-                    'symptoms': ['Import fails', 'Module not found error'],
-                    'diagnostic_steps': ['Check pip list', 'Verify virtual env'],
-                    'solution': 'Run: pip install requests'
-                }
-            ]
-        })
+        mock_call.return_value = json.dumps(
+            {
+                "troubleshooting": [
+                    {
+                        "problem": "ImportError: No module named requests",
+                        "symptoms": ["Import fails", "Module not found error"],
+                        "diagnostic_steps": ["Check pip list", "Verify virtual env"],
+                        "solution": "Run: pip install requests",
+                    }
+                ]
+            }
+        )
 
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'sk-ant-test'}):
-            with patch('skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE', True):
-                with patch('skill_seekers.cli.guide_enhancer.anthropic', create=True) as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "sk-ant-test"}):
+            with patch("skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE", True):
+                with patch("skill_seekers.cli.guide_enhancer.anthropic", create=True) as mock_anthropic:
                     mock_anthropic.Anthropic = Mock()
-                    enhancer = GuideEnhancer(mode='api')
-                    if enhancer.mode != 'api':
+                    enhancer = GuideEnhancer(mode="api")
+                    if enhancer.mode != "api":
                         pytest.skip("API mode not available")
 
                     enhancer.client = Mock()
 
                     guide_data = {
-                        'title': 'Test Guide',
-                        'steps': [{'description': 'import requests', 'code': 'import requests'}],
-                        'language': 'python'
+                        "title": "Test Guide",
+                        "steps": [{"description": "import requests", "code": "import requests"}],
+                        "language": "python",
                     }
                     result = enhancer.enhance_troubleshooting(guide_data)
 
                     assert len(result) == 1
                     assert isinstance(result[0], TroubleshootingItem)
-                    assert 'ImportError' in result[0].problem
+                    assert "ImportError" in result[0].problem
                     assert len(result[0].symptoms) == 2
                     assert len(result[0].diagnostic_steps) == 2
-                    assert 'pip install' in result[0].solution
+                    assert "pip install" in result[0].solution
 
 
 class TestGuideEnhancerPrerequisites:
@@ -186,53 +179,51 @@ class TestGuideEnhancerPrerequisites:
 
     def test_enhance_prerequisites_empty_list(self):
         """Test with empty prerequisites"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
         result = enhancer.enhance_prerequisites([])
         assert result == []
 
     def test_enhance_prerequisites_none_mode(self):
         """Test prerequisites in none mode"""
-        enhancer = GuideEnhancer(mode='none')
-        prereqs = ['requests', 'beautifulsoup4']
+        enhancer = GuideEnhancer(mode="none")
+        prereqs = ["requests", "beautifulsoup4"]
         result = enhancer.enhance_prerequisites(prereqs)
         assert result == []
 
-    @patch.object(GuideEnhancer, '_call_claude_api')
+    @patch.object(GuideEnhancer, "_call_claude_api")
     def test_enhance_prerequisites_api_mode(self, mock_call):
         """Test prerequisites with API mode"""
-        mock_call.return_value = json.dumps({
-            'prerequisites_detailed': [
-                {
-                    'name': 'requests',
-                    'why': 'HTTP client for making web requests',
-                    'setup': 'pip install requests'
-                },
-                {
-                    'name': 'beautifulsoup4',
-                    'why': 'HTML/XML parser for web scraping',
-                    'setup': 'pip install beautifulsoup4'
-                }
-            ]
-        })
+        mock_call.return_value = json.dumps(
+            {
+                "prerequisites_detailed": [
+                    {"name": "requests", "why": "HTTP client for making web requests", "setup": "pip install requests"},
+                    {
+                        "name": "beautifulsoup4",
+                        "why": "HTML/XML parser for web scraping",
+                        "setup": "pip install beautifulsoup4",
+                    },
+                ]
+            }
+        )
 
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'sk-ant-test'}):
-            with patch('skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE', True):
-                with patch('skill_seekers.cli.guide_enhancer.anthropic', create=True) as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "sk-ant-test"}):
+            with patch("skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE", True):
+                with patch("skill_seekers.cli.guide_enhancer.anthropic", create=True) as mock_anthropic:
                     mock_anthropic.Anthropic = Mock()
-                    enhancer = GuideEnhancer(mode='api')
-                    if enhancer.mode != 'api':
+                    enhancer = GuideEnhancer(mode="api")
+                    if enhancer.mode != "api":
                         pytest.skip("API mode not available")
 
                     enhancer.client = Mock()
 
-                    prereqs = ['requests', 'beautifulsoup4']
+                    prereqs = ["requests", "beautifulsoup4"]
                     result = enhancer.enhance_prerequisites(prereqs)
 
                     assert len(result) == 2
                     assert isinstance(result[0], PrerequisiteItem)
-                    assert result[0].name == 'requests'
-                    assert 'HTTP client' in result[0].why
-                    assert 'pip install' in result[0].setup
+                    assert result[0].name == "requests"
+                    assert "HTTP client" in result[0].why
+                    assert "pip install" in result[0].setup
 
 
 class TestGuideEnhancerNextSteps:
@@ -240,38 +231,34 @@ class TestGuideEnhancerNextSteps:
 
     def test_enhance_next_steps_none_mode(self):
         """Test next steps in none mode"""
-        enhancer = GuideEnhancer(mode='none')
-        guide_data = {'title': 'Test Guide', 'description': 'Test'}
+        enhancer = GuideEnhancer(mode="none")
+        guide_data = {"title": "Test Guide", "description": "Test"}
         result = enhancer.enhance_next_steps(guide_data)
         assert result == []
 
-    @patch.object(GuideEnhancer, '_call_claude_api')
+    @patch.object(GuideEnhancer, "_call_claude_api")
     def test_enhance_next_steps_api_mode(self, mock_call):
         """Test next steps with API mode"""
-        mock_call.return_value = json.dumps({
-            'next_steps': [
-                'How to handle async workflows',
-                'How to add error handling',
-                'How to implement caching'
-            ]
-        })
+        mock_call.return_value = json.dumps(
+            {"next_steps": ["How to handle async workflows", "How to add error handling", "How to implement caching"]}
+        )
 
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'sk-ant-test'}):
-            with patch('skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE', True):
-                with patch('skill_seekers.cli.guide_enhancer.anthropic', create=True) as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "sk-ant-test"}):
+            with patch("skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE", True):
+                with patch("skill_seekers.cli.guide_enhancer.anthropic", create=True) as mock_anthropic:
                     mock_anthropic.Anthropic = Mock()
-                    enhancer = GuideEnhancer(mode='api')
-                    if enhancer.mode != 'api':
+                    enhancer = GuideEnhancer(mode="api")
+                    if enhancer.mode != "api":
                         pytest.skip("API mode not available")
 
                     enhancer.client = Mock()
 
-                    guide_data = {'title': 'How to Scrape Docs', 'description': 'Basic scraping'}
+                    guide_data = {"title": "How to Scrape Docs", "description": "Basic scraping"}
                     result = enhancer.enhance_next_steps(guide_data)
 
                     assert len(result) == 3
-                    assert 'async' in result[0].lower()
-                    assert 'error' in result[1].lower()
+                    assert "async" in result[0].lower()
+                    assert "error" in result[1].lower()
 
 
 class TestGuideEnhancerUseCases:
@@ -279,37 +266,39 @@ class TestGuideEnhancerUseCases:
 
     def test_enhance_use_cases_none_mode(self):
         """Test use cases in none mode"""
-        enhancer = GuideEnhancer(mode='none')
-        guide_data = {'title': 'Test Guide', 'description': 'Test'}
+        enhancer = GuideEnhancer(mode="none")
+        guide_data = {"title": "Test Guide", "description": "Test"}
         result = enhancer.enhance_use_cases(guide_data)
         assert result == []
 
-    @patch.object(GuideEnhancer, '_call_claude_api')
+    @patch.object(GuideEnhancer, "_call_claude_api")
     def test_enhance_use_cases_api_mode(self, mock_call):
         """Test use cases with API mode"""
-        mock_call.return_value = json.dumps({
-            'use_cases': [
-                'Use when you need to automate documentation extraction',
-                'Ideal for building knowledge bases from technical docs'
-            ]
-        })
+        mock_call.return_value = json.dumps(
+            {
+                "use_cases": [
+                    "Use when you need to automate documentation extraction",
+                    "Ideal for building knowledge bases from technical docs",
+                ]
+            }
+        )
 
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'sk-ant-test'}):
-            with patch('skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE', True):
-                with patch('skill_seekers.cli.guide_enhancer.anthropic', create=True) as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "sk-ant-test"}):
+            with patch("skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE", True):
+                with patch("skill_seekers.cli.guide_enhancer.anthropic", create=True) as mock_anthropic:
                     mock_anthropic.Anthropic = Mock()
-                    enhancer = GuideEnhancer(mode='api')
-                    if enhancer.mode != 'api':
+                    enhancer = GuideEnhancer(mode="api")
+                    if enhancer.mode != "api":
                         pytest.skip("API mode not available")
 
                     enhancer.client = Mock()
 
-                    guide_data = {'title': 'How to Scrape Docs', 'description': 'Documentation scraping'}
+                    guide_data = {"title": "How to Scrape Docs", "description": "Documentation scraping"}
                     result = enhancer.enhance_use_cases(guide_data)
 
                     assert len(result) == 2
-                    assert 'automate' in result[0].lower()
-                    assert 'knowledge base' in result[1].lower()
+                    assert "automate" in result[0].lower()
+                    assert "knowledge base" in result[1].lower()
 
 
 class TestGuideEnhancerFullWorkflow:
@@ -317,97 +306,97 @@ class TestGuideEnhancerFullWorkflow:
 
     def test_enhance_guide_none_mode(self):
         """Test full guide enhancement in none mode"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
         guide_data = {
-            'title': 'How to Scrape Documentation',
-            'steps': [
-                {'description': 'Import libraries', 'code': 'import requests'},
-                {'description': 'Create scraper', 'code': 'scraper = Scraper()'}
+            "title": "How to Scrape Documentation",
+            "steps": [
+                {"description": "Import libraries", "code": "import requests"},
+                {"description": "Create scraper", "code": "scraper = Scraper()"},
             ],
-            'language': 'python',
-            'prerequisites': ['requests'],
-            'description': 'Basic scraping guide'
+            "language": "python",
+            "prerequisites": ["requests"],
+            "description": "Basic scraping guide",
         }
 
         result = enhancer.enhance_guide(guide_data)
 
         # In none mode, should return original guide
-        assert result['title'] == guide_data['title']
-        assert len(result['steps']) == 2
+        assert result["title"] == guide_data["title"]
+        assert len(result["steps"]) == 2
 
-    @patch.object(GuideEnhancer, '_call_claude_api')
+    @patch.object(GuideEnhancer, "_call_claude_api")
     def test_enhance_guide_api_mode_success(self, mock_call):
         """Test successful full guide enhancement via API"""
-        mock_call.return_value = json.dumps({
-            'step_descriptions': [
-                {'step_index': 0, 'explanation': 'Import required libraries', 'variations': []},
-                {'step_index': 1, 'explanation': 'Initialize scraper instance', 'variations': []}
-            ],
-            'troubleshooting': [
-                {
-                    'problem': 'Import error',
-                    'symptoms': ['Module not found'],
-                    'diagnostic_steps': ['Check installation'],
-                    'solution': 'pip install requests'
-                }
-            ],
-            'prerequisites_detailed': [
-                {'name': 'requests', 'why': 'HTTP client', 'setup': 'pip install requests'}
-            ],
-            'next_steps': ['How to add authentication'],
-            'use_cases': ['Automate documentation extraction']
-        })
+        mock_call.return_value = json.dumps(
+            {
+                "step_descriptions": [
+                    {"step_index": 0, "explanation": "Import required libraries", "variations": []},
+                    {"step_index": 1, "explanation": "Initialize scraper instance", "variations": []},
+                ],
+                "troubleshooting": [
+                    {
+                        "problem": "Import error",
+                        "symptoms": ["Module not found"],
+                        "diagnostic_steps": ["Check installation"],
+                        "solution": "pip install requests",
+                    }
+                ],
+                "prerequisites_detailed": [{"name": "requests", "why": "HTTP client", "setup": "pip install requests"}],
+                "next_steps": ["How to add authentication"],
+                "use_cases": ["Automate documentation extraction"],
+            }
+        )
 
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'sk-ant-test'}):
-            with patch('skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE', True):
-                with patch('skill_seekers.cli.guide_enhancer.anthropic', create=True) as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "sk-ant-test"}):
+            with patch("skill_seekers.cli.guide_enhancer.ANTHROPIC_AVAILABLE", True):
+                with patch("skill_seekers.cli.guide_enhancer.anthropic", create=True) as mock_anthropic:
                     mock_anthropic.Anthropic = Mock()
-                    enhancer = GuideEnhancer(mode='api')
-                    if enhancer.mode != 'api':
+                    enhancer = GuideEnhancer(mode="api")
+                    if enhancer.mode != "api":
                         pytest.skip("API mode not available")
 
                     enhancer.client = Mock()
 
                     guide_data = {
-                        'title': 'How to Scrape Documentation',
-                        'steps': [
-                            {'description': 'Import libraries', 'code': 'import requests'},
-                            {'description': 'Create scraper', 'code': 'scraper = Scraper()'}
+                        "title": "How to Scrape Documentation",
+                        "steps": [
+                            {"description": "Import libraries", "code": "import requests"},
+                            {"description": "Create scraper", "code": "scraper = Scraper()"},
                         ],
-                        'language': 'python',
-                        'prerequisites': ['requests'],
-                        'description': 'Basic scraping guide'
+                        "language": "python",
+                        "prerequisites": ["requests"],
+                        "description": "Basic scraping guide",
                     }
 
                     result = enhancer.enhance_guide(guide_data)
 
                     # Check enhancements were applied
-                    assert 'step_enhancements' in result
-                    assert 'troubleshooting_detailed' in result
-                    assert 'prerequisites_detailed' in result
-                    assert 'next_steps_detailed' in result
-                    assert 'use_cases' in result
+                    assert "step_enhancements" in result
+                    assert "troubleshooting_detailed" in result
+                    assert "prerequisites_detailed" in result
+                    assert "next_steps_detailed" in result
+                    assert "use_cases" in result
 
     def test_enhance_guide_error_fallback(self):
         """Test graceful fallback on enhancement error"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
-        with patch.object(enhancer, 'enhance_guide', side_effect=Exception('API error')):
+        with patch.object(enhancer, "enhance_guide", side_effect=Exception("API error")):
             guide_data = {
-                'title': 'Test',
-                'steps': [],
-                'language': 'python',
-                'prerequisites': [],
-                'description': 'Test'
+                "title": "Test",
+                "steps": [],
+                "language": "python",
+                "prerequisites": [],
+                "description": "Test",
             }
 
             # Should not raise exception - graceful fallback
             try:
-                enhancer = GuideEnhancer(mode='none')
+                enhancer = GuideEnhancer(mode="none")
                 result = enhancer.enhance_guide(guide_data)
                 # In none mode with error, returns original
-                assert result['title'] == guide_data['title']
+                assert result["title"] == guide_data["title"]
             except Exception:
                 pytest.fail("Should handle errors gracefully")
 
@@ -415,36 +404,39 @@ class TestGuideEnhancerFullWorkflow:
 class TestGuideEnhancerLocalMode:
     """Test LOCAL mode (Claude Code CLI)"""
 
-    @patch('subprocess.run')
+    @patch("subprocess.run")
     def test_call_claude_local_success(self, mock_run):
         """Test successful LOCAL mode call"""
         mock_run.return_value = MagicMock(
             returncode=0,
-            stdout=json.dumps({
-                'step_descriptions': [],
-                'troubleshooting': [],
-                'prerequisites_detailed': [],
-                'next_steps': [],
-                'use_cases': []
-            })
+            stdout=json.dumps(
+                {
+                    "step_descriptions": [],
+                    "troubleshooting": [],
+                    "prerequisites_detailed": [],
+                    "next_steps": [],
+                    "use_cases": [],
+                }
+            ),
         )
 
-        enhancer = GuideEnhancer(mode='local')
-        if enhancer.mode == 'local':
+        enhancer = GuideEnhancer(mode="local")
+        if enhancer.mode == "local":
             prompt = "Test prompt"
             result = enhancer._call_claude_local(prompt)
 
             assert result is not None
             assert mock_run.called
 
-    @patch('subprocess.run')
+    @patch("subprocess.run")
     def test_call_claude_local_timeout(self, mock_run):
         """Test LOCAL mode timeout handling"""
         from subprocess import TimeoutExpired
-        mock_run.side_effect = TimeoutExpired('claude', 300)
 
-        enhancer = GuideEnhancer(mode='local')
-        if enhancer.mode == 'local':
+        mock_run.side_effect = TimeoutExpired("claude", 300)
+
+        enhancer = GuideEnhancer(mode="local")
+        if enhancer.mode == "local":
             prompt = "Test prompt"
             result = enhancer._call_claude_local(prompt)
 
@@ -456,47 +448,45 @@ class TestGuideEnhancerPromptGeneration:
 
     def test_create_enhancement_prompt(self):
         """Test comprehensive enhancement prompt generation"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
         guide_data = {
-            'title': 'How to Test',
-            'steps': [
-                {'description': 'Write test', 'code': 'def test_example(): pass'}
-            ],
-            'language': 'python',
-            'prerequisites': ['pytest']
+            "title": "How to Test",
+            "steps": [{"description": "Write test", "code": "def test_example(): pass"}],
+            "language": "python",
+            "prerequisites": ["pytest"],
         }
 
         prompt = enhancer._create_enhancement_prompt(guide_data)
 
-        assert 'How to Test' in prompt
-        assert 'pytest' in prompt
-        assert 'STEP_DESCRIPTIONS' in prompt
-        assert 'TROUBLESHOOTING' in prompt
-        assert 'PREREQUISITES' in prompt
-        assert 'NEXT_STEPS' in prompt
-        assert 'USE_CASES' in prompt
-        assert 'JSON' in prompt
+        assert "How to Test" in prompt
+        assert "pytest" in prompt
+        assert "STEP_DESCRIPTIONS" in prompt
+        assert "TROUBLESHOOTING" in prompt
+        assert "PREREQUISITES" in prompt
+        assert "NEXT_STEPS" in prompt
+        assert "USE_CASES" in prompt
+        assert "JSON" in prompt
 
     def test_format_steps_for_prompt(self):
         """Test step formatting for prompts"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
         steps = [
-            {'description': 'Import', 'code': 'import requests'},
-            {'description': 'Create', 'code': 'obj = Object()'}
+            {"description": "Import", "code": "import requests"},
+            {"description": "Create", "code": "obj = Object()"},
         ]
 
         formatted = enhancer._format_steps_for_prompt(steps)
 
-        assert 'Step 1' in formatted
-        assert 'Step 2' in formatted
-        assert 'import requests' in formatted
-        assert 'obj = Object()' in formatted
+        assert "Step 1" in formatted
+        assert "Step 2" in formatted
+        assert "import requests" in formatted
+        assert "obj = Object()" in formatted
 
     def test_format_steps_empty(self):
         """Test formatting empty steps list"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
         formatted = enhancer._format_steps_for_prompt([])
         assert formatted == "No steps provided"
 
@@ -506,61 +496,57 @@ class TestGuideEnhancerResponseParsing:
 
     def test_parse_enhancement_response_valid_json(self):
         """Test parsing valid JSON response"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
-        response = json.dumps({
-            'step_descriptions': [
-                {'step_index': 0, 'explanation': 'Test', 'variations': []}
-            ],
-            'troubleshooting': [],
-            'prerequisites_detailed': [],
-            'next_steps': [],
-            'use_cases': []
-        })
+        response = json.dumps(
+            {
+                "step_descriptions": [{"step_index": 0, "explanation": "Test", "variations": []}],
+                "troubleshooting": [],
+                "prerequisites_detailed": [],
+                "next_steps": [],
+                "use_cases": [],
+            }
+        )
 
-        guide_data = {
-            'title': 'Test',
-            'steps': [{'description': 'Test', 'code': 'test'}],
-            'language': 'python'
-        }
+        guide_data = {"title": "Test", "steps": [{"description": "Test", "code": "test"}], "language": "python"}
 
         result = enhancer._parse_enhancement_response(response, guide_data)
 
-        assert 'step_enhancements' in result
-        assert len(result['step_enhancements']) == 1
+        assert "step_enhancements" in result
+        assert len(result["step_enhancements"]) == 1
 
     def test_parse_enhancement_response_with_extra_text(self):
         """Test parsing JSON embedded in text"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
         json_data = {
-            'step_descriptions': [],
-            'troubleshooting': [],
-            'prerequisites_detailed': [],
-            'next_steps': [],
-            'use_cases': []
+            "step_descriptions": [],
+            "troubleshooting": [],
+            "prerequisites_detailed": [],
+            "next_steps": [],
+            "use_cases": [],
         }
 
         response = f"Here's the result:\n{json.dumps(json_data)}\nDone!"
 
-        guide_data = {'title': 'Test', 'steps': [], 'language': 'python'}
+        guide_data = {"title": "Test", "steps": [], "language": "python"}
         result = enhancer._parse_enhancement_response(response, guide_data)
 
         # Should extract JSON successfully
-        assert 'title' in result
+        assert "title" in result
 
     def test_parse_enhancement_response_invalid_json(self):
         """Test handling invalid JSON"""
-        enhancer = GuideEnhancer(mode='none')
+        enhancer = GuideEnhancer(mode="none")
 
         response = "This is not valid JSON"
-        guide_data = {'title': 'Test', 'steps': [], 'language': 'python'}
+        guide_data = {"title": "Test", "steps": [], "language": "python"}
 
         result = enhancer._parse_enhancement_response(response, guide_data)
 
         # Should return original guide_data on parse error
-        assert result['title'] == 'Test'
+        assert result["title"] == "Test"
 
 
-if __name__ == '__main__':
-    pytest.main([__file__, '-v'])
+if __name__ == "__main__":
+    pytest.main([__file__, "-v"])
diff --git a/tests/test_how_to_guide_builder.py b/tests/test_how_to_guide_builder.py
index 74425da..911b076 100644
--- a/tests/test_how_to_guide_builder.py
+++ b/tests/test_how_to_guide_builder.py
@@ -10,29 +10,27 @@ Test Coverage:
 - End-to-end (1 test) - Full workflow
 """
 
-import unittest
-import sys
-import os
-from pathlib import Path
-import tempfile
-import shutil
 import json
+import os
+import shutil
+import sys
+import tempfile
+import unittest
+from pathlib import Path
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
+from skill_seekers.cli.guide_enhancer import StepEnhancement
 from skill_seekers.cli.how_to_guide_builder import (
-    WorkflowStep,
-    HowToGuide,
     GuideCollection,
+    GuideGenerator,
+    HowToGuide,
+    HowToGuideBuilder,
     WorkflowAnalyzer,
     WorkflowGrouper,
-    GuideGenerator,
-    HowToGuideBuilder,
-    PrerequisiteItem,
-    TroubleshootingItem
+    WorkflowStep,
 )
-from skill_seekers.cli.guide_enhancer import StepEnhancement
 
 
 class TestWorkflowAnalyzer(unittest.TestCase):
@@ -44,7 +42,7 @@ class TestWorkflowAnalyzer(unittest.TestCase):
     def test_analyze_python_workflow(self):
         """Test analysis of Python workflow with multiple steps"""
         workflow = {
-            'code': '''
+            "code": """
 def test_user_creation_workflow():
     # Step 1: Create database
     db = Database('test.db')
@@ -55,11 +53,11 @@ def test_user_creation_workflow():
 
     # Step 3: Verify creation
     assert db.get_user('Alice').email == 'alice@example.com'
-''',
-            'language': 'python',
-            'category': 'workflow',
-            'test_name': 'test_user_creation_workflow',
-            'file_path': 'tests/test_user.py'
+""",
+            "language": "python",
+            "category": "workflow",
+            "test_name": "test_user_creation_workflow",
+            "file_path": "tests/test_user.py",
         }
 
         steps, metadata = self.analyzer.analyze_workflow(workflow)
@@ -73,13 +71,13 @@ def test_user_creation_workflow():
         self.assertIsNotNone(steps[0].description)
 
         # Check metadata
-        self.assertIn('complexity_level', metadata)
-        self.assertIn(metadata['complexity_level'], ['beginner', 'intermediate', 'advanced'])
+        self.assertIn("complexity_level", metadata)
+        self.assertIn(metadata["complexity_level"], ["beginner", "intermediate", "advanced"])
 
     def test_detect_prerequisites(self):
         """Test detection of prerequisites from imports and fixtures"""
         workflow = {
-            'code': '''
+            "code": """
 import pytest
 from myapp import Database, User
 
@@ -90,11 +88,11 @@ def db():
 def test_workflow(db):
     user = User(name='Bob')
     db.save(user)
-''',
-            'language': 'python',
-            'category': 'workflow',
-            'test_name': 'test_workflow',
-            'file_path': 'tests/test.py'
+""",
+            "language": "python",
+            "category": "workflow",
+            "test_name": "test_workflow",
+            "file_path": "tests/test.py",
         }
 
         steps, metadata = self.analyzer.analyze_workflow(workflow)
@@ -106,14 +104,14 @@ def test_workflow(db):
 
     def test_find_verification_points(self):
         """Test finding verification/assertion points in workflow"""
-        code = '''
+        code = """
 def test_workflow():
     result = calculate(5, 3)
     assert result == 8  # Verify calculation
 
     status = save_to_db(result)
     assert status == True  # Verify save
-'''
+"""
 
         verifications = self.analyzer._find_verification_points(code)
 
@@ -123,38 +121,37 @@ def test_workflow():
     def test_calculate_complexity(self):
         """Test complexity level calculation"""
         # Simple workflow - beginner
-        simple_steps = [
-            WorkflowStep(1, 'x = 1', 'Assign variable'),
-            WorkflowStep(2, 'print(x)', 'Print variable')
-        ]
-        simple_workflow = {'code': 'x = 1\nprint(x)', 'category': 'workflow'}
+        simple_steps = [WorkflowStep(1, "x = 1", "Assign variable"), WorkflowStep(2, "print(x)", "Print variable")]
+        simple_workflow = {"code": "x = 1\nprint(x)", "category": "workflow"}
         complexity_simple = self.analyzer._calculate_complexity(simple_steps, simple_workflow)
-        self.assertEqual(complexity_simple, 'beginner')
+        self.assertEqual(complexity_simple, "beginner")
 
         # Complex workflow - advanced
-        complex_steps = [
-            WorkflowStep(i, f'step{i}', f'Step {i}')
-            for i in range(1, 8)
-        ]
+        complex_steps = [WorkflowStep(i, f"step{i}", f"Step {i}") for i in range(1, 8)]
         complex_workflow = {
-            'code': '\n'.join([f'async def step{i}(): await complex_operation()' for i in range(7)]),
-            'category': 'workflow'
+            "code": "\n".join([f"async def step{i}(): await complex_operation()" for i in range(7)]),
+            "category": "workflow",
         }
         complexity_complex = self.analyzer._calculate_complexity(complex_steps, complex_workflow)
-        self.assertIn(complexity_complex, ['intermediate', 'advanced'])
+        self.assertIn(complexity_complex, ["intermediate", "advanced"])
 
     def test_extract_steps_python_ast(self):
         """Test Python AST-based step extraction"""
-        code = '''
+        code = """
 def test_workflow():
     db = Database('test.db')
     user = User(name='Alice')
     db.save(user)
     result = db.query('SELECT * FROM users')
     assert len(result) == 1
-'''
-        workflow = {'code': code, 'language': 'python', 'category': 'workflow',
-                    'test_name': 'test_workflow', 'file_path': 'test.py'}
+"""
+        workflow = {
+            "code": code,
+            "language": "python",
+            "category": "workflow",
+            "test_name": "test_workflow",
+            "file_path": "test.py",
+        }
 
         steps = self.analyzer._extract_steps_python(code, workflow)
 
@@ -169,7 +166,7 @@ def test_workflow():
 
     def test_extract_steps_heuristic(self):
         """Test heuristic-based step extraction for non-Python languages"""
-        code = '''
+        code = """
 func TestWorkflow(t *testing.T) {
     // Step 1
     db := NewDatabase("test.db")
@@ -184,9 +181,14 @@ func TestWorkflow(t *testing.T) {
         t.Error("Expected 1 user")
     }
 }
-'''
-        workflow = {'code': code, 'language': 'go', 'category': 'workflow',
-                    'test_name': 'TestWorkflow', 'file_path': 'test.go'}
+"""
+        workflow = {
+            "code": code,
+            "language": "go",
+            "category": "workflow",
+            "test_name": "TestWorkflow",
+            "file_path": "test.go",
+        }
 
         steps = self.analyzer._extract_steps_heuristic(code, workflow)
 
@@ -203,12 +205,24 @@ class TestWorkflowGrouper(unittest.TestCase):
     def test_group_by_file_path(self):
         """Test grouping workflows by file path"""
         workflows = [
-            {'test_name': 'test_user_create', 'file_path': 'tests/test_user.py',
-             'code': 'user = User()', 'category': 'workflow'},
-            {'test_name': 'test_user_delete', 'file_path': 'tests/test_user.py',
-             'code': 'db.delete(user)', 'category': 'workflow'},
-            {'test_name': 'test_db_connect', 'file_path': 'tests/test_database.py',
-             'code': 'db = Database()', 'category': 'workflow'}
+            {
+                "test_name": "test_user_create",
+                "file_path": "tests/test_user.py",
+                "code": "user = User()",
+                "category": "workflow",
+            },
+            {
+                "test_name": "test_user_delete",
+                "file_path": "tests/test_user.py",
+                "code": "db.delete(user)",
+                "category": "workflow",
+            },
+            {
+                "test_name": "test_db_connect",
+                "file_path": "tests/test_database.py",
+                "code": "db = Database()",
+                "category": "workflow",
+            },
         ]
 
         grouped = self.grouper._group_by_file_path(workflows)
@@ -221,9 +235,9 @@ class TestWorkflowGrouper(unittest.TestCase):
     def test_group_by_test_name(self):
         """Test grouping workflows by test name patterns"""
         workflows = [
-            {'test_name': 'test_user_create', 'code': 'user = User()', 'category': 'workflow'},
-            {'test_name': 'test_user_update', 'code': 'user.update()', 'category': 'workflow'},
-            {'test_name': 'test_admin_create', 'code': 'admin = Admin()', 'category': 'workflow'}
+            {"test_name": "test_user_create", "code": "user = User()", "category": "workflow"},
+            {"test_name": "test_user_update", "code": "user.update()", "category": "workflow"},
+            {"test_name": "test_admin_create", "code": "admin = Admin()", "category": "workflow"},
         ]
 
         grouped = self.grouper._group_by_test_name(workflows)
@@ -235,17 +249,17 @@ class TestWorkflowGrouper(unittest.TestCase):
         """Test grouping workflows by complexity level"""
         workflows = [
             {
-                'test_name': 'test_simple',
-                'code': 'x = 1\nprint(x)',
-                'category': 'workflow',
-                'complexity_level': 'beginner'
+                "test_name": "test_simple",
+                "code": "x = 1\nprint(x)",
+                "category": "workflow",
+                "complexity_level": "beginner",
             },
             {
-                'test_name': 'test_complex',
-                'code': '\n'.join(['step()' for _ in range(10)]),
-                'category': 'workflow',
-                'complexity_level': 'advanced'
-            }
+                "test_name": "test_complex",
+                "code": "\n".join(["step()" for _ in range(10)]),
+                "category": "workflow",
+                "complexity_level": "advanced",
+            },
         ]
 
         grouped = self.grouper._group_by_complexity(workflows)
@@ -257,19 +271,19 @@ class TestWorkflowGrouper(unittest.TestCase):
         """Test AI-based tutorial grouping (or fallback if no AI)"""
         workflows = [
             {
-                'test_name': 'test_user_create',
-                'code': 'user = User(name="Alice")',
-                'category': 'workflow',
-                'file_path': 'tests/test_user.py',
-                'tutorial_group': 'User Management'  # Simulated AI categorization
+                "test_name": "test_user_create",
+                "code": 'user = User(name="Alice")',
+                "category": "workflow",
+                "file_path": "tests/test_user.py",
+                "tutorial_group": "User Management",  # Simulated AI categorization
             },
             {
-                'test_name': 'test_db_connect',
-                'code': 'db = Database()',
-                'category': 'workflow',
-                'file_path': 'tests/test_db.py',
-                'tutorial_group': 'Database Operations'
-            }
+                "test_name": "test_db_connect",
+                "code": "db = Database()",
+                "category": "workflow",
+                "file_path": "tests/test_db.py",
+                "tutorial_group": "Database Operations",
+            },
         ]
 
         grouped = self.grouper._group_by_ai_tutorial_group(workflows)
@@ -287,116 +301,111 @@ class TestGuideGenerator(unittest.TestCase):
     def test_generate_guide_markdown(self):
         """Test generation of complete markdown guide"""
         guide = HowToGuide(
-            guide_id='test-guide-1',
-            title='How to Create a User',
-            overview='This guide demonstrates user creation workflow',
-            complexity_level='beginner',
-            prerequisites=['Database', 'User model'],
-            required_imports=['from myapp import Database, User'],
+            guide_id="test-guide-1",
+            title="How to Create a User",
+            overview="This guide demonstrates user creation workflow",
+            complexity_level="beginner",
+            prerequisites=["Database", "User model"],
+            required_imports=["from myapp import Database, User"],
             steps=[
-                WorkflowStep(1, 'db = Database("test.db")', 'Create database connection'),
-                WorkflowStep(2, 'user = User(name="Alice")', 'Create user object'),
-                WorkflowStep(3, 'db.save(user)', 'Save to database')
+                WorkflowStep(1, 'db = Database("test.db")', "Create database connection"),
+                WorkflowStep(2, 'user = User(name="Alice")', "Create user object"),
+                WorkflowStep(3, "db.save(user)", "Save to database"),
             ],
-            use_case='Creating new users in the system',
-            tags=['user', 'database', 'create']
+            use_case="Creating new users in the system",
+            tags=["user", "database", "create"],
         )
 
         markdown = self.generator.generate_guide_markdown(guide)
 
         # Check markdown contains expected sections (actual format uses "# How To:" prefix)
-        self.assertIn('# How To:', markdown)
-        self.assertIn('How to Create a User', markdown)
-        self.assertIn('## Overview', markdown)
-        self.assertIn('## Prerequisites', markdown)
-        self.assertIn('Step 1:', markdown)
-        self.assertIn('Create database connection', markdown)
+        self.assertIn("# How To:", markdown)
+        self.assertIn("How to Create a User", markdown)
+        self.assertIn("## Overview", markdown)
+        self.assertIn("## Prerequisites", markdown)
+        self.assertIn("Step 1:", markdown)
+        self.assertIn("Create database connection", markdown)
 
     def test_create_header(self):
         """Test header generation with metadata"""
         guide = HowToGuide(
-            guide_id='test-1',
-            title='Test Guide',
-            overview='Test',
-            complexity_level='beginner',
-            tags=['test', 'example']
+            guide_id="test-1",
+            title="Test Guide",
+            overview="Test",
+            complexity_level="beginner",
+            tags=["test", "example"],
         )
 
         header = self.generator._create_header(guide)
 
         # Actual format uses "# How To:" prefix
-        self.assertIn('# How To:', header)
-        self.assertIn('Test Guide', header)
-        self.assertIn('Beginner', header)
+        self.assertIn("# How To:", header)
+        self.assertIn("Test Guide", header)
+        self.assertIn("Beginner", header)
 
     def test_create_steps_section(self):
         """Test steps section generation"""
         steps = [
             WorkflowStep(
                 1,
-                'db = Database()',
-                'Create database',
-                expected_result='Database object',
-                verification='assert db.is_connected()'
+                "db = Database()",
+                "Create database",
+                expected_result="Database object",
+                verification="assert db.is_connected()",
             ),
-            WorkflowStep(2, 'user = User()', 'Create user')
+            WorkflowStep(2, "user = User()", "Create user"),
         ]
 
         steps_md = self.generator._create_steps_section(steps)
 
         # Actual format uses "## Step-by-Step Guide"
-        self.assertIn('## Step-by-Step Guide', steps_md)
-        self.assertIn('### Step 1:', steps_md)
-        self.assertIn('Create database', steps_md)
-        self.assertIn('```', steps_md)  # Code block
-        self.assertIn('Database()', steps_md)
+        self.assertIn("## Step-by-Step Guide", steps_md)
+        self.assertIn("### Step 1:", steps_md)
+        self.assertIn("Create database", steps_md)
+        self.assertIn("```", steps_md)  # Code block
+        self.assertIn("Database()", steps_md)
 
     def test_create_complete_example(self):
         """Test complete example generation"""
         guide = HowToGuide(
-            guide_id='test-1',
-            title='Test',
-            overview='Test',
-            complexity_level='beginner',
-            steps=[
-                WorkflowStep(1, 'x = 1', 'Assign'),
-                WorkflowStep(2, 'print(x)', 'Print')
-            ],
-            workflows=[
-                {'code': 'x = 1\nprint(x)', 'language': 'python'}
-            ]
+            guide_id="test-1",
+            title="Test",
+            overview="Test",
+            complexity_level="beginner",
+            steps=[WorkflowStep(1, "x = 1", "Assign"), WorkflowStep(2, "print(x)", "Print")],
+            workflows=[{"code": "x = 1\nprint(x)", "language": "python"}],
         )
 
         example_md = self.generator._create_complete_example(guide)
 
-        self.assertIn('## Complete Example', example_md)
-        self.assertIn('```python', example_md)
+        self.assertIn("## Complete Example", example_md)
+        self.assertIn("```python", example_md)
 
     def test_create_index(self):
         """Test index generation for guide collection"""
         guides = [
             HowToGuide(
-                guide_id='guide-1',
-                title='Beginner Guide',
-                overview='Simple guide',
-                complexity_level='beginner',
-                tags=['user']
+                guide_id="guide-1",
+                title="Beginner Guide",
+                overview="Simple guide",
+                complexity_level="beginner",
+                tags=["user"],
             ),
             HowToGuide(
-                guide_id='guide-2',
-                title='Advanced Guide',
-                overview='Complex guide',
-                complexity_level='advanced',
-                tags=['admin', 'security']
-            )
+                guide_id="guide-2",
+                title="Advanced Guide",
+                overview="Complex guide",
+                complexity_level="advanced",
+                tags=["admin", "security"],
+            ),
         ]
 
         # Method is actually called generate_index
         index_md = self.generator.generate_index(guides)
 
-        self.assertIn('How-To Guides', index_md)
-        self.assertIn('Beginner Guide', index_md)
-        self.assertIn('Advanced Guide', index_md)
+        self.assertIn("How-To Guides", index_md)
+        self.assertIn("Beginner Guide", index_md)
+        self.assertIn("Advanced Guide", index_md)
 
 
 class TestHowToGuideBuilder(unittest.TestCase):
@@ -414,61 +423,51 @@ class TestHowToGuideBuilder(unittest.TestCase):
         """Test extraction of workflow examples from mixed examples"""
         examples = [
             {
-                'category': 'workflow',
-                'code': 'db = Database()\nuser = User()\ndb.save(user)',
-                'test_name': 'test_user_workflow',
-                'file_path': 'tests/test_user.py',
-                'language': 'python'
+                "category": "workflow",
+                "code": "db = Database()\nuser = User()\ndb.save(user)",
+                "test_name": "test_user_workflow",
+                "file_path": "tests/test_user.py",
+                "language": "python",
             },
             {
-                'category': 'instantiation',
-                'code': 'db = Database()',
-                'test_name': 'test_db',
-                'file_path': 'tests/test_db.py',
-                'language': 'python'
-            }
+                "category": "instantiation",
+                "code": "db = Database()",
+                "test_name": "test_db",
+                "file_path": "tests/test_db.py",
+                "language": "python",
+            },
         ]
 
         workflows = self.builder._extract_workflow_examples(examples)
 
         # Should only extract workflow category
         self.assertEqual(len(workflows), 1)
-        self.assertEqual(workflows[0]['category'], 'workflow')
+        self.assertEqual(workflows[0]["category"], "workflow")
 
     def test_create_guide_from_workflows(self):
         """Test guide creation from grouped workflows"""
         workflows = [
             {
-                'code': 'user = User(name="Alice")\ndb.save(user)',
-                'test_name': 'test_create_user',
-                'file_path': 'tests/test_user.py',
-                'language': 'python',
-                'category': 'workflow'
+                "code": 'user = User(name="Alice")\ndb.save(user)',
+                "test_name": "test_create_user",
+                "file_path": "tests/test_user.py",
+                "language": "python",
+                "category": "workflow",
             }
         ]
 
-        guide = self.builder._create_guide('User Management', workflows)
+        guide = self.builder._create_guide("User Management", workflows)
 
         self.assertIsInstance(guide, HowToGuide)
-        self.assertEqual(guide.title, 'User Management')
+        self.assertEqual(guide.title, "User Management")
         self.assertGreater(len(guide.steps), 0)
-        self.assertIn(guide.complexity_level, ['beginner', 'intermediate', 'advanced'])
+        self.assertIn(guide.complexity_level, ["beginner", "intermediate", "advanced"])
 
     def test_create_collection(self):
         """Test guide collection creation with metadata"""
         guides = [
-            HowToGuide(
-                guide_id='guide-1',
-                title='Guide 1',
-                overview='Test',
-                complexity_level='beginner'
-            ),
-            HowToGuide(
-                guide_id='guide-2',
-                title='Guide 2',
-                overview='Test',
-                complexity_level='advanced'
-            )
+            HowToGuide(guide_id="guide-1", title="Guide 1", overview="Test", complexity_level="beginner"),
+            HowToGuide(guide_id="guide-2", title="Guide 2", overview="Test", complexity_level="advanced"),
         ]
 
         collection = self.builder._create_collection(guides)
@@ -476,77 +475,70 @@ class TestHowToGuideBuilder(unittest.TestCase):
         self.assertIsInstance(collection, GuideCollection)
         self.assertEqual(collection.total_guides, 2)
         # Attribute is guides_by_complexity not by_complexity
-        self.assertEqual(collection.guides_by_complexity['beginner'], 1)
-        self.assertEqual(collection.guides_by_complexity['advanced'], 1)
+        self.assertEqual(collection.guides_by_complexity["beginner"], 1)
+        self.assertEqual(collection.guides_by_complexity["advanced"], 1)
 
     def test_save_guides_to_files(self):
         """Test saving guides to markdown files"""
         guides = [
             HowToGuide(
-                guide_id='test-guide',
-                title='Test Guide',
-                overview='Test overview',
-                complexity_level='beginner',
-                steps=[
-                    WorkflowStep(1, 'x = 1', 'Test step')
-                ]
+                guide_id="test-guide",
+                title="Test Guide",
+                overview="Test overview",
+                complexity_level="beginner",
+                steps=[WorkflowStep(1, "x = 1", "Test step")],
             )
         ]
 
         # Correct attribute names
         collection = GuideCollection(
-            total_guides=1,
-            guides=guides,
-            guides_by_complexity={'beginner': 1},
-            guides_by_use_case={}
+            total_guides=1, guides=guides, guides_by_complexity={"beginner": 1}, guides_by_use_case={}
         )
 
         output_dir = Path(self.temp_dir)
         self.builder._save_guides_to_files(collection, output_dir)
 
         # Check index file was created
-        self.assertTrue((output_dir / 'index.md').exists())
+        self.assertTrue((output_dir / "index.md").exists())
 
         # Check index content contains guide information
-        index_content = (output_dir / 'index.md').read_text()
-        self.assertIn('Test Guide', index_content)
+        index_content = (output_dir / "index.md").read_text()
+        self.assertIn("Test Guide", index_content)
 
         # Check that at least one markdown file exists
-        md_files = list(output_dir.glob('*.md'))
+        md_files = list(output_dir.glob("*.md"))
         self.assertGreaterEqual(len(md_files), 1)
 
     def test_build_guides_from_examples(self):
         """Test full guide building workflow"""
         examples = [
             {
-                'category': 'workflow',
-                'code': '''
+                "category": "workflow",
+                "code": """
 def test_user_workflow():
     db = Database('test.db')
     user = User(name='Alice', email='alice@test.com')
     db.save(user)
     assert db.get_user('Alice').email == 'alice@test.com'
-''',
-                'test_name': 'test_user_workflow',
-                'file_path': 'tests/test_user.py',
-                'language': 'python',
-                'description': 'User creation workflow',
-                'expected_behavior': 'User should be saved and retrieved'
+""",
+                "test_name": "test_user_workflow",
+                "file_path": "tests/test_user.py",
+                "language": "python",
+                "description": "User creation workflow",
+                "expected_behavior": "User should be saved and retrieved",
             }
         ]
 
-        output_dir = Path(self.temp_dir) / 'guides'
+        output_dir = Path(self.temp_dir) / "guides"
 
         collection = self.builder.build_guides_from_examples(
-            examples,
-            grouping_strategy='file-path',
-            output_dir=output_dir
+            examples, grouping_strategy="file-path", output_dir=output_dir
         )
 
         self.assertIsInstance(collection, GuideCollection)
         self.assertGreater(collection.total_guides, 0)
         self.assertTrue(output_dir.exists())
-        self.assertTrue((output_dir / 'index.md').exists())
+        self.assertTrue((output_dir / "index.md").exists())
 
 
 class TestEndToEnd(unittest.TestCase):
@@ -563,11 +555,11 @@ class TestEndToEnd(unittest.TestCase):
         """Test complete workflow from examples to guides"""
         # Create test examples JSON
         examples = {
-            'total_examples': 2,
-            'examples': [
+            "total_examples": 2,
+            "examples": [
                 {
-                    'category': 'workflow',
-                    'code': '''
+                    "category": "workflow",
+                    "code": '''
 def test_database_workflow():
     """Test complete database workflow"""
     # Setup
@@ -581,15 +573,15 @@ def test_database_workflow():
     saved_user = db.get_user('Alice')
     assert saved_user.email == 'alice@example.com'
 ''',
-                    'test_name': 'test_database_workflow',
-                    'file_path': 'tests/test_database.py',
-                    'language': 'python',
-                    'description': 'Complete database workflow',
-                    'expected_behavior': 'User saved and retrieved correctly'
+                    "test_name": "test_database_workflow",
+                    "file_path": "tests/test_database.py",
+                    "language": "python",
+                    "description": "Complete database workflow",
+                    "expected_behavior": "User saved and retrieved correctly",
                 },
                 {
-                    'category': 'workflow',
-                    'code': '''
+                    "category": "workflow",
+                    "code": '''
 def test_authentication_workflow():
     """Test user authentication"""
     user = User(name='Bob', password='secret123')
@@ -597,28 +589,26 @@ def test_authentication_workflow():
     assert token is not None
     assert verify_token(token) == user.name
 ''',
-                    'test_name': 'test_authentication_workflow',
-                    'file_path': 'tests/test_auth.py',
-                    'language': 'python',
-                    'description': 'Authentication workflow',
-                    'expected_behavior': 'User authenticated successfully'
-                }
-            ]
+                    "test_name": "test_authentication_workflow",
+                    "file_path": "tests/test_auth.py",
+                    "language": "python",
+                    "description": "Authentication workflow",
+                    "expected_behavior": "User authenticated successfully",
+                },
+            ],
         }
 
         # Save examples to temp file
-        examples_file = Path(self.temp_dir) / 'test_examples.json'
-        with open(examples_file, 'w') as f:
+        examples_file = Path(self.temp_dir) / "test_examples.json"
+        with open(examples_file, "w") as f:
             json.dump(examples, f)
 
         # Build guides
         builder = HowToGuideBuilder(enhance_with_ai=False)
-        output_dir = Path(self.temp_dir) / 'tutorials'
+        output_dir = Path(self.temp_dir) / "tutorials"
 
         collection = builder.build_guides_from_examples(
-            examples['examples'],
-            grouping_strategy='file-path',
-            output_dir=output_dir
+            examples["examples"], grouping_strategy="file-path", output_dir=output_dir
         )
 
         # Verify results
@@ -627,14 +617,14 @@ def test_authentication_workflow():
 
         # Check output files
         self.assertTrue(output_dir.exists())
-        self.assertTrue((output_dir / 'index.md').exists())
+        self.assertTrue((output_dir / "index.md").exists())
 
         # Check index content
-        index_content = (output_dir / 'index.md').read_text()
-        self.assertIn('How-To Guides', index_content)
+        index_content = (output_dir / "index.md").read_text()
+        self.assertIn("How-To Guides", index_content)
 
         # Verify guide files exist (index.md + guide(s))
-        guide_files = list(output_dir.glob('*.md'))
+        guide_files = list(output_dir.glob("*.md"))
         self.assertGreaterEqual(len(guide_files), 1)  # At least index.md or guides
 
 
@@ -652,37 +642,37 @@ class TestAIEnhancementIntegration(unittest.TestCase):
         """Test building guides WITHOUT AI enhancement (backward compatibility)"""
         examples = [
             {
-                'example_id': 'test_001',
-                'test_name': 'test_user_registration',
-                'category': 'workflow',
-                'code': '''
+                "example_id": "test_001",
+                "test_name": "test_user_registration",
+                "category": "workflow",
+                "code": """
 def test_user_registration():
     user = User.create(username="test", email="test@example.com")
     assert user.id is not None
     assert user.is_active is True
-                ''',
-                'language': 'python',
-                'file_path': 'tests/test_user.py',
-                'line_start': 10,
-                'tags': ['authentication', 'user'],
-                'ai_analysis': {
-                    'tutorial_group': 'User Management',
-                    'best_practices': ['Validate email format'],
-                    'common_mistakes': ['Not checking uniqueness']
-                }
+                """,
+                "language": "python",
+                "file_path": "tests/test_user.py",
+                "line_start": 10,
+                "tags": ["authentication", "user"],
+                "ai_analysis": {
+                    "tutorial_group": "User Management",
+                    "best_practices": ["Validate email format"],
+                    "common_mistakes": ["Not checking uniqueness"],
+                },
             }
         ]
 
         builder = HowToGuideBuilder()
-        output_dir = Path(self.temp_dir) / 'guides'
+        output_dir = Path(self.temp_dir) / "guides"
 
         # Build WITHOUT AI enhancement
         collection = builder.build_guides_from_examples(
             examples=examples,
-            grouping_strategy='ai-tutorial-group',
+            grouping_strategy="ai-tutorial-group",
             output_dir=output_dir,
             enhance_with_ai=False,
-            ai_mode='none'
+            ai_mode="none",
         )
 
         # Verify guides were created
@@ -691,54 +681,54 @@ def test_user_registration():
 
         # Verify output files exist
         self.assertTrue(output_dir.exists())
-        self.assertTrue((output_dir / 'index.md').exists())
+        self.assertTrue((output_dir / "index.md").exists())
 
     def test_build_with_ai_enhancement_api_mode_mocked(self):
         """Test building guides WITH AI enhancement in API mode (mocked)"""
-        from unittest.mock import patch, Mock
+        from unittest.mock import patch
 
         examples = [
             {
-                'example_id': 'test_002',
-                'test_name': 'test_data_scraping',
-                'category': 'workflow',
-                'code': '''
+                "example_id": "test_002",
+                "test_name": "test_data_scraping",
+                "category": "workflow",
+                "code": """
 def test_data_scraping():
     scraper = DocumentationScraper()
     result = scraper.scrape("https://example.com/docs")
     assert result.pages > 0
-                ''',
-                'language': 'python',
-                'file_path': 'tests/test_scraper.py',
-                'line_start': 20,
-                'tags': ['scraping', 'documentation'],
-                'ai_analysis': {
-                    'tutorial_group': 'Data Collection',
-                    'best_practices': ['Handle rate limiting'],
-                    'common_mistakes': ['Not handling SSL errors']
-                }
+                """,
+                "language": "python",
+                "file_path": "tests/test_scraper.py",
+                "line_start": 20,
+                "tags": ["scraping", "documentation"],
+                "ai_analysis": {
+                    "tutorial_group": "Data Collection",
+                    "best_practices": ["Handle rate limiting"],
+                    "common_mistakes": ["Not handling SSL errors"],
+                },
             }
         ]
 
         builder = HowToGuideBuilder()
-        output_dir = Path(self.temp_dir) / 'guides_enhanced'
+        output_dir = Path(self.temp_dir) / "guides_enhanced"
 
         # Mock GuideEnhancer to avoid actual AI calls
-        with patch('skill_seekers.cli.guide_enhancer.GuideEnhancer') as MockEnhancer:
+        with patch("skill_seekers.cli.guide_enhancer.GuideEnhancer") as MockEnhancer:
             mock_enhancer = MockEnhancer.return_value
-            mock_enhancer.mode = 'api'
+            mock_enhancer.mode = "api"
 
             # Mock the enhance_guide method to return enhanced data
             def mock_enhance_guide(guide_data):
                 enhanced = guide_data.copy()
                 # Return proper StepEnhancement objects
-                enhanced['step_enhancements'] = [
-                    StepEnhancement(step_index=0, explanation='Test explanation', variations=[])
+                enhanced["step_enhancements"] = [
+                    StepEnhancement(step_index=0, explanation="Test explanation", variations=[])
                 ]
-                enhanced['troubleshooting_detailed'] = []
-                enhanced['prerequisites_detailed'] = []
-                enhanced['next_steps_detailed'] = []
-                enhanced['use_cases'] = []
+                enhanced["troubleshooting_detailed"] = []
+                enhanced["prerequisites_detailed"] = []
+                enhanced["next_steps_detailed"] = []
+                enhanced["use_cases"] = []
                 return enhanced
 
             mock_enhancer.enhance_guide = mock_enhance_guide
@@ -746,10 +736,10 @@ def test_data_scraping():
             # Build WITH AI enhancement
             collection = builder.build_guides_from_examples(
                 examples=examples,
-                grouping_strategy='ai-tutorial-group',
+                grouping_strategy="ai-tutorial-group",
                 output_dir=output_dir,
                 enhance_with_ai=True,
-                ai_mode='api'
+                ai_mode="api",
             )
 
             # Verify guides were created
@@ -757,51 +747,51 @@ def test_data_scraping():
             self.assertGreater(collection.total_guides, 0)
 
             # Verify enhancer was initialized
-            MockEnhancer.assert_called_once_with(mode='api')
+            MockEnhancer.assert_called_once_with(mode="api")
 
     def test_build_with_ai_enhancement_local_mode_mocked(self):
         """Test building guides WITH AI enhancement in LOCAL mode (mocked)"""
-        from unittest.mock import patch, Mock
+        from unittest.mock import patch
 
         examples = [
             {
-                'example_id': 'test_003',
-                'test_name': 'test_api_integration',
-                'category': 'workflow',
-                'code': '''
+                "example_id": "test_003",
+                "test_name": "test_api_integration",
+                "category": "workflow",
+                "code": """
 def test_api_integration():
     client = APIClient(base_url="https://api.example.com")
     response = client.get("/users")
     assert response.status_code == 200
-                ''',
-                'language': 'python',
-                'file_path': 'tests/test_api.py',
-                'line_start': 30,
-                'tags': ['api', 'integration'],
-                'ai_analysis': {
-                    'tutorial_group': 'API Testing',
-                    'best_practices': ['Use environment variables'],
-                    'common_mistakes': ['Hardcoded credentials']
-                }
+                """,
+                "language": "python",
+                "file_path": "tests/test_api.py",
+                "line_start": 30,
+                "tags": ["api", "integration"],
+                "ai_analysis": {
+                    "tutorial_group": "API Testing",
+                    "best_practices": ["Use environment variables"],
+                    "common_mistakes": ["Hardcoded credentials"],
+                },
             }
         ]
 
         builder = HowToGuideBuilder()
-        output_dir = Path(self.temp_dir) / 'guides_local'
+        output_dir = Path(self.temp_dir) / "guides_local"
 
         # Mock GuideEnhancer for LOCAL mode
-        with patch('skill_seekers.cli.guide_enhancer.GuideEnhancer') as MockEnhancer:
+        with patch("skill_seekers.cli.guide_enhancer.GuideEnhancer") as MockEnhancer:
             mock_enhancer = MockEnhancer.return_value
-            mock_enhancer.mode = 'local'
+            mock_enhancer.mode = "local"
 
             # Mock the enhance_guide method
             def mock_enhance_guide(guide_data):
                 enhanced = guide_data.copy()
-                enhanced['step_enhancements'] = []
-                enhanced['troubleshooting_detailed'] = []
-                enhanced['prerequisites_detailed'] = []
-                enhanced['next_steps_detailed'] = []
-                enhanced['use_cases'] = []
+                enhanced["step_enhancements"] = []
+                enhanced["troubleshooting_detailed"] = []
+                enhanced["prerequisites_detailed"] = []
+                enhanced["next_steps_detailed"] = []
+                enhanced["use_cases"] = []
                 return enhanced
 
             mock_enhancer.enhance_guide = mock_enhance_guide
@@ -809,10 +799,10 @@ def test_api_integration():
             # Build WITH AI enhancement (LOCAL mode)
             collection = builder.build_guides_from_examples(
                 examples=examples,
-                grouping_strategy='ai-tutorial-group',
+                grouping_strategy="ai-tutorial-group",
                 output_dir=output_dir,
                 enhance_with_ai=True,
-                ai_mode='local'
+                ai_mode="local",
             )
 
             # Verify guides were created
@@ -820,50 +810,50 @@ def test_api_integration():
             self.assertGreater(collection.total_guides, 0)
 
             # Verify LOCAL mode was used
-            MockEnhancer.assert_called_once_with(mode='local')
+            MockEnhancer.assert_called_once_with(mode="local")
 
     def test_build_with_ai_enhancement_auto_mode(self):
         """Test building guides WITH AI enhancement in AUTO mode"""
-        from unittest.mock import patch, Mock
+        from unittest.mock import patch
 
         examples = [
             {
-                'example_id': 'test_004',
-                'test_name': 'test_database_migration',
-                'category': 'workflow',
-                'code': '''
+                "example_id": "test_004",
+                "test_name": "test_database_migration",
+                "category": "workflow",
+                "code": """
 def test_database_migration():
     migrator = DatabaseMigrator()
     migrator.run_migrations()
     assert migrator.current_version == "2.0"
-                ''',
-                'language': 'python',
-                'file_path': 'tests/test_db.py',
-                'line_start': 40,
-                'tags': ['database', 'migration'],
-                'ai_analysis': {
-                    'tutorial_group': 'Database Operations',
-                    'best_practices': ['Backup before migration'],
-                    'common_mistakes': ['Not testing rollback']
-                }
+                """,
+                "language": "python",
+                "file_path": "tests/test_db.py",
+                "line_start": 40,
+                "tags": ["database", "migration"],
+                "ai_analysis": {
+                    "tutorial_group": "Database Operations",
+                    "best_practices": ["Backup before migration"],
+                    "common_mistakes": ["Not testing rollback"],
+                },
             }
         ]
 
         builder = HowToGuideBuilder()
-        output_dir = Path(self.temp_dir) / 'guides_auto'
+        output_dir = Path(self.temp_dir) / "guides_auto"
 
         # Mock GuideEnhancer for AUTO mode
-        with patch('skill_seekers.cli.guide_enhancer.GuideEnhancer') as MockEnhancer:
+        with patch("skill_seekers.cli.guide_enhancer.GuideEnhancer") as MockEnhancer:
             mock_enhancer = MockEnhancer.return_value
-            mock_enhancer.mode = 'local'  # AUTO mode detected LOCAL
+            mock_enhancer.mode = "local"  # AUTO mode detected LOCAL
 
             def mock_enhance_guide(guide_data):
                 enhanced = guide_data.copy()
-                enhanced['step_enhancements'] = []
-                enhanced['troubleshooting_detailed'] = []
-                enhanced['prerequisites_detailed'] = []
-                enhanced['next_steps_detailed'] = []
-                enhanced['use_cases'] = []
+                enhanced["step_enhancements"] = []
+                enhanced["troubleshooting_detailed"] = []
+                enhanced["prerequisites_detailed"] = []
+                enhanced["next_steps_detailed"] = []
+                enhanced["use_cases"] = []
                 return enhanced
 
             mock_enhancer.enhance_guide = mock_enhance_guide
@@ -871,10 +861,10 @@ def test_database_migration():
             # Build WITH AI enhancement (AUTO mode)
             collection = builder.build_guides_from_examples(
                 examples=examples,
-                grouping_strategy='ai-tutorial-group',
+                grouping_strategy="ai-tutorial-group",
                 output_dir=output_dir,
                 enhance_with_ai=True,
-                ai_mode='auto'
+                ai_mode="auto",
             )
 
             # Verify guides were created
@@ -882,7 +872,7 @@ def test_database_migration():
             self.assertGreater(collection.total_guides, 0)
 
             # Verify AUTO mode was used
-            MockEnhancer.assert_called_once_with(mode='auto')
+            MockEnhancer.assert_called_once_with(mode="auto")
 
     def test_graceful_fallback_when_ai_fails(self):
         """Test graceful fallback when AI enhancement fails"""
@@ -890,39 +880,39 @@ def test_database_migration():
 
         examples = [
             {
-                'example_id': 'test_005',
-                'test_name': 'test_file_processing',
-                'category': 'workflow',
-                'code': '''
+                "example_id": "test_005",
+                "test_name": "test_file_processing",
+                "category": "workflow",
+                "code": """
 def test_file_processing():
     processor = FileProcessor()
     result = processor.process("data.csv")
     assert result.rows == 100
-                ''',
-                'language': 'python',
-                'file_path': 'tests/test_files.py',
-                'line_start': 50,
-                'tags': ['files', 'processing'],
-                'ai_analysis': {
-                    'tutorial_group': 'Data Processing',
-                    'best_practices': ['Validate file format'],
-                    'common_mistakes': ['Not handling encoding']
-                }
+                """,
+                "language": "python",
+                "file_path": "tests/test_files.py",
+                "line_start": 50,
+                "tags": ["files", "processing"],
+                "ai_analysis": {
+                    "tutorial_group": "Data Processing",
+                    "best_practices": ["Validate file format"],
+                    "common_mistakes": ["Not handling encoding"],
+                },
             }
         ]
 
         builder = HowToGuideBuilder()
-        output_dir = Path(self.temp_dir) / 'guides_fallback'
+        output_dir = Path(self.temp_dir) / "guides_fallback"
 
         # Mock GuideEnhancer to raise exception
-        with patch('skill_seekers.cli.guide_enhancer.GuideEnhancer', side_effect=Exception("AI unavailable")):
+        with patch("skill_seekers.cli.guide_enhancer.GuideEnhancer", side_effect=Exception("AI unavailable")):
             # Should NOT crash - graceful fallback
             collection = builder.build_guides_from_examples(
                 examples=examples,
-                grouping_strategy='ai-tutorial-group',
+                grouping_strategy="ai-tutorial-group",
                 output_dir=output_dir,
                 enhance_with_ai=True,
-                ai_mode='api'
+                ai_mode="api",
             )
 
             # Verify guides were still created (without enhancement)
@@ -930,5 +920,5 @@ def test_file_processing():
             self.assertGreater(collection.total_guides, 0)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_install_agent.py b/tests/test_install_agent.py
index 3bdb2ea..84debf0 100644
--- a/tests/test_install_agent.py
+++ b/tests/test_install_agent.py
@@ -10,25 +10,25 @@ Tests cover:
 - CLI interface
 """
 
-import pytest
-import tempfile
 import shutil
-from pathlib import Path
-from unittest.mock import patch, MagicMock
 import sys
+import tempfile
+from pathlib import Path
+from unittest.mock import patch
+
+import pytest
 
 # Add src to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
 
 from skill_seekers.cli.install_agent import (
-    AGENT_PATHS,
     get_agent_path,
     get_available_agents,
-    validate_agent_name,
-    validate_skill_directory,
     install_to_agent,
     install_to_all_agents,
     main,
+    validate_agent_name,
+    validate_skill_directory,
 )
 
 
@@ -38,50 +38,50 @@ class TestAgentPathMapping:
     def test_get_agent_path_home_expansion(self):
         """Test that ~ expands to home directory for global agents."""
         # Test claude (global agent with ~)
-        path = get_agent_path('claude')
+        path = get_agent_path("claude")
         assert path.is_absolute()
-        assert '.claude' in str(path)
+        assert ".claude" in str(path)
         assert str(path).startswith(str(Path.home()))
 
     def test_get_agent_path_project_relative(self):
         """Test that project-relative paths use current directory."""
         # Test cursor (project-relative agent)
-        path = get_agent_path('cursor')
+        path = get_agent_path("cursor")
         assert path.is_absolute()
-        assert '.cursor' in str(path)
+        assert ".cursor" in str(path)
         # Should be relative to current directory
         assert str(Path.cwd()) in str(path)
 
     def test_get_agent_path_project_relative_with_custom_root(self):
         """Test project-relative paths with custom project root."""
-        custom_root = Path('/tmp/test-project')
-        path = get_agent_path('cursor', project_root=custom_root)
+        custom_root = Path("/tmp/test-project")
+        path = get_agent_path("cursor", project_root=custom_root)
         assert path.is_absolute()
         assert str(custom_root) in str(path)
-        assert '.cursor' in str(path)
+        assert ".cursor" in str(path)
 
     def test_get_agent_path_invalid_agent(self):
         """Test that invalid agent raises ValueError."""
         with pytest.raises(ValueError, match="Unknown agent"):
-            get_agent_path('invalid_agent')
+            get_agent_path("invalid_agent")
 
     def test_get_available_agents(self):
         """Test that all 11 agents are listed."""
         agents = get_available_agents()
         assert len(agents) == 11
-        assert 'claude' in agents
-        assert 'cursor' in agents
-        assert 'vscode' in agents
-        assert 'amp' in agents
-        assert 'goose' in agents
-        assert 'neovate' in agents
+        assert "claude" in agents
+        assert "cursor" in agents
+        assert "vscode" in agents
+        assert "amp" in agents
+        assert "goose" in agents
+        assert "neovate" in agents
         assert sorted(agents) == agents  # Should be sorted
 
     def test_agent_path_case_insensitive(self):
         """Test that agent names are case-insensitive."""
-        path_lower = get_agent_path('claude')
-        path_upper = get_agent_path('CLAUDE')
-        path_mixed = get_agent_path('Claude')
+        path_lower = get_agent_path("claude")
+        path_upper = get_agent_path("CLAUDE")
+        path_mixed = get_agent_path("Claude")
         assert path_lower == path_upper == path_mixed
 
 
@@ -90,36 +90,36 @@ class TestAgentNameValidation:
 
     def test_validate_valid_agent(self):
         """Test that valid agent names pass validation."""
-        is_valid, error = validate_agent_name('claude')
+        is_valid, error = validate_agent_name("claude")
         assert is_valid is True
         assert error is None
 
     def test_validate_invalid_agent_suggests_similar(self):
         """Test that similar agent names are suggested for typos."""
-        is_valid, error = validate_agent_name('courser')
+        is_valid, error = validate_agent_name("courser")
         assert is_valid is False
-        assert 'cursor' in error.lower()  # Should suggest 'cursor'
+        assert "cursor" in error.lower()  # Should suggest 'cursor'
 
     def test_validate_special_all(self):
         """Test that 'all' is a valid special agent name."""
-        is_valid, error = validate_agent_name('all')
+        is_valid, error = validate_agent_name("all")
         assert is_valid is True
         assert error is None
 
     def test_validate_case_insensitive(self):
         """Test that validation is case-insensitive."""
-        for name in ['Claude', 'CLAUDE', 'claude', 'cLaUdE']:
+        for name in ["Claude", "CLAUDE", "claude", "cLaUdE"]:
             is_valid, error = validate_agent_name(name)
             assert is_valid is True
             assert error is None
 
     def test_validate_shows_available_agents(self):
         """Test that error message shows available agents."""
-        is_valid, error = validate_agent_name('invalid')
+        is_valid, error = validate_agent_name("invalid")
         assert is_valid is False
-        assert 'available agents' in error.lower()
-        assert 'claude' in error.lower()
-        assert 'cursor' in error.lower()
+        assert "available agents" in error.lower()
+        assert "claude" in error.lower()
+        assert "cursor" in error.lower()
 
 
 class TestSkillDirectoryValidation:
@@ -195,8 +195,8 @@ class TestInstallToAgent:
         with tempfile.TemporaryDirectory() as agent_tmpdir:
             agent_path = Path(agent_tmpdir) / ".claude" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', return_value=agent_path):
-                success, message = install_to_agent(self.skill_dir, 'claude', force=True)
+            with patch("skill_seekers.cli.install_agent.get_agent_path", return_value=agent_path):
+                success, message = install_to_agent(self.skill_dir, "claude", force=True)
 
                 assert success is True
                 target_path = agent_path / "test-skill"
@@ -208,8 +208,8 @@ class TestInstallToAgent:
         with tempfile.TemporaryDirectory() as agent_tmpdir:
             agent_path = Path(agent_tmpdir) / ".claude" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', return_value=agent_path):
-                success, message = install_to_agent(self.skill_dir, 'claude', force=True)
+            with patch("skill_seekers.cli.install_agent.get_agent_path", return_value=agent_path):
+                success, message = install_to_agent(self.skill_dir, "claude", force=True)
 
                 assert success is True
                 target_path = agent_path / "test-skill"
@@ -230,8 +230,8 @@ class TestInstallToAgent:
         with tempfile.TemporaryDirectory() as agent_tmpdir:
             agent_path = Path(agent_tmpdir) / ".claude" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', return_value=agent_path):
-                success, message = install_to_agent(self.skill_dir, 'claude', force=True)
+            with patch("skill_seekers.cli.install_agent.get_agent_path", return_value=agent_path):
+                success, message = install_to_agent(self.skill_dir, "claude", force=True)
 
                 assert success is True
                 target_path = agent_path / "test-skill"
@@ -248,8 +248,8 @@ class TestInstallToAgent:
             target_path = agent_path / "test-skill"
             target_path.mkdir(parents=True)
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', return_value=agent_path):
-                success, message = install_to_agent(self.skill_dir, 'claude', force=False)
+            with patch("skill_seekers.cli.install_agent.get_agent_path", return_value=agent_path):
+                success, message = install_to_agent(self.skill_dir, "claude", force=False)
 
                 assert success is False
                 assert "already installed" in message.lower()
@@ -263,8 +263,8 @@ class TestInstallToAgent:
             target_path.mkdir(parents=True)
             (target_path / "old_file.txt").write_text("old content")
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', return_value=agent_path):
-                success, message = install_to_agent(self.skill_dir, 'claude', force=True)
+            with patch("skill_seekers.cli.install_agent.get_agent_path", return_value=agent_path):
+                success, message = install_to_agent(self.skill_dir, "claude", force=True)
 
                 assert success is True
                 # Old file should be gone
@@ -276,7 +276,7 @@ class TestInstallToAgent:
         """Test that installation fails for invalid skill directory."""
         invalid_dir = Path("/nonexistent/directory")
 
-        success, message = install_to_agent(invalid_dir, 'claude')
+        success, message = install_to_agent(invalid_dir, "claude")
 
         assert success is False
         assert "does not exist" in message
@@ -287,7 +287,7 @@ class TestInstallToAgent:
             bad_skill_dir = Path(tmpdir) / "bad-skill"
             bad_skill_dir.mkdir()
 
-            success, message = install_to_agent(bad_skill_dir, 'claude')
+            success, message = install_to_agent(bad_skill_dir, "claude")
 
             assert success is False
             assert "SKILL.md not found" in message
@@ -297,8 +297,8 @@ class TestInstallToAgent:
         with tempfile.TemporaryDirectory() as agent_tmpdir:
             agent_path = Path(agent_tmpdir) / ".claude" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', return_value=agent_path):
-                success, message = install_to_agent(self.skill_dir, 'claude', dry_run=True)
+            with patch("skill_seekers.cli.install_agent.get_agent_path", return_value=agent_path):
+                success, message = install_to_agent(self.skill_dir, "claude", dry_run=True)
 
                 assert success is True
                 assert "DRY RUN" in message
@@ -324,15 +324,16 @@ class TestInstallToAllAgents:
     def test_install_to_all_success(self):
         """Test that install_to_all_agents attempts all 11 agents."""
         with tempfile.TemporaryDirectory() as agent_tmpdir:
+
             def mock_get_agent_path(agent_name, project_root=None):
                 return Path(agent_tmpdir) / f".{agent_name}" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', side_effect=mock_get_agent_path):
+            with patch("skill_seekers.cli.install_agent.get_agent_path", side_effect=mock_get_agent_path):
                 results = install_to_all_agents(self.skill_dir, force=True)
 
                 assert len(results) == 11
-                assert 'claude' in results
-                assert 'cursor' in results
+                assert "claude" in results
+                assert "cursor" in results
 
     def test_install_to_all_partial_success(self):
         """Test that install_to_all collects both successes and failures."""
@@ -356,7 +357,7 @@ class TestInstallToAllAgents:
             def mock_get_agent_path(agent_name, project_root=None):
                 return Path(agent_tmpdir) / f".{agent_name}" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', side_effect=mock_get_agent_path):
+            with patch("skill_seekers.cli.install_agent.get_agent_path", side_effect=mock_get_agent_path):
                 # Without force - should fail
                 results_no_force = install_to_all_agents(self.skill_dir, force=False)
                 # All should fail because directories exist
@@ -399,9 +400,8 @@ class TestInstallAgentCLI:
 
     def test_cli_help_output(self):
         """Test that --help shows usage information."""
-        with pytest.raises(SystemExit) as exc_info:
-            with patch('sys.argv', ['install_agent.py', '--help']):
-                main()
+        with pytest.raises(SystemExit) as exc_info, patch("sys.argv", ["install_agent.py", "--help"]):
+            main()
 
         # --help exits with code 0
         assert exc_info.value.code == 0
@@ -409,7 +409,7 @@ class TestInstallAgentCLI:
     def test_cli_requires_agent_flag(self):
         """Test that CLI fails without --agent flag."""
         with pytest.raises(SystemExit) as exc_info:
-            with patch('sys.argv', ['install_agent.py', str(self.skill_dir)]):
+            with patch("sys.argv", ["install_agent.py", str(self.skill_dir)]):
                 main()
 
         # Missing required argument exits with code 2
@@ -418,11 +418,12 @@ class TestInstallAgentCLI:
     def test_cli_dry_run(self):
         """Test that --dry-run flag works correctly."""
         with tempfile.TemporaryDirectory() as agent_tmpdir:
+
             def mock_get_agent_path(agent_name, project_root=None):
                 return Path(agent_tmpdir) / f".{agent_name}" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', side_effect=mock_get_agent_path):
-                with patch('sys.argv', ['install_agent.py', str(self.skill_dir), '--agent', 'claude', '--dry-run']):
+            with patch("skill_seekers.cli.install_agent.get_agent_path", side_effect=mock_get_agent_path):
+                with patch("sys.argv", ["install_agent.py", str(self.skill_dir), "--agent", "claude", "--dry-run"]):
                     exit_code = main()
 
                     assert exit_code == 0
@@ -432,11 +433,12 @@ class TestInstallAgentCLI:
     def test_cli_integration(self):
         """Test end-to-end CLI execution."""
         with tempfile.TemporaryDirectory() as agent_tmpdir:
+
             def mock_get_agent_path(agent_name, project_root=None):
                 return Path(agent_tmpdir) / f".{agent_name}" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', side_effect=mock_get_agent_path):
-                with patch('sys.argv', ['install_agent.py', str(self.skill_dir), '--agent', 'claude', '--force']):
+            with patch("skill_seekers.cli.install_agent.get_agent_path", side_effect=mock_get_agent_path):
+                with patch("sys.argv", ["install_agent.py", str(self.skill_dir), "--agent", "claude", "--force"]):
                     exit_code = main()
 
                     assert exit_code == 0
@@ -448,11 +450,12 @@ class TestInstallAgentCLI:
     def test_cli_install_to_all(self):
         """Test CLI with --agent all."""
         with tempfile.TemporaryDirectory() as agent_tmpdir:
+
             def mock_get_agent_path(agent_name, project_root=None):
                 return Path(agent_tmpdir) / f".{agent_name}" / "skills"
 
-            with patch('skill_seekers.cli.install_agent.get_agent_path', side_effect=mock_get_agent_path):
-                with patch('sys.argv', ['install_agent.py', str(self.skill_dir), '--agent', 'all', '--force']):
+            with patch("skill_seekers.cli.install_agent.get_agent_path", side_effect=mock_get_agent_path):
+                with patch("sys.argv", ["install_agent.py", str(self.skill_dir), "--agent", "all", "--force"]):
                     exit_code = main()
 
                     assert exit_code == 0
diff --git a/tests/test_install_multiplatform.py b/tests/test_install_multiplatform.py
index 5edfe04..11d6eb4 100644
--- a/tests/test_install_multiplatform.py
+++ b/tests/test_install_multiplatform.py
@@ -4,9 +4,8 @@ Tests for multi-platform install workflow
 """
 
 import unittest
-from unittest.mock import patch, MagicMock, AsyncMock
-import asyncio
 from pathlib import Path
+from unittest.mock import MagicMock, patch
 
 
 class TestInstallCLI(unittest.TestCase):
@@ -16,7 +15,6 @@ class TestInstallCLI(unittest.TestCase):
         """Test that CLI accepts --target flag"""
         import argparse
         import sys
-        from pathlib import Path
 
         # Mock sys.path to import install_skill module
         sys.path.insert(0, str(Path(__file__).parent.parent / "src" / "skill_seekers" / "cli"))
@@ -25,16 +23,16 @@ class TestInstallCLI(unittest.TestCase):
             # Create parser like install_skill.py does
             parser = argparse.ArgumentParser()
             parser.add_argument("--config", required=True)
-            parser.add_argument("--target", choices=['claude', 'gemini', 'openai', 'markdown'], default='claude')
+            parser.add_argument("--target", choices=["claude", "gemini", "openai", "markdown"], default="claude")
 
             # Test that each platform is accepted
-            for platform in ['claude', 'gemini', 'openai', 'markdown']:
-                args = parser.parse_args(['--config', 'test', '--target', platform])
+            for platform in ["claude", "gemini", "openai", "markdown"]:
+                args = parser.parse_args(["--config", "test", "--target", platform])
                 self.assertEqual(args.target, platform)
 
             # Test default is claude
-            args = parser.parse_args(['--config', 'test'])
-            self.assertEqual(args.target, 'claude')
+            args = parser.parse_args(["--config", "test"])
+            self.assertEqual(args.target, "claude")
 
         finally:
             sys.path.pop(0)
@@ -45,11 +43,11 @@ class TestInstallCLI(unittest.TestCase):
 
         parser = argparse.ArgumentParser()
         parser.add_argument("--config", required=True)
-        parser.add_argument("--target", choices=['claude', 'gemini', 'openai', 'markdown'], default='claude')
+        parser.add_argument("--target", choices=["claude", "gemini", "openai", "markdown"], default="claude")
 
         # Should raise SystemExit for invalid target
         with self.assertRaises(SystemExit):
-            parser.parse_args(['--config', 'test', '--target', 'invalid'])
+            parser.parse_args(["--config", "test", "--target", "invalid"])
 
 
 class TestInstallToolMultiPlatform(unittest.IsolatedAsyncioTestCase):
@@ -61,24 +59,20 @@ class TestInstallToolMultiPlatform(unittest.IsolatedAsyncioTestCase):
 
         # Just test dry_run mode which doesn't need mocking all internal tools
         # Test with each platform
-        for target in ['claude', 'gemini', 'openai']:
+        for target in ["claude", "gemini", "openai"]:
             # Use dry_run=True which skips actual execution
             # It will still show us the platform is being recognized
-            with patch('builtins.open', create=True) as mock_open, \
-                 patch('json.load') as mock_json_load:
-
+            with patch("builtins.open", create=True) as mock_open, patch("json.load") as mock_json_load:
                 # Mock config file reading
-                mock_json_load.return_value = {'name': 'test-skill'}
+                mock_json_load.return_value = {"name": "test-skill"}
                 mock_file = MagicMock()
                 mock_file.__enter__ = lambda s: s
                 mock_file.__exit__ = MagicMock()
                 mock_open.return_value = mock_file
 
-                result = await install_skill_tool({
-                    "config_path": "configs/test.json",
-                    "target": target,
-                    "dry_run": True
-                })
+                result = await install_skill_tool(
+                    {"config_path": "configs/test.json", "target": target, "dry_run": True}
+                )
 
                 # Verify result mentions the correct platform
                 result_text = result[0].text
@@ -87,11 +81,10 @@ class TestInstallToolMultiPlatform(unittest.IsolatedAsyncioTestCase):
 
     async def test_install_tool_uses_correct_adaptor(self):
         """Test that install_skill_tool uses the correct adaptor for each platform"""
-        from skill_seekers.mcp.tools.packaging_tools import install_skill_tool
         from skill_seekers.cli.adaptors import get_adaptor
 
         # Test that each platform creates the right adaptor
-        for target in ['claude', 'gemini', 'openai', 'markdown']:
+        for target in ["claude", "gemini", "openai", "markdown"]:
             adaptor = get_adaptor(target)
             self.assertEqual(adaptor.PLATFORM, target)
 
@@ -100,16 +93,16 @@ class TestInstallToolMultiPlatform(unittest.IsolatedAsyncioTestCase):
         from skill_seekers.cli.adaptors import get_adaptor
 
         # Test API key env var names
-        claude_adaptor = get_adaptor('claude')
-        self.assertEqual(claude_adaptor.get_env_var_name(), 'ANTHROPIC_API_KEY')
+        claude_adaptor = get_adaptor("claude")
+        self.assertEqual(claude_adaptor.get_env_var_name(), "ANTHROPIC_API_KEY")
 
-        gemini_adaptor = get_adaptor('gemini')
-        self.assertEqual(gemini_adaptor.get_env_var_name(), 'GOOGLE_API_KEY')
+        gemini_adaptor = get_adaptor("gemini")
+        self.assertEqual(gemini_adaptor.get_env_var_name(), "GOOGLE_API_KEY")
 
-        openai_adaptor = get_adaptor('openai')
-        self.assertEqual(openai_adaptor.get_env_var_name(), 'OPENAI_API_KEY')
+        openai_adaptor = get_adaptor("openai")
+        self.assertEqual(openai_adaptor.get_env_var_name(), "OPENAI_API_KEY")
 
-        markdown_adaptor = get_adaptor('markdown')
+        markdown_adaptor = get_adaptor("markdown")
         # Markdown doesn't need an API key, but should still have a method
         self.assertIsNotNone(markdown_adaptor.get_env_var_name())
 
@@ -123,10 +116,10 @@ class TestInstallWorkflowIntegration(unittest.IsolatedAsyncioTestCase):
 
         # Test each platform shows correct platform name
         platforms = {
-            'claude': 'Claude AI (Anthropic)',
-            'gemini': 'Google Gemini',
-            'openai': 'OpenAI ChatGPT',
-            'markdown': 'Generic Markdown (Universal)'
+            "claude": "Claude AI (Anthropic)",
+            "gemini": "Google Gemini",
+            "openai": "OpenAI ChatGPT",
+            "markdown": "Generic Markdown (Universal)",
         }
 
         for target, expected_name in platforms.items():
@@ -134,5 +127,5 @@ class TestInstallWorkflowIntegration(unittest.IsolatedAsyncioTestCase):
             self.assertEqual(adaptor.PLATFORM_NAME, expected_name)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_install_skill.py b/tests/test_install_skill.py
index aef7cb7..0db4e7a 100644
--- a/tests/test_install_skill.py
+++ b/tests/test_install_skill.py
@@ -10,13 +10,14 @@ Tests the complete workflow orchestration for A1.7:
 - CLI integration
 """
 
-import asyncio
+from unittest.mock import MagicMock, patch
+
 import pytest
-from unittest.mock import AsyncMock, MagicMock, patch
 
 # Defensive import for MCP package (may not be installed in all environments)
 try:
     from mcp.types import TextContent
+
     MCP_AVAILABLE = True
 except ImportError:
     MCP_AVAILABLE = False
@@ -43,10 +44,7 @@ class TestInstallSkillValidation:
     @pytest.mark.asyncio
     async def test_validation_both_configs(self):
         """Test error when both config_name and config_path provided"""
-        result = await install_skill_tool({
-            "config_name": "react",
-            "config_path": "configs/react.json"
-        })
+        result = await install_skill_tool({"config_name": "react", "config_path": "configs/react.json"})
 
         assert len(result) == 1
         assert isinstance(result[0], TextContent)
@@ -61,10 +59,7 @@ class TestInstallSkillDryRun:
     @pytest.mark.asyncio
     async def test_dry_run_with_config_name(self):
         """Test dry run with config name (includes fetch phase)"""
-        result = await install_skill_tool({
-            "config_name": "react",
-            "dry_run": True
-        })
+        result = await install_skill_tool({"config_name": "react", "dry_run": True})
 
         assert len(result) == 1
         output = result[0].text
@@ -87,10 +82,7 @@ class TestInstallSkillDryRun:
     @pytest.mark.asyncio
     async def test_dry_run_with_config_path(self):
         """Test dry run with config path (skips fetch phase)"""
-        result = await install_skill_tool({
-            "config_path": "configs/react.json",
-            "dry_run": True
-        })
+        result = await install_skill_tool({"config_path": "configs/react.json", "dry_run": True})
 
         assert len(result) == 1
         output = result[0].text
@@ -116,17 +108,13 @@ class TestInstallSkillEnhancementMandatory:
     @pytest.mark.asyncio
     async def test_enhancement_is_mandatory(self):
         """Test that enhancement phase is always present and mandatory"""
-        result = await install_skill_tool({
-            "config_name": "react",
-            "dry_run": True
-        })
+        result = await install_skill_tool({"config_name": "react", "dry_run": True})
 
         output = result[0].text
 
         # Verify enhancement phase is present
         assert "AI Enhancement (MANDATORY)" in output
-        assert "Enhancement is REQUIRED for quality (3/10→9/10 boost)" in output or \
-               "REQUIRED for quality" in output
+        assert "Enhancement is REQUIRED for quality (3/10→9/10 boost)" in output or "REQUIRED for quality" in output
 
         # Verify it's not optional
         assert "MANDATORY" in output
@@ -138,66 +126,49 @@ class TestInstallSkillPhaseOrchestration:
     """Test phase orchestration and data flow"""
 
     @pytest.mark.asyncio
-    @patch('skill_seekers.mcp.server.fetch_config_tool')
-    @patch('skill_seekers.mcp.server.scrape_docs_tool')
-    @patch('skill_seekers.mcp.server.run_subprocess_with_streaming')
-    @patch('skill_seekers.mcp.server.package_skill_tool')
-    @patch('skill_seekers.mcp.server.upload_skill_tool')
-    @patch('builtins.open')
-    @patch('os.environ.get')
+    @patch("skill_seekers.mcp.server.fetch_config_tool")
+    @patch("skill_seekers.mcp.server.scrape_docs_tool")
+    @patch("skill_seekers.mcp.server.run_subprocess_with_streaming")
+    @patch("skill_seekers.mcp.server.package_skill_tool")
+    @patch("skill_seekers.mcp.server.upload_skill_tool")
+    @patch("builtins.open")
+    @patch("os.environ.get")
     async def test_full_workflow_with_fetch(
-        self,
-        mock_env_get,
-        mock_open,
-        mock_upload,
-        mock_package,
-        mock_subprocess,
-        mock_scrape,
-        mock_fetch
+        self, mock_env_get, mock_open, mock_upload, mock_package, mock_subprocess, mock_scrape, mock_fetch
     ):
         """Test complete workflow when config_name is provided"""
 
         # Mock fetch_config response
-        mock_fetch.return_value = [TextContent(
-            type="text",
-            text="✅ Config fetched successfully\n\nConfig saved to: configs/react.json"
-        )]
+        mock_fetch.return_value = [
+            TextContent(type="text", text="✅ Config fetched successfully\n\nConfig saved to: configs/react.json")
+        ]
 
         # Mock config file read
         import json
+
         mock_file = MagicMock()
         mock_file.__enter__.return_value.read.return_value = json.dumps({"name": "react"})
         mock_open.return_value = mock_file
 
         # Mock scrape_docs response
-        mock_scrape.return_value = [TextContent(
-            type="text",
-            text="✅ Scraping complete\n\nSkill built at: output/react/"
-        )]
+        mock_scrape.return_value = [
+            TextContent(type="text", text="✅ Scraping complete\n\nSkill built at: output/react/")
+        ]
 
         # Mock enhancement subprocess
         mock_subprocess.return_value = ("✅ Enhancement complete", "", 0)
 
         # Mock package response
-        mock_package.return_value = [TextContent(
-            type="text",
-            text="✅ Package complete\n\nSaved to: output/react.zip"
-        )]
+        mock_package.return_value = [TextContent(type="text", text="✅ Package complete\n\nSaved to: output/react.zip")]
 
         # Mock upload response
-        mock_upload.return_value = [TextContent(
-            type="text",
-            text="✅ Upload successful"
-        )]
+        mock_upload.return_value = [TextContent(type="text", text="✅ Upload successful")]
 
         # Mock env (has API key)
         mock_env_get.return_value = "sk-ant-test-key"
 
         # Run the workflow
-        result = await install_skill_tool({
-            "config_name": "react",
-            "auto_upload": True
-        })
+        result = await install_skill_tool({"config_name": "react", "auto_upload": True})
 
         output = result[0].text
 
@@ -217,50 +188,39 @@ class TestInstallSkillPhaseOrchestration:
         assert "upload_skill" in output
 
     @pytest.mark.asyncio
-    @patch('skill_seekers.mcp.server.scrape_docs_tool')
-    @patch('skill_seekers.mcp.server.run_subprocess_with_streaming')
-    @patch('skill_seekers.mcp.server.package_skill_tool')
-    @patch('builtins.open')
-    @patch('os.environ.get')
+    @patch("skill_seekers.mcp.server.scrape_docs_tool")
+    @patch("skill_seekers.mcp.server.run_subprocess_with_streaming")
+    @patch("skill_seekers.mcp.server.package_skill_tool")
+    @patch("builtins.open")
+    @patch("os.environ.get")
     async def test_workflow_with_existing_config(
-        self,
-        mock_env_get,
-        mock_open,
-        mock_package,
-        mock_subprocess,
-        mock_scrape
+        self, mock_env_get, mock_open, mock_package, mock_subprocess, mock_scrape
     ):
         """Test workflow when config_path is provided (skips fetch)"""
 
         # Mock config file read
         import json
+
         mock_file = MagicMock()
         mock_file.__enter__.return_value.read.return_value = json.dumps({"name": "custom"})
         mock_open.return_value = mock_file
 
         # Mock scrape response
-        mock_scrape.return_value = [TextContent(
-            type="text",
-            text="✅ Scraping complete"
-        )]
+        mock_scrape.return_value = [TextContent(type="text", text="✅ Scraping complete")]
 
         # Mock enhancement subprocess
         mock_subprocess.return_value = ("✅ Enhancement complete", "", 0)
 
         # Mock package response
-        mock_package.return_value = [TextContent(
-            type="text",
-            text="✅ Package complete\n\nSaved to: output/custom.zip"
-        )]
+        mock_package.return_value = [
+            TextContent(type="text", text="✅ Package complete\n\nSaved to: output/custom.zip")
+        ]
 
         # Mock env (no API key - should skip upload)
         mock_env_get.return_value = ""
 
         # Run the workflow
-        result = await install_skill_tool({
-            "config_path": "configs/custom.json",
-            "auto_upload": True
-        })
+        result = await install_skill_tool({"config_path": "configs/custom.json", "auto_upload": True})
 
         output = result[0].text
 
@@ -283,19 +243,14 @@ class TestInstallSkillErrorHandling:
     """Test error handling at each phase"""
 
     @pytest.mark.asyncio
-    @patch('skill_seekers.mcp.server.fetch_config_tool')
+    @patch("skill_seekers.mcp.server.fetch_config_tool")
     async def test_fetch_phase_failure(self, mock_fetch):
         """Test handling of fetch phase failure"""
 
         # Mock fetch failure
-        mock_fetch.return_value = [TextContent(
-            type="text",
-            text="❌ Failed to fetch config: Network error"
-        )]
+        mock_fetch.return_value = [TextContent(type="text", text="❌ Failed to fetch config: Network error")]
 
-        result = await install_skill_tool({
-            "config_name": "react"
-        })
+        result = await install_skill_tool({"config_name": "react"})
 
         output = result[0].text
 
@@ -303,26 +258,22 @@ class TestInstallSkillErrorHandling:
         assert "❌ Failed to fetch config" in output
 
     @pytest.mark.asyncio
-    @patch('skill_seekers.mcp.server.scrape_docs_tool')
-    @patch('builtins.open')
+    @patch("skill_seekers.mcp.server.scrape_docs_tool")
+    @patch("builtins.open")
     async def test_scrape_phase_failure(self, mock_open, mock_scrape):
         """Test handling of scrape phase failure"""
 
         # Mock config read
         import json
+
         mock_file = MagicMock()
         mock_file.__enter__.return_value.read.return_value = json.dumps({"name": "test"})
         mock_open.return_value = mock_file
 
         # Mock scrape failure
-        mock_scrape.return_value = [TextContent(
-            type="text",
-            text="❌ Scraping failed: Connection timeout"
-        )]
+        mock_scrape.return_value = [TextContent(type="text", text="❌ Scraping failed: Connection timeout")]
 
-        result = await install_skill_tool({
-            "config_path": "configs/test.json"
-        })
+        result = await install_skill_tool({"config_path": "configs/test.json"})
 
         output = result[0].text
 
@@ -331,30 +282,26 @@ class TestInstallSkillErrorHandling:
         assert "WORKFLOW COMPLETE" not in output
 
     @pytest.mark.asyncio
-    @patch('skill_seekers.mcp.server.scrape_docs_tool')
-    @patch('skill_seekers.mcp.server.run_subprocess_with_streaming')
-    @patch('builtins.open')
+    @patch("skill_seekers.mcp.server.scrape_docs_tool")
+    @patch("skill_seekers.mcp.server.run_subprocess_with_streaming")
+    @patch("builtins.open")
     async def test_enhancement_phase_failure(self, mock_open, mock_subprocess, mock_scrape):
         """Test handling of enhancement phase failure"""
 
         # Mock config read
         import json
+
         mock_file = MagicMock()
         mock_file.__enter__.return_value.read.return_value = json.dumps({"name": "test"})
         mock_open.return_value = mock_file
 
         # Mock scrape success
-        mock_scrape.return_value = [TextContent(
-            type="text",
-            text="✅ Scraping complete"
-        )]
+        mock_scrape.return_value = [TextContent(type="text", text="✅ Scraping complete")]
 
         # Mock enhancement failure
         mock_subprocess.return_value = ("", "Enhancement error: Claude not found", 1)
 
-        result = await install_skill_tool({
-            "config_path": "configs/test.json"
-        })
+        result = await install_skill_tool({"config_path": "configs/test.json"})
 
         output = result[0].text
 
@@ -370,11 +317,7 @@ class TestInstallSkillOptions:
     @pytest.mark.asyncio
     async def test_no_upload_option(self):
         """Test that no_upload option skips upload phase"""
-        result = await install_skill_tool({
-            "config_name": "react",
-            "auto_upload": False,
-            "dry_run": True
-        })
+        result = await install_skill_tool({"config_name": "react", "auto_upload": False, "dry_run": True})
 
         output = result[0].text
 
@@ -385,11 +328,7 @@ class TestInstallSkillOptions:
     @pytest.mark.asyncio
     async def test_unlimited_option(self):
         """Test that unlimited option is passed to scraper"""
-        result = await install_skill_tool({
-            "config_path": "configs/react.json",
-            "unlimited": True,
-            "dry_run": True
-        })
+        result = await install_skill_tool({"config_path": "configs/react.json", "unlimited": True, "dry_run": True})
 
         output = result[0].text
 
@@ -399,11 +338,7 @@ class TestInstallSkillOptions:
     @pytest.mark.asyncio
     async def test_custom_destination(self):
         """Test custom destination directory"""
-        result = await install_skill_tool({
-            "config_name": "react",
-            "destination": "/tmp/skills",
-            "dry_run": True
-        })
+        result = await install_skill_tool({"config_name": "react", "destination": "/tmp/skills", "dry_run": True})
 
         output = result[0].text
 
diff --git a/tests/test_install_skill_e2e.py b/tests/test_install_skill_e2e.py
index 72cd0d4..eeacd39 100644
--- a/tests/test_install_skill_e2e.py
+++ b/tests/test_install_skill_e2e.py
@@ -36,21 +36,18 @@ Combined with unit tests: 24 total tests (23 passed, 1 skipped)
 Run with: pytest tests/test_install_skill.py tests/test_install_skill_e2e.py -v
 """
 
-import asyncio
 import json
-import os
-import shutil
 import subprocess
 import sys
-import tempfile
 from pathlib import Path
-from unittest.mock import patch, MagicMock
+from unittest.mock import MagicMock, patch
 
 import pytest
 
 # Defensive import for MCP package (may not be installed in all environments)
 try:
     from mcp.types import TextContent
+
     MCP_AVAILABLE = True
 except ImportError:
     MCP_AVAILABLE = False
@@ -71,25 +68,15 @@ class TestInstallSkillE2E:
             "name": "test-e2e",
             "description": "Test skill for E2E testing",
             "base_url": "https://example.com/docs/",
-            "selectors": {
-                "main_content": "article",
-                "title": "title",
-                "code_blocks": "pre"
-            },
-            "url_patterns": {
-                "include": ["/docs/"],
-                "exclude": ["/search", "/404"]
-            },
-            "categories": {
-                "getting_started": ["intro", "start"],
-                "api": ["api", "reference"]
-            },
+            "selectors": {"main_content": "article", "title": "title", "code_blocks": "pre"},
+            "url_patterns": {"include": ["/docs/"], "exclude": ["/search", "/404"]},
+            "categories": {"getting_started": ["intro", "start"], "api": ["api", "reference"]},
             "rate_limit": 0.1,
-            "max_pages": 5  # Keep it small for fast testing
+            "max_pages": 5,  # Keep it small for fast testing
         }
 
         config_path = tmp_path / "test-e2e.json"
-        with open(config_path, 'w') as f:
+        with open(config_path, "w") as f:
             json.dump(config, f, indent=2)
 
         return str(config_path)
@@ -112,34 +99,33 @@ class TestInstallSkillE2E:
         """E2E test: config_path mode, no upload"""
 
         # Mock the subprocess calls for scraping and enhancement
-        with patch('skill_seekers.mcp.server.scrape_docs_tool') as mock_scrape, \
-             patch('skill_seekers.mcp.server.run_subprocess_with_streaming') as mock_enhance, \
-             patch('skill_seekers.mcp.server.package_skill_tool') as mock_package:
-
+        with (
+            patch("skill_seekers.mcp.server.scrape_docs_tool") as mock_scrape,
+            patch("skill_seekers.mcp.server.run_subprocess_with_streaming") as mock_enhance,
+            patch("skill_seekers.mcp.server.package_skill_tool") as mock_package,
+        ):
             # Mock scrape_docs to return success
-            mock_scrape.return_value = [TextContent(
-                type="text",
-                text=f"✅ Scraping complete\n\nSkill built at: {mock_scrape_output}"
-            )]
+            mock_scrape.return_value = [
+                TextContent(type="text", text=f"✅ Scraping complete\n\nSkill built at: {mock_scrape_output}")
+            ]
 
             # Mock enhancement subprocess (success)
             mock_enhance.return_value = ("✅ Enhancement complete", "", 0)
 
             # Mock package_skill to return success
             zip_path = str(tmp_path / "output" / "test-e2e.zip")
-            mock_package.return_value = [TextContent(
-                type="text",
-                text=f"✅ Package complete\n\nSaved to: {zip_path}"
-            )]
+            mock_package.return_value = [TextContent(type="text", text=f"✅ Package complete\n\nSaved to: {zip_path}")]
 
             # Run the tool
-            result = await install_skill_tool({
-                "config_path": test_config_file,
-                "destination": str(tmp_path / "output"),
-                "auto_upload": False,  # Skip upload
-                "unlimited": False,
-                "dry_run": False
-            })
+            result = await install_skill_tool(
+                {
+                    "config_path": test_config_file,
+                    "destination": str(tmp_path / "output"),
+                    "auto_upload": False,  # Skip upload
+                    "unlimited": False,
+                    "dry_run": False,
+                }
+            )
 
             # Verify output
             assert len(result) == 1
@@ -170,19 +156,19 @@ class TestInstallSkillE2E:
     async def test_e2e_with_config_name_fetch(self, tmp_path):
         """E2E test: config_name mode with fetch phase"""
 
-        with patch('skill_seekers.mcp.server.fetch_config_tool') as mock_fetch, \
-             patch('skill_seekers.mcp.server.scrape_docs_tool') as mock_scrape, \
-             patch('skill_seekers.mcp.server.run_subprocess_with_streaming') as mock_enhance, \
-             patch('skill_seekers.mcp.server.package_skill_tool') as mock_package, \
-             patch('builtins.open', create=True) as mock_file_open, \
-             patch('os.environ.get') as mock_env:
-
+        with (
+            patch("skill_seekers.mcp.server.fetch_config_tool") as mock_fetch,
+            patch("skill_seekers.mcp.server.scrape_docs_tool") as mock_scrape,
+            patch("skill_seekers.mcp.server.run_subprocess_with_streaming") as mock_enhance,
+            patch("skill_seekers.mcp.server.package_skill_tool") as mock_package,
+            patch("builtins.open", create=True) as mock_file_open,
+            patch("os.environ.get") as mock_env,
+        ):
             # Mock fetch_config to return success
             config_path = str(tmp_path / "configs" / "react.json")
-            mock_fetch.return_value = [TextContent(
-                type="text",
-                text=f"✅ Config fetched successfully\n\nConfig saved to: {config_path}"
-            )]
+            mock_fetch.return_value = [
+                TextContent(type="text", text=f"✅ Config fetched successfully\n\nConfig saved to: {config_path}")
+            ]
 
             # Mock config file read
             mock_config = MagicMock()
@@ -191,32 +177,30 @@ class TestInstallSkillE2E:
 
             # Mock scrape_docs
             skill_dir = str(tmp_path / "output" / "react")
-            mock_scrape.return_value = [TextContent(
-                type="text",
-                text=f"✅ Scraping complete\n\nSkill built at: {skill_dir}"
-            )]
+            mock_scrape.return_value = [
+                TextContent(type="text", text=f"✅ Scraping complete\n\nSkill built at: {skill_dir}")
+            ]
 
             # Mock enhancement
             mock_enhance.return_value = ("✅ Enhancement complete", "", 0)
 
             # Mock package
             zip_path = str(tmp_path / "output" / "react.zip")
-            mock_package.return_value = [TextContent(
-                type="text",
-                text=f"✅ Package complete\n\nSaved to: {zip_path}"
-            )]
+            mock_package.return_value = [TextContent(type="text", text=f"✅ Package complete\n\nSaved to: {zip_path}")]
 
             # Mock env (no API key - should skip upload)
             mock_env.return_value = ""
 
             # Run the tool
-            result = await install_skill_tool({
-                "config_name": "react",
-                "destination": str(tmp_path / "output"),
-                "auto_upload": True,  # Would upload if key present
-                "unlimited": False,
-                "dry_run": False
-            })
+            result = await install_skill_tool(
+                {
+                    "config_name": "react",
+                    "destination": str(tmp_path / "output"),
+                    "auto_upload": True,  # Would upload if key present
+                    "unlimited": False,
+                    "dry_run": False,
+                }
+            )
 
             # Verify output
             output = result[0].text
@@ -238,11 +222,7 @@ class TestInstallSkillE2E:
     async def test_e2e_dry_run_mode(self, test_config_file):
         """E2E test: dry-run mode (no actual execution)"""
 
-        result = await install_skill_tool({
-            "config_path": test_config_file,
-            "auto_upload": False,
-            "dry_run": True
-        })
+        result = await install_skill_tool({"config_path": test_config_file, "auto_upload": False, "dry_run": True})
 
         output = result[0].text
 
@@ -263,18 +243,11 @@ class TestInstallSkillE2E:
     async def test_e2e_error_handling_scrape_failure(self, test_config_file):
         """E2E test: error handling when scrape fails"""
 
-        with patch('skill_seekers.mcp.server.scrape_docs_tool') as mock_scrape:
+        with patch("skill_seekers.mcp.server.scrape_docs_tool") as mock_scrape:
             # Mock scrape failure
-            mock_scrape.return_value = [TextContent(
-                type="text",
-                text="❌ Scraping failed: Network timeout"
-            )]
+            mock_scrape.return_value = [TextContent(type="text", text="❌ Scraping failed: Network timeout")]
 
-            result = await install_skill_tool({
-                "config_path": test_config_file,
-                "auto_upload": False,
-                "dry_run": False
-            })
+            result = await install_skill_tool({"config_path": test_config_file, "auto_upload": False, "dry_run": False})
 
             output = result[0].text
 
@@ -286,23 +259,19 @@ class TestInstallSkillE2E:
     async def test_e2e_error_handling_enhancement_failure(self, test_config_file, mock_scrape_output):
         """E2E test: error handling when enhancement fails"""
 
-        with patch('skill_seekers.mcp.server.scrape_docs_tool') as mock_scrape, \
-             patch('skill_seekers.mcp.server.run_subprocess_with_streaming') as mock_enhance:
-
+        with (
+            patch("skill_seekers.mcp.server.scrape_docs_tool") as mock_scrape,
+            patch("skill_seekers.mcp.server.run_subprocess_with_streaming") as mock_enhance,
+        ):
             # Mock successful scrape
-            mock_scrape.return_value = [TextContent(
-                type="text",
-                text=f"✅ Scraping complete\n\nSkill built at: {mock_scrape_output}"
-            )]
+            mock_scrape.return_value = [
+                TextContent(type="text", text=f"✅ Scraping complete\n\nSkill built at: {mock_scrape_output}")
+            ]
 
             # Mock enhancement failure
             mock_enhance.return_value = ("", "Enhancement error: Claude not found", 1)
 
-            result = await install_skill_tool({
-                "config_path": test_config_file,
-                "auto_upload": False,
-                "dry_run": False
-            })
+            result = await install_skill_tool({"config_path": test_config_file, "auto_upload": False, "dry_run": False})
 
             output = result[0].text
 
@@ -322,22 +291,15 @@ class TestInstallSkillCLI_E2E:
             "name": "test-cli-e2e",
             "description": "Test skill for CLI E2E testing",
             "base_url": "https://example.com/docs/",
-            "selectors": {
-                "main_content": "article",
-                "title": "title",
-                "code_blocks": "pre"
-            },
-            "url_patterns": {
-                "include": ["/docs/"],
-                "exclude": []
-            },
+            "selectors": {"main_content": "article", "title": "title", "code_blocks": "pre"},
+            "url_patterns": {"include": ["/docs/"], "exclude": []},
             "categories": {},
             "rate_limit": 0.1,
-            "max_pages": 3
+            "max_pages": 3,
         }
 
         config_path = tmp_path / "test-cli-e2e.json"
-        with open(config_path, 'w') as f:
+        with open(config_path, "w") as f:
             json.dump(config, f, indent=2)
 
         return str(config_path)
@@ -349,11 +311,7 @@ class TestInstallSkillCLI_E2E:
         # Import and call the tool directly (more reliable than subprocess)
         from skill_seekers.mcp.server import install_skill_tool
 
-        result = await install_skill_tool({
-            "config_path": test_config_file,
-            "dry_run": True,
-            "auto_upload": False
-        })
+        result = await install_skill_tool({"config_path": test_config_file, "dry_run": True, "auto_upload": False})
 
         # Verify output
         output = result[0].text
@@ -366,9 +324,7 @@ class TestInstallSkillCLI_E2E:
 
         # Run CLI without config
         result = subprocess.run(
-            [sys.executable, "-m", "skill_seekers.cli.install_skill"],
-            capture_output=True,
-            text=True
+            [sys.executable, "-m", "skill_seekers.cli.install_skill"], capture_output=True, text=True
         )
 
         # Should fail
@@ -381,9 +337,7 @@ class TestInstallSkillCLI_E2E:
         """E2E test: CLI help command"""
 
         result = subprocess.run(
-            [sys.executable, "-m", "skill_seekers.cli.install_skill", "--help"],
-            capture_output=True,
-            text=True
+            [sys.executable, "-m", "skill_seekers.cli.install_skill", "--help"], capture_output=True, text=True
         )
 
         # Should succeed
@@ -397,36 +351,34 @@ class TestInstallSkillCLI_E2E:
         assert "--no-upload" in output
 
     @pytest.mark.asyncio
-    @patch('skill_seekers.mcp.server.scrape_docs_tool')
-    @patch('skill_seekers.mcp.server.run_subprocess_with_streaming')
-    @patch('skill_seekers.mcp.server.package_skill_tool')
+    @patch("skill_seekers.mcp.server.scrape_docs_tool")
+    @patch("skill_seekers.mcp.server.run_subprocess_with_streaming")
+    @patch("skill_seekers.mcp.server.package_skill_tool")
     async def test_cli_full_workflow_mocked(self, mock_package, mock_enhance, mock_scrape, test_config_file, tmp_path):
         """E2E test: Full CLI workflow with mocked phases (via direct call)"""
 
         # Setup mocks
         skill_dir = str(tmp_path / "output" / "test-cli-e2e")
-        mock_scrape.return_value = [TextContent(
-            type="text",
-            text=f"✅ Scraping complete\n\nSkill built at: {skill_dir}"
-        )]
+        mock_scrape.return_value = [
+            TextContent(type="text", text=f"✅ Scraping complete\n\nSkill built at: {skill_dir}")
+        ]
 
         mock_enhance.return_value = ("✅ Enhancement complete", "", 0)
 
         zip_path = str(tmp_path / "output" / "test-cli-e2e.zip")
-        mock_package.return_value = [TextContent(
-            type="text",
-            text=f"✅ Package complete\n\nSaved to: {zip_path}"
-        )]
+        mock_package.return_value = [TextContent(type="text", text=f"✅ Package complete\n\nSaved to: {zip_path}")]
 
         # Call the tool directly
         from skill_seekers.mcp.server import install_skill_tool
 
-        result = await install_skill_tool({
-            "config_path": test_config_file,
-            "destination": str(tmp_path / "output"),
-            "auto_upload": False,
-            "dry_run": False
-        })
+        result = await install_skill_tool(
+            {
+                "config_path": test_config_file,
+                "destination": str(tmp_path / "output"),
+                "auto_upload": False,
+                "dry_run": False,
+            }
+        )
 
         # Verify success
         output = result[0].text
@@ -434,7 +386,9 @@ class TestInstallSkillCLI_E2E:
         assert "Enhancement" in output or "MANDATORY" in output
         assert "WORKFLOW COMPLETE" in output or "✅" in output
 
-    @pytest.mark.skip(reason="Subprocess-based CLI test has asyncio issues; functionality tested in test_cli_full_workflow_mocked")
+    @pytest.mark.skip(
+        reason="Subprocess-based CLI test has asyncio issues; functionality tested in test_cli_full_workflow_mocked"
+    )
     def test_cli_via_unified_command(self, test_config_file):
         """E2E test: Using 'skill-seekers install' unified CLI
 
@@ -445,17 +399,16 @@ class TestInstallSkillCLI_E2E:
 
         # Test the unified CLI entry point
         result = subprocess.run(
-            ["skill-seekers", "install",
-             "--config", test_config_file,
-             "--dry-run"],
+            ["skill-seekers", "install", "--config", test_config_file, "--dry-run"],
             capture_output=True,
             text=True,
-            timeout=30
+            timeout=30,
         )
 
         # Should work if command is available
-        assert result.returncode == 0 or "DRY RUN" in result.stdout, \
+        assert result.returncode == 0 or "DRY RUN" in result.stdout, (
             f"Unified CLI failed:\nSTDOUT:\n{result.stdout}\nSTDERR:\n{result.stderr}"
+        )
 
 
 @pytest.mark.skipif(not MCP_AVAILABLE, reason="MCP package not installed")
@@ -475,22 +428,15 @@ class TestInstallSkillE2E_RealFiles:
             "name": "test-real-e2e",
             "description": "Real E2E test",
             "base_url": "https://httpbin.org/html",  # Simple HTML endpoint
-            "selectors": {
-                "main_content": "body",
-                "title": "title",
-                "code_blocks": "code"
-            },
-            "url_patterns": {
-                "include": [],
-                "exclude": []
-            },
+            "selectors": {"main_content": "body", "title": "title", "code_blocks": "code"},
+            "url_patterns": {"include": [], "exclude": []},
             "categories": {},
             "rate_limit": 0.5,
-            "max_pages": 1  # Just one page for speed
+            "max_pages": 1,  # Just one page for speed
         }
 
         config_path = tmp_path / "test-real-e2e.json"
-        with open(config_path, 'w') as f:
+        with open(config_path, "w") as f:
             json.dump(config, f, indent=2)
 
         return str(config_path)
@@ -501,30 +447,30 @@ class TestInstallSkillE2E_RealFiles:
         """E2E test with real scraping but mocked enhancement/upload"""
 
         # Only mock enhancement and upload (let scraping run for real)
-        with patch('skill_seekers.mcp.server.run_subprocess_with_streaming') as mock_enhance, \
-             patch('skill_seekers.mcp.server.upload_skill_tool') as mock_upload, \
-             patch('os.environ.get') as mock_env:
-
+        with (
+            patch("skill_seekers.mcp.server.run_subprocess_with_streaming") as mock_enhance,
+            patch("skill_seekers.mcp.server.upload_skill_tool") as mock_upload,
+            patch("os.environ.get") as mock_env,
+        ):
             # Mock enhancement (avoid needing Claude Code)
             mock_enhance.return_value = ("✅ Enhancement complete", "", 0)
 
             # Mock upload (avoid needing API key)
-            mock_upload.return_value = [TextContent(
-                type="text",
-                text="✅ Upload successful"
-            )]
+            mock_upload.return_value = [TextContent(type="text", text="✅ Upload successful")]
 
             # Mock API key present
             mock_env.return_value = "sk-ant-test-key"
 
             # Run with real scraping
-            result = await install_skill_tool({
-                "config_path": real_test_config,
-                "destination": str(tmp_path / "output"),
-                "auto_upload": False,  # Skip upload even with key
-                "unlimited": False,
-                "dry_run": False
-            })
+            result = await install_skill_tool(
+                {
+                    "config_path": real_test_config,
+                    "destination": str(tmp_path / "output"),
+                    "auto_upload": False,  # Skip upload even with key
+                    "unlimited": False,
+                    "dry_run": False,
+                }
+            )
 
             output = result[0].text
 
diff --git a/tests/test_integration.py b/tests/test_integration.py
index 41086d0..bfadf06 100644
--- a/tests/test_integration.py
+++ b/tests/test_integration.py
@@ -4,12 +4,12 @@ Integration tests for doc_scraper
 Tests complete workflows and dry-run mode
 """
 
-import sys
-import os
-import unittest
 import json
-import tempfile
+import os
 import shutil
+import sys
+import tempfile
+import unittest
 from pathlib import Path
 
 # Add parent directory to path
@@ -24,19 +24,12 @@ class TestDryRunMode(unittest.TestCase):
     def setUp(self):
         """Set up test configuration"""
         self.config = {
-            'name': 'test-dry-run',
-            'base_url': 'https://example.com/',
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'url_patterns': {
-                'include': [],
-                'exclude': []
-            },
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test-dry-run",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "url_patterns": {"include": [], "exclude": []},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
 
     def test_dry_run_no_directories_created(self):
@@ -92,37 +85,33 @@ class TestConfigLoading(unittest.TestCase):
     def test_load_valid_config(self):
         """Test loading a valid configuration file"""
         config_data = {
-            'name': 'test-config',
-            'base_url': 'https://example.com/',
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'rate_limit': 0.5,
-            'max_pages': 100
+            "name": "test-config",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "rate_limit": 0.5,
+            "max_pages": 100,
         }
 
-        config_path = Path(self.temp_dir) / 'test.json'
-        with open(config_path, 'w') as f:
+        config_path = Path(self.temp_dir) / "test.json"
+        with open(config_path, "w") as f:
             json.dump(config_data, f)
 
         loaded_config = load_config(str(config_path))
-        self.assertEqual(loaded_config['name'], 'test-config')
-        self.assertEqual(loaded_config['base_url'], 'https://example.com/')
+        self.assertEqual(loaded_config["name"], "test-config")
+        self.assertEqual(loaded_config["base_url"], "https://example.com/")
 
     def test_load_invalid_json(self):
         """Test loading an invalid JSON file"""
-        config_path = Path(self.temp_dir) / 'invalid.json'
-        with open(config_path, 'w') as f:
-            f.write('{ invalid json }')
+        config_path = Path(self.temp_dir) / "invalid.json"
+        with open(config_path, "w") as f:
+            f.write("{ invalid json }")
 
         with self.assertRaises(SystemExit):
             load_config(str(config_path))
 
     def test_load_nonexistent_file(self):
         """Test loading a nonexistent file"""
-        config_path = Path(self.temp_dir) / 'nonexistent.json'
+        config_path = Path(self.temp_dir) / "nonexistent.json"
 
         with self.assertRaises(SystemExit):
             load_config(str(config_path))
@@ -130,12 +119,12 @@ class TestConfigLoading(unittest.TestCase):
     def test_load_config_with_validation_errors(self):
         """Test loading a config with validation errors"""
         config_data = {
-            'name': 'invalid@name',  # Invalid name
-            'base_url': 'example.com'  # Missing protocol
+            "name": "invalid@name",  # Invalid name
+            "base_url": "example.com",  # Missing protocol
         }
 
-        config_path = Path(self.temp_dir) / 'invalid_config.json'
-        with open(config_path, 'w') as f:
+        config_path = Path(self.temp_dir) / "invalid_config.json"
+        with open(config_path, "w") as f:
             json.dump(config_data, f)
 
         with self.assertRaises(SystemExit):
@@ -147,7 +136,7 @@ class TestRealConfigFiles(unittest.TestCase):
 
     def test_godot_config(self):
         """Test Godot config is valid"""
-        config_path = 'configs/godot.json'
+        config_path = "configs/godot.json"
         if os.path.exists(config_path):
             config = load_config(config_path)
             errors, _ = validate_config(config)
@@ -155,7 +144,7 @@ class TestRealConfigFiles(unittest.TestCase):
 
     def test_react_config(self):
         """Test React config is valid"""
-        config_path = 'configs/react.json'
+        config_path = "configs/react.json"
         if os.path.exists(config_path):
             config = load_config(config_path)
             errors, _ = validate_config(config)
@@ -163,7 +152,7 @@ class TestRealConfigFiles(unittest.TestCase):
 
     def test_vue_config(self):
         """Test Vue config is valid"""
-        config_path = 'configs/vue.json'
+        config_path = "configs/vue.json"
         if os.path.exists(config_path):
             config = load_config(config_path)
             errors, _ = validate_config(config)
@@ -171,7 +160,7 @@ class TestRealConfigFiles(unittest.TestCase):
 
     def test_django_config(self):
         """Test Django config is valid"""
-        config_path = 'configs/django.json'
+        config_path = "configs/django.json"
         if os.path.exists(config_path):
             config = load_config(config_path)
             errors, _ = validate_config(config)
@@ -179,7 +168,7 @@ class TestRealConfigFiles(unittest.TestCase):
 
     def test_fastapi_config(self):
         """Test FastAPI config is valid"""
-        config_path = 'configs/fastapi.json'
+        config_path = "configs/fastapi.json"
         if os.path.exists(config_path):
             config = load_config(config_path)
             errors, _ = validate_config(config)
@@ -187,7 +176,7 @@ class TestRealConfigFiles(unittest.TestCase):
 
     def test_steam_economy_config(self):
         """Test Steam Economy config is valid"""
-        config_path = 'configs/steam-economy-complete.json'
+        config_path = "configs/steam-economy-complete.json"
         if os.path.exists(config_path):
             config = load_config(config_path)
             errors, _ = validate_config(config)
@@ -200,46 +189,42 @@ class TestURLProcessing(unittest.TestCase):
     def test_url_normalization(self):
         """Test URL normalization in converter"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'url_patterns': {'include': [], 'exclude': []},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "url_patterns": {"include": [], "exclude": []},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         converter = DocToSkillConverter(config, dry_run=True)
 
         # Base URL should be stored correctly
-        self.assertEqual(converter.base_url, 'https://example.com/')
+        self.assertEqual(converter.base_url, "https://example.com/")
 
     def test_start_urls_fallback(self):
         """Test that start_urls defaults to base_url"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         converter = DocToSkillConverter(config, dry_run=True)
 
         # Should have base_url in pending_urls
         self.assertEqual(len(converter.pending_urls), 1)
-        self.assertEqual(converter.pending_urls[0], 'https://example.com/')
+        self.assertEqual(converter.pending_urls[0], "https://example.com/")
 
     def test_multiple_start_urls(self):
         """Test multiple start URLs"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'start_urls': [
-                'https://example.com/guide/',
-                'https://example.com/api/',
-                'https://example.com/tutorial/'
-            ],
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "start_urls": ["https://example.com/guide/", "https://example.com/api/", "https://example.com/tutorial/"],
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         converter = DocToSkillConverter(config, dry_run=True)
 
@@ -253,14 +238,10 @@ class TestLlmsTxtIntegration(unittest.TestCase):
     def test_scraper_has_llms_txt_attributes(self):
         """Test that scraper has llms.txt detection attributes"""
         config = {
-            'name': 'test-llms',
-            'base_url': 'https://hono.dev/docs',
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'max_pages': 50
+            "name": "test-llms",
+            "base_url": "https://hono.dev/docs",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "max_pages": 50,
         }
 
         scraper = DocToSkillConverter(config, dry_run=True)
@@ -272,21 +253,17 @@ class TestLlmsTxtIntegration(unittest.TestCase):
     def test_scraper_has_try_llms_txt_method(self):
         """Test that scraper has _try_llms_txt method"""
         config = {
-            'name': 'test-llms',
-            'base_url': 'https://hono.dev/docs',
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'max_pages': 50
+            "name": "test-llms",
+            "base_url": "https://hono.dev/docs",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "max_pages": 50,
         }
 
         scraper = DocToSkillConverter(config, dry_run=True)
 
         # Should have _try_llms_txt method
-        self.assertTrue(hasattr(scraper, '_try_llms_txt'))
-        self.assertTrue(callable(getattr(scraper, '_try_llms_txt')))
+        self.assertTrue(hasattr(scraper, "_try_llms_txt"))
+        self.assertTrue(callable(scraper._try_llms_txt))
 
 
 class TestContentExtraction(unittest.TestCase):
@@ -295,35 +272,33 @@ class TestContentExtraction(unittest.TestCase):
     def setUp(self):
         """Set up test converter"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         self.converter = DocToSkillConverter(config, dry_run=True)
 
     def test_extract_empty_content(self):
         """Test extracting from empty HTML"""
         from bs4 import BeautifulSoup
-        html = '<html><body></body></html>'
-        soup = BeautifulSoup(html, 'html.parser')
 
-        page = self.converter.extract_content(soup, 'https://example.com/test')
+        html = "<html><body></body></html>"
+        soup = BeautifulSoup(html, "html.parser")
 
-        self.assertEqual(page['url'], 'https://example.com/test')
-        self.assertEqual(page['title'], '')
-        self.assertEqual(page['content'], '')
-        self.assertEqual(len(page['code_samples']), 0)
+        page = self.converter.extract_content(soup, "https://example.com/test")
+
+        self.assertEqual(page["url"], "https://example.com/test")
+        self.assertEqual(page["title"], "")
+        self.assertEqual(page["content"], "")
+        self.assertEqual(len(page["code_samples"]), 0)
 
     def test_extract_basic_content(self):
         """Test extracting basic content"""
         from bs4 import BeautifulSoup
-        html = '''
+
+        html = """
         <html>
         <head><title>Test Page</title></head>
         <body>
@@ -335,16 +310,16 @@ class TestContentExtraction(unittest.TestCase):
             </article>
         </body>
         </html>
-        '''
-        soup = BeautifulSoup(html, 'html.parser')
+        """
+        soup = BeautifulSoup(html, "html.parser")
 
-        page = self.converter.extract_content(soup, 'https://example.com/test')
+        page = self.converter.extract_content(soup, "https://example.com/test")
 
-        self.assertEqual(page['url'], 'https://example.com/test')
-        self.assertIn('Page Title', page['title'])
-        self.assertIn('content', page['content'].lower())
-        self.assertGreater(len(page['code_samples']), 0)
-        self.assertEqual(page['code_samples'][0]['language'], 'python')
+        self.assertEqual(page["url"], "https://example.com/test")
+        self.assertIn("Page Title", page["title"])
+        self.assertIn("content", page["content"].lower())
+        self.assertGreater(len(page["code_samples"]), 0)
+        self.assertEqual(page["code_samples"][0]["language"], "python")
 
 
 class TestFullLlmsTxtWorkflow(unittest.TestCase):
@@ -354,15 +329,11 @@ class TestFullLlmsTxtWorkflow(unittest.TestCase):
         """Set up test configuration and temporary directory"""
         self.temp_dir = tempfile.mkdtemp()
         self.config = {
-            'name': 'test-e2e-llms',
-            'base_url': 'https://hono.dev/docs',
-            'llms_txt_url': 'https://hono.dev/llms-full.txt',
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'max_pages': 50
+            "name": "test-e2e-llms",
+            "base_url": "https://hono.dev/docs",
+            "llms_txt_url": "https://hono.dev/llms-full.txt",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "max_pages": 50,
         }
 
         # Sample llms.txt content for testing
@@ -435,11 +406,10 @@ app.use('*', cors())
 
     def test_full_llms_txt_workflow(self):
         """Test complete workflow: config -> scrape (llms.txt) -> build -> verify"""
-        from unittest.mock import patch, MagicMock
-        import requests
+        from unittest.mock import MagicMock, patch
 
         # Mock the requests.get call for downloading llms.txt
-        with patch('cli.llms_txt_downloader.requests.get') as mock_get:
+        with patch("cli.llms_txt_downloader.requests.get") as mock_get:
             # Configure mock response
             mock_response = MagicMock()
             mock_response.status_code = 200
@@ -452,94 +422,75 @@ app.use('*', cors())
             scraper.scrape_all()
 
             # Verify llms.txt was detected
-            self.assertTrue(scraper.llms_txt_detected,
-                          "llms.txt should be detected")
-            self.assertEqual(scraper.llms_txt_variant, 'explicit',
-                           "Should use explicit variant from config")
+            self.assertTrue(scraper.llms_txt_detected, "llms.txt should be detected")
+            self.assertEqual(scraper.llms_txt_variant, "explicit", "Should use explicit variant from config")
 
             # Verify pages were parsed
-            self.assertGreater(len(scraper.pages), 0,
-                             "Should have parsed pages from llms.txt")
+            self.assertGreater(len(scraper.pages), 0, "Should have parsed pages from llms.txt")
 
             # Verify page structure
-            self.assertTrue(all('title' in page for page in scraper.pages),
-                          "All pages should have titles")
-            self.assertTrue(all('content' in page for page in scraper.pages),
-                          "All pages should have content")
-            self.assertTrue(any(len(page.get('code_samples', [])) > 0
-                              for page in scraper.pages),
-                          "At least one page should have code samples")
+            self.assertTrue(all("title" in page for page in scraper.pages), "All pages should have titles")
+            self.assertTrue(all("content" in page for page in scraper.pages), "All pages should have content")
+            self.assertTrue(
+                any(len(page.get("code_samples", [])) > 0 for page in scraper.pages),
+                "At least one page should have code samples",
+            )
 
             # Verify code samples have language detection
-            pages_with_code = [p for p in scraper.pages
-                             if len(p.get('code_samples', [])) > 0]
+            pages_with_code = [p for p in scraper.pages if len(p.get("code_samples", [])) > 0]
             if pages_with_code:
-                sample = pages_with_code[0]['code_samples'][0]
-                self.assertIn('language', sample,
-                            "Code samples should have language field")
-                self.assertIn('code', sample,
-                            "Code samples should have code field")
+                sample = pages_with_code[0]["code_samples"][0]
+                self.assertIn("language", sample, "Code samples should have language field")
+                self.assertIn("code", sample, "Code samples should have code field")
 
             # Build skill
             scraper.build_skill()
 
             # Verify SKILL.md exists
             skill_md_path = Path(f"output/{self.config['name']}/SKILL.md")
-            self.assertTrue(skill_md_path.exists(),
-                          "SKILL.md should be created")
+            self.assertTrue(skill_md_path.exists(), "SKILL.md should be created")
 
             # Verify SKILL.md content
             skill_content = skill_md_path.read_text()
-            self.assertIn(self.config['name'], skill_content,
-                        "SKILL.md should contain skill name")
-            self.assertGreater(len(skill_content), 100,
-                             "SKILL.md should have substantial content")
+            self.assertIn(self.config["name"], skill_content, "SKILL.md should contain skill name")
+            self.assertGreater(len(skill_content), 100, "SKILL.md should have substantial content")
 
             # Verify references directory exists
             refs_dir = Path(f"output/{self.config['name']}/references")
-            self.assertTrue(refs_dir.exists(),
-                          "references directory should exist")
+            self.assertTrue(refs_dir.exists(), "references directory should exist")
 
             # Verify at least index.md was created
-            index_md = refs_dir / 'index.md'
-            self.assertTrue(index_md.exists(),
-                          "references/index.md should exist")
+            index_md = refs_dir / "index.md"
+            self.assertTrue(index_md.exists(), "references/index.md should exist")
 
             # Verify reference files have content
-            ref_files = list(refs_dir.glob('*.md'))
-            self.assertGreater(len(ref_files), 0,
-                             "Should have at least one reference file")
+            ref_files = list(refs_dir.glob("*.md"))
+            self.assertGreater(len(ref_files), 0, "Should have at least one reference file")
 
             # Verify data directory was created and has summary
             data_dir = Path(f"output/{self.config['name']}_data")
-            self.assertTrue(data_dir.exists(),
-                          "Data directory should exist")
+            self.assertTrue(data_dir.exists(), "Data directory should exist")
 
-            summary_path = data_dir / 'summary.json'
-            self.assertTrue(summary_path.exists(),
-                          "summary.json should exist")
+            summary_path = data_dir / "summary.json"
+            self.assertTrue(summary_path.exists(), "summary.json should exist")
 
             # Verify summary content
             with open(summary_path) as f:
                 summary = json.load(f)
-                self.assertEqual(summary['name'], self.config['name'])
-                self.assertGreater(summary['total_pages'], 0)
-                self.assertIn('llms_txt_detected', summary)
-                self.assertTrue(summary['llms_txt_detected'])
+                self.assertEqual(summary["name"], self.config["name"])
+                self.assertGreater(summary["total_pages"], 0)
+                self.assertIn("llms_txt_detected", summary)
+                self.assertTrue(summary["llms_txt_detected"])
 
     def test_multi_variant_download(self):
         """Test downloading all 3 llms.txt variants"""
-        from unittest.mock import patch, Mock
+        from unittest.mock import Mock, patch
 
         config = {
-            'name': 'test-multi-variant',
-            'base_url': 'https://hono.dev/docs',
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'max_pages': 50
+            "name": "test-multi-variant",
+            "base_url": "https://hono.dev/docs",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "max_pages": 50,
         }
 
         # Mock all 3 variants
@@ -547,9 +498,10 @@ app.use('*', cors())
         sample_standard = "# Standard\n" + "x" * 200
         sample_small = "# Small\n" + "x" * 500
 
-        with patch('cli.llms_txt_detector.requests.head') as mock_head, \
-             patch('cli.llms_txt_downloader.requests.get') as mock_get:
-
+        with (
+            patch("cli.llms_txt_detector.requests.head") as mock_head,
+            patch("cli.llms_txt_downloader.requests.get") as mock_get,
+        ):
             # Mock detection (all exist)
             mock_head_response = Mock()
             mock_head_response.status_code = 200
@@ -559,9 +511,9 @@ app.use('*', cors())
             def mock_download(url, **kwargs):
                 response = Mock()
                 response.status_code = 200
-                if 'llms-full.txt' in url:
+                if "llms-full.txt" in url:
                     response.text = sample_full
-                elif 'llms-small.txt' in url:
+                elif "llms-small.txt" in url:
                     response.text = sample_small
                 else:  # llms.txt
                     response.text = sample_standard
@@ -572,6 +524,7 @@ app.use('*', cors())
 
             # Run scraper
             from skill_seekers.cli.doc_scraper import DocToSkillConverter as DocumentationScraper
+
             scraper = DocumentationScraper(config, dry_run=False)
             result = scraper._try_llms_txt()
 
@@ -579,69 +532,65 @@ app.use('*', cors())
             refs_dir = Path(f"output/{config['name']}/references")
 
             self.assertTrue(refs_dir.exists(), "references directory should exist")
-            self.assertTrue((refs_dir / 'llms-full.md').exists(), "llms-full.md should exist")
-            self.assertTrue((refs_dir / 'llms.md').exists(), "llms.md should exist")
-            self.assertTrue((refs_dir / 'llms-small.md').exists(), "llms-small.md should exist")
+            self.assertTrue((refs_dir / "llms-full.md").exists(), "llms-full.md should exist")
+            self.assertTrue((refs_dir / "llms.md").exists(), "llms.md should exist")
+            self.assertTrue((refs_dir / "llms-small.md").exists(), "llms-small.md should exist")
 
             # Verify content not truncated
-            full_content = (refs_dir / 'llms-full.md').read_text()
+            full_content = (refs_dir / "llms-full.md").read_text()
             self.assertEqual(len(full_content), len(sample_full))
 
         # Clean up
         shutil.rmtree(f"output/{config['name']}_data", ignore_errors=True)
         shutil.rmtree(f"output/{config['name']}", ignore_errors=True)
 
+
 def test_no_content_truncation():
     """Test that content is NOT truncated in reference files"""
-    from unittest.mock import Mock
-    import tempfile
 
     config = {
-        'name': 'test-no-truncate',
-        'base_url': 'https://example.com/docs',
-        'selectors': {
-            'main_content': 'article',
-            'title': 'h1',
-            'code_blocks': 'pre code'
-        },
-        'max_pages': 50
+        "name": "test-no-truncate",
+        "base_url": "https://example.com/docs",
+        "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+        "max_pages": 50,
     }
 
     # Create scraper with long content
     from skill_seekers.cli.doc_scraper import DocToSkillConverter
+
     scraper = DocToSkillConverter(config, dry_run=False)
 
     # Create page with content > 2500 chars
     long_content = "x" * 5000
     long_code = "y" * 1000
 
-    pages = [{
-        'title': 'Long Page',
-        'url': 'https://example.com/long',
-        'content': long_content,
-        'code_samples': [
-            {'code': long_code, 'language': 'python'}
-        ],
-        'headings': []
-    }]
+    pages = [
+        {
+            "title": "Long Page",
+            "url": "https://example.com/long",
+            "content": long_content,
+            "code_samples": [{"code": long_code, "language": "python"}],
+            "headings": [],
+        }
+    ]
 
     # Create reference file
-    scraper.create_reference_file('test', pages)
+    scraper.create_reference_file("test", pages)
 
     # Verify no truncation
     ref_file = Path(f"output/{config['name']}/references/test.md")
-    with open(ref_file, 'r') as f:
+    with open(ref_file) as f:
         content = f.read()
 
     assert long_content in content  # Full content included
-    assert long_code in content     # Full code included
-    assert '[Content truncated]' not in content
-    assert '...' not in content or content.count('...') == 0
+    assert long_code in content  # Full code included
+    assert "[Content truncated]" not in content
+    assert "..." not in content or content.count("...") == 0
 
     # Clean up
     shutil.rmtree(f"output/{config['name']}_data", ignore_errors=True)
     shutil.rmtree(f"output/{config['name']}", ignore_errors=True)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_issue_219_e2e.py b/tests/test_issue_219_e2e.py
index a72c787..a052c4b 100644
--- a/tests/test_issue_219_e2e.py
+++ b/tests/test_issue_219_e2e.py
@@ -8,18 +8,18 @@ Tests verify complete fixes for:
 3. Custom API endpoint support (ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN)
 """
 
-import unittest
-import sys
 import os
-import subprocess
-import tempfile
 import shutil
+import subprocess
+import sys
+import tempfile
+import unittest
 from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
 from types import SimpleNamespace
+from unittest.mock import Mock, patch
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 
 class TestIssue219Problem1LargeFiles(unittest.TestCase):
@@ -29,6 +29,7 @@ class TestIssue219Problem1LargeFiles(unittest.TestCase):
         """Set up test environment"""
         try:
             from github import Github, GithubException
+
             self.PYGITHUB_AVAILABLE = True
         except ImportError:
             self.PYGITHUB_AVAILABLE = False
@@ -37,34 +38,30 @@ class TestIssue219Problem1LargeFiles(unittest.TestCase):
             self.skipTest("PyGithub not installed")
 
         from skill_seekers.cli.github_scraper import GitHubScraper
+
         self.GitHubScraper = GitHubScraper
 
     def test_large_file_extraction_end_to_end(self):
         """E2E: Verify large files (encoding='none') are downloaded via URL"""
-        from github import GithubException
 
-        config = {
-            'repo': 'ccxt/ccxt',
-            'name': 'ccxt',
-            'github_token': None
-        }
+        config = {"repo": "ccxt/ccxt", "name": "ccxt", "github_token": None}
 
         # Mock large CHANGELOG (1.4MB, encoding="none")
         mock_content = Mock()
-        mock_content.type = 'file'
-        mock_content.encoding = 'none'  # This is what GitHub API returns for large files
+        mock_content.type = "file"
+        mock_content.encoding = "none"  # This is what GitHub API returns for large files
         mock_content.size = 1388271
-        mock_content.download_url = 'https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md'
+        mock_content.download_url = "https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md"
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
             # Mock requests.get for download
-            with patch('requests.get') as mock_requests:
+            with patch("requests.get") as mock_requests:
                 mock_response = Mock()
-                mock_response.text = '# CCXT Changelog\n\n## v4.4.20\n- Bug fixes'
+                mock_response.text = "# CCXT Changelog\n\n## v4.4.20\n- Bug fixes"
                 mock_response.raise_for_status = Mock()
                 mock_requests.return_value = mock_response
 
@@ -73,44 +70,38 @@ class TestIssue219Problem1LargeFiles(unittest.TestCase):
 
                 # VERIFY: download_url was called
                 mock_requests.assert_called_once_with(
-                    'https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md',
-                    timeout=30
+                    "https://raw.githubusercontent.com/ccxt/ccxt/master/CHANGELOG.md", timeout=30
                 )
 
                 # VERIFY: CHANGELOG was extracted successfully
-                self.assertIn('changelog', scraper.extracted_data)
-                self.assertIn('Bug fixes', scraper.extracted_data['changelog'])
-                self.assertEqual(scraper.extracted_data['changelog'], mock_response.text)
+                self.assertIn("changelog", scraper.extracted_data)
+                self.assertIn("Bug fixes", scraper.extracted_data["changelog"])
+                self.assertEqual(scraper.extracted_data["changelog"], mock_response.text)
 
     def test_large_file_fallback_on_error(self):
         """E2E: Verify graceful handling if download_url fails"""
-        from github import GithubException
 
-        config = {
-            'repo': 'test/repo',
-            'name': 'test',
-            'github_token': None
-        }
+        config = {"repo": "test/repo", "name": "test", "github_token": None}
 
         # Mock large file without download_url
         mock_content = Mock()
-        mock_content.type = 'file'
-        mock_content.encoding = 'none'
+        mock_content.type = "file"
+        mock_content.encoding = "none"
         mock_content.size = 2000000
         mock_content.download_url = None  # Missing download URL
 
-        with patch('skill_seekers.cli.github_scraper.Github'):
+        with patch("skill_seekers.cli.github_scraper.Github"):
             scraper = self.GitHubScraper(config)
             scraper.repo = Mock()
             scraper.repo.get_contents.return_value = mock_content
 
             # Should return None gracefully
-            result = scraper._get_file_content('CHANGELOG.md')
+            result = scraper._get_file_content("CHANGELOG.md")
             self.assertIsNone(result)
 
             # Should not crash
             scraper._extract_changelog()
-            self.assertEqual(scraper.extracted_data['changelog'], '')
+            self.assertEqual(scraper.extracted_data["changelog"], "")
 
 
 class TestIssue219Problem2CLIFlags(unittest.TestCase):
@@ -118,41 +109,36 @@ class TestIssue219Problem2CLIFlags(unittest.TestCase):
 
     def test_github_command_has_enhancement_flags(self):
         """E2E: Verify --enhance-local flag exists in github command help"""
-        result = subprocess.run(
-            ['skill-seekers', 'github', '--help'],
-            capture_output=True,
-            text=True
-        )
+        result = subprocess.run(["skill-seekers", "github", "--help"], capture_output=True, text=True)
 
         # VERIFY: Command succeeds
         self.assertEqual(result.returncode, 0, "github --help should succeed")
 
         # VERIFY: All enhancement flags present
-        self.assertIn('--enhance', result.stdout, "Missing --enhance flag")
-        self.assertIn('--enhance-local', result.stdout, "Missing --enhance-local flag")
-        self.assertIn('--api-key', result.stdout, "Missing --api-key flag")
+        self.assertIn("--enhance", result.stdout, "Missing --enhance flag")
+        self.assertIn("--enhance-local", result.stdout, "Missing --enhance-local flag")
+        self.assertIn("--api-key", result.stdout, "Missing --api-key flag")
 
     def test_github_command_accepts_enhance_local_flag(self):
         """E2E: Verify --enhance-local flag doesn't cause 'unrecognized arguments' error"""
         # Strategy: Parse arguments directly without executing to avoid network hangs on CI
         # This tests that the CLI accepts the flag without actually running the command
-        from skill_seekers.cli import github_scraper
         import argparse
 
         # Get the argument parser from github_scraper
         parser = argparse.ArgumentParser()
         # Add the same arguments as github_scraper.main()
-        parser.add_argument('--repo', required=True)
-        parser.add_argument('--enhance-local', action='store_true')
-        parser.add_argument('--enhance', action='store_true')
-        parser.add_argument('--api-key')
+        parser.add_argument("--repo", required=True)
+        parser.add_argument("--enhance-local", action="store_true")
+        parser.add_argument("--enhance", action="store_true")
+        parser.add_argument("--api-key")
 
         # VERIFY: Parsing succeeds without "unrecognized arguments" error
         try:
-            args = parser.parse_args(['--repo', 'test/test', '--enhance-local'])
+            args = parser.parse_args(["--repo", "test/test", "--enhance-local"])
             # If we get here, argument parsing succeeded
             self.assertTrue(args.enhance_local, "Flag should be parsed as True")
-            self.assertEqual(args.repo, 'test/test')
+            self.assertEqual(args.repo, "test/test")
         except SystemExit as e:
             # Argument parsing failed
             self.fail(f"Argument parsing failed with: {e}")
@@ -162,33 +148,27 @@ class TestIssue219Problem2CLIFlags(unittest.TestCase):
         from skill_seekers.cli import main
 
         # Mock sys.argv to simulate CLI call
-        test_args = [
-            'skill-seekers',
-            'github',
-            '--repo', 'test/test',
-            '--name', 'test',
-            '--enhance-local'
-        ]
+        test_args = ["skill-seekers", "github", "--repo", "test/test", "--name", "test", "--enhance-local"]
 
-        with patch('sys.argv', test_args):
-            with patch('skill_seekers.cli.github_scraper.main') as mock_github_main:
-                mock_github_main.return_value = 0
+        with patch("sys.argv", test_args), patch("skill_seekers.cli.github_scraper.main") as mock_github_main:
+            mock_github_main.return_value = 0
 
-                # Call main dispatcher
-                with patch('sys.exit'):
-                    try:
-                        main.main()
-                    except SystemExit:
-                        pass
+            # Call main dispatcher
+            with patch("sys.exit"):
+                try:
+                    main.main()
+                except SystemExit:
+                    pass
 
-                # VERIFY: github_scraper.main was called
-                mock_github_main.assert_called_once()
+            # VERIFY: github_scraper.main was called
+            mock_github_main.assert_called_once()
 
-                # VERIFY: sys.argv contains --enhance-local flag
-                # (main.py should have added it before calling github_scraper)
-                called_with_enhance = any('--enhance-local' in str(call) for call in mock_github_main.call_args_list)
-                self.assertTrue(called_with_enhance or '--enhance-local' in sys.argv,
-                              "Flag should be forwarded to github_scraper")
+            # VERIFY: sys.argv contains --enhance-local flag
+            # (main.py should have added it before calling github_scraper)
+            called_with_enhance = any("--enhance-local" in str(call) for call in mock_github_main.call_args_list)
+            self.assertTrue(
+                called_with_enhance or "--enhance-local" in sys.argv, "Flag should be forwarded to github_scraper"
+            )
 
 
 class TestIssue219Problem3CustomAPIEndpoints(unittest.TestCase):
@@ -201,12 +181,12 @@ class TestIssue219Problem3CustomAPIEndpoints(unittest.TestCase):
         self.skill_dir.mkdir()
 
         # Create minimal SKILL.md
-        (self.skill_dir / "SKILL.md").write_text("# Test Skill\n", encoding='utf-8')
+        (self.skill_dir / "SKILL.md").write_text("# Test Skill\n", encoding="utf-8")
 
         # Create references directory
         refs_dir = self.skill_dir / "references"
         refs_dir.mkdir()
-        (refs_dir / "index.md").write_text("# Index\n", encoding='utf-8')
+        (refs_dir / "index.md").write_text("# Index\n", encoding="utf-8")
 
     def tearDown(self):
         """Clean up test environment"""
@@ -220,22 +200,20 @@ class TestIssue219Problem3CustomAPIEndpoints(unittest.TestCase):
             self.skipTest("anthropic package not installed")
 
         # Set custom base URL
-        custom_url = 'http://localhost:3000'
+        custom_url = "http://localhost:3000"
 
-        with patch.dict(os.environ, {
-            'ANTHROPIC_API_KEY': 'test-key-123',
-            'ANTHROPIC_BASE_URL': custom_url
-        }):
-            with patch('skill_seekers.cli.enhance_skill.anthropic.Anthropic') as mock_anthropic:
-                # Create enhancer
-                enhancer = SkillEnhancer(self.skill_dir)
+        with (
+            patch.dict(os.environ, {"ANTHROPIC_API_KEY": "test-key-123", "ANTHROPIC_BASE_URL": custom_url}),
+            patch("skill_seekers.cli.enhance_skill.anthropic.Anthropic") as mock_anthropic,
+        ):
+            # Create enhancer
+            enhancer = SkillEnhancer(self.skill_dir)
 
-                # VERIFY: Anthropic client called with custom base_url
-                mock_anthropic.assert_called_once()
-                call_kwargs = mock_anthropic.call_args[1]
-                self.assertIn('base_url', call_kwargs, "base_url should be passed")
-                self.assertEqual(call_kwargs['base_url'], custom_url,
-                               "base_url should match ANTHROPIC_BASE_URL env var")
+            # VERIFY: Anthropic client called with custom base_url
+            mock_anthropic.assert_called_once()
+            call_kwargs = mock_anthropic.call_args[1]
+            self.assertIn("base_url", call_kwargs, "base_url should be passed")
+            self.assertEqual(call_kwargs["base_url"], custom_url, "base_url should match ANTHROPIC_BASE_URL env var")
 
     def test_anthropic_auth_token_support(self):
         """E2E: Verify ANTHROPIC_AUTH_TOKEN is accepted as alternative to ANTHROPIC_API_KEY"""
@@ -244,25 +222,25 @@ class TestIssue219Problem3CustomAPIEndpoints(unittest.TestCase):
         except ImportError:
             self.skipTest("anthropic package not installed")
 
-        custom_token = 'custom-auth-token-456'
+        custom_token = "custom-auth-token-456"
 
         # Use ANTHROPIC_AUTH_TOKEN instead of ANTHROPIC_API_KEY
-        with patch.dict(os.environ, {
-            'ANTHROPIC_AUTH_TOKEN': custom_token
-        }, clear=True):
-            with patch('skill_seekers.cli.enhance_skill.anthropic.Anthropic') as mock_anthropic:
-                # Create enhancer (should accept ANTHROPIC_AUTH_TOKEN)
-                enhancer = SkillEnhancer(self.skill_dir)
+        with (
+            patch.dict(os.environ, {"ANTHROPIC_AUTH_TOKEN": custom_token}, clear=True),
+            patch("skill_seekers.cli.enhance_skill.anthropic.Anthropic") as mock_anthropic,
+        ):
+            # Create enhancer (should accept ANTHROPIC_AUTH_TOKEN)
+            enhancer = SkillEnhancer(self.skill_dir)
 
-                # VERIFY: api_key set to ANTHROPIC_AUTH_TOKEN value
-                self.assertEqual(enhancer.api_key, custom_token,
-                               "Should use ANTHROPIC_AUTH_TOKEN when ANTHROPIC_API_KEY not set")
+            # VERIFY: api_key set to ANTHROPIC_AUTH_TOKEN value
+            self.assertEqual(
+                enhancer.api_key, custom_token, "Should use ANTHROPIC_AUTH_TOKEN when ANTHROPIC_API_KEY not set"
+            )
 
-                # VERIFY: Anthropic client initialized with correct key
-                mock_anthropic.assert_called_once()
-                call_kwargs = mock_anthropic.call_args[1]
-                self.assertEqual(call_kwargs['api_key'], custom_token,
-                               "api_key should match ANTHROPIC_AUTH_TOKEN")
+            # VERIFY: Anthropic client initialized with correct key
+            mock_anthropic.assert_called_once()
+            call_kwargs = mock_anthropic.call_args[1]
+            self.assertEqual(call_kwargs["api_key"], custom_token, "api_key should match ANTHROPIC_AUTH_TOKEN")
 
     def test_thinking_block_handling(self):
         """E2E: Verify ThinkingBlock doesn't cause .text AttributeError"""
@@ -271,16 +249,16 @@ class TestIssue219Problem3CustomAPIEndpoints(unittest.TestCase):
         except ImportError:
             self.skipTest("anthropic package not installed")
 
-        with patch.dict(os.environ, {'ANTHROPIC_API_KEY': 'test-key'}):
-            with patch('skill_seekers.cli.enhance_skill.anthropic.Anthropic') as mock_anthropic:
+        with patch.dict(os.environ, {"ANTHROPIC_API_KEY": "test-key"}):
+            with patch("skill_seekers.cli.enhance_skill.anthropic.Anthropic") as mock_anthropic:
                 enhancer = SkillEnhancer(self.skill_dir)
 
                 # Mock response with ThinkingBlock (newer SDK)
                 # ThinkingBlock has no .text attribute
-                mock_thinking_block = SimpleNamespace(type='thinking')
+                mock_thinking_block = SimpleNamespace(type="thinking")
 
                 # TextBlock has .text attribute
-                mock_text_block = SimpleNamespace(text='# Enhanced SKILL.md\n\nContent here')
+                mock_text_block = SimpleNamespace(text="# Enhanced SKILL.md\n\nContent here")
 
                 mock_message = Mock()
                 mock_message.content = [mock_thinking_block, mock_text_block]
@@ -290,24 +268,23 @@ class TestIssue219Problem3CustomAPIEndpoints(unittest.TestCase):
 
                 # Read references (with proper metadata structure)
                 references = {
-                    'index.md': {
-                        'content': '# Index\nTest content',
-                        'source': 'documentation',
-                        'confidence': 'high',
-                        'path': 'index.md',
-                        'truncated': False,
-                        'size': 23,
-                        'repo_id': None
+                    "index.md": {
+                        "content": "# Index\nTest content",
+                        "source": "documentation",
+                        "confidence": "high",
+                        "path": "index.md",
+                        "truncated": False,
+                        "size": 23,
+                        "repo_id": None,
                     }
                 }
 
                 # Call enhance_skill_md (should handle ThinkingBlock gracefully)
-                result = enhancer.enhance_skill_md(references, current_skill_md='# Old')
+                result = enhancer.enhance_skill_md(references, current_skill_md="# Old")
 
                 # VERIFY: Should find text from TextBlock, ignore ThinkingBlock
                 self.assertIsNotNone(result, "Should return enhanced content")
-                self.assertEqual(result, '# Enhanced SKILL.md\n\nContent here',
-                               "Should extract text from TextBlock")
+                self.assertEqual(result, "# Enhanced SKILL.md\n\nContent here", "Should extract text from TextBlock")
 
 
 class TestIssue219IntegrationAll(unittest.TestCase):
@@ -320,22 +297,18 @@ class TestIssue219IntegrationAll(unittest.TestCase):
         # 2. Large files are downloaded
         # 3. Custom API endpoints work
 
-        result = subprocess.run(
-            ['skill-seekers', 'github', '--help'],
-            capture_output=True,
-            text=True
-        )
+        result = subprocess.run(["skill-seekers", "github", "--help"], capture_output=True, text=True)
 
         # All flags present
-        self.assertIn('--enhance', result.stdout)
-        self.assertIn('--enhance-local', result.stdout)
-        self.assertIn('--api-key', result.stdout)
+        self.assertIn("--enhance", result.stdout)
+        self.assertIn("--enhance-local", result.stdout)
+        self.assertIn("--api-key", result.stdout)
 
         # Verify we can import all fixed modules
         try:
-            from skill_seekers.cli.github_scraper import GitHubScraper
-            from skill_seekers.cli.enhance_skill import SkillEnhancer
             from skill_seekers.cli import main
+            from skill_seekers.cli.enhance_skill import SkillEnhancer
+            from skill_seekers.cli.github_scraper import GitHubScraper
 
             # All imports successful
             self.assertTrue(True, "All modules import successfully")
@@ -343,6 +316,6 @@ class TestIssue219IntegrationAll(unittest.TestCase):
             self.fail(f"Module import failed: {e}")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Run tests with verbose output
     unittest.main(verbosity=2)
diff --git a/tests/test_language_detector.py b/tests/test_language_detector.py
index c3753fe..8cd0564 100644
--- a/tests/test_language_detector.py
+++ b/tests/test_language_detector.py
@@ -10,6 +10,7 @@ Run with: pytest tests/test_language_detector.py -v
 
 import pytest
 from bs4 import BeautifulSoup
+
 from skill_seekers.cli.language_detector import LanguageDetector
 
 
@@ -20,50 +21,50 @@ class TestCSSClassDetection:
         """Test language- prefix pattern"""
         detector = LanguageDetector()
 
-        classes = ['language-python', 'highlight']
-        assert detector.extract_language_from_classes(classes) == 'python'
+        classes = ["language-python", "highlight"]
+        assert detector.extract_language_from_classes(classes) == "python"
 
-        classes = ['language-javascript']
-        assert detector.extract_language_from_classes(classes) == 'javascript'
+        classes = ["language-javascript"]
+        assert detector.extract_language_from_classes(classes) == "javascript"
 
     def test_lang_prefix(self):
         """Test lang- prefix pattern"""
         detector = LanguageDetector()
 
-        classes = ['lang-java', 'code']
-        assert detector.extract_language_from_classes(classes) == 'java'
+        classes = ["lang-java", "code"]
+        assert detector.extract_language_from_classes(classes) == "java"
 
-        classes = ['lang-typescript']
-        assert detector.extract_language_from_classes(classes) == 'typescript'
+        classes = ["lang-typescript"]
+        assert detector.extract_language_from_classes(classes) == "typescript"
 
     def test_brush_pattern(self):
         """Test brush: pattern"""
         detector = LanguageDetector()
 
-        classes = ['brush: php']
-        assert detector.extract_language_from_classes(classes) == 'php'
+        classes = ["brush: php"]
+        assert detector.extract_language_from_classes(classes) == "php"
 
-        classes = ['brush: csharp']
-        assert detector.extract_language_from_classes(classes) == 'csharp'
+        classes = ["brush: csharp"]
+        assert detector.extract_language_from_classes(classes) == "csharp"
 
     def test_bare_class_name(self):
         """Test bare language name as class"""
         detector = LanguageDetector()
 
-        classes = ['python', 'highlight']
-        assert detector.extract_language_from_classes(classes) == 'python'
+        classes = ["python", "highlight"]
+        assert detector.extract_language_from_classes(classes) == "python"
 
-        classes = ['rust']
-        assert detector.extract_language_from_classes(classes) == 'rust'
+        classes = ["rust"]
+        assert detector.extract_language_from_classes(classes) == "rust"
 
     def test_unknown_language(self):
         """Test unknown language class"""
         detector = LanguageDetector()
 
-        classes = ['language-foobar']
+        classes = ["language-foobar"]
         assert detector.extract_language_from_classes(classes) is None
 
-        classes = ['highlight', 'code']
+        classes = ["highlight", "code"]
         assert detector.extract_language_from_classes(classes) is None
 
     def test_empty_classes(self):
@@ -79,11 +80,11 @@ class TestCSSClassDetection:
 
         # Create mock element
         html = '<code class="language-python">print("hello")</code>'
-        soup = BeautifulSoup(html, 'html.parser')
-        elem = soup.find('code')
+        soup = BeautifulSoup(html, "html.parser")
+        elem = soup.find("code")
 
         lang, confidence = detector.detect_from_html(elem, 'print("hello")')
-        assert lang == 'python'
+        assert lang == "python"
         assert confidence == 1.0  # CSS class = high confidence
 
     def test_detect_from_html_with_parent_class(self):
@@ -92,11 +93,11 @@ class TestCSSClassDetection:
 
         # Parent has class, child doesn't
         html = '<pre class="language-java"><code>System.out.println("hello");</code></pre>'
-        soup = BeautifulSoup(html, 'html.parser')
-        elem = soup.find('code')
+        soup = BeautifulSoup(html, "html.parser")
+        elem = soup.find("code")
 
         lang, confidence = detector.detect_from_html(elem, 'System.out.println("hello");')
-        assert lang == 'java'
+        assert lang == "java"
         assert confidence == 1.0
 
 
@@ -121,7 +122,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.9  # High confidence (Unity patterns)
 
     def test_unity_lifecycle_methods(self):
@@ -137,7 +138,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.5
 
     def test_unity_coroutine_detection(self):
@@ -152,7 +153,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.4
 
     def test_unity_serializefield_attribute(self):
@@ -168,7 +169,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.7
 
     def test_unity_types(self):
@@ -183,7 +184,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.3
 
     def test_unity_namespace(self):
@@ -195,7 +196,7 @@ class TestUnityCSharpDetection:
 
         # Short code, but very specific Unity pattern (19 chars)
         # Now detects due to lowered min length threshold (10 chars)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.5
 
         # Longer version
@@ -204,7 +205,7 @@ class TestUnityCSharpDetection:
         using System.Collections;
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.5
 
     def test_generic_csharp_vs_unity(self):
@@ -225,7 +226,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         # Confidence should be high (contains multiple C# patterns)
         # No Unity-specific patterns, but Console.WriteLine is strong indicator
         assert 0.7 <= confidence <= 1.0
@@ -236,7 +237,7 @@ class TestUnityCSharpDetection:
 
         code = "void Update() { Time.deltaTime; }"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.3  # Low but detected
 
     def test_unity_input_system(self):
@@ -249,7 +250,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.4
 
     def test_unity_full_script(self):
@@ -292,7 +293,7 @@ class TestUnityCSharpDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'csharp'
+        assert lang == "csharp"
         assert confidence >= 0.9  # Very high confidence (many Unity patterns)
 
 
@@ -314,7 +315,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'python'
+        assert lang == "python"
         assert confidence >= 0.5
 
     def test_javascript_detection(self):
@@ -332,7 +333,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'javascript'
+        assert lang == "javascript"
         assert confidence >= 0.5
 
     def test_typescript_detection(self):
@@ -353,7 +354,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'typescript'
+        assert lang == "typescript"
         assert confidence >= 0.7
 
     def test_java_detection(self):
@@ -369,7 +370,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'java'
+        assert lang == "java"
         assert confidence >= 0.6
 
     def test_go_detection(self):
@@ -388,7 +389,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'go'
+        assert lang == "go"
         assert confidence >= 0.6
 
     def test_rust_detection(self):
@@ -408,7 +409,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'rust'
+        assert lang == "rust"
         assert confidence >= 0.6
 
     def test_php_detection(self):
@@ -426,7 +427,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'php'
+        assert lang == "php"
         assert confidence >= 0.7
 
     def test_jsx_detection(self):
@@ -446,7 +447,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'jsx'
+        assert lang == "jsx"
         assert confidence >= 0.5
 
     def test_vue_detection(self):
@@ -468,7 +469,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'vue'
+        assert lang == "vue"
         assert confidence >= 0.7
 
     def test_sql_detection(self):
@@ -484,7 +485,7 @@ class TestLanguageDetection:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'sql'
+        assert lang == "sql"
         assert confidence >= 0.6
 
 
@@ -497,7 +498,7 @@ class TestEdgeCases:
 
         code = "x = 5"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'unknown'
+        assert lang == "unknown"
         assert confidence == 0.0
 
     def test_empty_code(self):
@@ -505,7 +506,7 @@ class TestEdgeCases:
         detector = LanguageDetector()
 
         lang, confidence = detector.detect_from_code("")
-        assert lang == 'unknown'
+        assert lang == "unknown"
         assert confidence == 0.0
 
     def test_whitespace_only(self):
@@ -514,7 +515,7 @@ class TestEdgeCases:
 
         code = "    \n    \n    "
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'unknown'
+        assert lang == "unknown"
         assert confidence == 0.0
 
     def test_comments_only(self):
@@ -547,7 +548,7 @@ class TestEdgeCases:
         lang, confidence = detector.detect_from_code(code)
         # Should detect strongest pattern
         # Both html and javascript patterns present
-        assert lang in ['html', 'javascript']
+        assert lang in ["html", "javascript"]
 
     def test_confidence_threshold(self):
         """Test minimum confidence threshold"""
@@ -561,7 +562,7 @@ class TestEdgeCases:
 
         # If confidence < 0.7, should return unknown
         if confidence < 0.7:
-            assert lang == 'unknown'
+            assert lang == "unknown"
 
     def test_html_with_embedded_css(self):
         """Test HTML with embedded CSS"""
@@ -577,7 +578,7 @@ class TestEdgeCases:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang in ['html', 'css']
+        assert lang in ["html", "css"]
 
     def test_case_insensitive_patterns(self):
         """Test that patterns are case-insensitive"""
@@ -591,7 +592,7 @@ class TestEdgeCases:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'sql'
+        assert lang == "sql"
 
     def test_r_language_detection(self):
         """Test R language detection (edge case: single letter)"""
@@ -607,7 +608,7 @@ class TestEdgeCases:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'r'
+        assert lang == "r"
         assert confidence >= 0.5
 
     def test_julia_detection(self):
@@ -624,7 +625,7 @@ class TestEdgeCases:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'julia'
+        assert lang == "julia"
         assert confidence >= 0.3
 
     def test_gdscript_detection(self):
@@ -644,7 +645,7 @@ class TestEdgeCases:
         """
 
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'gdscript'
+        assert lang == "gdscript"
         assert confidence >= 0.5
 
     def test_multiple_confidence_scores(self):
@@ -662,7 +663,7 @@ class TestEdgeCases:
 
         lang, confidence = detector.detect_from_code(code)
         # Should detect the one with highest confidence
-        assert lang in ['csharp', 'java']
+        assert lang in ["csharp", "java"]
         assert confidence > 0.0
 
 
@@ -674,14 +675,14 @@ class TestIntegration:
         detector = LanguageDetector()
 
         # Element without CSS classes
-        html = '<code>def test(): pass</code>'
-        soup = BeautifulSoup(html, 'html.parser')
-        elem = soup.find('code')
+        html = "<code>def test(): pass</code>"
+        soup = BeautifulSoup(html, "html.parser")
+        elem = soup.find("code")
 
-        lang, confidence = detector.detect_from_html(elem, 'def test(): pass')
+        lang, confidence = detector.detect_from_html(elem, "def test(): pass")
         # Should fallback to pattern matching
         # Now detects due to lowered min length threshold (10 chars)
-        assert lang == 'python'
+        assert lang == "python"
         assert confidence >= 0.2
 
     def test_backward_compatibility_with_doc_scraper(self):
@@ -690,8 +691,8 @@ class TestIntegration:
 
         # Simulate doc_scraper.py usage
         html = '<code class="language-python">import os\nprint("hello")</code>'
-        soup = BeautifulSoup(html, 'html.parser')
-        elem = soup.find('code')
+        soup = BeautifulSoup(html, "html.parser")
+        elem = soup.find("code")
         code = elem.get_text()
 
         # This is how doc_scraper.py would call it
@@ -700,7 +701,7 @@ class TestIntegration:
         # Should work exactly as before (returning string)
         assert isinstance(lang, str)
         assert isinstance(confidence, float)
-        assert lang == 'python'
+        assert lang == "python"
         assert 0.0 <= confidence <= 1.0
 
 
diff --git a/tests/test_llms_txt_detector.py b/tests/test_llms_txt_detector.py
index 68c8b43..07556e6 100644
--- a/tests/test_llms_txt_detector.py
+++ b/tests/test_llms_txt_detector.py
@@ -1,12 +1,13 @@
-import pytest
-from unittest.mock import patch, Mock
+from unittest.mock import Mock, patch
+
 from skill_seekers.cli.llms_txt_detector import LlmsTxtDetector
 
+
 def test_detect_llms_txt_variants():
     """Test detection of llms.txt file variants"""
     detector = LlmsTxtDetector("https://hono.dev/docs")
 
-    with patch('skill_seekers.cli.llms_txt_detector.requests.head') as mock_head:
+    with patch("skill_seekers.cli.llms_txt_detector.requests.head") as mock_head:
         mock_response = Mock()
         mock_response.status_code = 200
         mock_head.return_value = mock_response
@@ -14,15 +15,16 @@ def test_detect_llms_txt_variants():
         variants = detector.detect()
 
         assert variants is not None
-        assert variants['url'] == 'https://hono.dev/llms-full.txt'
-        assert variants['variant'] == 'full'
+        assert variants["url"] == "https://hono.dev/llms-full.txt"
+        assert variants["variant"] == "full"
         mock_head.assert_called()
 
+
 def test_detect_no_llms_txt():
     """Test detection when no llms.txt file exists"""
     detector = LlmsTxtDetector("https://example.com/docs")
 
-    with patch('skill_seekers.cli.llms_txt_detector.requests.head') as mock_head:
+    with patch("skill_seekers.cli.llms_txt_detector.requests.head") as mock_head:
         mock_response = Mock()
         mock_response.status_code = 404
         mock_head.return_value = mock_response
@@ -32,11 +34,12 @@ def test_detect_no_llms_txt():
         assert variants is None
         assert mock_head.call_count == 3  # Should try all three variants
 
+
 def test_url_parsing_with_complex_paths():
     """Test URL parsing handles non-standard paths correctly"""
     detector = LlmsTxtDetector("https://example.com/docs/v2/guide")
 
-    with patch('skill_seekers.cli.llms_txt_detector.requests.head') as mock_head:
+    with patch("skill_seekers.cli.llms_txt_detector.requests.head") as mock_head:
         mock_response = Mock()
         mock_response.status_code = 200
         mock_head.return_value = mock_response
@@ -44,23 +47,20 @@ def test_url_parsing_with_complex_paths():
         variants = detector.detect()
 
         assert variants is not None
-        assert variants['url'] == 'https://example.com/llms-full.txt'
-        mock_head.assert_called_with(
-            'https://example.com/llms-full.txt',
-            timeout=5,
-            allow_redirects=True
-        )
+        assert variants["url"] == "https://example.com/llms-full.txt"
+        mock_head.assert_called_with("https://example.com/llms-full.txt", timeout=5, allow_redirects=True)
+
 
 def test_detect_all_variants():
     """Test detecting all llms.txt variants"""
     detector = LlmsTxtDetector("https://hono.dev/docs")
 
-    with patch('skill_seekers.cli.llms_txt_detector.requests.head') as mock_head:
+    with patch("skill_seekers.cli.llms_txt_detector.requests.head") as mock_head:
         # Mock responses for different variants
         def mock_response(url, **kwargs):
             response = Mock()
             # All 3 variants exist for Hono
-            if 'llms-full.txt' in url or 'llms.txt' in url or 'llms-small.txt' in url:
+            if "llms-full.txt" in url or "llms.txt" in url or "llms-small.txt" in url:
                 response.status_code = 200
             else:
                 response.status_code = 404
@@ -71,7 +71,7 @@ def test_detect_all_variants():
         variants = detector.detect_all()
 
         assert len(variants) == 3
-        assert any(v['variant'] == 'full' for v in variants)
-        assert any(v['variant'] == 'standard' for v in variants)
-        assert any(v['variant'] == 'small' for v in variants)
-        assert all('url' in v for v in variants)
+        assert any(v["variant"] == "full" for v in variants)
+        assert any(v["variant"] == "standard" for v in variants)
+        assert any(v["variant"] == "small" for v in variants)
+        assert all("url" in v for v in variants)
diff --git a/tests/test_llms_txt_downloader.py b/tests/test_llms_txt_downloader.py
index bcdc4dc..376f533 100644
--- a/tests/test_llms_txt_downloader.py
+++ b/tests/test_llms_txt_downloader.py
@@ -1,17 +1,22 @@
-import pytest
-from unittest.mock import patch, Mock
+from unittest.mock import Mock, patch
+
 import requests
+
 from skill_seekers.cli.llms_txt_downloader import LlmsTxtDownloader
 
+
 def test_successful_download():
     """Test successful download with valid markdown content"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
 
     mock_response = Mock()
-    mock_response.text = "# Header\n\nSome content with markdown patterns.\n\n## Subheader\n\n- List item\n- Another item\n\n```python\ncode_block()\n```\n" + "x" * 200
+    mock_response.text = (
+        "# Header\n\nSome content with markdown patterns.\n\n## Subheader\n\n- List item\n- Another item\n\n```python\ncode_block()\n```\n"
+        + "x" * 200
+    )
     mock_response.raise_for_status = Mock()
 
-    with patch('requests.get', return_value=mock_response) as mock_get:
+    with patch("requests.get", return_value=mock_response) as mock_get:
         content = downloader.download()
 
     assert content is not None
@@ -20,18 +25,20 @@ def test_successful_download():
     assert "# Header" in content
     mock_get.assert_called_once()
 
+
 def test_timeout_with_retry():
     """Test timeout scenario with retry logic"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt", max_retries=2)
 
-    with patch('requests.get', side_effect=requests.Timeout("Connection timeout")) as mock_get:
-        with patch('time.sleep') as mock_sleep:  # Mock sleep to speed up test
+    with patch("requests.get", side_effect=requests.Timeout("Connection timeout")) as mock_get:
+        with patch("time.sleep") as mock_sleep:  # Mock sleep to speed up test
             content = downloader.download()
 
     assert content is None
     assert mock_get.call_count == 2  # Should retry once (2 total attempts)
     assert mock_sleep.call_count == 1  # Should sleep once between retries
 
+
 def test_empty_content_rejection():
     """Test rejection of content shorter than 100 chars"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
@@ -40,11 +47,12 @@ def test_empty_content_rejection():
     mock_response.text = "# Short"
     mock_response.raise_for_status = Mock()
 
-    with patch('requests.get', return_value=mock_response):
+    with patch("requests.get", return_value=mock_response):
         content = downloader.download()
 
     assert content is None
 
+
 def test_non_markdown_rejection():
     """Test rejection of content that doesn't look like markdown"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
@@ -53,11 +61,12 @@ def test_non_markdown_rejection():
     mock_response.text = "Plain text without any markdown patterns at all. " * 10
     mock_response.raise_for_status = Mock()
 
-    with patch('requests.get', return_value=mock_response):
+    with patch("requests.get", return_value=mock_response):
         content = downloader.download()
 
     assert content is None
 
+
 def test_http_error_handling():
     """Test handling of HTTP errors (404, 500, etc.)"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt", max_retries=2)
@@ -65,19 +74,19 @@ def test_http_error_handling():
     mock_response = Mock()
     mock_response.raise_for_status.side_effect = requests.HTTPError("404 Not Found")
 
-    with patch('requests.get', return_value=mock_response) as mock_get:
-        with patch('time.sleep'):
-            content = downloader.download()
+    with patch("requests.get", return_value=mock_response) as mock_get, patch("time.sleep"):
+        content = downloader.download()
 
     assert content is None
     assert mock_get.call_count == 2  # Should retry once
 
+
 def test_exponential_backoff():
     """Test that exponential backoff delays are correct"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt", max_retries=3)
 
-    with patch('requests.get', side_effect=requests.Timeout("Connection timeout")):
-        with patch('time.sleep') as mock_sleep:
+    with patch("requests.get", side_effect=requests.Timeout("Connection timeout")):
+        with patch("time.sleep") as mock_sleep:
             content = downloader.download()
 
     assert content is None
@@ -86,6 +95,7 @@ def test_exponential_backoff():
     mock_sleep.assert_any_call(1)  # First retry delay
     mock_sleep.assert_any_call(2)  # Second retry delay
 
+
 def test_markdown_validation():
     """Test markdown pattern detection"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
@@ -101,6 +111,7 @@ def test_markdown_validation():
     # Test non-markdown content
     assert not downloader._is_markdown("Plain text without any markdown patterns")
 
+
 def test_custom_timeout():
     """Test custom timeout parameter"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt", timeout=10)
@@ -109,25 +120,26 @@ def test_custom_timeout():
     mock_response.text = "# Header\n\nContent " * 50
     mock_response.raise_for_status = Mock()
 
-    with patch('requests.get', return_value=mock_response) as mock_get:
+    with patch("requests.get", return_value=mock_response) as mock_get:
         content = downloader.download()
 
     assert content is not None
     # Verify timeout was passed to requests.get
     call_kwargs = mock_get.call_args[1]
-    assert call_kwargs['timeout'] == 10
+    assert call_kwargs["timeout"] == 10
+
 
 def test_custom_max_retries():
     """Test custom max_retries parameter"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt", max_retries=5)
 
-    with patch('requests.get', side_effect=requests.Timeout("Connection timeout")) as mock_get:
-        with patch('time.sleep'):
-            content = downloader.download()
+    with patch("requests.get", side_effect=requests.Timeout("Connection timeout")) as mock_get, patch("time.sleep"):
+        content = downloader.download()
 
     assert content is None
     assert mock_get.call_count == 5  # Should attempt 5 times
 
+
 def test_user_agent_header():
     """Test that custom user agent is set"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
@@ -136,13 +148,14 @@ def test_user_agent_header():
     mock_response.text = "# Header\n\nContent " * 50
     mock_response.raise_for_status = Mock()
 
-    with patch('requests.get', return_value=mock_response) as mock_get:
+    with patch("requests.get", return_value=mock_response) as mock_get:
         content = downloader.download()
 
     assert content is not None
     # Verify custom user agent was passed
     call_kwargs = mock_get.call_args[1]
-    assert call_kwargs['headers']['User-Agent'] == 'Skill-Seekers-llms.txt-Reader/1.0'
+    assert call_kwargs["headers"]["User-Agent"] == "Skill-Seekers-llms.txt-Reader/1.0"
+
 
 def test_get_proper_filename():
     """Test filename conversion from .txt to .md"""
@@ -151,7 +164,8 @@ def test_get_proper_filename():
     filename = downloader.get_proper_filename()
 
     assert filename == "llms-full.md"
-    assert not filename.endswith('.txt')
+    assert not filename.endswith(".txt")
+
 
 def test_get_proper_filename_standard():
     """Test standard variant naming"""
@@ -161,6 +175,7 @@ def test_get_proper_filename_standard():
 
     assert filename == "llms.md"
 
+
 def test_get_proper_filename_small():
     """Test small variant naming"""
     downloader = LlmsTxtDownloader("https://hono.dev/llms-small.txt")
@@ -169,17 +184,19 @@ def test_get_proper_filename_small():
 
     assert filename == "llms-small.md"
 
+
 def test_is_markdown_rejects_html_doctype():
     """Test that HTML with DOCTYPE is rejected (prevents redirect trap)"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
 
-    html = '<!DOCTYPE html><html><head><title>Product Page</title></head><body>Content</body></html>'
+    html = "<!DOCTYPE html><html><head><title>Product Page</title></head><body>Content</body></html>"
     assert not downloader._is_markdown(html)
 
     # Test case-insensitive
-    html_uppercase = '<!DOCTYPE HTML><HTML><BODY>Content</BODY></HTML>'
+    html_uppercase = "<!DOCTYPE HTML><HTML><BODY>Content</BODY></HTML>"
     assert not downloader._is_markdown(html_uppercase)
 
+
 def test_is_markdown_rejects_html_tag():
     """Test that HTML with <html> tag is rejected (prevents redirect trap)"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
@@ -188,50 +205,54 @@ def test_is_markdown_rejects_html_tag():
     assert not downloader._is_markdown(html)
 
     # Test with just opening tag
-    html_partial = '<html><head>Some content'
+    html_partial = "<html><head>Some content"
     assert not downloader._is_markdown(html_partial)
 
+
 def test_is_markdown_rejects_html_meta():
     """Test that HTML with <meta> or <head> tags is rejected"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
 
-    html_with_head = '<head><title>Page</title></head><body>Content</body>'
+    html_with_head = "<head><title>Page</title></head><body>Content</body>"
     assert not downloader._is_markdown(html_with_head)
 
     html_with_meta = '<meta charset="utf-8"><meta name="viewport" content="width=device-width">'
     assert not downloader._is_markdown(html_with_meta)
 
+
 def test_is_markdown_accepts_markdown_with_html_words():
     """Test that markdown mentioning 'html' word is still accepted"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
 
-    markdown = '# Guide\n\nLearn about html tags in markdown. You can write HTML inside markdown.'
+    markdown = "# Guide\n\nLearn about html tags in markdown. You can write HTML inside markdown."
     assert downloader._is_markdown(markdown)
 
     # Test with actual markdown patterns
-    markdown_with_code = '# HTML Tutorial\n\n```html\n<div>example</div>\n```\n\n## More content'
+    markdown_with_code = "# HTML Tutorial\n\n```html\n<div>example</div>\n```\n\n## More content"
     assert downloader._is_markdown(markdown_with_code)
 
+
 def test_html_detection_only_scans_first_500_chars():
     """Test that HTML detection only scans first 500 characters for performance"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
 
     # HTML tag after 500 chars should not be detected
-    safe_markdown = '# Header\n\n' + ('Valid markdown content. ' * 50) + '\n\n<!DOCTYPE html>'
+    safe_markdown = "# Header\n\n" + ("Valid markdown content. " * 50) + "\n\n<!DOCTYPE html>"
     # This should pass because <!DOCTYPE html> is beyond first 500 chars
-    if len(safe_markdown[:500]) < len('<!DOCTYPE html>'):
+    if len(safe_markdown[:500]) < len("<!DOCTYPE html>"):
         # If the HTML is within 500 chars, adjust test
         assert not downloader._is_markdown(safe_markdown)
     else:
         # HTML beyond 500 chars should not trigger rejection
         assert downloader._is_markdown(safe_markdown)
 
+
 def test_html_redirect_trap_scenario():
     """Test real-world scenario: llms.txt redirects to HTML product page"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
 
     # Simulate Claude Code redirect scenario (302 to HTML page)
-    html_product_page = '''<!DOCTYPE html>
+    html_product_page = """<!DOCTYPE html>
 <html lang="en">
 <head>
     <meta charset="UTF-8">
@@ -241,21 +262,22 @@ def test_html_redirect_trap_scenario():
     <h1>Claude Code</h1>
     <p>Product information...</p>
 </body>
-</html>'''
+</html>"""
 
     # Should reject this HTML even though it has <h1> tag (looks like markdown "# ")
     assert not downloader._is_markdown(html_product_page)
 
+
 def test_download_rejects_html_redirect():
     """Test that download() properly rejects HTML redirects"""
     downloader = LlmsTxtDownloader("https://example.com/llms.txt")
 
     mock_response = Mock()
     # Simulate server returning HTML instead of markdown
-    mock_response.text = '<!DOCTYPE html><html><body><h1>Product Page</h1></body></html>'
+    mock_response.text = "<!DOCTYPE html><html><body><h1>Product Page</h1></body></html>"
     mock_response.raise_for_status = Mock()
 
-    with patch('requests.get', return_value=mock_response):
+    with patch("requests.get", return_value=mock_response):
         content = downloader.download()
 
     # Should return None (rejected as non-markdown)
diff --git a/tests/test_llms_txt_parser.py b/tests/test_llms_txt_parser.py
index 0a28bcb..39a52ff 100644
--- a/tests/test_llms_txt_parser.py
+++ b/tests/test_llms_txt_parser.py
@@ -1,6 +1,6 @@
-import pytest
 from skill_seekers.cli.llms_txt_parser import LlmsTxtParser
 
+
 def test_parse_markdown_sections():
     """Test parsing markdown into page sections"""
     sample_content = """# Getting Started
@@ -28,7 +28,7 @@ Main API documentation here.
     pages = parser.parse()
 
     assert len(pages) >= 2
-    assert pages[0]['title'] == 'Getting Started'
-    assert pages[1]['title'] == 'API Reference'
-    assert len(pages[0]['code_samples']) == 1
-    assert pages[0]['code_samples'][0]['language'] == 'javascript'
+    assert pages[0]["title"] == "Getting Started"
+    assert pages[1]["title"] == "API Reference"
+    assert len(pages[0]["code_samples"]) == 1
+    assert pages[0]["code_samples"][0]["language"] == "javascript"
diff --git a/tests/test_markdown_parsing.py b/tests/test_markdown_parsing.py
index 9917225..87b5e88 100644
--- a/tests/test_markdown_parsing.py
+++ b/tests/test_markdown_parsing.py
@@ -8,10 +8,9 @@ Tests the following functionality:
 4. Empty/short content filtering in save_page
 """
 
-import unittest
-import tempfile
 import os
 import shutil
+import unittest
 
 
 class TestMarkdownContentExtraction(unittest.TestCase):
@@ -22,11 +21,11 @@ class TestMarkdownContentExtraction(unittest.TestCase):
         from skill_seekers.cli.doc_scraper import DocToSkillConverter
 
         self.config = {
-            'name': 'test_md_parsing',
-            'base_url': 'https://example.com',
-            'selectors': {},
-            'url_patterns': {'include': [], 'exclude': []},
-            'categories': {}
+            "name": "test_md_parsing",
+            "base_url": "https://example.com",
+            "selectors": {},
+            "url_patterns": {"include": [], "exclude": []},
+            "categories": {},
         }
         self.converter = DocToSkillConverter(self.config)
 
@@ -40,7 +39,7 @@ class TestMarkdownContentExtraction(unittest.TestCase):
         """Test extracting title from first h1."""
         content = "# My Documentation Title\n\nSome content here."
         result = self.converter._extract_markdown_content(content, "https://example.com/test.md")
-        self.assertEqual(result['title'], "My Documentation Title")
+        self.assertEqual(result["title"], "My Documentation Title")
 
     def test_extract_headings_h2_to_h6(self):
         """Test extracting h2-h6 headings (not h1)."""
@@ -56,9 +55,9 @@ Content here.
 """
         result = self.converter._extract_markdown_content(content, "https://example.com/test.md")
         # Should have 5 headings (h2-h6), not h1
-        self.assertEqual(len(result['headings']), 5)
-        self.assertEqual(result['headings'][0]['level'], 'h2')
-        self.assertEqual(result['headings'][0]['text'], 'Section One')
+        self.assertEqual(len(result["headings"]), 5)
+        self.assertEqual(result["headings"][0]["level"], "h2")
+        self.assertEqual(result["headings"][0]["text"], "Section One")
 
     def test_extract_code_blocks_with_language(self):
         """Test extracting code blocks with language tags."""
@@ -80,10 +79,10 @@ plain code without language
 ```
 """
         result = self.converter._extract_markdown_content(content, "https://example.com/test.md")
-        self.assertEqual(len(result['code_samples']), 3)
-        self.assertEqual(result['code_samples'][0]['language'], 'python')
-        self.assertEqual(result['code_samples'][1]['language'], 'javascript')
-        self.assertEqual(result['code_samples'][2]['language'], 'unknown')
+        self.assertEqual(len(result["code_samples"]), 3)
+        self.assertEqual(result["code_samples"][0]["language"], "python")
+        self.assertEqual(result["code_samples"][1]["language"], "javascript")
+        self.assertEqual(result["code_samples"][2]["language"], "unknown")
 
     def test_extract_markdown_links_only_md_files(self):
         """Test that only .md links are extracted."""
@@ -96,8 +95,8 @@ plain code without language
 """
         result = self.converter._extract_markdown_content(content, "https://example.com/docs/test.md")
         # Should only include .md links
-        md_links = [l for l in result['links'] if '.md' in l]
-        self.assertEqual(len(md_links), len(result['links']))
+        md_links = [l for l in result["links"] if ".md" in l]
+        self.assertEqual(len(md_links), len(result["links"]))
 
     def test_extract_content_paragraphs(self):
         """Test extracting paragraph content."""
@@ -110,14 +109,14 @@ Short.
 Another paragraph that should be included in the final content output.
 """
         result = self.converter._extract_markdown_content(content, "https://example.com/test.md")
-        self.assertIn("paragraph with enough content", result['content'])
-        self.assertNotIn("Short.", result['content'])
+        self.assertIn("paragraph with enough content", result["content"])
+        self.assertNotIn("Short.", result["content"])
 
     def test_detect_html_in_md_url(self):
         """Test that HTML content is detected when .md URL returns HTML."""
         html_content = "<!DOCTYPE html><html><head><title>Page</title></head><body><h1>Hello</h1></body></html>"
         result = self.converter._extract_markdown_content(html_content, "https://example.com/test.md")
-        self.assertEqual(result['title'], "Page")
+        self.assertEqual(result["title"], "Page")
 
 
 class TestHtmlAsMarkdownExtraction(unittest.TestCase):
@@ -128,11 +127,11 @@ class TestHtmlAsMarkdownExtraction(unittest.TestCase):
         from skill_seekers.cli.doc_scraper import DocToSkillConverter
 
         self.config = {
-            'name': 'test_html_fallback',
-            'base_url': 'https://example.com',
-            'selectors': {},
-            'url_patterns': {'include': [], 'exclude': []},
-            'categories': {}
+            "name": "test_html_fallback",
+            "base_url": "https://example.com",
+            "selectors": {},
+            "url_patterns": {"include": [], "exclude": []},
+            "categories": {},
         }
         self.converter = DocToSkillConverter(self.config)
 
@@ -146,7 +145,7 @@ class TestHtmlAsMarkdownExtraction(unittest.TestCase):
         """Test extracting title from HTML title tag."""
         html = "<html><head><title>My Page Title</title></head><body></body></html>"
         result = self.converter._extract_html_as_markdown(html, "https://example.com/test.md")
-        self.assertEqual(result['title'], "My Page Title")
+        self.assertEqual(result["title"], "My Page Title")
 
     def test_find_main_content_area(self):
         """Test finding main content from various selectors."""
@@ -161,7 +160,7 @@ class TestHtmlAsMarkdownExtraction(unittest.TestCase):
         </body></html>
         """
         result = self.converter._extract_html_as_markdown(html, "https://example.com/test.md")
-        self.assertIn("main content area", result['content'].lower())
+        self.assertIn("main content area", result["content"].lower())
 
     def test_extract_code_blocks_from_html(self):
         """Test extracting code blocks from HTML pre/code tags."""
@@ -173,7 +172,7 @@ class TestHtmlAsMarkdownExtraction(unittest.TestCase):
         </body></html>
         """
         result = self.converter._extract_html_as_markdown(html, "https://example.com/test.md")
-        self.assertTrue(len(result['code_samples']) > 0)
+        self.assertTrue(len(result["code_samples"]) > 0)
 
     def test_fallback_to_body_when_no_main(self):
         """Test fallback to body when no main/article element."""
@@ -186,7 +185,7 @@ class TestHtmlAsMarkdownExtraction(unittest.TestCase):
         </body></html>
         """
         result = self.converter._extract_html_as_markdown(html, "https://example.com/test.md")
-        self.assertTrue(len(result['headings']) > 0 or len(result['content']) > 0)
+        self.assertTrue(len(result["headings"]) > 0 or len(result["content"]) > 0)
 
 
 class TestLlmsTxtUrlExtraction(unittest.TestCase):
@@ -292,11 +291,11 @@ class TestSavePageContentFiltering(unittest.TestCase):
         from skill_seekers.cli.doc_scraper import DocToSkillConverter
 
         self.config = {
-            'name': 'test_save_filter',
-            'base_url': 'https://example.com',
-            'selectors': {},
-            'url_patterns': {'include': [], 'exclude': []},
-            'categories': {}
+            "name": "test_save_filter",
+            "base_url": "https://example.com",
+            "selectors": {},
+            "url_patterns": {"include": [], "exclude": []},
+            "categories": {},
         }
         self.converter = DocToSkillConverter(self.config)
 
@@ -309,51 +308,51 @@ class TestSavePageContentFiltering(unittest.TestCase):
     def test_skip_empty_content(self):
         """Test that pages with empty content are skipped."""
         page = {
-            'url': 'https://example.com/empty',
-            'title': 'Empty Page',
-            'content': '',
-            'headings': [],
-            'code_samples': []
+            "url": "https://example.com/empty",
+            "title": "Empty Page",
+            "content": "",
+            "headings": [],
+            "code_samples": [],
         }
 
         self.converter.save_page(page)
 
-        pages_dir = os.path.join(self.converter.data_dir, 'pages')
+        pages_dir = os.path.join(self.converter.data_dir, "pages")
         if os.path.exists(pages_dir):
             self.assertEqual(len(os.listdir(pages_dir)), 0)
 
     def test_skip_short_content_under_50_chars(self):
         """Test that pages with content < 50 chars are skipped."""
         page = {
-            'url': 'https://example.com/short',
-            'title': 'Short',
-            'content': 'This is too short.',  # 18 chars
-            'headings': [],
-            'code_samples': []
+            "url": "https://example.com/short",
+            "title": "Short",
+            "content": "This is too short.",  # 18 chars
+            "headings": [],
+            "code_samples": [],
         }
 
         self.converter.save_page(page)
 
-        pages_dir = os.path.join(self.converter.data_dir, 'pages')
+        pages_dir = os.path.join(self.converter.data_dir, "pages")
         if os.path.exists(pages_dir):
             self.assertEqual(len(os.listdir(pages_dir)), 0)
 
     def test_save_content_over_50_chars(self):
         """Test that pages with content >= 50 chars are saved."""
         page = {
-            'url': 'https://example.com/valid',
-            'title': 'Valid Page',
-            'content': 'A' * 60,  # 60 chars, should pass
-            'headings': [],
-            'code_samples': []
+            "url": "https://example.com/valid",
+            "title": "Valid Page",
+            "content": "A" * 60,  # 60 chars, should pass
+            "headings": [],
+            "code_samples": [],
         }
 
         self.converter.save_page(page)
 
-        pages_dir = os.path.join(self.converter.data_dir, 'pages')
+        pages_dir = os.path.join(self.converter.data_dir, "pages")
         self.assertTrue(os.path.exists(pages_dir))
         self.assertEqual(len(os.listdir(pages_dir)), 1)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_mcp_fastmcp.py b/tests/test_mcp_fastmcp.py
index a8d8ac1..018a7f2 100644
--- a/tests/test_mcp_fastmcp.py
+++ b/tests/test_mcp_fastmcp.py
@@ -4,13 +4,11 @@ Comprehensive test suite for FastMCP Server Implementation
 Tests all 17 tools across 5 categories with comprehensive coverage
 """
 
-import sys
-import os
 import json
-import tempfile
+import os
+from unittest.mock import MagicMock, Mock, patch
+
 import pytest
-from pathlib import Path
-from unittest.mock import Mock, patch, AsyncMock, MagicMock
 
 # WORKAROUND for shadowing issue: Temporarily change to /tmp to import external mcp
 # This avoids any local mcp/ directory being in the import path
@@ -19,9 +17,10 @@ MCP_AVAILABLE = False
 FASTMCP_AVAILABLE = False
 
 try:
-    os.chdir('/tmp')  # Change away from project directory
-    from mcp.types import TextContent
+    os.chdir("/tmp")  # Change away from project directory
     from mcp.server import FastMCP
+    from mcp.types import TextContent
+
     MCP_AVAILABLE = True
     FASTMCP_AVAILABLE = True
 except ImportError:
@@ -56,12 +55,7 @@ def temp_dirs(tmp_path):
     output_dir.mkdir()
     cache_dir.mkdir()
 
-    return {
-        "config": config_dir,
-        "output": output_dir,
-        "cache": cache_dir,
-        "base": tmp_path
-    }
+    return {"config": config_dir, "output": output_dir, "cache": cache_dir, "base": tmp_path}
 
 
 @pytest.fixture
@@ -71,21 +65,11 @@ def sample_config(temp_dirs):
         "name": "test-framework",
         "description": "Test framework for testing",
         "base_url": "https://test-framework.dev/",
-        "selectors": {
-            "main_content": "article",
-            "title": "h1",
-            "code_blocks": "pre"
-        },
-        "url_patterns": {
-            "include": ["/docs/"],
-            "exclude": ["/blog/", "/search/"]
-        },
-        "categories": {
-            "getting_started": ["introduction", "getting-started"],
-            "api": ["api", "reference"]
-        },
+        "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+        "url_patterns": {"include": ["/docs/"], "exclude": ["/blog/", "/search/"]},
+        "categories": {"getting_started": ["introduction", "getting-started"], "api": ["api", "reference"]},
         "rate_limit": 0.5,
-        "max_pages": 100
+        "max_pages": 100,
     }
 
     config_path = temp_dirs["config"] / "test-framework.json"
@@ -101,18 +85,9 @@ def unified_config(temp_dirs):
         "description": "Test unified scraping",
         "merge_mode": "rule-based",
         "sources": [
-            {
-                "type": "documentation",
-                "base_url": "https://example.com/docs/",
-                "extract_api": True,
-                "max_pages": 10
-            },
-            {
-                "type": "github",
-                "repo": "test/repo",
-                "extract_readme": True
-            }
-        ]
+            {"type": "documentation", "base_url": "https://example.com/docs/", "extract_api": True, "max_pages": 10},
+            {"type": "github", "repo": "test/repo", "extract_readme": True},
+        ],
     }
 
     config_path = temp_dirs["config"] / "test-unified.json"
@@ -132,7 +107,7 @@ class TestFastMCPServerInitialization:
     def test_server_import(self):
         """Test that FastMCP server module can be imported."""
         assert server_fastmcp is not None
-        assert hasattr(server_fastmcp, 'mcp')
+        assert hasattr(server_fastmcp, "mcp")
 
     def test_server_has_name(self):
         """Test that server has correct name."""
@@ -169,7 +144,7 @@ class TestFastMCPServerInitialization:
             "submit_config",
             "add_config_source",
             "list_config_sources",
-            "remove_config_source"
+            "remove_config_source",
         ]
 
         # Check that decorators were applied
@@ -191,11 +166,7 @@ class TestConfigTools:
         """Test basic config generation."""
         monkeypatch.chdir(temp_dirs["base"])
 
-        args = {
-            "name": "my-framework",
-            "url": "https://my-framework.dev/",
-            "description": "My framework skill"
-        }
+        args = {"name": "my-framework", "url": "https://my-framework.dev/", "description": "My framework skill"}
 
         result = await server_fastmcp.generate_config(**args)
 
@@ -216,7 +187,7 @@ class TestConfigTools:
             "url": "https://custom.dev/",
             "description": "Custom skill",
             "max_pages": 200,
-            "rate_limit": 1.0
+            "rate_limit": 1.0,
         }
 
         result = await server_fastmcp.generate_config(**args)
@@ -230,7 +201,7 @@ class TestConfigTools:
             "name": "unlimited-framework",
             "url": "https://unlimited.dev/",
             "description": "Unlimited skill",
-            "unlimited": True
+            "unlimited": True,
         }
 
         result = await server_fastmcp.generate_config(**args)
@@ -261,9 +232,7 @@ class TestConfigTools:
 
     async def test_validate_config_missing_file(self, temp_dirs):
         """Test validating a non-existent config file."""
-        result = await server_fastmcp.validate_config(
-            config_path=str(temp_dirs["config"] / "nonexistent.json")
-        )
+        result = await server_fastmcp.validate_config(config_path=str(temp_dirs["config"] / "nonexistent.json"))
 
         assert isinstance(result, str)
         # Should indicate error
@@ -282,110 +251,73 @@ class TestScrapingTools:
 
     async def test_estimate_pages_basic(self, sample_config):
         """Test basic page estimation."""
-        with patch('subprocess.run') as mock_run:
-            mock_run.return_value = Mock(
-                returncode=0,
-                stdout="Estimated pages: 150\nRecommended max_pages: 200"
-            )
+        with patch("subprocess.run") as mock_run:
+            mock_run.return_value = Mock(returncode=0, stdout="Estimated pages: 150\nRecommended max_pages: 200")
 
-            result = await server_fastmcp.estimate_pages(
-                config_path=str(sample_config)
-            )
+            result = await server_fastmcp.estimate_pages(config_path=str(sample_config))
 
             assert isinstance(result, str)
 
     async def test_estimate_pages_unlimited(self, sample_config):
         """Test estimation with unlimited discovery."""
-        result = await server_fastmcp.estimate_pages(
-            config_path=str(sample_config),
-            unlimited=True
-        )
+        result = await server_fastmcp.estimate_pages(config_path=str(sample_config), unlimited=True)
 
         assert isinstance(result, str)
 
     async def test_estimate_pages_custom_discovery(self, sample_config):
         """Test estimation with custom max_discovery."""
-        result = await server_fastmcp.estimate_pages(
-            config_path=str(sample_config),
-            max_discovery=500
-        )
+        result = await server_fastmcp.estimate_pages(config_path=str(sample_config), max_discovery=500)
 
         assert isinstance(result, str)
 
     async def test_scrape_docs_basic(self, sample_config):
         """Test basic documentation scraping."""
-        with patch('subprocess.run') as mock_run:
-            mock_run.return_value = Mock(
-                returncode=0,
-                stdout="Scraping completed successfully"
-            )
+        with patch("subprocess.run") as mock_run:
+            mock_run.return_value = Mock(returncode=0, stdout="Scraping completed successfully")
 
-            result = await server_fastmcp.scrape_docs(
-                config_path=str(sample_config),
-                dry_run=True
-            )
+            result = await server_fastmcp.scrape_docs(config_path=str(sample_config), dry_run=True)
 
             assert isinstance(result, str)
 
     async def test_scrape_docs_with_enhancement(self, sample_config):
         """Test scraping with local enhancement."""
-        result = await server_fastmcp.scrape_docs(
-            config_path=str(sample_config),
-            enhance_local=True,
-            dry_run=True
-        )
+        result = await server_fastmcp.scrape_docs(config_path=str(sample_config), enhance_local=True, dry_run=True)
 
         assert isinstance(result, str)
 
     async def test_scrape_docs_skip_scrape(self, sample_config):
         """Test scraping with skip_scrape flag."""
-        result = await server_fastmcp.scrape_docs(
-            config_path=str(sample_config),
-            skip_scrape=True
-        )
+        result = await server_fastmcp.scrape_docs(config_path=str(sample_config), skip_scrape=True)
 
         assert isinstance(result, str)
 
     async def test_scrape_docs_unified(self, unified_config):
         """Test scraping with unified config."""
-        result = await server_fastmcp.scrape_docs(
-            config_path=str(unified_config),
-            dry_run=True
-        )
+        result = await server_fastmcp.scrape_docs(config_path=str(unified_config), dry_run=True)
 
         assert isinstance(result, str)
 
     async def test_scrape_docs_merge_mode_override(self, unified_config):
         """Test scraping with merge mode override."""
         result = await server_fastmcp.scrape_docs(
-            config_path=str(unified_config),
-            merge_mode="claude-enhanced",
-            dry_run=True
+            config_path=str(unified_config), merge_mode="claude-enhanced", dry_run=True
         )
 
         assert isinstance(result, str)
 
     async def test_scrape_github_basic(self):
         """Test basic GitHub scraping."""
-        with patch('subprocess.run') as mock_run:
-            mock_run.return_value = Mock(
-                returncode=0,
-                stdout="GitHub scraping completed"
-            )
+        with patch("subprocess.run") as mock_run:
+            mock_run.return_value = Mock(returncode=0, stdout="GitHub scraping completed")
 
-            result = await server_fastmcp.scrape_github(
-                repo="facebook/react",
-                name="react-github-test"
-            )
+            result = await server_fastmcp.scrape_github(repo="facebook/react", name="react-github-test")
 
             assert isinstance(result, str)
 
     async def test_scrape_github_with_token(self):
         """Test GitHub scraping with authentication token."""
         result = await server_fastmcp.scrape_github(
-            repo="private/repo",
-            token="fake_token_for_testing",
-            name="private-test"
+            repo="private/repo", token="fake_token_for_testing", name="private-test"
         )
 
         assert isinstance(result, str)
@@ -393,12 +325,7 @@ class TestScrapingTools:
     async def test_scrape_github_options(self):
         """Test GitHub scraping with various options."""
         result = await server_fastmcp.scrape_github(
-            repo="test/repo",
-            no_issues=True,
-            no_changelog=True,
-            no_releases=True,
-            max_issues=50,
-            scrape_only=True
+            repo="test/repo", no_issues=True, no_changelog=True, no_releases=True, max_issues=50, scrape_only=True
         )
 
         assert isinstance(result, str)
@@ -406,26 +333,17 @@ class TestScrapingTools:
     async def test_scrape_pdf_basic(self, temp_dirs):
         """Test basic PDF scraping."""
         # Create a dummy PDF config
-        pdf_config = {
-            "name": "test-pdf",
-            "pdf_path": "/path/to/test.pdf",
-            "description": "Test PDF skill"
-        }
+        pdf_config = {"name": "test-pdf", "pdf_path": "/path/to/test.pdf", "description": "Test PDF skill"}
         config_path = temp_dirs["config"] / "test-pdf.json"
         config_path.write_text(json.dumps(pdf_config))
 
-        result = await server_fastmcp.scrape_pdf(
-            config_path=str(config_path)
-        )
+        result = await server_fastmcp.scrape_pdf(config_path=str(config_path))
 
         assert isinstance(result, str)
 
     async def test_scrape_pdf_direct_path(self):
         """Test PDF scraping with direct path."""
-        result = await server_fastmcp.scrape_pdf(
-            pdf_path="/path/to/manual.pdf",
-            name="manual-skill"
-        )
+        result = await server_fastmcp.scrape_pdf(pdf_path="/path/to/manual.pdf", name="manual-skill")
 
         assert isinstance(result, str)
 
@@ -437,8 +355,7 @@ class TestScrapingTools:
         (src_dir / "test.py").write_text("def hello(): pass")
 
         result = await server_fastmcp.scrape_codebase(
-            directory=str(src_dir),
-            output=str(temp_dirs["output"] / "codebase_analysis")
+            directory=str(src_dir), output=str(temp_dirs["output"] / "codebase_analysis")
         )
 
         assert isinstance(result, str)
@@ -456,7 +373,7 @@ class TestScrapingTools:
             depth="deep",
             languages="Python,JavaScript",
             file_patterns="*.py,*.js",
-            build_api_reference=True
+            build_api_reference=True,
         )
 
         assert isinstance(result, str)
@@ -479,16 +396,10 @@ class TestPackagingTools:
         skill_dir.mkdir()
         (skill_dir / "SKILL.md").write_text("# Test Skill")
 
-        with patch('skill_seekers.mcp.tools.packaging_tools.subprocess.run') as mock_run:
-            mock_run.return_value = Mock(
-                returncode=0,
-                stdout="Packaging completed"
-            )
+        with patch("skill_seekers.mcp.tools.packaging_tools.subprocess.run") as mock_run:
+            mock_run.return_value = Mock(returncode=0, stdout="Packaging completed")
 
-            result = await server_fastmcp.package_skill(
-                skill_dir=str(skill_dir),
-                auto_upload=False
-            )
+            result = await server_fastmcp.package_skill(skill_dir=str(skill_dir), auto_upload=False)
 
             assert isinstance(result, str)
 
@@ -498,10 +409,7 @@ class TestPackagingTools:
         skill_dir.mkdir()
         (skill_dir / "SKILL.md").write_text("# Test Skill")
 
-        result = await server_fastmcp.package_skill(
-            skill_dir=str(skill_dir),
-            auto_upload=True
-        )
+        result = await server_fastmcp.package_skill(skill_dir=str(skill_dir), auto_upload=True)
 
         assert isinstance(result, str)
 
@@ -511,76 +419,55 @@ class TestPackagingTools:
         zip_path = temp_dirs["output"] / "test-skill.zip"
         zip_path.write_text("fake zip content")
 
-        with patch('skill_seekers.mcp.tools.packaging_tools.subprocess.run') as mock_run:
-            mock_run.return_value = Mock(
-                returncode=0,
-                stdout="Upload successful"
-            )
+        with patch("skill_seekers.mcp.tools.packaging_tools.subprocess.run") as mock_run:
+            mock_run.return_value = Mock(returncode=0, stdout="Upload successful")
 
-            result = await server_fastmcp.upload_skill(
-                skill_zip=str(zip_path)
-            )
+            result = await server_fastmcp.upload_skill(skill_zip=str(zip_path))
 
             assert isinstance(result, str)
 
     async def test_upload_skill_missing_file(self, temp_dirs):
         """Test upload with missing file."""
-        result = await server_fastmcp.upload_skill(
-            skill_zip=str(temp_dirs["output"] / "nonexistent.zip")
-        )
+        result = await server_fastmcp.upload_skill(skill_zip=str(temp_dirs["output"] / "nonexistent.zip"))
 
         assert isinstance(result, str)
 
     async def test_install_skill_with_config_name(self):
         """Test complete install workflow with config name."""
         # Mock the fetch_config_tool import that install_skill_tool uses
-        with patch('skill_seekers.mcp.tools.source_tools.fetch_config_tool') as mock_fetch:
+        with patch("skill_seekers.mcp.tools.source_tools.fetch_config_tool") as mock_fetch:
             mock_fetch.return_value = [Mock(text="Config fetched")]
 
-            result = await server_fastmcp.install_skill(
-                config_name="react",
-                destination="output",
-                dry_run=True
-            )
+            result = await server_fastmcp.install_skill(config_name="react", destination="output", dry_run=True)
 
             assert isinstance(result, str)
 
     async def test_install_skill_with_config_path(self, sample_config):
         """Test complete install workflow with config path."""
-        with patch('skill_seekers.mcp.tools.source_tools.fetch_config_tool') as mock_fetch:
+        with patch("skill_seekers.mcp.tools.source_tools.fetch_config_tool") as mock_fetch:
             mock_fetch.return_value = [Mock(text="Config ready")]
 
             result = await server_fastmcp.install_skill(
-                config_path=str(sample_config),
-                destination="output",
-                dry_run=True
+                config_path=str(sample_config), destination="output", dry_run=True
             )
 
             assert isinstance(result, str)
 
     async def test_install_skill_unlimited(self):
         """Test install workflow with unlimited pages."""
-        with patch('skill_seekers.mcp.tools.source_tools.fetch_config_tool') as mock_fetch:
+        with patch("skill_seekers.mcp.tools.source_tools.fetch_config_tool") as mock_fetch:
             mock_fetch.return_value = [Mock(text="Config fetched")]
 
-            result = await server_fastmcp.install_skill(
-                config_name="react",
-                unlimited=True,
-                dry_run=True
-            )
+            result = await server_fastmcp.install_skill(config_name="react", unlimited=True, dry_run=True)
 
             assert isinstance(result, str)
 
     async def test_install_skill_no_upload(self):
         """Test install workflow without auto-upload."""
-        with patch('skill_seekers.mcp.tools.source_tools.fetch_config_tool') as mock_fetch:
+        with patch("skill_seekers.mcp.tools.source_tools.fetch_config_tool") as mock_fetch:
             mock_fetch.return_value = [Mock(text="Config fetched")]
 
-            result = await server_fastmcp.install_skill(
-                config_name="react",
-                auto_upload=False,
-                dry_run=True
-            )
+            result = await server_fastmcp.install_skill(config_name="react", auto_upload=False, dry_run=True)
 
             assert isinstance(result, str)
 
@@ -597,21 +484,14 @@ class TestSplittingTools:
 
     async def test_split_config_auto_strategy(self, sample_config):
         """Test config splitting with auto strategy."""
-        result = await server_fastmcp.split_config(
-            config_path=str(sample_config),
-            strategy="auto",
-            dry_run=True
-        )
+        result = await server_fastmcp.split_config(config_path=str(sample_config), strategy="auto", dry_run=True)
 
         assert isinstance(result, str)
 
     async def test_split_config_category_strategy(self, sample_config):
         """Test config splitting with category strategy."""
         result = await server_fastmcp.split_config(
-            config_path=str(sample_config),
-            strategy="category",
-            target_pages=5000,
-            dry_run=True
+            config_path=str(sample_config), strategy="category", target_pages=5000, dry_run=True
         )
 
         assert isinstance(result, str)
@@ -619,10 +499,7 @@ class TestSplittingTools:
     async def test_split_config_size_strategy(self, sample_config):
         """Test config splitting with size strategy."""
         result = await server_fastmcp.split_config(
-            config_path=str(sample_config),
-            strategy="size",
-            target_pages=3000,
-            dry_run=True
+            config_path=str(sample_config), strategy="size", target_pages=3000, dry_run=True
         )
 
         assert isinstance(result, str)
@@ -633,17 +510,14 @@ class TestSplittingTools:
         (temp_dirs["config"] / "godot-scripting.json").write_text("{}")
         (temp_dirs["config"] / "godot-physics.json").write_text("{}")
 
-        result = await server_fastmcp.generate_router(
-            config_pattern=str(temp_dirs["config"] / "godot-*.json")
-        )
+        result = await server_fastmcp.generate_router(config_pattern=str(temp_dirs["config"] / "godot-*.json"))
 
         assert isinstance(result, str)
 
     async def test_generate_router_with_name(self, temp_dirs):
         """Test router generation with custom name."""
         result = await server_fastmcp.generate_router(
-            config_pattern=str(temp_dirs["config"] / "godot-*.json"),
-            router_name="godot-hub"
+            config_pattern=str(temp_dirs["config"] / "godot-*.json"), router_name="godot-hub"
         )
 
         assert isinstance(result, str)
@@ -661,47 +535,37 @@ class TestSourceTools:
 
     async def test_fetch_config_list_api(self):
         """Test fetching config list from API."""
-        with patch('skill_seekers.mcp.tools.source_tools.httpx.AsyncClient') as mock_client:
+        with patch("skill_seekers.mcp.tools.source_tools.httpx.AsyncClient") as mock_client:
             mock_response = MagicMock()
             mock_response.json.return_value = {
                 "configs": [
                     {"name": "react", "category": "web-frameworks"},
-                    {"name": "vue", "category": "web-frameworks"}
+                    {"name": "vue", "category": "web-frameworks"},
                 ],
-                "total": 2
+                "total": 2,
             }
             mock_client.return_value.__aenter__.return_value.get.return_value = mock_response
 
-            result = await server_fastmcp.fetch_config(
-                list_available=True
-            )
+            result = await server_fastmcp.fetch_config(list_available=True)
 
             assert isinstance(result, str)
 
     async def test_fetch_config_download_api(self, temp_dirs):
         """Test downloading specific config from API."""
-        result = await server_fastmcp.fetch_config(
-            config_name="react",
-            destination=str(temp_dirs["config"])
-        )
+        result = await server_fastmcp.fetch_config(config_name="react", destination=str(temp_dirs["config"]))
 
         assert isinstance(result, str)
 
     async def test_fetch_config_with_category_filter(self):
         """Test fetching configs with category filter."""
-        result = await server_fastmcp.fetch_config(
-            list_available=True,
-            category="web-frameworks"
-        )
+        result = await server_fastmcp.fetch_config(list_available=True, category="web-frameworks")
 
         assert isinstance(result, str)
 
     async def test_fetch_config_from_git_url(self, temp_dirs):
         """Test fetching config from git URL."""
         result = await server_fastmcp.fetch_config(
-            config_name="react",
-            git_url="https://github.com/myorg/configs.git",
-            destination=str(temp_dirs["config"])
+            config_name="react", git_url="https://github.com/myorg/configs.git", destination=str(temp_dirs["config"])
         )
 
         assert isinstance(result, str)
@@ -709,9 +573,7 @@ class TestSourceTools:
     async def test_fetch_config_from_source(self, temp_dirs):
         """Test fetching config from named source."""
         result = await server_fastmcp.fetch_config(
-            config_name="react",
-            source="team",
-            destination=str(temp_dirs["config"])
+            config_name="react", source="team", destination=str(temp_dirs["config"])
         )
 
         assert isinstance(result, str)
@@ -722,7 +584,7 @@ class TestSourceTools:
             config_name="react",
             git_url="https://github.com/private/configs.git",
             token="fake_token",
-            destination=str(temp_dirs["config"])
+            destination=str(temp_dirs["config"]),
         )
 
         assert isinstance(result, str)
@@ -733,7 +595,7 @@ class TestSourceTools:
             config_name="react",
             git_url="https://github.com/myorg/configs.git",
             refresh=True,
-            destination=str(temp_dirs["config"])
+            destination=str(temp_dirs["config"]),
         )
 
         assert isinstance(result, str)
@@ -741,32 +603,22 @@ class TestSourceTools:
     async def test_submit_config_with_path(self, sample_config):
         """Test submitting config from file path."""
         result = await server_fastmcp.submit_config(
-            config_path=str(sample_config),
-            testing_notes="Tested with 20 pages, works well"
+            config_path=str(sample_config), testing_notes="Tested with 20 pages, works well"
         )
 
         assert isinstance(result, str)
 
     async def test_submit_config_with_json(self):
         """Test submitting config as JSON string."""
-        config_json = json.dumps({
-            "name": "my-framework",
-            "base_url": "https://my-framework.dev/"
-        })
+        config_json = json.dumps({"name": "my-framework", "base_url": "https://my-framework.dev/"})
 
-        result = await server_fastmcp.submit_config(
-            config_json=config_json,
-            testing_notes="Works great!"
-        )
+        result = await server_fastmcp.submit_config(config_json=config_json, testing_notes="Works great!")
 
         assert isinstance(result, str)
 
     async def test_add_config_source_basic(self):
         """Test adding a config source."""
-        result = await server_fastmcp.add_config_source(
-            name="team",
-            git_url="https://github.com/myorg/configs.git"
-        )
+        result = await server_fastmcp.add_config_source(name="team", git_url="https://github.com/myorg/configs.git")
 
         assert isinstance(result, str)
 
@@ -779,7 +631,7 @@ class TestSourceTools:
             token_env="GITLAB_TOKEN",
             branch="develop",
             priority=50,
-            enabled=True
+            enabled=True,
         )
 
         assert isinstance(result, str)
@@ -787,34 +639,26 @@ class TestSourceTools:
     async def test_add_config_source_ssh_url(self):
         """Test adding config source with SSH URL."""
         result = await server_fastmcp.add_config_source(
-            name="private",
-            git_url="git@github.com:myorg/private-configs.git",
-            source_type="github"
+            name="private", git_url="git@github.com:myorg/private-configs.git", source_type="github"
         )
 
         assert isinstance(result, str)
 
     async def test_list_config_sources_all(self):
         """Test listing all config sources."""
-        result = await server_fastmcp.list_config_sources(
-            enabled_only=False
-        )
+        result = await server_fastmcp.list_config_sources(enabled_only=False)
 
         assert isinstance(result, str)
 
     async def test_list_config_sources_enabled_only(self):
         """Test listing only enabled sources."""
-        result = await server_fastmcp.list_config_sources(
-            enabled_only=True
-        )
+        result = await server_fastmcp.list_config_sources(enabled_only=True)
 
         assert isinstance(result, str)
 
     async def test_remove_config_source(self):
         """Test removing a config source."""
-        result = await server_fastmcp.remove_config_source(
-            name="team"
-        )
+        result = await server_fastmcp.remove_config_source(name="team")
 
         assert isinstance(result, str)
 
@@ -835,45 +679,34 @@ class TestFastMCPIntegration:
 
         # Step 1: Generate config
         result1 = await server_fastmcp.generate_config(
-            name="workflow-test",
-            url="https://workflow.dev/",
-            description="Workflow test"
+            name="workflow-test", url="https://workflow.dev/", description="Workflow test"
         )
         assert isinstance(result1, str)
 
         # Step 2: Validate config
         config_path = temp_dirs["base"] / "configs" / "workflow-test.json"
         if config_path.exists():
-            result2 = await server_fastmcp.validate_config(
-                config_path=str(config_path)
-            )
+            result2 = await server_fastmcp.validate_config(config_path=str(config_path))
             assert isinstance(result2, str)
 
     async def test_workflow_source_fetch_scrape(self, temp_dirs):
         """Test workflow: add source → fetch config → scrape."""
         # Step 1: Add source
         result1 = await server_fastmcp.add_config_source(
-            name="test-source",
-            git_url="https://github.com/test/configs.git"
+            name="test-source", git_url="https://github.com/test/configs.git"
         )
         assert isinstance(result1, str)
 
         # Step 2: Fetch config
         result2 = await server_fastmcp.fetch_config(
-            config_name="react",
-            source="test-source",
-            destination=str(temp_dirs["config"])
+            config_name="react", source="test-source", destination=str(temp_dirs["config"])
         )
         assert isinstance(result2, str)
 
     async def test_workflow_split_router(self, sample_config, temp_dirs):
         """Test workflow: split config → generate router."""
         # Step 1: Split config
-        result1 = await server_fastmcp.split_config(
-            config_path=str(sample_config),
-            strategy="category",
-            dry_run=True
-        )
+        result1 = await server_fastmcp.split_config(config_path=str(sample_config), strategy="category", dry_run=True)
         assert isinstance(result1, str)
 
         # Step 2: Generate router
@@ -898,9 +731,7 @@ class TestErrorHandling:
         monkeypatch.chdir(temp_dirs["base"])
 
         result = await server_fastmcp.generate_config(
-            name="invalid-test",
-            url="not-a-valid-url",
-            description="Test invalid URL"
+            name="invalid-test", url="not-a-valid-url", description="Test invalid URL"
         )
 
         assert isinstance(result, str)
@@ -911,9 +742,7 @@ class TestErrorHandling:
         bad_config = temp_dirs["config"] / "bad.json"
         bad_config.write_text("{ invalid json }")
 
-        result = await server_fastmcp.validate_config(
-            config_path=str(bad_config)
-        )
+        result = await server_fastmcp.validate_config(config_path=str(bad_config))
 
         assert isinstance(result, str)
 
@@ -921,9 +750,7 @@ class TestErrorHandling:
         """Test error handling for missing config file."""
         # This should handle the error gracefully and return a string
         try:
-            result = await server_fastmcp.scrape_docs(
-                config_path="/nonexistent/config.json"
-            )
+            result = await server_fastmcp.scrape_docs(config_path="/nonexistent/config.json")
             assert isinstance(result, str)
             # Should contain error message
             assert "error" in result.lower() or "not found" in result.lower() or "❌" in result
@@ -933,9 +760,7 @@ class TestErrorHandling:
 
     async def test_package_skill_missing_directory(self):
         """Test error handling for missing skill directory."""
-        result = await server_fastmcp.package_skill(
-            skill_dir="/nonexistent/skill"
-        )
+        result = await server_fastmcp.package_skill(skill_dir="/nonexistent/skill")
 
         assert isinstance(result, str)
 
@@ -955,9 +780,7 @@ class TestTypeValidation:
         monkeypatch.chdir(temp_dirs["base"])
 
         result = await server_fastmcp.generate_config(
-            name="type-test",
-            url="https://test.dev/",
-            description="Type test"
+            name="type-test", url="https://test.dev/", description="Type test"
         )
 
         assert isinstance(result, str)
@@ -969,9 +792,7 @@ class TestTypeValidation:
 
     async def test_estimate_pages_return_type(self, sample_config):
         """Test that estimate_pages returns string."""
-        result = await server_fastmcp.estimate_pages(
-            config_path=str(sample_config)
-        )
+        result = await server_fastmcp.estimate_pages(config_path=str(sample_config))
         assert isinstance(result, str)
 
     async def test_all_tools_return_strings(self, sample_config, temp_dirs):
diff --git a/tests/test_mcp_git_sources.py b/tests/test_mcp_git_sources.py
index d094db8..4049313 100644
--- a/tests/test_mcp_git_sources.py
+++ b/tests/test_mcp_git_sources.py
@@ -5,15 +5,15 @@ Tests the complete MCP tool workflow for git-based config fetching
 """
 
 import json
+from unittest.mock import MagicMock, patch
+
 import pytest
-import os
-from pathlib import Path
-from unittest.mock import AsyncMock, MagicMock, patch, Mock
 
 # Test if MCP is available
 try:
     import mcp
     from mcp.types import TextContent
+
     MCP_AVAILABLE = True
 except ImportError:
     MCP_AVAILABLE = False
@@ -31,11 +31,7 @@ def temp_dirs(tmp_path):
     cache_dir.mkdir()
     dest_dir.mkdir()
 
-    return {
-        "config": config_dir,
-        "cache": cache_dir,
-        "dest": dest_dir
-    }
+    return {"config": config_dir, "cache": cache_dir, "dest": dest_dir}
 
 
 @pytest.fixture
@@ -46,18 +42,10 @@ def mock_git_repo(temp_dirs):
     (repo_path / ".git").mkdir()
 
     # Create sample config files
-    react_config = {
-        "name": "react",
-        "description": "React framework",
-        "base_url": "https://react.dev/"
-    }
+    react_config = {"name": "react", "description": "React framework", "base_url": "https://react.dev/"}
     (repo_path / "react.json").write_text(json.dumps(react_config, indent=2))
 
-    vue_config = {
-        "name": "vue",
-        "description": "Vue framework",
-        "base_url": "https://vuejs.org/"
-    }
+    vue_config = {"name": "vue", "description": "Vue framework", "base_url": "https://vuejs.org/"}
     (repo_path / "vue.json").write_text(json.dumps(vue_config, indent=2))
 
     return repo_path
@@ -72,15 +60,15 @@ class TestFetchConfigModes:
         """Test API mode - listing available configs."""
         from skill_seekers.mcp.server import fetch_config_tool
 
-        with patch('skill_seekers.mcp.server.httpx.AsyncClient') as mock_client:
+        with patch("skill_seekers.mcp.server.httpx.AsyncClient") as mock_client:
             # Mock API response
             mock_response = MagicMock()
             mock_response.json.return_value = {
                 "configs": [
                     {"name": "react", "category": "web-frameworks", "description": "React framework", "type": "single"},
-                    {"name": "vue", "category": "web-frameworks", "description": "Vue framework", "type": "single"}
+                    {"name": "vue", "category": "web-frameworks", "description": "Vue framework", "type": "single"},
                 ],
-                "total": 2
+                "total": 2,
             }
             mock_client.return_value.__aenter__.return_value.get.return_value = mock_response
 
@@ -96,28 +84,22 @@ class TestFetchConfigModes:
         """Test API mode - downloading specific config."""
         from skill_seekers.mcp.server import fetch_config_tool
 
-        with patch('skill_seekers.mcp.server.httpx.AsyncClient') as mock_client:
+        with patch("skill_seekers.mcp.server.httpx.AsyncClient") as mock_client:
             # Mock API responses
             mock_detail_response = MagicMock()
             mock_detail_response.json.return_value = {
                 "name": "react",
                 "category": "web-frameworks",
-                "description": "React framework"
+                "description": "React framework",
             }
 
             mock_download_response = MagicMock()
-            mock_download_response.json.return_value = {
-                "name": "react",
-                "base_url": "https://react.dev/"
-            }
+            mock_download_response.json.return_value = {"name": "react", "base_url": "https://react.dev/"}
 
             mock_client_instance = mock_client.return_value.__aenter__.return_value
             mock_client_instance.get.side_effect = [mock_detail_response, mock_download_response]
 
-            args = {
-                "config_name": "react",
-                "destination": str(temp_dirs["dest"])
-            }
+            args = {"config_name": "react", "destination": str(temp_dirs["dest"])}
             result = await fetch_config_tool(args)
 
             assert len(result) == 1
@@ -128,7 +110,7 @@ class TestFetchConfigModes:
             config_file = temp_dirs["dest"] / "react.json"
             assert config_file.exists()
 
-    @patch('skill_seekers.mcp.server.GitConfigRepo')
+    @patch("skill_seekers.mcp.server.GitConfigRepo")
     async def test_fetch_config_git_url_mode(self, mock_git_repo_class, temp_dirs):
         """Test Git URL mode - direct git clone."""
         from skill_seekers.mcp.server import fetch_config_tool
@@ -149,7 +131,7 @@ class TestFetchConfigModes:
         args = {
             "config_name": "react",
             "git_url": "https://github.com/myorg/configs.git",
-            "destination": str(temp_dirs["dest"])
+            "destination": str(temp_dirs["dest"]),
         }
         result = await fetch_config_tool(args)
 
@@ -165,8 +147,8 @@ class TestFetchConfigModes:
         config_file = temp_dirs["dest"] / "react.json"
         assert config_file.exists()
 
-    @patch('skill_seekers.mcp.server.GitConfigRepo')
-    @patch('skill_seekers.mcp.server.SourceManager')
+    @patch("skill_seekers.mcp.server.GitConfigRepo")
+    @patch("skill_seekers.mcp.server.SourceManager")
     async def test_fetch_config_source_mode(self, mock_source_manager_class, mock_git_repo_class, temp_dirs):
         """Test Source mode - using named source from registry."""
         from skill_seekers.mcp.server import fetch_config_tool
@@ -177,7 +159,7 @@ class TestFetchConfigModes:
             "name": "team",
             "git_url": "https://github.com/myorg/configs.git",
             "branch": "main",
-            "token_env": "GITHUB_TOKEN"
+            "token_env": "GITHUB_TOKEN",
         }
         mock_source_manager_class.return_value = mock_source_manager
 
@@ -193,11 +175,7 @@ class TestFetchConfigModes:
         mock_repo_instance.get_config.return_value = react_config
         mock_git_repo_class.return_value = mock_repo_instance
 
-        args = {
-            "config_name": "react",
-            "source": "team",
-            "destination": str(temp_dirs["dest"])
-        }
+        args = {"config_name": "react", "source": "team", "destination": str(temp_dirs["dest"])}
         result = await fetch_config_tool(args)
 
         assert len(result) == 1
@@ -216,22 +194,19 @@ class TestFetchConfigModes:
         """Test error when source doesn't exist."""
         from skill_seekers.mcp.server import fetch_config_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.get_source.side_effect = KeyError("Source 'nonexistent' not found")
             mock_sm_class.return_value = mock_sm
 
-            args = {
-                "config_name": "react",
-                "source": "nonexistent"
-            }
+            args = {"config_name": "react", "source": "nonexistent"}
             result = await fetch_config_tool(args)
 
             assert len(result) == 1
             assert "❌" in result[0].text
             assert "not found" in result[0].text
 
-    @patch('skill_seekers.mcp.server.GitConfigRepo')
+    @patch("skill_seekers.mcp.server.GitConfigRepo")
     async def test_fetch_config_config_not_found_in_repo(self, mock_git_repo_class, temp_dirs):
         """Test error when config doesn't exist in repository."""
         from skill_seekers.mcp.server import fetch_config_tool
@@ -247,10 +222,7 @@ class TestFetchConfigModes:
         )
         mock_git_repo_class.return_value = mock_repo_instance
 
-        args = {
-            "config_name": "django",
-            "git_url": "https://github.com/myorg/configs.git"
-        }
+        args = {"config_name": "django", "git_url": "https://github.com/myorg/configs.git"}
         result = await fetch_config_tool(args)
 
         assert len(result) == 1
@@ -258,7 +230,7 @@ class TestFetchConfigModes:
         assert "not found" in result[0].text
         assert "Available configs" in result[0].text
 
-    @patch('skill_seekers.mcp.server.GitConfigRepo')
+    @patch("skill_seekers.mcp.server.GitConfigRepo")
     async def test_fetch_config_invalid_git_url(self, mock_git_repo_class):
         """Test error handling for invalid git URL."""
         from skill_seekers.mcp.server import fetch_config_tool
@@ -268,10 +240,7 @@ class TestFetchConfigModes:
         mock_repo_instance.clone_or_pull.side_effect = ValueError("Invalid git URL: not-a-url")
         mock_git_repo_class.return_value = mock_repo_instance
 
-        args = {
-            "config_name": "react",
-            "git_url": "not-a-url"
-        }
+        args = {"config_name": "react", "git_url": "not-a-url"}
         result = await fetch_config_tool(args)
 
         assert len(result) == 1
@@ -288,7 +257,7 @@ class TestSourceManagementTools:
         """Test adding a new config source."""
         from skill_seekers.mcp.server import add_config_source_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.add_source.return_value = {
                 "name": "team",
@@ -298,14 +267,11 @@ class TestSourceManagementTools:
                 "token_env": "GITHUB_TOKEN",
                 "priority": 100,
                 "enabled": True,
-                "added_at": "2025-12-21T10:00:00+00:00"
+                "added_at": "2025-12-21T10:00:00+00:00",
             }
             mock_sm_class.return_value = mock_sm
 
-            args = {
-                "name": "team",
-                "git_url": "https://github.com/myorg/configs.git"
-            }
+            args = {"name": "team", "git_url": "https://github.com/myorg/configs.git"}
             result = await add_config_source_tool(args)
 
             assert len(result) == 1
@@ -344,17 +310,14 @@ class TestSourceManagementTools:
         """Test error when source name is invalid."""
         from skill_seekers.mcp.server import add_config_source_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.add_source.side_effect = ValueError(
                 "Invalid source name 'team@company'. Must be alphanumeric with optional hyphens/underscores."
             )
             mock_sm_class.return_value = mock_sm
 
-            args = {
-                "name": "team@company",
-                "git_url": "https://github.com/myorg/configs.git"
-            }
+            args = {"name": "team@company", "git_url": "https://github.com/myorg/configs.git"}
             result = await add_config_source_tool(args)
 
             assert len(result) == 1
@@ -365,7 +328,7 @@ class TestSourceManagementTools:
         """Test listing config sources."""
         from skill_seekers.mcp.server import list_config_sources_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.list_sources.return_value = [
                 {
@@ -376,7 +339,7 @@ class TestSourceManagementTools:
                     "token_env": "GITHUB_TOKEN",
                     "priority": 1,
                     "enabled": True,
-                    "added_at": "2025-12-21T10:00:00+00:00"
+                    "added_at": "2025-12-21T10:00:00+00:00",
                 },
                 {
                     "name": "company",
@@ -386,8 +349,8 @@ class TestSourceManagementTools:
                     "token_env": "GITLAB_TOKEN",
                     "priority": 2,
                     "enabled": True,
-                    "added_at": "2025-12-21T11:00:00+00:00"
-                }
+                    "added_at": "2025-12-21T11:00:00+00:00",
+                },
             ]
             mock_sm_class.return_value = mock_sm
 
@@ -404,7 +367,7 @@ class TestSourceManagementTools:
         """Test listing when no sources registered."""
         from skill_seekers.mcp.server import list_config_sources_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.list_sources.return_value = []
             mock_sm_class.return_value = mock_sm
@@ -419,7 +382,7 @@ class TestSourceManagementTools:
         """Test listing only enabled sources."""
         from skill_seekers.mcp.server import list_config_sources_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.list_sources.return_value = [
                 {
@@ -430,7 +393,7 @@ class TestSourceManagementTools:
                     "token_env": "GITHUB_TOKEN",
                     "priority": 1,
                     "enabled": True,
-                    "added_at": "2025-12-21T10:00:00+00:00"
+                    "added_at": "2025-12-21T10:00:00+00:00",
                 }
             ]
             mock_sm_class.return_value = mock_sm
@@ -448,7 +411,7 @@ class TestSourceManagementTools:
         """Test removing a config source."""
         from skill_seekers.mcp.server import remove_config_source_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.remove_source.return_value = True
             mock_sm_class.return_value = mock_sm
@@ -468,12 +431,12 @@ class TestSourceManagementTools:
         """Test removing non-existent source."""
         from skill_seekers.mcp.server import remove_config_source_tool
 
-        with patch('skill_seekers.mcp.server.SourceManager') as mock_sm_class:
+        with patch("skill_seekers.mcp.server.SourceManager") as mock_sm_class:
             mock_sm = MagicMock()
             mock_sm.remove_source.return_value = False
             mock_sm.list_sources.return_value = [
                 {"name": "team", "git_url": "https://example.com/1.git"},
-                {"name": "company", "git_url": "https://example.com/2.git"}
+                {"name": "company", "git_url": "https://example.com/2.git"},
             ]
             mock_sm_class.return_value = mock_sm
 
@@ -503,15 +466,15 @@ class TestSourceManagementTools:
 class TestCompleteWorkflow:
     """Test complete workflow of add → fetch → remove."""
 
-    @patch('skill_seekers.mcp.server.GitConfigRepo')
-    @patch('skill_seekers.mcp.server.SourceManager')
+    @patch("skill_seekers.mcp.server.GitConfigRepo")
+    @patch("skill_seekers.mcp.server.SourceManager")
     async def test_add_fetch_remove_workflow(self, mock_sm_class, mock_git_repo_class, temp_dirs):
         """Test complete workflow: add source → fetch config → remove source."""
         from skill_seekers.mcp.server import (
             add_config_source_tool,
             fetch_config_tool,
             list_config_sources_tool,
-            remove_config_source_tool
+            remove_config_source_tool,
         )
 
         # Step 1: Add source
@@ -524,14 +487,11 @@ class TestCompleteWorkflow:
             "token_env": "GITHUB_TOKEN",
             "priority": 100,
             "enabled": True,
-            "added_at": "2025-12-21T10:00:00+00:00"
+            "added_at": "2025-12-21T10:00:00+00:00",
         }
         mock_sm_class.return_value = mock_sm
 
-        add_result = await add_config_source_tool({
-            "name": "team",
-            "git_url": "https://github.com/myorg/configs.git"
-        })
+        add_result = await add_config_source_tool({"name": "team", "git_url": "https://github.com/myorg/configs.git"})
         assert "✅" in add_result[0].text
 
         # Step 2: Fetch config from source
@@ -539,7 +499,7 @@ class TestCompleteWorkflow:
             "name": "team",
             "git_url": "https://github.com/myorg/configs.git",
             "branch": "main",
-            "token_env": "GITHUB_TOKEN"
+            "token_env": "GITHUB_TOKEN",
         }
 
         mock_repo = MagicMock()
@@ -553,27 +513,27 @@ class TestCompleteWorkflow:
         mock_repo.get_config.return_value = react_config
         mock_git_repo_class.return_value = mock_repo
 
-        fetch_result = await fetch_config_tool({
-            "config_name": "react",
-            "source": "team",
-            "destination": str(temp_dirs["dest"])
-        })
+        fetch_result = await fetch_config_tool(
+            {"config_name": "react", "source": "team", "destination": str(temp_dirs["dest"])}
+        )
         assert "✅" in fetch_result[0].text
 
         # Verify config file created
         assert (temp_dirs["dest"] / "react.json").exists()
 
         # Step 3: List sources
-        mock_sm.list_sources.return_value = [{
-            "name": "team",
-            "git_url": "https://github.com/myorg/configs.git",
-            "type": "github",
-            "branch": "main",
-            "token_env": "GITHUB_TOKEN",
-            "priority": 100,
-            "enabled": True,
-            "added_at": "2025-12-21T10:00:00+00:00"
-        }]
+        mock_sm.list_sources.return_value = [
+            {
+                "name": "team",
+                "git_url": "https://github.com/myorg/configs.git",
+                "type": "github",
+                "branch": "main",
+                "token_env": "GITHUB_TOKEN",
+                "priority": 100,
+                "enabled": True,
+                "added_at": "2025-12-21T10:00:00+00:00",
+            }
+        ]
 
         list_result = await list_config_sources_tool({})
         assert "team" in list_result[0].text
diff --git a/tests/test_mcp_server.py b/tests/test_mcp_server.py
index 0288af2..b4d640c 100644
--- a/tests/test_mcp_server.py
+++ b/tests/test_mcp_server.py
@@ -4,15 +4,14 @@ Comprehensive test suite for Skill Seeker MCP Server
 Tests all MCP tools and server functionality
 """
 
-import sys
-import os
-import unittest
 import json
-import tempfile
+import os
 import shutil
-import asyncio
+import sys
+import tempfile
+import unittest
 from pathlib import Path
-from unittest.mock import Mock, patch, AsyncMock, MagicMock
+from unittest.mock import MagicMock, patch
 
 # CRITICAL: Import MCP package BEFORE adding project to path
 # to avoid shadowing the installed mcp package with our local mcp/ directory
@@ -21,9 +20,10 @@ from unittest.mock import Mock, patch, AsyncMock, MagicMock
 # This avoids our local mcp/ directory being in the import path
 _original_dir = os.getcwd()
 try:
-    os.chdir('/tmp')  # Change away from project directory
+    os.chdir("/tmp")  # Change away from project directory
     from mcp.server import Server
-    from mcp.types import Tool, TextContent
+    from mcp.types import TextContent, Tool
+
     MCP_AVAILABLE = True
 except ImportError:
     MCP_AVAILABLE = False
@@ -51,11 +51,13 @@ class TestMCPServerInitialization(unittest.TestCase):
     def test_server_import(self):
         """Test that server module can be imported"""
         from mcp import server as mcp_server_module
+
         self.assertIsNotNone(mcp_server_module)
 
     def test_server_initialization(self):
         """Test server initializes correctly"""
         import mcp.server
+
         app = mcp.server.Server("test-skill-seeker")
         self.assertEqual(app.name, "test-skill-seeker")
 
@@ -79,7 +81,7 @@ class TestListTools(unittest.IsolatedAsyncioTestCase):
             "scrape_docs",
             "package_skill",
             "list_configs",
-            "validate_config"
+            "validate_config",
         ]
 
         for expected in expected_tools:
@@ -117,11 +119,7 @@ class TestGenerateConfigTool(unittest.IsolatedAsyncioTestCase):
 
     async def test_generate_config_basic(self):
         """Test basic config generation"""
-        args = {
-            "name": "test-framework",
-            "url": "https://test-framework.dev/",
-            "description": "Test framework skill"
-        }
+        args = {"name": "test-framework", "url": "https://test-framework.dev/", "description": "Test framework skill"}
 
         result = await skill_seeker_server.generate_config_tool(args)
 
@@ -148,7 +146,7 @@ class TestGenerateConfigTool(unittest.IsolatedAsyncioTestCase):
             "url": "https://custom.dev/",
             "description": "Custom skill",
             "max_pages": 200,
-            "rate_limit": 1.0
+            "rate_limit": 1.0,
         }
 
         result = await skill_seeker_server.generate_config_tool(args)
@@ -162,11 +160,7 @@ class TestGenerateConfigTool(unittest.IsolatedAsyncioTestCase):
 
     async def test_generate_config_defaults(self):
         """Test that default values are applied correctly"""
-        args = {
-            "name": "default-test",
-            "url": "https://test.dev/",
-            "description": "Test defaults"
-        }
+        args = {"name": "default-test", "url": "https://test.dev/", "description": "Test defaults"}
 
         result = await skill_seeker_server.generate_config_tool(args)
 
@@ -193,15 +187,11 @@ class TestEstimatePagesTool(unittest.IsolatedAsyncioTestCase):
         config_data = {
             "name": "test",
             "base_url": "https://example.com/",
-            "selectors": {
-                "main_content": "article",
-                "title": "h1",
-                "code_blocks": "pre"
-            },
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
             "rate_limit": 0.5,
-            "max_pages": 50
+            "max_pages": 50,
         }
-        with open(self.config_path, 'w') as f:
+        with open(self.config_path, "w") as f:
             json.dump(config_data, f)
 
     async def asyncTearDown(self):
@@ -209,16 +199,14 @@ class TestEstimatePagesTool(unittest.IsolatedAsyncioTestCase):
         os.chdir(self.original_cwd)
         shutil.rmtree(self.temp_dir, ignore_errors=True)
 
-    @patch('skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming')
+    @patch("skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming")
     async def test_estimate_pages_success(self, mock_streaming):
         """Test successful page estimation"""
         # Mock successful subprocess run with streaming
         # Returns (stdout, stderr, returncode)
         mock_streaming.return_value = ("Estimated 50 pages", "", 0)
 
-        args = {
-            "config_path": str(self.config_path)
-        }
+        args = {"config_path": str(self.config_path)}
 
         result = await skill_seeker_server.estimate_pages_tool(args)
 
@@ -228,16 +216,13 @@ class TestEstimatePagesTool(unittest.IsolatedAsyncioTestCase):
         # Should also have progress message
         self.assertIn("Estimating page count", result[0].text)
 
-    @patch('skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming')
+    @patch("skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming")
     async def test_estimate_pages_with_max_discovery(self, mock_streaming):
         """Test page estimation with custom max_discovery"""
         # Mock successful subprocess run with streaming
         mock_streaming.return_value = ("Estimated 100 pages", "", 0)
 
-        args = {
-            "config_path": str(self.config_path),
-            "max_discovery": 500
-        }
+        args = {"config_path": str(self.config_path), "max_discovery": 500}
 
         result = await skill_seeker_server.estimate_pages_tool(args)
 
@@ -247,15 +232,13 @@ class TestEstimatePagesTool(unittest.IsolatedAsyncioTestCase):
         self.assertIn("--max-discovery", call_args)
         self.assertIn("500", call_args)
 
-    @patch('skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming')
+    @patch("skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming")
     async def test_estimate_pages_error(self, mock_streaming):
         """Test error handling in page estimation"""
         # Mock failed subprocess run with streaming
         mock_streaming.return_value = ("", "Config file not found", 1)
 
-        args = {
-            "config_path": "nonexistent.json"
-        }
+        args = {"config_path": "nonexistent.json"}
 
         result = await skill_seeker_server.estimate_pages_tool(args)
 
@@ -278,13 +261,9 @@ class TestScrapeDocsTool(unittest.IsolatedAsyncioTestCase):
         config_data = {
             "name": "test",
             "base_url": "https://example.com/",
-            "selectors": {
-                "main_content": "article",
-                "title": "h1",
-                "code_blocks": "pre"
-            }
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
         }
-        with open(self.config_path, 'w') as f:
+        with open(self.config_path, "w") as f:
             json.dump(config_data, f)
 
     async def asyncTearDown(self):
@@ -292,31 +271,26 @@ class TestScrapeDocsTool(unittest.IsolatedAsyncioTestCase):
         os.chdir(self.original_cwd)
         shutil.rmtree(self.temp_dir, ignore_errors=True)
 
-    @patch('skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming')
+    @patch("skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming")
     async def test_scrape_docs_basic(self, mock_streaming):
         """Test basic documentation scraping"""
         # Mock successful subprocess run with streaming
         mock_streaming.return_value = ("Scraping completed successfully", "", 0)
 
-        args = {
-            "config_path": str(self.config_path)
-        }
+        args = {"config_path": str(self.config_path)}
 
         result = await skill_seeker_server.scrape_docs_tool(args)
 
         self.assertIsInstance(result, list)
         self.assertIn("success", result[0].text.lower())
 
-    @patch('skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming')
+    @patch("skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming")
     async def test_scrape_docs_with_skip_scrape(self, mock_streaming):
         """Test scraping with skip_scrape flag"""
         # Mock successful subprocess run with streaming
         mock_streaming.return_value = ("Using cached data", "", 0)
 
-        args = {
-            "config_path": str(self.config_path),
-            "skip_scrape": True
-        }
+        args = {"config_path": str(self.config_path), "skip_scrape": True}
 
         result = await skill_seeker_server.scrape_docs_tool(args)
 
@@ -324,32 +298,26 @@ class TestScrapeDocsTool(unittest.IsolatedAsyncioTestCase):
         call_args = mock_streaming.call_args[0][0]
         self.assertIn("--skip-scrape", call_args)
 
-    @patch('skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming')
+    @patch("skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming")
     async def test_scrape_docs_with_dry_run(self, mock_streaming):
         """Test scraping with dry_run flag"""
         # Mock successful subprocess run with streaming
         mock_streaming.return_value = ("Dry run completed", "", 0)
 
-        args = {
-            "config_path": str(self.config_path),
-            "dry_run": True
-        }
+        args = {"config_path": str(self.config_path), "dry_run": True}
 
         result = await skill_seeker_server.scrape_docs_tool(args)
 
         call_args = mock_streaming.call_args[0][0]
         self.assertIn("--dry-run", call_args)
 
-    @patch('skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming')
+    @patch("skill_seekers.mcp.tools.scraping_tools.run_subprocess_with_streaming")
     async def test_scrape_docs_with_enhance_local(self, mock_streaming):
         """Test scraping with local enhancement"""
         # Mock successful subprocess run with streaming
         mock_streaming.return_value = ("Scraping with enhancement", "", 0)
 
-        args = {
-            "config_path": str(self.config_path),
-            "enhance_local": True
-        }
+        args = {"config_path": str(self.config_path), "enhance_local": True}
 
         result = await skill_seeker_server.scrape_docs_tool(args)
 
@@ -379,7 +347,7 @@ class TestPackageSkillTool(unittest.IsolatedAsyncioTestCase):
         os.chdir(self.original_cwd)
         shutil.rmtree(self.temp_dir, ignore_errors=True)
 
-    @patch('subprocess.run')
+    @patch("subprocess.run")
     async def test_package_skill_success(self, mock_run):
         """Test successful skill packaging"""
         mock_result = MagicMock()
@@ -387,16 +355,14 @@ class TestPackageSkillTool(unittest.IsolatedAsyncioTestCase):
         mock_result.stdout = "Package created: test-skill.zip"
         mock_run.return_value = mock_result
 
-        args = {
-            "skill_dir": str(self.skill_dir)
-        }
+        args = {"skill_dir": str(self.skill_dir)}
 
         result = await skill_seeker_server.package_skill_tool(args)
 
         self.assertIsInstance(result, list)
         self.assertIn("test-skill", result[0].text)
 
-    @patch('subprocess.run')
+    @patch("subprocess.run")
     async def test_package_skill_error(self, mock_run):
         """Test error handling in skill packaging"""
         mock_result = MagicMock()
@@ -404,9 +370,7 @@ class TestPackageSkillTool(unittest.IsolatedAsyncioTestCase):
         mock_result.stderr = "Directory not found"
         mock_run.return_value = mock_result
 
-        args = {
-            "skill_dir": "nonexistent-dir"
-        }
+        args = {"skill_dir": "nonexistent-dir"}
 
         result = await skill_seeker_server.package_skill_tool(args)
 
@@ -427,21 +391,13 @@ class TestListConfigsTool(unittest.IsolatedAsyncioTestCase):
         os.makedirs("configs", exist_ok=True)
 
         configs = [
-            {
-                "name": "test1",
-                "description": "Test 1 skill",
-                "base_url": "https://test1.dev/"
-            },
-            {
-                "name": "test2",
-                "description": "Test 2 skill",
-                "base_url": "https://test2.dev/"
-            }
+            {"name": "test1", "description": "Test 1 skill", "base_url": "https://test1.dev/"},
+            {"name": "test2", "description": "Test 2 skill", "base_url": "https://test2.dev/"},
         ]
 
         for config in configs:
             path = Path(f"configs/{config['name']}.json")
-            with open(path, 'w') as f:
+            with open(path, "w") as f:
                 json.dump(config, f)
 
     async def asyncTearDown(self):
@@ -504,20 +460,14 @@ class TestValidateConfigTool(unittest.IsolatedAsyncioTestCase):
         valid_config = {
             "name": "valid-test",
             "base_url": "https://example.com/",
-            "selectors": {
-                "main_content": "article",
-                "title": "h1",
-                "code_blocks": "pre"
-            },
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
             "rate_limit": 0.5,
-            "max_pages": 100
+            "max_pages": 100,
         }
-        with open(config_path, 'w') as f:
+        with open(config_path, "w") as f:
             json.dump(valid_config, f)
 
-        args = {
-            "config_path": str(config_path)
-        }
+        args = {"config_path": str(config_path)}
 
         result = await skill_seeker_server.validate_config_tool(args)
 
@@ -533,14 +483,12 @@ class TestValidateConfigTool(unittest.IsolatedAsyncioTestCase):
             "description": "Missing name field",
             "sources": [
                 {"type": "invalid_type", "url": "https://example.com"}  # Invalid source type
-            ]
+            ],
         }
-        with open(config_path, 'w') as f:
+        with open(config_path, "w") as f:
             json.dump(invalid_config, f)
 
-        args = {
-            "config_path": str(config_path)
-        }
+        args = {"config_path": str(config_path)}
 
         result = await skill_seeker_server.validate_config_tool(args)
 
@@ -549,9 +497,7 @@ class TestValidateConfigTool(unittest.IsolatedAsyncioTestCase):
 
     async def test_validate_nonexistent_config(self):
         """Test validating a nonexistent config"""
-        args = {
-            "config_path": "configs/nonexistent.json"
-        }
+        args = {"config_path": "configs/nonexistent.json"}
 
         result = await skill_seeker_server.validate_config_tool(args)
 
@@ -593,15 +539,13 @@ class TestMCPServerIntegration(unittest.IsolatedAsyncioTestCase):
             generate_args = {
                 "name": "workflow-test",
                 "url": "https://workflow-test.dev/",
-                "description": "Workflow test skill"
+                "description": "Workflow test skill",
             }
             result1 = await skill_seeker_server.generate_config_tool(generate_args)
             self.assertIn("✅", result1[0].text)
 
             # Step 2: Validate config
-            validate_args = {
-                "config_path": "configs/workflow-test.json"
-            }
+            validate_args = {"config_path": "configs/workflow-test.json"}
             result2 = await skill_seeker_server.validate_config_tool(validate_args)
             self.assertIn("✅", result2[0].text)
 
@@ -620,9 +564,7 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
 
     async def test_submit_config_requires_token(self):
         """Should error without GitHub token"""
-        args = {
-            "config_json": '{"name": "test", "description": "Test", "base_url": "https://example.com"}'
-        }
+        args = {"config_json": '{"name": "test", "description": "Test", "base_url": "https://example.com"}'}
         result = await skill_seeker_server.submit_config_tool(args)
         self.assertIn("GitHub token required", result[0].text)
 
@@ -630,7 +572,7 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
         """Should reject config missing required fields"""
         args = {
             "config_json": '{"name": "test"}',  # Missing description, base_url
-            "github_token": "fake_token"
+            "github_token": "fake_token",
         }
         result = await skill_seeker_server.submit_config_tool(args)
         self.assertIn("validation failed", result[0].text.lower())
@@ -641,7 +583,7 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
         """Should reject invalid name characters"""
         args = {
             "config_json": '{"name": "React@2024!", "description": "Test", "base_url": "https://example.com"}',
-            "github_token": "fake_token"
+            "github_token": "fake_token",
         }
         result = await skill_seeker_server.submit_config_tool(args)
         self.assertIn("validation failed", result[0].text.lower())
@@ -650,7 +592,7 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
         """Should reject invalid URL format"""
         args = {
             "config_json": '{"name": "test", "description": "Test", "base_url": "not-a-url"}',
-            "github_token": "fake_token"
+            "github_token": "fake_token",
         }
         result = await skill_seeker_server.submit_config_tool(args)
         self.assertIn("validation failed", result[0].text.lower())
@@ -661,20 +603,13 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
             "name": "testframework",
             "description": "Test framework docs",
             "base_url": "https://docs.test.com/",
-            "selectors": {
-                "main_content": "article",
-                "title": "h1",
-                "code_blocks": "pre code"
-            },
-            "max_pages": 100
-        }
-        args = {
-            "config_json": json.dumps(valid_config),
-            "github_token": "fake_token"
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "max_pages": 100,
         }
+        args = {"config_json": json.dumps(valid_config), "github_token": "fake_token"}
 
         # Mock GitHub API call
-        with patch('github.Github') as mock_gh:
+        with patch("github.Github") as mock_gh:
             mock_repo = MagicMock()
             mock_issue = MagicMock()
             mock_issue.html_url = "https://github.com/test/issue/1"
@@ -693,23 +628,13 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
             "description": "Test unified config",
             "merge_mode": "rule-based",
             "sources": [
-                {
-                    "type": "documentation",
-                    "base_url": "https://docs.test.com/",
-                    "max_pages": 100
-                },
-                {
-                    "type": "github",
-                    "repo": "testorg/testrepo"
-                }
-            ]
-        }
-        args = {
-            "config_json": json.dumps(unified_config),
-            "github_token": "fake_token"
+                {"type": "documentation", "base_url": "https://docs.test.com/", "max_pages": 100},
+                {"type": "github", "repo": "testorg/testrepo"},
+            ],
         }
+        args = {"config_json": json.dumps(unified_config), "github_token": "fake_token"}
 
-        with patch('github.Github') as mock_gh:
+        with patch("github.Github") as mock_gh:
             mock_repo = MagicMock()
             mock_issue = MagicMock()
             mock_issue.html_url = "https://github.com/test/issue/2"
@@ -723,21 +648,14 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
 
     async def test_submit_config_from_file_path(self):
         """Should accept config_path parameter"""
-        with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
-            json.dump({
-                "name": "testfile",
-                "description": "From file",
-                "base_url": "https://test.com/"
-            }, f)
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+            json.dump({"name": "testfile", "description": "From file", "base_url": "https://test.com/"}, f)
             temp_path = f.name
 
         try:
-            args = {
-                "config_path": temp_path,
-                "github_token": "fake_token"
-            }
+            args = {"config_path": temp_path, "github_token": "fake_token"}
 
-            with patch('github.Github') as mock_gh:
+            with patch("github.Github") as mock_gh:
                 mock_repo = MagicMock()
                 mock_issue = MagicMock()
                 mock_issue.html_url = "https://github.com/test/issue/3"
@@ -754,10 +672,10 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
         """Should auto-detect category from config name"""
         args = {
             "config_json": '{"name": "react-test", "description": "React", "base_url": "https://react.dev/"}',
-            "github_token": "fake_token"
+            "github_token": "fake_token",
         }
 
-        with patch('github.Github') as mock_gh:
+        with patch("github.Github") as mock_gh:
             mock_repo = MagicMock()
             mock_issue = MagicMock()
             mock_issue.html_url = "https://github.com/test/issue/4"
@@ -770,5 +688,5 @@ class TestSubmitConfigTool(unittest.IsolatedAsyncioTestCase):
             self.assertTrue("web-frameworks" in result[0].text or "Category" in result[0].text)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_merge_sources_github.py b/tests/test_merge_sources_github.py
index caf56aa..91c8ba6 100644
--- a/tests/test_merge_sources_github.py
+++ b/tests/test_merge_sources_github.py
@@ -8,22 +8,14 @@ Tests the multi-layer merging architecture:
 - Layer 4: GitHub insights (issues)
 """
 
-import pytest
-from pathlib import Path
-from unittest.mock import Mock
+from skill_seekers.cli.conflict_detector import Conflict
+from skill_seekers.cli.github_fetcher import CodeStream, DocsStream, InsightsStream, ThreeStreamData
 from skill_seekers.cli.merge_sources import (
+    RuleBasedMerger,
+    _match_issues_to_apis,
     categorize_issues_by_topic,
     generate_hybrid_content,
-    RuleBasedMerger,
-    _match_issues_to_apis
 )
-from skill_seekers.cli.github_fetcher import (
-    CodeStream,
-    DocsStream,
-    InsightsStream,
-    ThreeStreamData
-)
-from skill_seekers.cli.conflict_detector import Conflict
 
 
 class TestIssueCategorization:
@@ -32,68 +24,66 @@ class TestIssueCategorization:
     def test_categorize_issues_basic(self):
         """Test basic issue categorization."""
         problems = [
-            {'title': 'OAuth setup fails', 'labels': ['bug', 'oauth'], 'number': 1, 'state': 'open', 'comments': 10},
-            {'title': 'Testing framework issue', 'labels': ['testing'], 'number': 2, 'state': 'open', 'comments': 5}
+            {"title": "OAuth setup fails", "labels": ["bug", "oauth"], "number": 1, "state": "open", "comments": 10},
+            {"title": "Testing framework issue", "labels": ["testing"], "number": 2, "state": "open", "comments": 5},
         ]
         solutions = [
-            {'title': 'Fixed OAuth redirect', 'labels': ['oauth'], 'number': 3, 'state': 'closed', 'comments': 3}
+            {"title": "Fixed OAuth redirect", "labels": ["oauth"], "number": 3, "state": "closed", "comments": 3}
         ]
 
-        topics = ['oauth', 'testing', 'async']
+        topics = ["oauth", "testing", "async"]
 
         categorized = categorize_issues_by_topic(problems, solutions, topics)
 
-        assert 'oauth' in categorized
-        assert len(categorized['oauth']) == 2  # 1 problem + 1 solution
-        assert 'testing' in categorized
-        assert len(categorized['testing']) == 1
+        assert "oauth" in categorized
+        assert len(categorized["oauth"]) == 2  # 1 problem + 1 solution
+        assert "testing" in categorized
+        assert len(categorized["testing"]) == 1
 
     def test_categorize_issues_keyword_matching(self):
         """Test keyword matching in titles and labels."""
         problems = [
-            {'title': 'Database connection timeout', 'labels': ['db'], 'number': 1, 'state': 'open', 'comments': 7}
+            {"title": "Database connection timeout", "labels": ["db"], "number": 1, "state": "open", "comments": 7}
         ]
         solutions = []
 
-        topics = ['database']
+        topics = ["database"]
 
         categorized = categorize_issues_by_topic(problems, solutions, topics)
 
         # Should match 'database' topic due to 'db' in labels
-        assert 'database' in categorized or 'other' in categorized
+        assert "database" in categorized or "other" in categorized
 
     def test_categorize_issues_multi_keyword_topic(self):
         """Test topics with multiple keywords."""
         problems = [
-            {'title': 'Async API call fails', 'labels': ['async', 'api'], 'number': 1, 'state': 'open', 'comments': 8}
+            {"title": "Async API call fails", "labels": ["async", "api"], "number": 1, "state": "open", "comments": 8}
         ]
         solutions = []
 
-        topics = ['async api']
+        topics = ["async api"]
 
         categorized = categorize_issues_by_topic(problems, solutions, topics)
 
         # Should match due to both 'async' and 'api' in labels
-        assert 'async api' in categorized
-        assert len(categorized['async api']) == 1
+        assert "async api" in categorized
+        assert len(categorized["async api"]) == 1
 
     def test_categorize_issues_no_match_goes_to_other(self):
         """Test that unmatched issues go to 'other' category."""
-        problems = [
-            {'title': 'Random issue', 'labels': ['misc'], 'number': 1, 'state': 'open', 'comments': 5}
-        ]
+        problems = [{"title": "Random issue", "labels": ["misc"], "number": 1, "state": "open", "comments": 5}]
         solutions = []
 
-        topics = ['oauth', 'testing']
+        topics = ["oauth", "testing"]
 
         categorized = categorize_issues_by_topic(problems, solutions, topics)
 
-        assert 'other' in categorized
-        assert len(categorized['other']) == 1
+        assert "other" in categorized
+        assert len(categorized["other"]) == 1
 
     def test_categorize_issues_empty_lists(self):
         """Test categorization with empty input."""
-        categorized = categorize_issues_by_topic([], [], ['oauth'])
+        categorized = categorize_issues_by_topic([], [], ["oauth"])
 
         # Should return empty dict (no categories with issues)
         assert len(categorized) == 0
@@ -104,36 +94,23 @@ class TestHybridContent:
 
     def test_generate_hybrid_content_basic(self):
         """Test basic hybrid content generation."""
-        api_data = {
-            'apis': {
-                'oauth_login': {'name': 'oauth_login', 'status': 'matched'}
-            },
-            'summary': {'total_apis': 1}
-        }
+        api_data = {"apis": {"oauth_login": {"name": "oauth_login", "status": "matched"}}, "summary": {"total_apis": 1}}
 
         github_docs = {
-            'readme': '# Project README',
-            'contributing': None,
-            'docs_files': [{'path': 'docs/oauth.md', 'content': 'OAuth guide'}]
+            "readme": "# Project README",
+            "contributing": None,
+            "docs_files": [{"path": "docs/oauth.md", "content": "OAuth guide"}],
         }
 
         github_insights = {
-            'metadata': {
-                'stars': 1234,
-                'forks': 56,
-                'language': 'Python',
-                'description': 'Test project'
-            },
-            'common_problems': [
-                {'title': 'OAuth fails', 'number': 42, 'state': 'open', 'comments': 10, 'labels': ['bug']}
+            "metadata": {"stars": 1234, "forks": 56, "language": "Python", "description": "Test project"},
+            "common_problems": [
+                {"title": "OAuth fails", "number": 42, "state": "open", "comments": 10, "labels": ["bug"]}
             ],
-            'known_solutions': [
-                {'title': 'Fixed OAuth', 'number': 35, 'state': 'closed', 'comments': 5, 'labels': ['bug']}
+            "known_solutions": [
+                {"title": "Fixed OAuth", "number": 35, "state": "closed", "comments": 5, "labels": ["bug"]}
             ],
-            'top_labels': [
-                {'label': 'bug', 'count': 10},
-                {'label': 'enhancement', 'count': 5}
-            ]
+            "top_labels": [{"label": "bug", "count": 10}, {"label": "enhancement", "count": 5}],
         }
 
         conflicts = []
@@ -141,68 +118,68 @@ class TestHybridContent:
         hybrid = generate_hybrid_content(api_data, github_docs, github_insights, conflicts)
 
         # Check structure
-        assert 'api_reference' in hybrid
-        assert 'github_context' in hybrid
-        assert 'conflict_summary' in hybrid
-        assert 'issue_links' in hybrid
+        assert "api_reference" in hybrid
+        assert "github_context" in hybrid
+        assert "conflict_summary" in hybrid
+        assert "issue_links" in hybrid
 
         # Check GitHub docs layer
-        assert hybrid['github_context']['docs']['readme'] == '# Project README'
-        assert hybrid['github_context']['docs']['docs_files_count'] == 1
+        assert hybrid["github_context"]["docs"]["readme"] == "# Project README"
+        assert hybrid["github_context"]["docs"]["docs_files_count"] == 1
 
         # Check GitHub insights layer
-        assert hybrid['github_context']['metadata']['stars'] == 1234
-        assert hybrid['github_context']['metadata']['language'] == 'Python'
-        assert hybrid['github_context']['issues']['common_problems_count'] == 1
-        assert hybrid['github_context']['issues']['known_solutions_count'] == 1
-        assert len(hybrid['github_context']['issues']['top_problems']) == 1
-        assert len(hybrid['github_context']['top_labels']) == 2
+        assert hybrid["github_context"]["metadata"]["stars"] == 1234
+        assert hybrid["github_context"]["metadata"]["language"] == "Python"
+        assert hybrid["github_context"]["issues"]["common_problems_count"] == 1
+        assert hybrid["github_context"]["issues"]["known_solutions_count"] == 1
+        assert len(hybrid["github_context"]["issues"]["top_problems"]) == 1
+        assert len(hybrid["github_context"]["top_labels"]) == 2
 
     def test_generate_hybrid_content_with_conflicts(self):
         """Test hybrid content with conflicts."""
-        api_data = {'apis': {}, 'summary': {}}
+        api_data = {"apis": {}, "summary": {}}
         github_docs = None
         github_insights = None
 
         conflicts = [
             Conflict(
-                api_name='test_api',
-                type='signature_mismatch',
-                severity='medium',
-                difference='Parameter count differs',
-                docs_info={'parameters': ['a', 'b']},
-                code_info={'parameters': ['a', 'b', 'c']}
+                api_name="test_api",
+                type="signature_mismatch",
+                severity="medium",
+                difference="Parameter count differs",
+                docs_info={"parameters": ["a", "b"]},
+                code_info={"parameters": ["a", "b", "c"]},
             ),
             Conflict(
-                api_name='test_api_2',
-                type='missing_in_docs',
-                severity='low',
-                difference='API not documented',
+                api_name="test_api_2",
+                type="missing_in_docs",
+                severity="low",
+                difference="API not documented",
                 docs_info=None,
-                code_info={'name': 'test_api_2'}
-            )
+                code_info={"name": "test_api_2"},
+            ),
         ]
 
         hybrid = generate_hybrid_content(api_data, github_docs, github_insights, conflicts)
 
         # Check conflict summary
-        assert hybrid['conflict_summary']['total_conflicts'] == 2
-        assert hybrid['conflict_summary']['by_type']['signature_mismatch'] == 1
-        assert hybrid['conflict_summary']['by_type']['missing_in_docs'] == 1
-        assert hybrid['conflict_summary']['by_severity']['medium'] == 1
-        assert hybrid['conflict_summary']['by_severity']['low'] == 1
+        assert hybrid["conflict_summary"]["total_conflicts"] == 2
+        assert hybrid["conflict_summary"]["by_type"]["signature_mismatch"] == 1
+        assert hybrid["conflict_summary"]["by_type"]["missing_in_docs"] == 1
+        assert hybrid["conflict_summary"]["by_severity"]["medium"] == 1
+        assert hybrid["conflict_summary"]["by_severity"]["low"] == 1
 
     def test_generate_hybrid_content_no_github_data(self):
         """Test hybrid content with no GitHub data."""
-        api_data = {'apis': {}, 'summary': {}}
+        api_data = {"apis": {}, "summary": {}}
 
         hybrid = generate_hybrid_content(api_data, None, None, [])
 
         # Should still have structure, but no GitHub context
-        assert 'api_reference' in hybrid
-        assert 'github_context' in hybrid
-        assert hybrid['github_context'] == {}
-        assert hybrid['conflict_summary']['total_conflicts'] == 0
+        assert "api_reference" in hybrid
+        assert "github_context" in hybrid
+        assert hybrid["github_context"] == {}
+        assert hybrid["conflict_summary"]["total_conflicts"] == 0
 
 
 class TestIssueToAPIMatching:
@@ -210,39 +187,34 @@ class TestIssueToAPIMatching:
 
     def test_match_issues_to_apis_basic(self):
         """Test basic issue to API matching."""
-        apis = {
-            'oauth_login': {'name': 'oauth_login'},
-            'async_fetch': {'name': 'async_fetch'}
-        }
+        apis = {"oauth_login": {"name": "oauth_login"}, "async_fetch": {"name": "async_fetch"}}
 
         problems = [
-            {'title': 'OAuth login fails', 'number': 42, 'state': 'open', 'comments': 10, 'labels': ['bug', 'oauth']}
+            {"title": "OAuth login fails", "number": 42, "state": "open", "comments": 10, "labels": ["bug", "oauth"]}
         ]
 
         solutions = [
-            {'title': 'Fixed async fetch timeout', 'number': 35, 'state': 'closed', 'comments': 5, 'labels': ['async']}
+            {"title": "Fixed async fetch timeout", "number": 35, "state": "closed", "comments": 5, "labels": ["async"]}
         ]
 
         issue_links = _match_issues_to_apis(apis, problems, solutions)
 
         # Should match oauth issue to oauth_login API
-        assert 'oauth_login' in issue_links
-        assert len(issue_links['oauth_login']) == 1
-        assert issue_links['oauth_login'][0]['number'] == 42
+        assert "oauth_login" in issue_links
+        assert len(issue_links["oauth_login"]) == 1
+        assert issue_links["oauth_login"][0]["number"] == 42
 
         # Should match async issue to async_fetch API
-        assert 'async_fetch' in issue_links
-        assert len(issue_links['async_fetch']) == 1
-        assert issue_links['async_fetch'][0]['number'] == 35
+        assert "async_fetch" in issue_links
+        assert len(issue_links["async_fetch"]) == 1
+        assert issue_links["async_fetch"][0]["number"] == 35
 
     def test_match_issues_to_apis_no_matches(self):
         """Test when no issues match any APIs."""
-        apis = {
-            'database_connect': {'name': 'database_connect'}
-        }
+        apis = {"database_connect": {"name": "database_connect"}}
 
         problems = [
-            {'title': 'Random unrelated issue', 'number': 1, 'state': 'open', 'comments': 5, 'labels': ['misc']}
+            {"title": "Random unrelated issue", "number": 1, "state": "open", "comments": 5, "labels": ["misc"]}
         ]
 
         issue_links = _match_issues_to_apis(apis, problems, [])
@@ -252,19 +224,15 @@ class TestIssueToAPIMatching:
 
     def test_match_issues_to_apis_dotted_names(self):
         """Test matching with dotted API names."""
-        apis = {
-            'module.oauth.login': {'name': 'module.oauth.login'}
-        }
+        apis = {"module.oauth.login": {"name": "module.oauth.login"}}
 
-        problems = [
-            {'title': 'OAuth module fails', 'number': 42, 'state': 'open', 'comments': 10, 'labels': ['oauth']}
-        ]
+        problems = [{"title": "OAuth module fails", "number": 42, "state": "open", "comments": 10, "labels": ["oauth"]}]
 
         issue_links = _match_issues_to_apis(apis, problems, [])
 
         # Should match due to 'oauth' keyword
-        assert 'module.oauth.login' in issue_links
-        assert len(issue_links['module.oauth.login']) == 1
+        assert "module.oauth.login" in issue_links
+        assert len(issue_links["module.oauth.login"]) == 1
 
 
 class TestRuleBasedMergerWithGitHubStreams:
@@ -272,26 +240,22 @@ class TestRuleBasedMergerWithGitHubStreams:
 
     def test_merger_with_github_streams(self, tmp_path):
         """Test merger with three-stream GitHub data."""
-        docs_data = {'pages': []}
-        github_data = {'apis': {}}
+        docs_data = {"pages": []}
+        github_data = {"apis": {}}
         conflicts = []
 
         # Create three-stream data
         code_stream = CodeStream(directory=tmp_path, files=[])
         docs_stream = DocsStream(
-            readme='# README',
-            contributing='# Contributing',
-            docs_files=[{'path': 'docs/guide.md', 'content': 'Guide content'}]
+            readme="# README",
+            contributing="# Contributing",
+            docs_files=[{"path": "docs/guide.md", "content": "Guide content"}],
         )
         insights_stream = InsightsStream(
-            metadata={'stars': 1234, 'forks': 56, 'language': 'Python'},
-            common_problems=[
-                {'title': 'Bug 1', 'number': 1, 'state': 'open', 'comments': 10, 'labels': ['bug']}
-            ],
-            known_solutions=[
-                {'title': 'Fix 1', 'number': 2, 'state': 'closed', 'comments': 5, 'labels': ['bug']}
-            ],
-            top_labels=[{'label': 'bug', 'count': 10}]
+            metadata={"stars": 1234, "forks": 56, "language": "Python"},
+            common_problems=[{"title": "Bug 1", "number": 1, "state": "open", "comments": 10, "labels": ["bug"]}],
+            known_solutions=[{"title": "Fix 1", "number": 2, "state": "closed", "comments": 5, "labels": ["bug"]}],
+            top_labels=[{"label": "bug", "count": 10}],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
@@ -301,24 +265,19 @@ class TestRuleBasedMergerWithGitHubStreams:
         assert merger.github_streams is not None
         assert merger.github_docs is not None
         assert merger.github_insights is not None
-        assert merger.github_docs['readme'] == '# README'
-        assert merger.github_insights['metadata']['stars'] == 1234
+        assert merger.github_docs["readme"] == "# README"
+        assert merger.github_insights["metadata"]["stars"] == 1234
 
     def test_merger_merge_all_with_streams(self, tmp_path):
         """Test merge_all() with GitHub streams."""
-        docs_data = {'pages': []}
-        github_data = {'apis': {}}
+        docs_data = {"pages": []}
+        github_data = {"apis": {}}
         conflicts = []
 
         # Create three-stream data
         code_stream = CodeStream(directory=tmp_path, files=[])
-        docs_stream = DocsStream(readme='# README', contributing=None, docs_files=[])
-        insights_stream = InsightsStream(
-            metadata={'stars': 500},
-            common_problems=[],
-            known_solutions=[],
-            top_labels=[]
-        )
+        docs_stream = DocsStream(readme="# README", contributing=None, docs_files=[])
+        insights_stream = InsightsStream(metadata={"stars": 500}, common_problems=[], known_solutions=[], top_labels=[])
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
         # Create and run merger
@@ -326,15 +285,15 @@ class TestRuleBasedMergerWithGitHubStreams:
         result = merger.merge_all()
 
         # Check result has GitHub context
-        assert 'github_context' in result
-        assert 'conflict_summary' in result
-        assert 'issue_links' in result
-        assert result['github_context']['metadata']['stars'] == 500
+        assert "github_context" in result
+        assert "conflict_summary" in result
+        assert "issue_links" in result
+        assert result["github_context"]["metadata"]["stars"] == 500
 
     def test_merger_without_streams_backward_compat(self):
         """Test backward compatibility without GitHub streams."""
-        docs_data = {'pages': []}
-        github_data = {'apis': {}}
+        docs_data = {"pages": []}
+        github_data = {"apis": {}}
         conflicts = []
 
         # Create merger without streams (old API)
@@ -346,10 +305,10 @@ class TestRuleBasedMergerWithGitHubStreams:
 
         # Should still work
         result = merger.merge_all()
-        assert 'apis' in result
-        assert 'summary' in result
+        assert "apis" in result
+        assert "summary" in result
         # Should not have GitHub context
-        assert 'github_context' not in result
+        assert "github_context" not in result
 
 
 class TestIntegration:
@@ -358,39 +317,52 @@ class TestIntegration:
     def test_full_pipeline_with_streams(self, tmp_path):
         """Test complete pipeline with three-stream data."""
         # Create minimal test data
-        docs_data = {'pages': []}
-        github_data = {'apis': {}}
+        docs_data = {"pages": []}
+        github_data = {"apis": {}}
 
         # Create three-stream data
         code_stream = CodeStream(directory=tmp_path, files=[])
         docs_stream = DocsStream(
-            readme='# Test Project\n\nA test project.',
-            contributing='# Contributing\n\nPull requests welcome.',
+            readme="# Test Project\n\nA test project.",
+            contributing="# Contributing\n\nPull requests welcome.",
             docs_files=[
-                {'path': 'docs/quickstart.md', 'content': '# Quick Start'},
-                {'path': 'docs/api.md', 'content': '# API Reference'}
-            ]
+                {"path": "docs/quickstart.md", "content": "# Quick Start"},
+                {"path": "docs/api.md", "content": "# API Reference"},
+            ],
         )
         insights_stream = InsightsStream(
-            metadata={
-                'stars': 2500,
-                'forks': 123,
-                'language': 'Python',
-                'description': 'Test framework'
-            },
+            metadata={"stars": 2500, "forks": 123, "language": "Python", "description": "Test framework"},
             common_problems=[
-                {'title': 'Installation fails on Windows', 'number': 150, 'state': 'open', 'comments': 25, 'labels': ['bug', 'windows']},
-                {'title': 'Memory leak in async mode', 'number': 142, 'state': 'open', 'comments': 18, 'labels': ['bug', 'async']}
+                {
+                    "title": "Installation fails on Windows",
+                    "number": 150,
+                    "state": "open",
+                    "comments": 25,
+                    "labels": ["bug", "windows"],
+                },
+                {
+                    "title": "Memory leak in async mode",
+                    "number": 142,
+                    "state": "open",
+                    "comments": 18,
+                    "labels": ["bug", "async"],
+                },
             ],
             known_solutions=[
-                {'title': 'Fixed config loading', 'number': 130, 'state': 'closed', 'comments': 8, 'labels': ['bug']},
-                {'title': 'Resolved OAuth timeout', 'number': 125, 'state': 'closed', 'comments': 12, 'labels': ['oauth']}
+                {"title": "Fixed config loading", "number": 130, "state": "closed", "comments": 8, "labels": ["bug"]},
+                {
+                    "title": "Resolved OAuth timeout",
+                    "number": 125,
+                    "state": "closed",
+                    "comments": 12,
+                    "labels": ["oauth"],
+                },
             ],
             top_labels=[
-                {'label': 'bug', 'count': 45},
-                {'label': 'enhancement', 'count': 20},
-                {'label': 'question', 'count': 15}
-            ]
+                {"label": "bug", "count": 45},
+                {"label": "enhancement", "count": 20},
+                {"label": "question", "count": 15},
+            ],
         )
         github_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
 
@@ -399,24 +371,24 @@ class TestIntegration:
         result = merger.merge_all()
 
         # Verify all layers present
-        assert 'apis' in result  # Layer 1 & 2: Code + Docs
-        assert 'github_context' in result  # Layer 3 & 4: GitHub docs + insights
+        assert "apis" in result  # Layer 1 & 2: Code + Docs
+        assert "github_context" in result  # Layer 3 & 4: GitHub docs + insights
 
         # Verify Layer 3: GitHub docs
-        gh_context = result['github_context']
-        assert gh_context['docs']['readme'] == '# Test Project\n\nA test project.'
-        assert gh_context['docs']['contributing'] == '# Contributing\n\nPull requests welcome.'
-        assert gh_context['docs']['docs_files_count'] == 2
+        gh_context = result["github_context"]
+        assert gh_context["docs"]["readme"] == "# Test Project\n\nA test project."
+        assert gh_context["docs"]["contributing"] == "# Contributing\n\nPull requests welcome."
+        assert gh_context["docs"]["docs_files_count"] == 2
 
         # Verify Layer 4: GitHub insights
-        assert gh_context['metadata']['stars'] == 2500
-        assert gh_context['metadata']['language'] == 'Python'
-        assert gh_context['issues']['common_problems_count'] == 2
-        assert gh_context['issues']['known_solutions_count'] == 2
-        assert len(gh_context['issues']['top_problems']) == 2
-        assert len(gh_context['issues']['top_solutions']) == 2
-        assert len(gh_context['top_labels']) == 3
+        assert gh_context["metadata"]["stars"] == 2500
+        assert gh_context["metadata"]["language"] == "Python"
+        assert gh_context["issues"]["common_problems_count"] == 2
+        assert gh_context["issues"]["known_solutions_count"] == 2
+        assert len(gh_context["issues"]["top_problems"]) == 2
+        assert len(gh_context["issues"]["top_solutions"]) == 2
+        assert len(gh_context["top_labels"]) == 3
 
         # Verify conflict summary
-        assert 'conflict_summary' in result
-        assert result['conflict_summary']['total_conflicts'] == 0
+        assert "conflict_summary" in result
+        assert result["conflict_summary"]["total_conflicts"] == 0
diff --git a/tests/test_multi_source.py b/tests/test_multi_source.py
index 80644d2..36129d7 100644
--- a/tests/test_multi_source.py
+++ b/tests/test_multi_source.py
@@ -9,10 +9,10 @@ Tests the following functionality:
 5. Multiple GitHub repositories handling
 """
 
-import unittest
-import tempfile
 import os
 import shutil
+import tempfile
+import unittest
 
 
 class TestUnifiedScraperDataStructure(unittest.TestCase):
@@ -23,11 +23,9 @@ class TestUnifiedScraperDataStructure(unittest.TestCase):
         from skill_seekers.cli.unified_scraper import UnifiedScraper
 
         config = {
-            'name': 'test_multi',
-            'description': 'Test skill',
-            'sources': [
-                {'type': 'documentation', 'base_url': 'https://example.com'}
-            ]
+            "name": "test_multi",
+            "description": "Test skill",
+            "sources": [{"type": "documentation", "base_url": "https://example.com"}],
         }
 
         with tempfile.TemporaryDirectory() as temp_dir:
@@ -36,9 +34,9 @@ class TestUnifiedScraperDataStructure(unittest.TestCase):
                 os.chdir(temp_dir)
                 scraper = UnifiedScraper(config)
 
-                self.assertIsInstance(scraper.scraped_data['documentation'], list)
-                self.assertIsInstance(scraper.scraped_data['github'], list)
-                self.assertIsInstance(scraper.scraped_data['pdf'], list)
+                self.assertIsInstance(scraper.scraped_data["documentation"], list)
+                self.assertIsInstance(scraper.scraped_data["github"], list)
+                self.assertIsInstance(scraper.scraped_data["pdf"], list)
             finally:
                 os.chdir(original_dir)
 
@@ -47,11 +45,9 @@ class TestUnifiedScraperDataStructure(unittest.TestCase):
         from skill_seekers.cli.unified_scraper import UnifiedScraper
 
         config = {
-            'name': 'test_counters',
-            'description': 'Test skill',
-            'sources': [
-                {'type': 'documentation', 'base_url': 'https://example.com'}
-            ]
+            "name": "test_counters",
+            "description": "Test skill",
+            "sources": [{"type": "documentation", "base_url": "https://example.com"}],
         }
 
         with tempfile.TemporaryDirectory() as temp_dir:
@@ -60,9 +56,9 @@ class TestUnifiedScraperDataStructure(unittest.TestCase):
                 os.chdir(temp_dir)
                 scraper = UnifiedScraper(config)
 
-                self.assertEqual(scraper._source_counters['documentation'], 0)
-                self.assertEqual(scraper._source_counters['github'], 0)
-                self.assertEqual(scraper._source_counters['pdf'], 0)
+                self.assertEqual(scraper._source_counters["documentation"], 0)
+                self.assertEqual(scraper._source_counters["github"], 0)
+                self.assertEqual(scraper._source_counters["pdf"], 0)
             finally:
                 os.chdir(original_dir)
 
@@ -71,11 +67,9 @@ class TestUnifiedScraperDataStructure(unittest.TestCase):
         from skill_seekers.cli.unified_scraper import UnifiedScraper
 
         config = {
-            'name': 'test_empty',
-            'description': 'Test skill',
-            'sources': [
-                {'type': 'documentation', 'base_url': 'https://example.com'}
-            ]
+            "name": "test_empty",
+            "description": "Test skill",
+            "sources": [{"type": "documentation", "base_url": "https://example.com"}],
         }
 
         with tempfile.TemporaryDirectory() as temp_dir:
@@ -84,9 +78,9 @@ class TestUnifiedScraperDataStructure(unittest.TestCase):
                 os.chdir(temp_dir)
                 scraper = UnifiedScraper(config)
 
-                self.assertEqual(len(scraper.scraped_data['documentation']), 0)
-                self.assertEqual(len(scraper.scraped_data['github']), 0)
-                self.assertEqual(len(scraper.scraped_data['pdf']), 0)
+                self.assertEqual(len(scraper.scraped_data["documentation"]), 0)
+                self.assertEqual(len(scraper.scraped_data["github"]), 0)
+                self.assertEqual(len(scraper.scraped_data["pdf"]), 0)
             finally:
                 os.chdir(original_dir)
 
@@ -111,134 +105,118 @@ class TestUnifiedSkillBuilderDocsReferences(unittest.TestCase):
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
         # Create mock refs directories
-        refs_dir1 = os.path.join(self.temp_dir, 'refs1')
-        refs_dir2 = os.path.join(self.temp_dir, 'refs2')
+        refs_dir1 = os.path.join(self.temp_dir, "refs1")
+        refs_dir2 = os.path.join(self.temp_dir, "refs2")
         os.makedirs(refs_dir1)
         os.makedirs(refs_dir2)
 
-        config = {
-            'name': 'test_docs_refs',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_docs_refs", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [
-                {'source_id': 'source_a', 'base_url': 'https://a.com', 'total_pages': 5, 'refs_dir': refs_dir1},
-                {'source_id': 'source_b', 'base_url': 'https://b.com', 'total_pages': 3, 'refs_dir': refs_dir2}
+            "documentation": [
+                {"source_id": "source_a", "base_url": "https://a.com", "total_pages": 5, "refs_dir": refs_dir1},
+                {"source_id": "source_b", "base_url": "https://b.com", "total_pages": 3, "refs_dir": refs_dir2},
             ],
-            'github': [],
-            'pdf': []
+            "github": [],
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_docs_references(scraped_data['documentation'])
+        builder._generate_docs_references(scraped_data["documentation"])
 
-        docs_dir = os.path.join(builder.skill_dir, 'references', 'documentation')
-        self.assertTrue(os.path.exists(os.path.join(docs_dir, 'source_a')))
-        self.assertTrue(os.path.exists(os.path.join(docs_dir, 'source_b')))
+        docs_dir = os.path.join(builder.skill_dir, "references", "documentation")
+        self.assertTrue(os.path.exists(os.path.join(docs_dir, "source_a")))
+        self.assertTrue(os.path.exists(os.path.join(docs_dir, "source_b")))
 
     def test_creates_index_per_source(self):
         """Test that each source subdirectory has its own index.md."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        refs_dir = os.path.join(self.temp_dir, 'refs')
+        refs_dir = os.path.join(self.temp_dir, "refs")
         os.makedirs(refs_dir)
 
-        config = {
-            'name': 'test_source_index',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_source_index", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [
-                {'source_id': 'my_source', 'base_url': 'https://example.com', 'total_pages': 10, 'refs_dir': refs_dir}
+            "documentation": [
+                {"source_id": "my_source", "base_url": "https://example.com", "total_pages": 10, "refs_dir": refs_dir}
             ],
-            'github': [],
-            'pdf': []
+            "github": [],
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_docs_references(scraped_data['documentation'])
+        builder._generate_docs_references(scraped_data["documentation"])
 
-        source_index = os.path.join(builder.skill_dir, 'references', 'documentation', 'my_source', 'index.md')
+        source_index = os.path.join(builder.skill_dir, "references", "documentation", "my_source", "index.md")
         self.assertTrue(os.path.exists(source_index))
 
-        with open(source_index, 'r') as f:
+        with open(source_index) as f:
             content = f.read()
-            self.assertIn('my_source', content)
-            self.assertIn('https://example.com', content)
+            self.assertIn("my_source", content)
+            self.assertIn("https://example.com", content)
 
     def test_creates_main_index_listing_all_sources(self):
         """Test that main index.md lists all documentation sources."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        refs_dir1 = os.path.join(self.temp_dir, 'refs1')
-        refs_dir2 = os.path.join(self.temp_dir, 'refs2')
+        refs_dir1 = os.path.join(self.temp_dir, "refs1")
+        refs_dir2 = os.path.join(self.temp_dir, "refs2")
         os.makedirs(refs_dir1)
         os.makedirs(refs_dir2)
 
-        config = {
-            'name': 'test_main_index',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_main_index", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [
-                {'source_id': 'docs_one', 'base_url': 'https://one.com', 'total_pages': 10, 'refs_dir': refs_dir1},
-                {'source_id': 'docs_two', 'base_url': 'https://two.com', 'total_pages': 20, 'refs_dir': refs_dir2}
+            "documentation": [
+                {"source_id": "docs_one", "base_url": "https://one.com", "total_pages": 10, "refs_dir": refs_dir1},
+                {"source_id": "docs_two", "base_url": "https://two.com", "total_pages": 20, "refs_dir": refs_dir2},
             ],
-            'github': [],
-            'pdf': []
+            "github": [],
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_docs_references(scraped_data['documentation'])
+        builder._generate_docs_references(scraped_data["documentation"])
 
-        main_index = os.path.join(builder.skill_dir, 'references', 'documentation', 'index.md')
+        main_index = os.path.join(builder.skill_dir, "references", "documentation", "index.md")
         self.assertTrue(os.path.exists(main_index))
 
-        with open(main_index, 'r') as f:
+        with open(main_index) as f:
             content = f.read()
-            self.assertIn('docs_one', content)
-            self.assertIn('docs_two', content)
-            self.assertIn('2 documentation sources', content)
+            self.assertIn("docs_one", content)
+            self.assertIn("docs_two", content)
+            self.assertIn("2 documentation sources", content)
 
     def test_copies_reference_files_to_source_dir(self):
         """Test that reference files are copied to source subdirectory."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        refs_dir = os.path.join(self.temp_dir, 'refs')
+        refs_dir = os.path.join(self.temp_dir, "refs")
         os.makedirs(refs_dir)
 
         # Create mock reference files
-        with open(os.path.join(refs_dir, 'api.md'), 'w') as f:
-            f.write('# API Reference')
-        with open(os.path.join(refs_dir, 'guide.md'), 'w') as f:
-            f.write('# User Guide')
+        with open(os.path.join(refs_dir, "api.md"), "w") as f:
+            f.write("# API Reference")
+        with open(os.path.join(refs_dir, "guide.md"), "w") as f:
+            f.write("# User Guide")
 
-        config = {
-            'name': 'test_copy_refs',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_copy_refs", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [
-                {'source_id': 'test_source', 'base_url': 'https://test.com', 'total_pages': 5, 'refs_dir': refs_dir}
+            "documentation": [
+                {"source_id": "test_source", "base_url": "https://test.com", "total_pages": 5, "refs_dir": refs_dir}
             ],
-            'github': [],
-            'pdf': []
+            "github": [],
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_docs_references(scraped_data['documentation'])
+        builder._generate_docs_references(scraped_data["documentation"])
 
-        source_dir = os.path.join(builder.skill_dir, 'references', 'documentation', 'test_source')
-        self.assertTrue(os.path.exists(os.path.join(source_dir, 'api.md')))
-        self.assertTrue(os.path.exists(os.path.join(source_dir, 'guide.md')))
+        source_dir = os.path.join(builder.skill_dir, "references", "documentation", "test_source")
+        self.assertTrue(os.path.exists(os.path.join(source_dir, "api.md")))
+        self.assertTrue(os.path.exists(os.path.join(source_dir, "guide.md")))
 
 
 class TestUnifiedSkillBuilderGitHubReferences(unittest.TestCase):
@@ -260,127 +238,148 @@ class TestUnifiedSkillBuilderGitHubReferences(unittest.TestCase):
         """Test that each GitHub repo gets its own subdirectory."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        config = {
-            'name': 'test_github_refs',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_github_refs", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [],
-            'github': [
-                {'repo': 'org/repo1', 'repo_id': 'org_repo1', 'data': {'readme': '# Repo 1', 'issues': [], 'releases': [], 'repo_info': {}}},
-                {'repo': 'org/repo2', 'repo_id': 'org_repo2', 'data': {'readme': '# Repo 2', 'issues': [], 'releases': [], 'repo_info': {}}}
+            "documentation": [],
+            "github": [
+                {
+                    "repo": "org/repo1",
+                    "repo_id": "org_repo1",
+                    "data": {"readme": "# Repo 1", "issues": [], "releases": [], "repo_info": {}},
+                },
+                {
+                    "repo": "org/repo2",
+                    "repo_id": "org_repo2",
+                    "data": {"readme": "# Repo 2", "issues": [], "releases": [], "repo_info": {}},
+                },
             ],
-            'pdf': []
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_github_references(scraped_data['github'])
+        builder._generate_github_references(scraped_data["github"])
 
-        github_dir = os.path.join(builder.skill_dir, 'references', 'github')
-        self.assertTrue(os.path.exists(os.path.join(github_dir, 'org_repo1')))
-        self.assertTrue(os.path.exists(os.path.join(github_dir, 'org_repo2')))
+        github_dir = os.path.join(builder.skill_dir, "references", "github")
+        self.assertTrue(os.path.exists(os.path.join(github_dir, "org_repo1")))
+        self.assertTrue(os.path.exists(os.path.join(github_dir, "org_repo2")))
 
     def test_creates_readme_per_repo(self):
         """Test that README.md is created for each repo."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        config = {
-            'name': 'test_readme',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_readme", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [],
-            'github': [
-                {'repo': 'test/myrepo', 'repo_id': 'test_myrepo', 'data': {'readme': '# My Repository\n\nDescription here.', 'issues': [], 'releases': [], 'repo_info': {}}}
+            "documentation": [],
+            "github": [
+                {
+                    "repo": "test/myrepo",
+                    "repo_id": "test_myrepo",
+                    "data": {
+                        "readme": "# My Repository\n\nDescription here.",
+                        "issues": [],
+                        "releases": [],
+                        "repo_info": {},
+                    },
+                }
             ],
-            'pdf': []
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_github_references(scraped_data['github'])
+        builder._generate_github_references(scraped_data["github"])
 
-        readme_path = os.path.join(builder.skill_dir, 'references', 'github', 'test_myrepo', 'README.md')
+        readme_path = os.path.join(builder.skill_dir, "references", "github", "test_myrepo", "README.md")
         self.assertTrue(os.path.exists(readme_path))
 
-        with open(readme_path, 'r') as f:
+        with open(readme_path) as f:
             content = f.read()
-            self.assertIn('test/myrepo', content)
+            self.assertIn("test/myrepo", content)
 
     def test_creates_issues_file_when_issues_exist(self):
         """Test that issues.md is created when repo has issues."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        config = {
-            'name': 'test_issues',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_issues", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [],
-            'github': [
+            "documentation": [],
+            "github": [
                 {
-                    'repo': 'test/repo',
-                    'repo_id': 'test_repo',
-                    'data': {
-                        'readme': '# Repo',
-                        'issues': [
-                            {'number': 1, 'title': 'Bug report', 'state': 'open', 'labels': ['bug'], 'url': 'https://github.com/test/repo/issues/1'},
-                            {'number': 2, 'title': 'Feature request', 'state': 'closed', 'labels': ['enhancement'], 'url': 'https://github.com/test/repo/issues/2'}
+                    "repo": "test/repo",
+                    "repo_id": "test_repo",
+                    "data": {
+                        "readme": "# Repo",
+                        "issues": [
+                            {
+                                "number": 1,
+                                "title": "Bug report",
+                                "state": "open",
+                                "labels": ["bug"],
+                                "url": "https://github.com/test/repo/issues/1",
+                            },
+                            {
+                                "number": 2,
+                                "title": "Feature request",
+                                "state": "closed",
+                                "labels": ["enhancement"],
+                                "url": "https://github.com/test/repo/issues/2",
+                            },
                         ],
-                        'releases': [],
-                        'repo_info': {}
-                    }
+                        "releases": [],
+                        "repo_info": {},
+                    },
                 }
             ],
-            'pdf': []
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_github_references(scraped_data['github'])
+        builder._generate_github_references(scraped_data["github"])
 
-        issues_path = os.path.join(builder.skill_dir, 'references', 'github', 'test_repo', 'issues.md')
+        issues_path = os.path.join(builder.skill_dir, "references", "github", "test_repo", "issues.md")
         self.assertTrue(os.path.exists(issues_path))
 
-        with open(issues_path, 'r') as f:
+        with open(issues_path) as f:
             content = f.read()
-            self.assertIn('Bug report', content)
-            self.assertIn('Feature request', content)
+            self.assertIn("Bug report", content)
+            self.assertIn("Feature request", content)
 
     def test_creates_main_index_listing_all_repos(self):
         """Test that main index.md lists all GitHub repositories."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        config = {
-            'name': 'test_github_index',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_github_index", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [],
-            'github': [
-                {'repo': 'org/first', 'repo_id': 'org_first', 'data': {'readme': '#', 'issues': [], 'releases': [], 'repo_info': {'stars': 100}}},
-                {'repo': 'org/second', 'repo_id': 'org_second', 'data': {'readme': '#', 'issues': [], 'releases': [], 'repo_info': {'stars': 50}}}
+            "documentation": [],
+            "github": [
+                {
+                    "repo": "org/first",
+                    "repo_id": "org_first",
+                    "data": {"readme": "#", "issues": [], "releases": [], "repo_info": {"stars": 100}},
+                },
+                {
+                    "repo": "org/second",
+                    "repo_id": "org_second",
+                    "data": {"readme": "#", "issues": [], "releases": [], "repo_info": {"stars": 50}},
+                },
             ],
-            'pdf': []
+            "pdf": [],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_github_references(scraped_data['github'])
+        builder._generate_github_references(scraped_data["github"])
 
-        main_index = os.path.join(builder.skill_dir, 'references', 'github', 'index.md')
+        main_index = os.path.join(builder.skill_dir, "references", "github", "index.md")
         self.assertTrue(os.path.exists(main_index))
 
-        with open(main_index, 'r') as f:
+        with open(main_index) as f:
             content = f.read()
-            self.assertIn('org/first', content)
-            self.assertIn('org/second', content)
-            self.assertIn('2 GitHub repositories', content)
+            self.assertIn("org/first", content)
+            self.assertIn("org/second", content)
+            self.assertIn("2 GitHub repositories", content)
 
 
 class TestUnifiedSkillBuilderPdfReferences(unittest.TestCase):
@@ -402,32 +401,24 @@ class TestUnifiedSkillBuilderPdfReferences(unittest.TestCase):
         """Test that PDF index shows correct document count."""
         from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-        config = {
-            'name': 'test_pdf',
-            'description': 'Test',
-            'sources': []
-        }
+        config = {"name": "test_pdf", "description": "Test", "sources": []}
 
         scraped_data = {
-            'documentation': [],
-            'github': [],
-            'pdf': [
-                {'path': '/path/to/doc1.pdf'},
-                {'path': '/path/to/doc2.pdf'},
-                {'path': '/path/to/doc3.pdf'}
-            ]
+            "documentation": [],
+            "github": [],
+            "pdf": [{"path": "/path/to/doc1.pdf"}, {"path": "/path/to/doc2.pdf"}, {"path": "/path/to/doc3.pdf"}],
         }
 
         builder = UnifiedSkillBuilder(config, scraped_data)
-        builder._generate_pdf_references(scraped_data['pdf'])
+        builder._generate_pdf_references(scraped_data["pdf"])
 
-        pdf_index = os.path.join(builder.skill_dir, 'references', 'pdf', 'index.md')
+        pdf_index = os.path.join(builder.skill_dir, "references", "pdf", "index.md")
         self.assertTrue(os.path.exists(pdf_index))
 
-        with open(pdf_index, 'r') as f:
+        with open(pdf_index) as f:
             content = f.read()
-            self.assertIn('3 PDF document', content)
+            self.assertIn("3 PDF document", content)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_package_skill.py b/tests/test_package_skill.py
index b05b3c2..a2c3b94 100644
--- a/tests/test_package_skill.py
+++ b/tests/test_package_skill.py
@@ -3,11 +3,10 @@
 Tests for cli/package_skill.py functionality
 """
 
-import unittest
 import tempfile
+import unittest
 import zipfile
 from pathlib import Path
-import sys
 
 from skill_seekers.cli.package_skill import package_skill
 
@@ -47,7 +46,7 @@ class TestPackageSkill(unittest.TestCase):
             self.assertTrue(success)
             self.assertIsNotNone(zip_path)
             self.assertTrue(zip_path.exists())
-            self.assertEqual(zip_path.suffix, '.zip')
+            self.assertEqual(zip_path.suffix, ".zip")
             self.assertTrue(zipfile.is_zipfile(zip_path))
 
     def test_package_creates_correct_zip_structure(self):
@@ -60,15 +59,15 @@ class TestPackageSkill(unittest.TestCase):
             self.assertTrue(success)
 
             # Check zip contents
-            with zipfile.ZipFile(zip_path, 'r') as zf:
+            with zipfile.ZipFile(zip_path, "r") as zf:
                 names = zf.namelist()
 
                 # Should contain SKILL.md
-                self.assertTrue(any('SKILL.md' in name for name in names))
+                self.assertTrue(any("SKILL.md" in name for name in names))
 
                 # Should contain references
-                self.assertTrue(any('references/index.md' in name for name in names))
-                self.assertTrue(any('references/getting_started.md' in name for name in names))
+                self.assertTrue(any("references/index.md" in name for name in names))
+                self.assertTrue(any("references/getting_started.md" in name for name in names))
 
     def test_package_excludes_backup_files(self):
         """Test that .backup files are excluded from zip"""
@@ -83,9 +82,9 @@ class TestPackageSkill(unittest.TestCase):
             self.assertTrue(success)
 
             # Check that backup is NOT in zip
-            with zipfile.ZipFile(zip_path, 'r') as zf:
+            with zipfile.ZipFile(zip_path, "r") as zf:
                 names = zf.namelist()
-                self.assertFalse(any('.backup' in name for name in names))
+                self.assertFalse(any(".backup" in name for name in names))
 
     def test_package_nonexistent_directory(self):
         """Test packaging a nonexistent directory"""
@@ -150,17 +149,12 @@ class TestPackageSkillCLI(unittest.TestCase):
         import subprocess
 
         try:
-            result = subprocess.run(
-                ['skill-seekers', 'package', '--help'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers", "package", "--help"], capture_output=True, text=True, timeout=5)
 
             # argparse may return 0 or 2 for --help
             self.assertIn(result.returncode, [0, 2])
             output = result.stdout + result.stderr
-            self.assertTrue('usage:' in output.lower() or 'package' in output.lower())
+            self.assertTrue("usage:" in output.lower() or "package" in output.lower())
         except FileNotFoundError:
             self.skipTest("skill-seekers command not installed")
 
@@ -169,12 +163,7 @@ class TestPackageSkillCLI(unittest.TestCase):
         import subprocess
 
         try:
-            result = subprocess.run(
-                ['skill-seekers-package', '--help'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers-package", "--help"], capture_output=True, text=True, timeout=5)
 
             # argparse may return 0 or 2 for --help
             self.assertIn(result.returncode, [0, 2])
@@ -182,5 +171,5 @@ class TestPackageSkillCLI(unittest.TestCase):
             self.skipTest("skill-seekers-package command not installed")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_package_structure.py b/tests/test_package_structure.py
index 055a272..a77e1bc 100644
--- a/tests/test_package_structure.py
+++ b/tests/test_package_structure.py
@@ -4,10 +4,11 @@ Tests that the package structure is correct and imports work properly.
 This ensures modern Python packaging (src/ layout, pyproject.toml) is successful.
 """
 
-import pytest
 import sys
 from pathlib import Path
 
+import pytest
+
 
 class TestCliPackage:
     """Test skill_seekers.cli package structure and imports."""
@@ -15,40 +16,47 @@ class TestCliPackage:
     def test_cli_package_exists(self):
         """Test that skill_seekers.cli package can be imported."""
         import skill_seekers.cli
+
         assert skill_seekers.cli is not None
 
     def test_cli_has_version(self):
         """Test that skill_seekers.cli package has __version__."""
         import skill_seekers.cli
-        assert hasattr(skill_seekers.cli, '__version__')
-        assert skill_seekers.cli.__version__ == '2.5.2'
+
+        assert hasattr(skill_seekers.cli, "__version__")
+        assert skill_seekers.cli.__version__ == "2.5.2"
 
     def test_cli_has_all(self):
         """Test that skill_seekers.cli package has __all__ export list."""
         import skill_seekers.cli
-        assert hasattr(skill_seekers.cli, '__all__')
+
+        assert hasattr(skill_seekers.cli, "__all__")
         assert isinstance(skill_seekers.cli.__all__, list)
         assert len(skill_seekers.cli.__all__) > 0
 
     def test_llms_txt_detector_import(self):
         """Test that LlmsTxtDetector can be imported from skill_seekers.cli."""
         from skill_seekers.cli import LlmsTxtDetector
+
         assert LlmsTxtDetector is not None
 
     def test_llms_txt_downloader_import(self):
         """Test that LlmsTxtDownloader can be imported from skill_seekers.cli."""
         from skill_seekers.cli import LlmsTxtDownloader
+
         assert LlmsTxtDownloader is not None
 
     def test_llms_txt_parser_import(self):
         """Test that LlmsTxtParser can be imported from skill_seekers.cli."""
         from skill_seekers.cli import LlmsTxtParser
+
         assert LlmsTxtParser is not None
 
     def test_open_folder_import(self):
         """Test that open_folder can be imported from skill_seekers.cli (if utils exists)."""
         try:
             from skill_seekers.cli import open_folder
+
             # If import succeeds, function should not be None
             assert open_folder is not None
         except ImportError:
@@ -58,8 +66,9 @@ class TestCliPackage:
     def test_cli_exports_match_all(self):
         """Test that exported items in __all__ can actually be imported."""
         import skill_seekers.cli as cli
+
         for item_name in cli.__all__:
-            if item_name == 'open_folder' and cli.open_folder is None:
+            if item_name == "open_folder" and cli.open_folder is None:
                 # open_folder might be None if utils doesn't exist
                 continue
             assert hasattr(cli, item_name), f"{item_name} not found in cli package"
@@ -71,30 +80,35 @@ class TestMcpPackage:
     def test_mcp_package_exists(self):
         """Test that skill_seekers.mcp package can be imported."""
         import skill_seekers.mcp
+
         assert skill_seekers.mcp is not None
 
     def test_mcp_has_version(self):
         """Test that skill_seekers.mcp package has __version__."""
         import skill_seekers.mcp
-        assert hasattr(skill_seekers.mcp, '__version__')
-        assert skill_seekers.mcp.__version__ == '2.5.2'
+
+        assert hasattr(skill_seekers.mcp, "__version__")
+        assert skill_seekers.mcp.__version__ == "2.5.2"
 
     def test_mcp_has_all(self):
         """Test that skill_seekers.mcp package has __all__ export list."""
         import skill_seekers.mcp
-        assert hasattr(skill_seekers.mcp, '__all__')
+
+        assert hasattr(skill_seekers.mcp, "__all__")
         assert isinstance(skill_seekers.mcp.__all__, list)
 
     def test_mcp_tools_package_exists(self):
         """Test that skill_seekers.mcp.tools subpackage can be imported."""
         import skill_seekers.mcp.tools
+
         assert skill_seekers.mcp.tools is not None
 
     def test_mcp_tools_has_version(self):
         """Test that skill_seekers.mcp.tools has __version__."""
         import skill_seekers.mcp.tools
-        assert hasattr(skill_seekers.mcp.tools, '__version__')
-        assert skill_seekers.mcp.tools.__version__ == '2.5.2'
+
+        assert hasattr(skill_seekers.mcp.tools, "__version__")
+        assert skill_seekers.mcp.tools.__version__ == "2.5.2"
 
 
 class TestPackageStructure:
@@ -102,28 +116,30 @@ class TestPackageStructure:
 
     def test_cli_init_file_exists(self):
         """Test that src/skill_seekers/cli/__init__.py exists."""
-        init_file = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'cli' / '__init__.py'
+        init_file = Path(__file__).parent.parent / "src" / "skill_seekers" / "cli" / "__init__.py"
         assert init_file.exists(), "src/skill_seekers/cli/__init__.py not found"
 
     def test_mcp_init_file_exists(self):
         """Test that src/skill_seekers/mcp/__init__.py exists."""
-        init_file = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'mcp' / '__init__.py'
+        init_file = Path(__file__).parent.parent / "src" / "skill_seekers" / "mcp" / "__init__.py"
         assert init_file.exists(), "src/skill_seekers/mcp/__init__.py not found"
 
     def test_mcp_tools_init_file_exists(self):
         """Test that src/skill_seekers/mcp/tools/__init__.py exists."""
-        init_file = Path(__file__).parent.parent / 'src' / 'skill_seekers' / 'mcp' / 'tools' / '__init__.py'
+        init_file = Path(__file__).parent.parent / "src" / "skill_seekers" / "mcp" / "tools" / "__init__.py"
         assert init_file.exists(), "src/skill_seekers/mcp/tools/__init__.py not found"
 
     def test_cli_init_has_docstring(self):
         """Test that skill_seekers.cli/__init__.py has a module docstring."""
         import skill_seekers.cli
+
         assert skill_seekers.cli.__doc__ is not None
         assert len(skill_seekers.cli.__doc__) > 50  # Should have substantial documentation
 
     def test_mcp_init_has_docstring(self):
         """Test that skill_seekers.mcp/__init__.py has a module docstring."""
         import skill_seekers.mcp
+
         assert skill_seekers.mcp.__doc__ is not None
         assert len(skill_seekers.mcp.__doc__) > 50  # Should have substantial documentation
 
@@ -133,9 +149,8 @@ class TestImportPatterns:
 
     def test_direct_module_import(self):
         """Test importing modules directly."""
-        from skill_seekers.cli import llms_txt_detector
-        from skill_seekers.cli import llms_txt_downloader
-        from skill_seekers.cli import llms_txt_parser
+        from skill_seekers.cli import llms_txt_detector, llms_txt_downloader, llms_txt_parser
+
         assert llms_txt_detector is not None
         assert llms_txt_downloader is not None
         assert llms_txt_parser is not None
@@ -143,20 +158,17 @@ class TestImportPatterns:
     def test_class_import_from_package(self):
         """Test importing classes from package."""
         from skill_seekers.cli import LlmsTxtDetector, LlmsTxtDownloader, LlmsTxtParser
-        assert LlmsTxtDetector.__name__ == 'LlmsTxtDetector'
-        assert LlmsTxtDownloader.__name__ == 'LlmsTxtDownloader'
-        assert LlmsTxtParser.__name__ == 'LlmsTxtParser'
+
+        assert LlmsTxtDetector.__name__ == "LlmsTxtDetector"
+        assert LlmsTxtDownloader.__name__ == "LlmsTxtDownloader"
+        assert LlmsTxtParser.__name__ == "LlmsTxtParser"
 
     def test_package_level_import(self):
         """Test importing entire packages."""
-        import skill_seekers
-        import skill_seekers.cli
-        import skill_seekers.mcp
-        import skill_seekers.mcp.tools
-        assert 'skill_seekers' in sys.modules
-        assert 'skill_seekers.cli' in sys.modules
-        assert 'skill_seekers.mcp' in sys.modules
-        assert 'skill_seekers.mcp.tools' in sys.modules
+        assert "skill_seekers" in sys.modules
+        assert "skill_seekers.cli" in sys.modules
+        assert "skill_seekers.mcp" in sys.modules
+        assert "skill_seekers.mcp.tools" in sys.modules
 
 
 class TestBackwardsCompatibility:
@@ -168,6 +180,7 @@ class TestBackwardsCompatibility:
         from skill_seekers.cli.llms_txt_detector import LlmsTxtDetector
         from skill_seekers.cli.llms_txt_downloader import LlmsTxtDownloader
         from skill_seekers.cli.llms_txt_parser import LlmsTxtParser
+
         assert LlmsTxtDetector is not None
         assert LlmsTxtDownloader is not None
         assert LlmsTxtParser is not None
@@ -177,6 +190,7 @@ class TestBackwardsCompatibility:
         import skill_seekers.cli.llms_txt_detector
         import skill_seekers.cli.llms_txt_downloader
         import skill_seekers.cli.llms_txt_parser
+
         assert skill_seekers.cli.llms_txt_detector is not None
         assert skill_seekers.cli.llms_txt_downloader is not None
         assert skill_seekers.cli.llms_txt_parser is not None
@@ -188,20 +202,23 @@ class TestRootPackage:
     def test_root_package_exists(self):
         """Test that skill_seekers root package can be imported."""
         import skill_seekers
+
         assert skill_seekers is not None
 
     def test_root_has_version(self):
         """Test that skill_seekers root package has __version__."""
         import skill_seekers
-        assert hasattr(skill_seekers, '__version__')
-        assert skill_seekers.__version__ == '2.5.2'
+
+        assert hasattr(skill_seekers, "__version__")
+        assert skill_seekers.__version__ == "2.5.2"
 
     def test_root_has_metadata(self):
         """Test that skill_seekers root package has metadata."""
         import skill_seekers
-        assert hasattr(skill_seekers, '__author__')
-        assert hasattr(skill_seekers, '__license__')
-        assert skill_seekers.__license__ == 'MIT'
+
+        assert hasattr(skill_seekers, "__author__")
+        assert hasattr(skill_seekers, "__license__")
+        assert skill_seekers.__license__ == "MIT"
 
 
 class TestCLIEntryPoints:
@@ -210,14 +227,16 @@ class TestCLIEntryPoints:
     def test_main_cli_module_exists(self):
         """Test that main.py module exists and can be imported."""
         from skill_seekers.cli import main
+
         assert main is not None
-        assert hasattr(main, 'main')
+        assert hasattr(main, "main")
         assert callable(main.main)
 
     def test_main_cli_has_parser(self):
         """Test that main.py has parser creation function."""
         from skill_seekers.cli.main import create_parser
+
         parser = create_parser()
         assert parser is not None
         # Test that main subcommands are configured
-        assert parser.prog == 'skill-seekers'
+        assert parser.prog == "skill-seekers"
diff --git a/tests/test_parallel_scraping.py b/tests/test_parallel_scraping.py
index 86fb181..7fee766 100644
--- a/tests/test_parallel_scraping.py
+++ b/tests/test_parallel_scraping.py
@@ -3,15 +3,9 @@
 Tests for parallel scraping, unlimited mode, and rate limiting features (PR #144)
 """
 
-import sys
 import os
-import unittest
 import tempfile
-import json
-import time
-from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
-from collections import deque
+import unittest
 
 from skill_seekers.cli.doc_scraper import DocToSkillConverter
 
@@ -30,41 +24,41 @@ class TestParallelScrapingConfiguration(unittest.TestCase):
     def test_single_worker_default(self):
         """Test default is single-worker mode"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": 10,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertEqual(converter.workers, 1)
-            self.assertFalse(hasattr(converter, 'lock'))
+            self.assertFalse(hasattr(converter, "lock"))
 
     def test_multiple_workers_creates_lock(self):
         """Test multiple workers creates thread lock"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': 10,
-            'workers': 4
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": 10,
+            "workers": 4,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertEqual(converter.workers, 4)
-            self.assertTrue(hasattr(converter, 'lock'))
+            self.assertTrue(hasattr(converter, "lock"))
 
     def test_workers_from_config(self):
         """Test workers parameter is read from config"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'workers': 8
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "workers": 8,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -87,43 +81,39 @@ class TestUnlimitedMode(unittest.TestCase):
     def test_unlimited_with_none(self):
         """Test max_pages: None enables unlimited mode"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': None
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": None,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
-            self.assertIsNone(converter.config.get('max_pages'))
+            self.assertIsNone(converter.config.get("max_pages"))
 
     def test_unlimited_with_minus_one(self):
         """Test max_pages: -1 enables unlimited mode"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': -1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": -1,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
-            self.assertEqual(converter.config.get('max_pages'), -1)
+            self.assertEqual(converter.config.get("max_pages"), -1)
 
     def test_limited_mode_default(self):
         """Test default max_pages is limited"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'}
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "selectors": {"main_content": "article"}}
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
-            max_pages = converter.config.get('max_pages', 500)
+            max_pages = converter.config.get("max_pages", 500)
             self.assertIsNotNone(max_pages)
             self.assertGreater(max_pages, 0)
 
@@ -142,43 +132,39 @@ class TestRateLimiting(unittest.TestCase):
     def test_rate_limit_from_config(self):
         """Test rate_limit is read from config"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'rate_limit': 0.1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "rate_limit": 0.1,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
-            self.assertEqual(converter.config.get('rate_limit'), 0.1)
+            self.assertEqual(converter.config.get("rate_limit"), 0.1)
 
     def test_rate_limit_default(self):
         """Test default rate_limit is 0.5"""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'}
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "selectors": {"main_content": "article"}}
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
-            self.assertEqual(converter.config.get('rate_limit', 0.5), 0.5)
+            self.assertEqual(converter.config.get("rate_limit", 0.5), 0.5)
 
     def test_zero_rate_limit_disables(self):
         """Test rate_limit: 0 disables rate limiting"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'rate_limit': 0
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "rate_limit": 0,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
-            self.assertEqual(converter.config.get('rate_limit'), 0)
+            self.assertEqual(converter.config.get("rate_limit"), 0)
 
 
 class TestThreadSafety(unittest.TestCase):
@@ -195,10 +181,10 @@ class TestThreadSafety(unittest.TestCase):
     def test_lock_protects_visited_urls(self):
         """Test visited_urls operations are protected by lock"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'workers': 4
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "workers": 4,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -206,25 +192,26 @@ class TestThreadSafety(unittest.TestCase):
             converter = DocToSkillConverter(config, dry_run=True)
 
             # Verify lock exists
-            self.assertTrue(hasattr(converter, 'lock'))
+            self.assertTrue(hasattr(converter, "lock"))
 
             # Verify it's a threading.Lock
             import threading
+
             self.assertIsInstance(converter.lock, type(threading.Lock()))
 
     def test_single_worker_no_lock(self):
         """Test single worker doesn't create unnecessary lock"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'workers': 1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "workers": 1,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
-            self.assertFalse(hasattr(converter, 'lock'))
+            self.assertFalse(hasattr(converter, "lock"))
 
 
 class TestScrapingModes(unittest.TestCase):
@@ -241,69 +228,69 @@ class TestScrapingModes(unittest.TestCase):
     def test_single_threaded_limited(self):
         """Test traditional single-threaded limited mode"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': 10,
-            'workers': 1
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": 10,
+            "workers": 1,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertEqual(converter.workers, 1)
-            self.assertEqual(converter.config.get('max_pages'), 10)
+            self.assertEqual(converter.config.get("max_pages"), 10)
 
     def test_parallel_limited(self):
         """Test parallel scraping with page limit"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': 100,
-            'workers': 4
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": 100,
+            "workers": 4,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertEqual(converter.workers, 4)
-            self.assertEqual(converter.config.get('max_pages'), 100)
-            self.assertTrue(hasattr(converter, 'lock'))
+            self.assertEqual(converter.config.get("max_pages"), 100)
+            self.assertTrue(hasattr(converter, "lock"))
 
     def test_parallel_unlimited(self):
         """Test parallel scraping with unlimited pages"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': None,
-            'workers': 8
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": None,
+            "workers": 8,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertEqual(converter.workers, 8)
-            self.assertIsNone(converter.config.get('max_pages'))
-            self.assertTrue(hasattr(converter, 'lock'))
+            self.assertIsNone(converter.config.get("max_pages"))
+            self.assertTrue(hasattr(converter, "lock"))
 
     def test_fast_scraping_mode(self):
         """Test fast scraping with low rate limit and workers"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'rate_limit': 0.1,
-            'workers': 8,
-            'max_pages': 1000
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "rate_limit": 0.1,
+            "workers": 8,
+            "max_pages": 1000,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertEqual(converter.workers, 8)
-            self.assertEqual(converter.config.get('rate_limit'), 0.1)
+            self.assertEqual(converter.config.get("rate_limit"), 0.1)
 
 
 class TestDryRunWithNewFeatures(unittest.TestCase):
@@ -320,10 +307,10 @@ class TestDryRunWithNewFeatures(unittest.TestCase):
     def test_dry_run_with_parallel(self):
         """Test dry-run with parallel workers"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'workers': 4
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "workers": 4,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
@@ -335,18 +322,18 @@ class TestDryRunWithNewFeatures(unittest.TestCase):
     def test_dry_run_with_unlimited(self):
         """Test dry-run with unlimited mode"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'max_pages': None
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "max_pages": None,
         }
 
         with tempfile.TemporaryDirectory() as tmpdir:
             os.chdir(tmpdir)
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertTrue(converter.dry_run)
-            self.assertIsNone(converter.config.get('max_pages'))
+            self.assertIsNone(converter.config.get("max_pages"))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_pattern_recognizer.py b/tests/test_pattern_recognizer.py
index 4782e2c..9b80456 100644
--- a/tests/test_pattern_recognizer.py
+++ b/tests/test_pattern_recognizer.py
@@ -10,27 +10,20 @@ Test Coverage:
 - Multi-Language Support (3 tests)
 """
 
-import unittest
-import sys
 import os
+import sys
+import unittest
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 from skill_seekers.cli.pattern_recognizer import (
-    SingletonDetector,
     FactoryDetector,
-    ObserverDetector,
-    StrategyDetector,
-    DecoratorDetector,
-    BuilderDetector,
-    AdapterDetector,
-    CommandDetector,
-    TemplateMethodDetector,
-    ChainOfResponsibilityDetector,
-    PatternRecognizer,
     LanguageAdapter,
-    PatternInstance
+    ObserverDetector,
+    PatternInstance,
+    PatternRecognizer,
+    SingletonDetector,
 )
 
 
@@ -38,8 +31,8 @@ class TestSingletonDetector(unittest.TestCase):
     """Tests for Singleton pattern detection"""
 
     def setUp(self):
-        self.detector = SingletonDetector(depth='deep')
-        self.recognizer = PatternRecognizer(depth='deep')
+        self.detector = SingletonDetector(depth="deep")
+        self.recognizer = PatternRecognizer(depth="deep")
 
     def test_surface_detection_by_name(self):
         """Test surface detection using class name"""
@@ -48,13 +41,13 @@ class DatabaseSingleton:
     def __init__(self):
         self.connection = None
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
         self.assertEqual(len(report.patterns), 1)
         pattern = report.patterns[0]
-        self.assertEqual(pattern.pattern_type, 'Singleton')
+        self.assertEqual(pattern.pattern_type, "Singleton")
         self.assertGreaterEqual(pattern.confidence, 0.6)
-        self.assertIn('Singleton', pattern.class_name)
+        self.assertIn("Singleton", pattern.class_name)
 
     def test_deep_detection_with_instance_method(self):
         """Test deep detection with getInstance() method"""
@@ -66,12 +59,12 @@ class Database:
     def __init__(self):
         self._instance = None
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
         # May or may not detect based on getInstance alone
         # Checking that analysis completes successfully
         self.assertIsNotNone(report)
-        self.assertEqual(report.language, 'Python')
+        self.assertEqual(report.language, "Python")
 
     def test_python_singleton_with_new(self):
         """Test Python-specific __new__ singleton pattern"""
@@ -84,7 +77,7 @@ class Config:
             cls._instance = super().__new__(cls)
         return cls._instance
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
         # Detection may vary based on __new__ method signatures from CodeAnalyzer
         # Main check: analysis completes successfully
@@ -107,7 +100,7 @@ public class Singleton {
     }
 }
 """
-        report = self.recognizer.analyze_file('test.java', code, 'Java')
+        report = self.recognizer.analyze_file("test.java", code, "Java")
 
         # May detect Singleton based on getInstance method
         # Since CodeAnalyzer uses regex for Java, detection may vary
@@ -118,8 +111,8 @@ class TestFactoryDetector(unittest.TestCase):
     """Tests for Factory pattern detection"""
 
     def setUp(self):
-        self.detector = FactoryDetector(depth='deep')
-        self.recognizer = PatternRecognizer(depth='deep')
+        self.detector = FactoryDetector(depth="deep")
+        self.recognizer = PatternRecognizer(depth="deep")
 
     def test_surface_detection_by_name(self):
         """Test surface detection using class name"""
@@ -128,14 +121,14 @@ class CarFactory:
     def create_car(self, type):
         pass
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Factory']
+        patterns = [p for p in report.patterns if p.pattern_type == "Factory"]
         self.assertGreater(len(patterns), 0)
         pattern = patterns[0]
         # Confidence may be adjusted by deep detection
         self.assertGreaterEqual(pattern.confidence, 0.5)
-        self.assertIn('Factory', pattern.class_name)
+        self.assertIn("Factory", pattern.class_name)
 
     def test_factory_method_detection(self):
         """Test detection of create/make methods"""
@@ -150,12 +143,12 @@ class VehicleFactory:
     def make_vehicle(self, specs):
         return Vehicle(specs)
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Factory']
+        patterns = [p for p in report.patterns if p.pattern_type == "Factory"]
         self.assertGreater(len(patterns), 0)
         pattern = patterns[0]
-        self.assertIn('create', ' '.join(pattern.evidence).lower())
+        self.assertIn("create", " ".join(pattern.evidence).lower())
 
     def test_abstract_factory_multiple_methods(self):
         """Test Abstract Factory with multiple creation methods"""
@@ -170,9 +163,9 @@ class UIFactory:
     def create_menu(self):
         pass
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Factory']
+        patterns = [p for p in report.patterns if p.pattern_type == "Factory"]
         self.assertGreater(len(patterns), 0)
         pattern = patterns[0]
         self.assertGreaterEqual(pattern.confidence, 0.5)
@@ -188,9 +181,9 @@ class ShapeFactory:
             return Square(*args)
         return None
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Factory']
+        patterns = [p for p in report.patterns if p.pattern_type == "Factory"]
         self.assertGreater(len(patterns), 0)
 
 
@@ -198,8 +191,8 @@ class TestObserverDetector(unittest.TestCase):
     """Tests for Observer pattern detection"""
 
     def setUp(self):
-        self.detector = ObserverDetector(depth='deep')
-        self.recognizer = PatternRecognizer(depth='deep')
+        self.detector = ObserverDetector(depth="deep")
+        self.recognizer = PatternRecognizer(depth="deep")
 
     def test_observer_triplet_detection(self):
         """Test classic attach/detach/notify triplet"""
@@ -218,18 +211,14 @@ class Subject:
         for observer in self.observers:
             observer.update()
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Observer']
+        patterns = [p for p in report.patterns if p.pattern_type == "Observer"]
         self.assertGreater(len(patterns), 0)
         pattern = patterns[0]
         self.assertGreaterEqual(pattern.confidence, 0.8)
-        evidence_str = ' '.join(pattern.evidence).lower()
-        self.assertTrue(
-            'attach' in evidence_str and
-            'detach' in evidence_str and
-            'notify' in evidence_str
-        )
+        evidence_str = " ".join(pattern.evidence).lower()
+        self.assertTrue("attach" in evidence_str and "detach" in evidence_str and "notify" in evidence_str)
 
     def test_pubsub_pattern(self):
         """Test publish/subscribe variant"""
@@ -244,9 +233,9 @@ class EventBus:
     def publish(self, event, data):
         pass
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Observer']
+        patterns = [p for p in report.patterns if p.pattern_type == "Observer"]
         self.assertGreater(len(patterns), 0)
 
     def test_event_emitter_pattern(self):
@@ -262,9 +251,9 @@ class EventEmitter:
     def emit(self, event, *args):
         pass
 """
-        report = self.recognizer.analyze_file('test.py', code, 'Python')
+        report = self.recognizer.analyze_file("test.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Observer']
+        patterns = [p for p in report.patterns if p.pattern_type == "Observer"]
         self.assertGreater(len(patterns), 0)
 
 
@@ -272,7 +261,7 @@ class TestPatternRecognizerIntegration(unittest.TestCase):
     """Integration tests for PatternRecognizer"""
 
     def setUp(self):
-        self.recognizer = PatternRecognizer(depth='deep')
+        self.recognizer = PatternRecognizer(depth="deep")
 
     def test_analyze_singleton_code(self):
         """Test end-to-end Singleton analysis"""
@@ -288,10 +277,10 @@ class ConfigManager:
     def getInstance(self):
         return self._instance
 """
-        report = self.recognizer.analyze_file('config.py', code, 'Python')
+        report = self.recognizer.analyze_file("config.py", code, "Python")
 
-        self.assertEqual(report.file_path, 'config.py')
-        self.assertEqual(report.language, 'Python')
+        self.assertEqual(report.file_path, "config.py")
+        self.assertEqual(report.language, "Python")
         self.assertGreater(len(report.patterns), 0)
         self.assertGreater(report.total_classes, 0)
 
@@ -306,9 +295,9 @@ class AnimalFactory:
             return Cat()
         return None
 """
-        report = self.recognizer.analyze_file('factory.py', code, 'Python')
+        report = self.recognizer.analyze_file("factory.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Factory']
+        patterns = [p for p in report.patterns if p.pattern_type == "Factory"]
         self.assertGreater(len(patterns), 0)
 
     def test_analyze_observer_code(self):
@@ -328,9 +317,9 @@ class WeatherStation:
         for obs in self.observers:
             obs.update(self.temperature)
 """
-        report = self.recognizer.analyze_file('weather.py', code, 'Python')
+        report = self.recognizer.analyze_file("weather.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Observer']
+        patterns = [p for p in report.patterns if p.pattern_type == "Observer"]
         self.assertGreater(len(patterns), 0)
 
     def test_pattern_report_summary(self):
@@ -346,7 +335,7 @@ class LoggerFactory:
     def create_logger(self, type):
         return Logger(type)
 """
-        report = self.recognizer.analyze_file('logging.py', code, 'Python')
+        report = self.recognizer.analyze_file("logging.py", code, "Python")
 
         summary = report.get_summary()
         self.assertIsInstance(summary, dict)
@@ -361,7 +350,7 @@ class TestMultiLanguageSupport(unittest.TestCase):
     """Tests for multi-language pattern detection"""
 
     def setUp(self):
-        self.recognizer = PatternRecognizer(depth='deep')
+        self.recognizer = PatternRecognizer(depth="deep")
 
     def test_python_patterns(self):
         """Test Python-specific patterns"""
@@ -374,12 +363,12 @@ class DatabaseConnection:
             cls._instance = super().__new__(cls)
         return cls._instance
 """
-        report = self.recognizer.analyze_file('db.py', code, 'Python')
+        report = self.recognizer.analyze_file("db.py", code, "Python")
 
         # Detection depends on CodeAnalyzer's ability to parse __new__ method
         # Main check: analysis completes successfully
         self.assertIsNotNone(report)
-        self.assertEqual(report.language, 'Python')
+        self.assertEqual(report.language, "Python")
 
     def test_javascript_patterns(self):
         """Test JavaScript-specific patterns"""
@@ -402,7 +391,7 @@ const singleton = (function() {
 })();
 """
         # Note: CodeAnalyzer uses regex for JavaScript, so detection may be limited
-        report = self.recognizer.analyze_file('app.js', code, 'JavaScript')
+        report = self.recognizer.analyze_file("app.js", code, "JavaScript")
         self.assertIsNotNone(report)
 
     def test_java_patterns(self):
@@ -421,7 +410,7 @@ public class Logger {
     }
 }
 """
-        report = self.recognizer.analyze_file('Logger.java', code, 'Java')
+        report = self.recognizer.analyze_file("Logger.java", code, "Java")
         self.assertIsNotNone(report)
 
 
@@ -429,7 +418,7 @@ class TestExtendedPatternDetectors(unittest.TestCase):
     """Tests for extended pattern detectors (Builder, Adapter, Command, etc.)"""
 
     def setUp(self):
-        self.recognizer = PatternRecognizer(depth='deep')
+        self.recognizer = PatternRecognizer(depth="deep")
 
     def test_builder_pattern(self):
         """Test Builder pattern detection"""
@@ -449,9 +438,9 @@ class QueryBuilder:
     def build(self):
         return Query(self.query)
 """
-        report = self.recognizer.analyze_file('query.py', code, 'Python')
+        report = self.recognizer.analyze_file("query.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Builder']
+        patterns = [p for p in report.patterns if p.pattern_type == "Builder"]
         self.assertGreater(len(patterns), 0)
 
     def test_adapter_pattern(self):
@@ -467,9 +456,9 @@ class DatabaseAdapter:
     def connect(self):
         return self.adaptee.open_connection()
 """
-        report = self.recognizer.analyze_file('adapter.py', code, 'Python')
+        report = self.recognizer.analyze_file("adapter.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Adapter']
+        patterns = [p for p in report.patterns if p.pattern_type == "Adapter"]
         self.assertGreater(len(patterns), 0)
 
     def test_command_pattern(self):
@@ -485,9 +474,9 @@ class SaveCommand:
     def undo(self):
         self.receiver.revert()
 """
-        report = self.recognizer.analyze_file('command.py', code, 'Python')
+        report = self.recognizer.analyze_file("command.py", code, "Python")
 
-        patterns = [p for p in report.patterns if p.pattern_type == 'Command']
+        patterns = [p for p in report.patterns if p.pattern_type == "Command"]
         self.assertGreater(len(patterns), 0)
 
 
@@ -497,38 +486,38 @@ class TestLanguageAdapter(unittest.TestCase):
     def test_python_decorator_boost(self):
         """Test Python @decorator syntax boost"""
         pattern = PatternInstance(
-            pattern_type='Decorator',
-            category='Structural',
+            pattern_type="Decorator",
+            category="Structural",
             confidence=0.6,
-            location='test.py',
-            class_name='LogDecorator',
-            evidence=['Uses @decorator syntax']
+            location="test.py",
+            class_name="LogDecorator",
+            evidence=["Uses @decorator syntax"],
         )
 
-        adapted = LanguageAdapter.adapt_for_language(pattern, 'Python')
+        adapted = LanguageAdapter.adapt_for_language(pattern, "Python")
         self.assertGreater(adapted.confidence, 0.6)
-        self.assertIn('Python @decorator', ' '.join(adapted.evidence))
+        self.assertIn("Python @decorator", " ".join(adapted.evidence))
 
     def test_javascript_module_pattern(self):
         """Test JavaScript module pattern boost"""
         pattern = PatternInstance(
-            pattern_type='Singleton',
-            category='Creational',
+            pattern_type="Singleton",
+            category="Creational",
             confidence=0.5,
-            location='app.js',
-            class_name='App',
-            evidence=['Has getInstance', 'module pattern detected']
+            location="app.js",
+            class_name="App",
+            evidence=["Has getInstance", "module pattern detected"],
         )
 
-        adapted = LanguageAdapter.adapt_for_language(pattern, 'JavaScript')
+        adapted = LanguageAdapter.adapt_for_language(pattern, "JavaScript")
         self.assertGreater(adapted.confidence, 0.5)
 
     def test_no_pattern_returns_none(self):
         """Test None input returns None"""
-        result = LanguageAdapter.adapt_for_language(None, 'Python')
+        result = LanguageAdapter.adapt_for_language(None, "Python")
         self.assertIsNone(result)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Run tests with verbose output
     unittest.main(verbosity=2)
diff --git a/tests/test_pdf_advanced_features.py b/tests/test_pdf_advanced_features.py
index 892d041..72ee020 100644
--- a/tests/test_pdf_advanced_features.py
+++ b/tests/test_pdf_advanced_features.py
@@ -10,26 +10,28 @@ Tests cover:
 - Caching
 """
 
-import unittest
+import io
+import shutil
 import sys
 import tempfile
-import shutil
-import io
+import unittest
 from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
+from unittest.mock import MagicMock, Mock, patch
 
 # Add parent directory to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent / "cli"))
 
 try:
     import fitz  # PyMuPDF
+
     PYMUPDF_AVAILABLE = True
 except ImportError:
     PYMUPDF_AVAILABLE = False
 
 try:
-    from PIL import Image
     import pytesseract
+    from PIL import Image
+
     TESSERACT_AVAILABLE = True
 except ImportError:
     TESSERACT_AVAILABLE = False
@@ -42,11 +44,12 @@ class TestOCRSupport(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
         self.temp_dir = tempfile.mkdtemp()
 
     def tearDown(self):
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_ocr_initialization(self):
@@ -86,7 +89,7 @@ class TestOCRSupport(unittest.TestCase):
         # OCR should not be triggered
         mock_page.get_pixmap.assert_not_called()
 
-    @patch('pdf_extractor_poc.TESSERACT_AVAILABLE', False)
+    @patch("pdf_extractor_poc.TESSERACT_AVAILABLE", False)
     def test_ocr_unavailable_warning(self):
         """Test warning when OCR requested but pytesseract not available"""
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
@@ -97,7 +100,7 @@ class TestOCRSupport(unittest.TestCase):
         mock_page.get_text.return_value = "Short"  # Less than 50 chars
 
         # Capture output
-        with patch('sys.stdout', new=io.StringIO()) as fake_out:
+        with patch("sys.stdout", new=io.StringIO()) as fake_out:
             text = extractor.extract_text_with_ocr(mock_page)
             output = fake_out.getvalue()
 
@@ -119,10 +122,10 @@ class TestOCRSupport(unittest.TestCase):
         mock_pix = Mock()
         mock_pix.width = 100
         mock_pix.height = 100
-        mock_pix.samples = b'\x00' * (100 * 100 * 3)
+        mock_pix.samples = b"\x00" * (100 * 100 * 3)
         mock_page.get_pixmap.return_value = mock_pix
 
-        with patch('pytesseract.image_to_string', return_value="OCR extracted text here"):
+        with patch("pytesseract.image_to_string", return_value="OCR extracted text here"):
             text = extractor.extract_text_with_ocr(mock_page)
 
         # Should use OCR text since it's longer
@@ -137,11 +140,12 @@ class TestPasswordProtection(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
         self.temp_dir = tempfile.mkdtemp()
 
     def tearDown(self):
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_password_initialization(self):
@@ -164,7 +168,7 @@ class TestPasswordProtection(unittest.TestCase):
         mock_doc.metadata = {}
         mock_doc.__len__.return_value = 10
 
-        with patch('fitz.open', return_value=mock_doc):
+        with patch("fitz.open", return_value=mock_doc):
             # This would be called in extract_all()
             doc = fitz.open(extractor.pdf_path)
 
@@ -182,7 +186,7 @@ class TestPasswordProtection(unittest.TestCase):
         mock_doc.is_encrypted = True
         mock_doc.authenticate.return_value = False
 
-        with patch('fitz.open', return_value=mock_doc):
+        with patch("fitz.open", return_value=mock_doc):
             doc = fitz.open(extractor.pdf_path)
             result = doc.authenticate(extractor.password)
 
@@ -197,7 +201,7 @@ class TestPasswordProtection(unittest.TestCase):
         mock_doc = Mock()
         mock_doc.is_encrypted = True
 
-        with patch('fitz.open', return_value=mock_doc):
+        with patch("fitz.open", return_value=mock_doc):
             doc = fitz.open(extractor.pdf_path)
 
             self.assertTrue(doc.is_encrypted)
@@ -211,11 +215,12 @@ class TestTableExtraction(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
         self.temp_dir = tempfile.mkdtemp()
 
     def tearDown(self):
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_table_extraction_initialization(self):
@@ -245,10 +250,7 @@ class TestTableExtraction(unittest.TestCase):
 
         # Create mock table
         mock_table = Mock()
-        mock_table.extract.return_value = [
-            ["Header 1", "Header 2", "Header 3"],
-            ["Data 1", "Data 2", "Data 3"]
-        ]
+        mock_table.extract.return_value = [["Header 1", "Header 2", "Header 3"], ["Data 1", "Data 2", "Data 3"]]
         mock_table.bbox = (0, 0, 100, 100)
 
         # Create mock tables result
@@ -261,9 +263,9 @@ class TestTableExtraction(unittest.TestCase):
         tables = extractor.extract_tables_from_page(mock_page)
 
         self.assertEqual(len(tables), 1)
-        self.assertEqual(tables[0]['row_count'], 2)
-        self.assertEqual(tables[0]['col_count'], 3)
-        self.assertEqual(tables[0]['table_index'], 0)
+        self.assertEqual(tables[0]["row_count"], 2)
+        self.assertEqual(tables[0]["col_count"], 3)
+        self.assertEqual(tables[0]["table_index"], 0)
 
     def test_multiple_tables_extraction(self):
         """Test extraction of multiple tables from one page"""
@@ -289,8 +291,8 @@ class TestTableExtraction(unittest.TestCase):
         tables = extractor.extract_tables_from_page(mock_page)
 
         self.assertEqual(len(tables), 2)
-        self.assertEqual(tables[0]['table_index'], 0)
-        self.assertEqual(tables[1]['table_index'], 1)
+        self.assertEqual(tables[0]["table_index"], 0)
+        self.assertEqual(tables[1]["table_index"], 1)
 
     def test_table_extraction_error_handling(self):
         """Test error handling during table extraction"""
@@ -314,11 +316,12 @@ class TestCaching(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
         self.temp_dir = tempfile.mkdtemp()
 
     def tearDown(self):
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_cache_initialization(self):
@@ -396,11 +399,12 @@ class TestParallelProcessing(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
         self.temp_dir = tempfile.mkdtemp()
 
     def tearDown(self):
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_parallel_initialization(self):
@@ -422,6 +426,7 @@ class TestParallelProcessing(unittest.TestCase):
     def test_worker_count_auto_detect(self):
         """Test worker count auto-detection"""
         import os
+
         cpu_count = os.cpu_count()
 
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
@@ -445,11 +450,12 @@ class TestIntegration(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
         self.temp_dir = tempfile.mkdtemp()
 
     def tearDown(self):
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_full_initialization_with_all_features(self):
@@ -479,7 +485,7 @@ class TestIntegration(unittest.TestCase):
             {"use_ocr": True, "extract_tables": True},
             {"password": "test", "parallel": True},
             {"use_cache": True, "extract_tables": True, "parallel": True},
-            {"use_ocr": True, "password": "test", "extract_tables": True, "parallel": True}
+            {"use_ocr": True, "password": "test", "extract_tables": True, "parallel": True},
         ]
 
         for combo in combinations:
@@ -495,30 +501,38 @@ class TestIntegration(unittest.TestCase):
         """Test that page data includes table count"""
         # This tests that the page_data structure includes tables
         expected_keys = [
-            'page_number', 'text', 'markdown', 'headings',
-            'code_samples', 'images_count', 'extracted_images',
-            'tables', 'char_count', 'code_blocks_count', 'tables_count'
+            "page_number",
+            "text",
+            "markdown",
+            "headings",
+            "code_samples",
+            "images_count",
+            "extracted_images",
+            "tables",
+            "char_count",
+            "code_blocks_count",
+            "tables_count",
         ]
 
         # Just verify the structure is correct
         # Actual extraction is tested in other test classes
         page_data = {
-            'page_number': 1,
-            'text': 'test',
-            'markdown': 'test',
-            'headings': [],
-            'code_samples': [],
-            'images_count': 0,
-            'extracted_images': [],
-            'tables': [],
-            'char_count': 4,
-            'code_blocks_count': 0,
-            'tables_count': 0
+            "page_number": 1,
+            "text": "test",
+            "markdown": "test",
+            "headings": [],
+            "code_samples": [],
+            "images_count": 0,
+            "extracted_images": [],
+            "tables": [],
+            "char_count": 4,
+            "code_blocks_count": 0,
+            "tables_count": 0,
         }
 
         for key in expected_keys:
             self.assertIn(key, page_data)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_pdf_extractor.py b/tests/test_pdf_extractor.py
index d45a504..1d5eee7 100644
--- a/tests/test_pdf_extractor.py
+++ b/tests/test_pdf_extractor.py
@@ -12,8 +12,8 @@ Tests cover:
 - Code block merging
 """
 
-import unittest
 import sys
+import unittest
 from pathlib import Path
 
 # Add parent directory to path for imports
@@ -21,6 +21,7 @@ sys.path.insert(0, str(Path(__file__).parent.parent / "cli"))
 
 try:
     import fitz  # PyMuPDF
+
     PYMUPDF_AVAILABLE = True
 except ImportError:
     PYMUPDF_AVAILABLE = False
@@ -33,6 +34,7 @@ class TestLanguageDetection(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
 
     def test_detect_python_with_confidence(self):
@@ -40,6 +42,7 @@ class TestLanguageDetection(unittest.TestCase):
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
         # Initialize language_detector manually (since __init__ not called)
         from skill_seekers.cli.language_detector import LanguageDetector
+
         extractor.language_detector = LanguageDetector(min_confidence=0.15)
 
         code = "def hello():\n    print('world')\n    return True"
@@ -55,6 +58,7 @@ class TestLanguageDetection(unittest.TestCase):
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
         # Initialize language_detector manually (since __init__ not called)
         from skill_seekers.cli.language_detector import LanguageDetector
+
         extractor.language_detector = LanguageDetector(min_confidence=0.15)
 
         code = "const handleClick = () => {\n  console.log('clicked');\n};"
@@ -69,9 +73,10 @@ class TestLanguageDetection(unittest.TestCase):
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
         # Initialize language_detector manually (since __init__ not called)
         from skill_seekers.cli.language_detector import LanguageDetector
+
         extractor.language_detector = LanguageDetector(min_confidence=0.15)
 
-        code = "#include <iostream>\nint main() {\n  std::cout << \"Hello\";\n}"
+        code = '#include <iostream>\nint main() {\n  std::cout << "Hello";\n}'
 
         language, confidence = extractor.detect_language_from_code(code)
 
@@ -83,6 +88,7 @@ class TestLanguageDetection(unittest.TestCase):
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
         # Initialize language_detector manually (since __init__ not called)
         from skill_seekers.cli.language_detector import LanguageDetector
+
         extractor.language_detector = LanguageDetector(min_confidence=0.15)
 
         code = "this is not code at all just plain text"
@@ -97,15 +103,10 @@ class TestLanguageDetection(unittest.TestCase):
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
         # Initialize language_detector manually (since __init__ not called)
         from skill_seekers.cli.language_detector import LanguageDetector
+
         extractor.language_detector = LanguageDetector(min_confidence=0.15)
 
-        test_codes = [
-            "def foo(): pass",
-            "const x = 10;",
-            "#include <stdio.h>",
-            "random text here",
-            ""
-        ]
+        test_codes = ["def foo(): pass", "const x = 10;", "#include <stdio.h>", "random text here", ""]
 
         for code in test_codes:
             _, confidence = extractor.detect_language_from_code(code)
@@ -120,6 +121,7 @@ class TestSyntaxValidation(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
 
     def test_validate_python_valid(self):
@@ -170,7 +172,7 @@ class TestSyntaxValidation(unittest.TestCase):
         is_valid, issues = extractor.validate_code_syntax(code, "python")
 
         self.assertFalse(is_valid)
-        self.assertIn('May be natural language', ' '.join(issues))
+        self.assertIn("May be natural language", " ".join(issues))
 
 
 class TestQualityScoring(unittest.TestCase):
@@ -180,6 +182,7 @@ class TestQualityScoring(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
 
     def test_quality_score_range(self):
@@ -237,15 +240,13 @@ class TestChapterDetection(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
 
     def test_detect_chapter_with_number(self):
         """Test chapter detection with number"""
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
-        page_data = {
-            'text': 'Chapter 1: Introduction to Python\nThis is the first chapter.',
-            'headings': []
-        }
+        page_data = {"text": "Chapter 1: Introduction to Python\nThis is the first chapter.", "headings": []}
 
         is_chapter, title = extractor.detect_chapter_start(page_data)
 
@@ -256,8 +257,8 @@ class TestChapterDetection(unittest.TestCase):
         """Test chapter detection with uppercase"""
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
         page_data = {
-            'text': 'Chapter 1\nThis is the introduction',  # Pattern requires Chapter + digit
-            'headings': []
+            "text": "Chapter 1\nThis is the introduction",  # Pattern requires Chapter + digit
+            "headings": [],
         }
 
         is_chapter, title = extractor.detect_chapter_start(page_data)
@@ -267,10 +268,7 @@ class TestChapterDetection(unittest.TestCase):
     def test_detect_section_heading(self):
         """Test section heading detection"""
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
-        page_data = {
-            'text': '2. Getting Started\nThis is a section.',
-            'headings': []
-        }
+        page_data = {"text": "2. Getting Started\nThis is a section.", "headings": []}
 
         is_chapter, title = extractor.detect_chapter_start(page_data)
 
@@ -279,10 +277,7 @@ class TestChapterDetection(unittest.TestCase):
     def test_not_chapter(self):
         """Test normal text is not detected as chapter"""
         extractor = self.PDFExtractor.__new__(self.PDFExtractor)
-        page_data = {
-            'text': 'This is just normal paragraph text without any chapter markers.',
-            'headings': []
-        }
+        page_data = {"text": "This is just normal paragraph text without any chapter markers.", "headings": []}
 
         is_chapter, title = extractor.detect_chapter_start(page_data)
 
@@ -296,6 +291,7 @@ class TestCodeBlockMerging(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
 
     def test_merge_continued_blocks(self):
@@ -305,26 +301,22 @@ class TestCodeBlockMerging(unittest.TestCase):
 
         pages = [
             {
-                'page_number': 1,
-                'code_samples': [
-                    {'code': 'def hello():', 'language': 'python', 'detection_method': 'pattern'}
-                ],
-                'code_blocks_count': 1
+                "page_number": 1,
+                "code_samples": [{"code": "def hello():", "language": "python", "detection_method": "pattern"}],
+                "code_blocks_count": 1,
             },
             {
-                'page_number': 2,
-                'code_samples': [
-                    {'code': '    print("world")', 'language': 'python', 'detection_method': 'pattern'}
-                ],
-                'code_blocks_count': 1
-            }
+                "page_number": 2,
+                "code_samples": [{"code": '    print("world")', "language": "python", "detection_method": "pattern"}],
+                "code_blocks_count": 1,
+            },
         ]
 
         merged = extractor.merge_continued_code_blocks(pages)
 
         # Should have merged the two blocks
-        self.assertIn('def hello():', merged[0]['code_samples'][0]['code'])
-        self.assertIn('print("world")', merged[0]['code_samples'][0]['code'])
+        self.assertIn("def hello():", merged[0]["code_samples"][0]["code"])
+        self.assertIn('print("world")', merged[0]["code_samples"][0]["code"])
 
     def test_no_merge_different_languages(self):
         """Test blocks with different languages are not merged"""
@@ -332,26 +324,22 @@ class TestCodeBlockMerging(unittest.TestCase):
 
         pages = [
             {
-                'page_number': 1,
-                'code_samples': [
-                    {'code': 'def foo():', 'language': 'python', 'detection_method': 'pattern'}
-                ],
-                'code_blocks_count': 1
+                "page_number": 1,
+                "code_samples": [{"code": "def foo():", "language": "python", "detection_method": "pattern"}],
+                "code_blocks_count": 1,
             },
             {
-                'page_number': 2,
-                'code_samples': [
-                    {'code': 'const x = 10;', 'language': 'javascript', 'detection_method': 'pattern'}
-                ],
-                'code_blocks_count': 1
-            }
+                "page_number": 2,
+                "code_samples": [{"code": "const x = 10;", "language": "javascript", "detection_method": "pattern"}],
+                "code_blocks_count": 1,
+            },
         ]
 
         merged = extractor.merge_continued_code_blocks(pages)
 
         # Should NOT merge different languages
-        self.assertEqual(len(merged[0]['code_samples']), 1)
-        self.assertEqual(len(merged[1]['code_samples']), 1)
+        self.assertEqual(len(merged[0]["code_samples"]), 1)
+        self.assertEqual(len(merged[1]["code_samples"]), 1)
 
 
 class TestCodeDetectionMethods(unittest.TestCase):
@@ -361,6 +349,7 @@ class TestCodeDetectionMethods(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
 
     def test_pattern_based_detection(self):
@@ -394,6 +383,7 @@ class TestQualityFiltering(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_extractor_poc import PDFExtractor
+
         self.PDFExtractor = PDFExtractor
 
     def test_filter_by_min_quality(self):
@@ -402,23 +392,15 @@ class TestQualityFiltering(unittest.TestCase):
         extractor.min_quality = 5.0
 
         # High quality block
-        high_quality = {
-            'code': 'def calculate():\n    return 42',
-            'language': 'python',
-            'quality': 8.0
-        }
+        high_quality = {"code": "def calculate():\n    return 42", "language": "python", "quality": 8.0}
 
         # Low quality block
-        low_quality = {
-            'code': 'x',
-            'language': 'unknown',
-            'quality': 2.0
-        }
+        low_quality = {"code": "x", "language": "unknown", "quality": 2.0}
 
         # Only high quality should pass
-        self.assertGreaterEqual(high_quality['quality'], extractor.min_quality)
-        self.assertLess(low_quality['quality'], extractor.min_quality)
+        self.assertGreaterEqual(high_quality["quality"], extractor.min_quality)
+        self.assertLess(low_quality["quality"], extractor.min_quality)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_pdf_scraper.py b/tests/test_pdf_scraper.py
index fed6a4f..13713bf 100644
--- a/tests/test_pdf_scraper.py
+++ b/tests/test_pdf_scraper.py
@@ -11,16 +11,15 @@ Tests cover:
 - Error handling
 """
 
-import unittest
-import sys
 import json
-import tempfile
 import shutil
+import tempfile
+import unittest
 from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
 
 try:
     import fitz  # PyMuPDF
+
     PYMUPDF_AVAILABLE = True
 except ImportError:
     PYMUPDF_AVAILABLE = False
@@ -33,6 +32,7 @@ class TestPDFToSkillConverter(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
+
         self.PDFToSkillConverter = PDFToSkillConverter
 
         # Create temporary directory for test output
@@ -41,15 +41,12 @@ class TestPDFToSkillConverter(unittest.TestCase):
 
     def tearDown(self):
         # Clean up temporary directory
-        if hasattr(self, 'temp_dir'):
+        if hasattr(self, "temp_dir"):
             shutil.rmtree(self.temp_dir, ignore_errors=True)
 
     def test_init_with_name_and_pdf_path(self):
         """Test initialization with name and PDF path"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         self.assertEqual(converter.name, "test_skill")
@@ -62,10 +59,7 @@ class TestPDFToSkillConverter(unittest.TestCase):
             "name": "config_skill",
             "description": "Test skill",
             "pdf_path": "docs/test.pdf",
-            "extract_options": {
-                "chunk_size": 10,
-                "min_quality": 5.0
-            }
+            "extract_options": {"chunk_size": 10, "min_quality": 5.0},
         }
 
         converter = self.PDFToSkillConverter(config)
@@ -86,6 +80,7 @@ class TestCategorization(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
+
         self.PDFToSkillConverter = PDFToSkillConverter
         self.temp_dir = tempfile.mkdtemp()
 
@@ -99,8 +94,8 @@ class TestCategorization(unittest.TestCase):
             "pdf_path": "test.pdf",
             "categories": {
                 "getting_started": ["introduction", "getting started"],
-                "api": ["api", "reference", "function"]
-            }
+                "api": ["api", "reference", "function"],
+            },
         }
 
         converter = self.PDFToSkillConverter(config)
@@ -108,16 +103,8 @@ class TestCategorization(unittest.TestCase):
         # Mock extracted data with different content
         converter.extracted_data = {
             "pages": [
-                {
-                    "page_number": 1,
-                    "text": "Introduction to the API",
-                    "chapter": "Chapter 1: Getting Started"
-                },
-                {
-                    "page_number": 2,
-                    "text": "API reference for functions",
-                    "chapter": None
-                }
+                {"page_number": 1, "text": "Introduction to the API", "chapter": "Chapter 1: Getting Started"},
+                {"page_number": 2, "text": "API reference for functions", "chapter": None},
             ]
         }
 
@@ -129,30 +116,15 @@ class TestCategorization(unittest.TestCase):
 
     def test_categorize_by_chapters(self):
         """Test categorization using chapter information"""
-        config = {
-            "name": "test",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Mock data with chapters
         converter.extracted_data = {
             "pages": [
-                {
-                    "page_number": 1,
-                    "text": "Content here",
-                    "chapter": "Chapter 1: Introduction"
-                },
-                {
-                    "page_number": 2,
-                    "text": "More content",
-                    "chapter": "Chapter 1: Introduction"
-                },
-                {
-                    "page_number": 3,
-                    "text": "New chapter",
-                    "chapter": "Chapter 2: Advanced Topics"
-                }
+                {"page_number": 1, "text": "Content here", "chapter": "Chapter 1: Introduction"},
+                {"page_number": 2, "text": "More content", "chapter": "Chapter 1: Introduction"},
+                {"page_number": 3, "text": "New chapter", "chapter": "Chapter 2: Advanced Topics"},
             ]
         }
 
@@ -164,22 +136,11 @@ class TestCategorization(unittest.TestCase):
 
     def test_categorize_handles_no_chapters(self):
         """Test categorization when no chapters are detected"""
-        config = {
-            "name": "test",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Mock data without chapters
-        converter.extracted_data = {
-            "pages": [
-                {
-                    "page_number": 1,
-                    "text": "Some content",
-                    "chapter": None
-                }
-            ]
-        }
+        converter.extracted_data = {"pages": [{"page_number": 1, "text": "Some content", "chapter": None}]}
 
         categories = converter.categorize_content()
 
@@ -194,6 +155,7 @@ class TestSkillBuilding(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
+
         self.PDFToSkillConverter = PDFToSkillConverter
         self.temp_dir = tempfile.mkdtemp()
 
@@ -202,10 +164,7 @@ class TestSkillBuilding(unittest.TestCase):
 
     def test_build_skill_creates_structure(self):
         """Test that build_skill creates required directory structure"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Override skill_dir to use temp directory
@@ -213,21 +172,12 @@ class TestSkillBuilding(unittest.TestCase):
 
         # Mock extracted data
         converter.extracted_data = {
-            "pages": [
-                {
-                    "page_number": 1,
-                    "text": "Test content",
-                    "code_blocks": [],
-                    "images": []
-                }
-            ],
-            "total_pages": 1
+            "pages": [{"page_number": 1, "text": "Test content", "code_blocks": [], "images": []}],
+            "total_pages": 1,
         }
 
         # Mock categorization
-        converter.categories = {
-            "getting_started": [converter.extracted_data["pages"][0]]
-        }
+        converter.categories = {"getting_started": [converter.extracted_data["pages"][0]]}
 
         converter.build_skill()
 
@@ -240,11 +190,7 @@ class TestSkillBuilding(unittest.TestCase):
 
     def test_build_skill_creates_skill_md(self):
         """Test that SKILL.md is created"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf",
-            "description": "Test description"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf", "description": "Test description"}
         converter = self.PDFToSkillConverter(config)
 
         # Override skill_dir to use temp directory
@@ -252,7 +198,7 @@ class TestSkillBuilding(unittest.TestCase):
 
         converter.extracted_data = {
             "pages": [{"page_number": 1, "text": "Test", "code_blocks": [], "images": []}],
-            "total_pages": 1
+            "total_pages": 1,
         }
         converter.categories = {"test": [converter.extracted_data["pages"][0]]}
 
@@ -268,10 +214,7 @@ class TestSkillBuilding(unittest.TestCase):
 
     def test_build_skill_creates_reference_files(self):
         """Test that reference files are created for categories"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Override skill_dir to use temp directory
@@ -280,14 +223,14 @@ class TestSkillBuilding(unittest.TestCase):
         converter.extracted_data = {
             "pages": [
                 {"page_number": 1, "text": "Getting started", "code_blocks": [], "images": []},
-                {"page_number": 2, "text": "API reference", "code_blocks": [], "images": []}
+                {"page_number": 2, "text": "API reference", "code_blocks": [], "images": []},
             ],
-            "total_pages": 2
+            "total_pages": 2,
         }
 
         converter.categories = {
             "getting_started": [converter.extracted_data["pages"][0]],
-            "api": [converter.extracted_data["pages"][1]]
+            "api": [converter.extracted_data["pages"][1]],
         }
 
         converter.build_skill()
@@ -306,6 +249,7 @@ class TestCodeBlockHandling(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
+
         self.PDFToSkillConverter = PDFToSkillConverter
         self.temp_dir = tempfile.mkdtemp()
 
@@ -314,10 +258,7 @@ class TestCodeBlockHandling(unittest.TestCase):
 
     def test_code_blocks_included_in_references(self):
         """Test that code blocks are included in reference files"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Override skill_dir to use temp directory
@@ -329,22 +270,14 @@ class TestCodeBlockHandling(unittest.TestCase):
                 {
                     "page_number": 1,
                     "text": "Example code",
-                    "code_blocks": [
-                        {
-                            "code": "def hello():\n    print('world')",
-                            "language": "python",
-                            "quality": 8.0
-                        }
-                    ],
-                    "images": []
+                    "code_blocks": [{"code": "def hello():\n    print('world')", "language": "python", "quality": 8.0}],
+                    "images": [],
                 }
             ],
-            "total_pages": 1
+            "total_pages": 1,
         }
 
-        converter.categories = {
-            "examples": [converter.extracted_data["pages"][0]]
-        }
+        converter.categories = {"examples": [converter.extracted_data["pages"][0]]}
 
         converter.build_skill()
 
@@ -358,10 +291,7 @@ class TestCodeBlockHandling(unittest.TestCase):
 
     def test_high_quality_code_preferred(self):
         """Test that high-quality code blocks are prioritized"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Override skill_dir to use temp directory
@@ -375,12 +305,12 @@ class TestCodeBlockHandling(unittest.TestCase):
                     "text": "Code examples",
                     "code_blocks": [
                         {"code": "x = 1", "language": "python", "quality": 2.0},
-                        {"code": "def process():\n    return result", "language": "python", "quality": 9.0}
+                        {"code": "def process():\n    return result", "language": "python", "quality": 9.0},
                     ],
-                    "images": []
+                    "images": [],
                 }
             ],
-            "total_pages": 1
+            "total_pages": 1,
         }
 
         converter.categories = {"examples": [converter.extracted_data["pages"][0]]}
@@ -400,6 +330,7 @@ class TestImageHandling(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
+
         self.PDFToSkillConverter = PDFToSkillConverter
         self.temp_dir = tempfile.mkdtemp()
 
@@ -408,17 +339,14 @@ class TestImageHandling(unittest.TestCase):
 
     def test_images_saved_to_assets(self):
         """Test that images are saved to assets directory"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Override skill_dir to use temp directory
         converter.skill_dir = str(Path(self.temp_dir) / "test_skill")
 
         # Mock image data (1x1 white PNG)
-        mock_image_bytes = b'\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01\x08\x06\x00\x00\x00\x1f\x15\xc4\x89\x00\x00\x00\nIDATx\x9cc\x00\x01\x00\x00\x05\x00\x01\r\n-\xb4\x00\x00\x00\x00IEND\xaeB`\x82'
+        mock_image_bytes = b"\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01\x08\x06\x00\x00\x00\x1f\x15\xc4\x89\x00\x00\x00\nIDATx\x9cc\x00\x01\x00\x00\x05\x00\x01\r\n-\xb4\x00\x00\x00\x00IEND\xaeB`\x82"
 
         converter.extracted_data = {
             "pages": [
@@ -426,18 +354,10 @@ class TestImageHandling(unittest.TestCase):
                     "page_number": 1,
                     "text": "See diagram",
                     "code_blocks": [],
-                    "images": [
-                        {
-                            "page": 1,
-                            "index": 0,
-                            "width": 100,
-                            "height": 100,
-                            "data": mock_image_bytes
-                        }
-                    ]
+                    "images": [{"page": 1, "index": 0, "width": 100, "height": 100, "data": mock_image_bytes}],
                 }
             ],
-            "total_pages": 1
+            "total_pages": 1,
         }
 
         converter.categories = {"diagrams": [converter.extracted_data["pages"][0]]}
@@ -450,16 +370,13 @@ class TestImageHandling(unittest.TestCase):
 
     def test_image_references_in_markdown(self):
         """Test that images are referenced in markdown files"""
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         # Override skill_dir to use temp directory
         converter.skill_dir = str(Path(self.temp_dir) / "test_skill")
 
-        mock_image_bytes = b'\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01\x08\x06\x00\x00\x00\x1f\x15\xc4\x89\x00\x00\x00\nIDATx\x9cc\x00\x01\x00\x00\x05\x00\x01\r\n-\xb4\x00\x00\x00\x00IEND\xaeB`\x82'
+        mock_image_bytes = b"\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01\x08\x06\x00\x00\x00\x1f\x15\xc4\x89\x00\x00\x00\nIDATx\x9cc\x00\x01\x00\x00\x05\x00\x01\r\n-\xb4\x00\x00\x00\x00IEND\xaeB`\x82"
 
         converter.extracted_data = {
             "pages": [
@@ -467,18 +384,10 @@ class TestImageHandling(unittest.TestCase):
                     "page_number": 1,
                     "text": "Architecture diagram",
                     "code_blocks": [],
-                    "images": [
-                        {
-                            "page": 1,
-                            "index": 0,
-                            "width": 200,
-                            "height": 150,
-                            "data": mock_image_bytes
-                        }
-                    ]
+                    "images": [{"page": 1, "index": 0, "width": 200, "height": 150, "data": mock_image_bytes}],
                 }
             ],
-            "total_pages": 1
+            "total_pages": 1,
         }
 
         converter.categories = {"architecture": [converter.extracted_data["pages"][0]]}
@@ -499,6 +408,7 @@ class TestErrorHandling(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
+
         self.PDFToSkillConverter = PDFToSkillConverter
         self.temp_dir = tempfile.mkdtemp()
 
@@ -507,10 +417,7 @@ class TestErrorHandling(unittest.TestCase):
 
     def test_missing_pdf_file(self):
         """Test error when PDF file doesn't exist"""
-        config = {
-            "name": "test",
-            "pdf_path": "nonexistent.pdf"
-        }
+        config = {"name": "test", "pdf_path": "nonexistent.pdf"}
         converter = self.PDFToSkillConverter(config)
 
         with self.assertRaises((FileNotFoundError, RuntimeError)):
@@ -539,6 +446,7 @@ class TestJSONWorkflow(unittest.TestCase):
         if not PYMUPDF_AVAILABLE:
             self.skipTest("PyMuPDF not installed")
         from skill_seekers.cli.pdf_scraper import PDFToSkillConverter
+
         self.PDFToSkillConverter = PDFToSkillConverter
         self.temp_dir = tempfile.mkdtemp()
 
@@ -549,27 +457,15 @@ class TestJSONWorkflow(unittest.TestCase):
         """Test loading extracted data from JSON file"""
         # Create mock extracted JSON
         extracted_data = {
-            "pages": [
-                {
-                    "page_number": 1,
-                    "text": "Test content",
-                    "code_blocks": [],
-                    "images": []
-                }
-            ],
+            "pages": [{"page_number": 1, "text": "Test content", "code_blocks": [], "images": []}],
             "total_pages": 1,
-            "metadata": {
-                "title": "Test PDF"
-            }
+            "metadata": {"title": "Test PDF"},
         }
 
         json_path = Path(self.temp_dir) / "extracted.json"
         json_path.write_text(json.dumps(extracted_data, indent=2))
 
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
         converter.load_extracted_data(str(json_path))
 
@@ -580,16 +476,13 @@ class TestJSONWorkflow(unittest.TestCase):
         """Test that from_json workflow skips PDF extraction"""
         extracted_data = {
             "pages": [{"page_number": 1, "text": "Content", "code_blocks": [], "images": []}],
-            "total_pages": 1
+            "total_pages": 1,
         }
 
         json_path = Path(self.temp_dir) / "extracted.json"
         json_path.write_text(json.dumps(extracted_data))
 
-        config = {
-            "name": "test_skill",
-            "pdf_path": "test.pdf"
-        }
+        config = {"name": "test_skill", "pdf_path": "test.pdf"}
         converter = self.PDFToSkillConverter(config)
         converter.load_extracted_data(str(json_path))
 
@@ -598,5 +491,5 @@ class TestJSONWorkflow(unittest.TestCase):
         self.assertEqual(converter.extracted_data["total_pages"], 1)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_pr144_concerns.py b/tests/test_pr144_concerns.py
index 1c3d4df..169dba9 100644
--- a/tests/test_pr144_concerns.py
+++ b/tests/test_pr144_concerns.py
@@ -4,17 +4,14 @@ Test script to investigate PR #144 concerns
 """
 
 import sys
-import json
-import tempfile
 from pathlib import Path
-from collections import deque
 
 # Add cli to path
-sys.path.insert(0, str(Path(__file__).parent / 'cli'))
+sys.path.insert(0, str(Path(__file__).parent / "cli"))
 
-print("="*60)
+print("=" * 60)
 print("PR #144 CONCERN INVESTIGATION")
-print("="*60)
+print("=" * 60)
 
 ## CONCERN 1: Thread Safety
 print("\n1. THREAD SAFETY ANALYSIS")
@@ -126,9 +123,9 @@ print("\n✓ Process cleanup:")
 print("  - Line 88: communicate() gets remaining output")
 print("  - process.returncode properly captured")
 
-print("\n" + "="*60)
+print("\n" + "=" * 60)
 print("SUMMARY OF FINDINGS")
-print("="*60)
+print("=" * 60)
 
 print("\n🚨 CRITICAL ISSUES FOUND:")
 print("1. Race condition on visited_urls.add() (line 414)")
@@ -146,4 +143,4 @@ print("8. Checkpoint saves are protected")
 print("9. save_page() file I/O protected")
 print("10. Timeout mechanism solid")
 
-print("\n" + "="*60)
+print("\n" + "=" * 60)
diff --git a/tests/test_quality_checker.py b/tests/test_quality_checker.py
index 9342768..19a1bba 100644
--- a/tests/test_quality_checker.py
+++ b/tests/test_quality_checker.py
@@ -3,12 +3,11 @@
 Tests for cli/quality_checker.py functionality
 """
 
-import unittest
 import tempfile
+import unittest
 from pathlib import Path
-import os
 
-from skill_seekers.cli.quality_checker import SkillQualityChecker, QualityReport
+from skill_seekers.cli.quality_checker import QualityReport, SkillQualityChecker
 
 
 class TestQualityChecker(unittest.TestCase):
@@ -21,14 +20,14 @@ class TestQualityChecker(unittest.TestCase):
 
         # Create SKILL.md
         skill_md = skill_dir / "SKILL.md"
-        skill_md.write_text(skill_md_content, encoding='utf-8')
+        skill_md.write_text(skill_md_content, encoding="utf-8")
 
         # Create references directory
         if create_references:
             refs_dir = skill_dir / "references"
             refs_dir.mkdir()
-            (refs_dir / "index.md").write_text("# Index\n\nTest reference.", encoding='utf-8')
-            (refs_dir / "getting_started.md").write_text("# Getting Started\n\nHow to start.", encoding='utf-8')
+            (refs_dir / "index.md").write_text("# Index\n\nTest reference.", encoding="utf-8")
+            (refs_dir / "getting_started.md").write_text("# Getting Started\n\nHow to start.", encoding="utf-8")
 
         return skill_dir
 
@@ -43,7 +42,7 @@ class TestQualityChecker(unittest.TestCase):
 
             # Should have error about missing SKILL.md
             self.assertTrue(report.has_errors)
-            self.assertTrue(any('SKILL.md' in issue.message for issue in report.errors))
+            self.assertTrue(any("SKILL.md" in issue.message for issue in report.errors))
 
     def test_checker_detects_missing_references(self):
         """Test that checker warns about missing references"""
@@ -63,7 +62,7 @@ This is a test.
 
             # Should have warning about missing references
             self.assertTrue(report.has_warnings)
-            self.assertTrue(any('references' in issue.message.lower() for issue in report.warnings))
+            self.assertTrue(any("references" in issue.message.lower() for issue in report.warnings))
 
     def test_checker_detects_invalid_frontmatter(self):
         """Test that checker detects invalid YAML frontmatter"""
@@ -79,7 +78,7 @@ No frontmatter here!
 
             # Should have error about missing frontmatter
             self.assertTrue(report.has_errors)
-            self.assertTrue(any('frontmatter' in issue.message.lower() for issue in report.errors))
+            self.assertTrue(any("frontmatter" in issue.message.lower() for issue in report.errors))
 
     def test_checker_detects_missing_name_field(self):
         """Test that checker detects missing name field in frontmatter"""
@@ -97,7 +96,7 @@ description: test
 
             # Should have error about missing name field
             self.assertTrue(report.has_errors)
-            self.assertTrue(any('name' in issue.message.lower() for issue in report.errors))
+            self.assertTrue(any("name" in issue.message.lower() for issue in report.errors))
 
     def test_checker_detects_code_without_language(self):
         """Test that checker warns about code blocks without language tags"""
@@ -121,7 +120,7 @@ print("hello")
 
             # Should have warning about code without language
             self.assertTrue(report.has_warnings)
-            self.assertTrue(any('language' in issue.message.lower() for issue in report.warnings))
+            self.assertTrue(any("language" in issue.message.lower() for issue in report.warnings))
 
     def test_checker_approves_good_skill(self):
         """Test that checker gives high score to well-formed skill"""
@@ -189,7 +188,7 @@ See [this file](nonexistent.md) for more info.
 
             # Should have warning about broken link
             self.assertTrue(report.has_warnings)
-            self.assertTrue(any('broken link' in issue.message.lower() for issue in report.warnings))
+            self.assertTrue(any("broken link" in issue.message.lower() for issue in report.warnings))
 
     def test_quality_score_calculation(self):
         """Test that quality score is calculated correctly"""
@@ -200,16 +199,16 @@ See [this file](nonexistent.md) for more info.
             self.assertEqual(report.quality_score, 100.0)
 
             # Add an error (should deduct 15 points)
-            report.add_error('test', 'Test error')
+            report.add_error("test", "Test error")
             self.assertEqual(report.quality_score, 85.0)
 
             # Add a warning (should deduct 5 points)
-            report.add_warning('test', 'Test warning')
+            report.add_warning("test", "Test warning")
             self.assertEqual(report.quality_score, 80.0)
 
             # Add more errors
-            report.add_error('test', 'Another error')
-            report.add_error('test', 'Yet another error')
+            report.add_error("test", "Another error")
+            report.add_error("test", "Yet another error")
             self.assertEqual(report.quality_score, 50.0)
 
     def test_quality_grade_calculation(self):
@@ -218,26 +217,26 @@ See [this file](nonexistent.md) for more info.
             report = QualityReport("test", Path(tmpdir))
 
             # Grade A (90-100)
-            self.assertEqual(report.quality_grade, 'A')
+            self.assertEqual(report.quality_grade, "A")
 
             # Grade B (80-89)
-            report.add_error('test', 'Error 1')
-            self.assertEqual(report.quality_grade, 'B')
+            report.add_error("test", "Error 1")
+            self.assertEqual(report.quality_grade, "B")
 
             # Grade C (70-79)
-            report.add_warning('test', 'Warning 1')
-            report.add_warning('test', 'Warning 2')
-            self.assertEqual(report.quality_grade, 'C')
+            report.add_warning("test", "Warning 1")
+            report.add_warning("test", "Warning 2")
+            self.assertEqual(report.quality_grade, "C")
 
             # Grade D (60-69)
-            report.add_warning('test', 'Warning 3')
-            report.add_warning('test', 'Warning 4')
-            self.assertEqual(report.quality_grade, 'D')
+            report.add_warning("test", "Warning 3")
+            report.add_warning("test", "Warning 4")
+            self.assertEqual(report.quality_grade, "D")
 
             # Grade F (below 60)
-            report.add_error('test', 'Error 2')
-            report.add_error('test', 'Error 3')
-            self.assertEqual(report.quality_grade, 'F')
+            report.add_error("test", "Error 2")
+            report.add_error("test", "Error 3")
+            self.assertEqual(report.quality_grade, "F")
 
     def test_is_excellent_property(self):
         """Test is_excellent property"""
@@ -248,13 +247,13 @@ See [this file](nonexistent.md) for more info.
             self.assertTrue(report.is_excellent)
 
             # Adding an error should make it not excellent
-            report.add_error('test', 'Test error')
+            report.add_error("test", "Test error")
             self.assertFalse(report.is_excellent)
 
             # Clean report
             report2 = QualityReport("test", Path(tmpdir))
             # Adding a warning should also make it not excellent
-            report2.add_warning('test', 'Test warning')
+            report2.add_warning("test", "Test warning")
             self.assertFalse(report2.is_excellent)
 
 
@@ -268,12 +267,12 @@ class TestCompletenessChecks(unittest.TestCase):
 
         # Create SKILL.md
         skill_md = skill_dir / "SKILL.md"
-        skill_md.write_text(skill_md_content, encoding='utf-8')
+        skill_md.write_text(skill_md_content, encoding="utf-8")
 
         # Create references directory
         refs_dir = skill_dir / "references"
         refs_dir.mkdir()
-        (refs_dir / "index.md").write_text("# Index\n", encoding='utf-8')
+        (refs_dir / "index.md").write_text("# Index\n", encoding="utf-8")
 
         return skill_dir
 
@@ -302,9 +301,13 @@ Run the command.
             report = checker.check_all()
 
             # Should have info about found prerequisites
-            completeness_infos = [i for i in report.info if i.category == 'completeness']
-            self.assertTrue(any('prerequisites' in i.message.lower() or 'verification' in i.message.lower()
-                               for i in completeness_infos))
+            completeness_infos = [i for i in report.info if i.category == "completeness"]
+            self.assertTrue(
+                any(
+                    "prerequisites" in i.message.lower() or "verification" in i.message.lower()
+                    for i in completeness_infos
+                )
+            )
 
     def test_checker_detects_troubleshooting_section(self):
         """Test that checker detects troubleshooting section"""
@@ -331,9 +334,13 @@ If the command fails, check your permissions.
             report = checker.check_all()
 
             # Should have info about found troubleshooting
-            completeness_infos = [i for i in report.info if i.category == 'completeness']
-            self.assertTrue(any('troubleshoot' in i.message.lower() or 'error handling' in i.message.lower()
-                               for i in completeness_infos))
+            completeness_infos = [i for i in report.info if i.category == "completeness"]
+            self.assertTrue(
+                any(
+                    "troubleshoot" in i.message.lower() or "error handling" in i.message.lower()
+                    for i in completeness_infos
+                )
+            )
 
     def test_checker_detects_workflow_steps(self):
         """Test that checker detects workflow steps"""
@@ -360,9 +367,10 @@ Finally, verify the installation.
             report = checker.check_all()
 
             # Should have info about found workflow steps
-            completeness_infos = [i for i in report.info if i.category == 'completeness']
-            self.assertTrue(any('workflow' in i.message.lower() or 'step' in i.message.lower()
-                               for i in completeness_infos))
+            completeness_infos = [i for i in report.info if i.category == "completeness"]
+            self.assertTrue(
+                any("workflow" in i.message.lower() or "step" in i.message.lower() for i in completeness_infos)
+            )
 
     def test_checker_suggests_adding_prerequisites(self):
         """Test that checker suggests adding prerequisites when missing"""
@@ -383,9 +391,12 @@ Just run the command.
             report = checker.check_all()
 
             # Should have info suggesting prerequisites
-            completeness_infos = [i for i in report.info if i.category == 'completeness']
-            self.assertTrue(any('consider' in i.message.lower() and 'prerequisites' in i.message.lower()
-                               for i in completeness_infos))
+            completeness_infos = [i for i in report.info if i.category == "completeness"]
+            self.assertTrue(
+                any(
+                    "consider" in i.message.lower() and "prerequisites" in i.message.lower() for i in completeness_infos
+                )
+            )
 
 
 class TestQualityCheckerCLI(unittest.TestCase):
@@ -397,15 +408,15 @@ class TestQualityCheckerCLI(unittest.TestCase):
 
         try:
             result = subprocess.run(
-                ['python3', '-m', 'skill_seekers.cli.quality_checker', '--help'],
+                ["python3", "-m", "skill_seekers.cli.quality_checker", "--help"],
                 capture_output=True,
                 text=True,
-                timeout=5
+                timeout=5,
             )
 
             # Should include usage info
             output = result.stdout + result.stderr
-            self.assertTrue('usage:' in output.lower() or 'quality' in output.lower())
+            self.assertTrue("usage:" in output.lower() or "quality" in output.lower())
         except FileNotFoundError:
             self.skipTest("Module not installed")
 
@@ -414,14 +425,12 @@ class TestQualityCheckerCLI(unittest.TestCase):
         import subprocess
 
         result = subprocess.run(
-            ['python3', '-m', 'skill_seekers.cli.quality_checker', '/nonexistent/path'],
-            capture_output=True,
-            text=True
+            ["python3", "-m", "skill_seekers.cli.quality_checker", "/nonexistent/path"], capture_output=True, text=True
         )
 
         # Should fail
         self.assertNotEqual(result.returncode, 0)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_rate_limit_handler.py b/tests/test_rate_limit_handler.py
index 27d35d5..5089a53 100644
--- a/tests/test_rate_limit_handler.py
+++ b/tests/test_rate_limit_handler.py
@@ -4,13 +4,13 @@ Tests for Rate Limit Handler
 Tests the smart rate limit detection and handling system.
 """
 
-import pytest
-from unittest.mock import Mock, patch
 from datetime import datetime, timedelta
-import requests
+from unittest.mock import Mock, patch
+
+import pytest
 
-from skill_seekers.cli.rate_limit_handler import RateLimitHandler, RateLimitError, create_github_headers
 from skill_seekers.cli.config_manager import ConfigManager
+from skill_seekers.cli.rate_limit_handler import RateLimitError, RateLimitHandler, create_github_headers
 
 
 class TestRateLimitHandler:
@@ -40,16 +40,12 @@ class TestRateLimitHandler:
         assert handler.token == "ghp_test"
         assert handler.interactive is False
 
-    @patch('skill_seekers.cli.rate_limit_handler.get_config_manager')
+    @patch("skill_seekers.cli.rate_limit_handler.get_config_manager")
     def test_init_with_config_strategy(self, mock_get_config):
         """Test initialization pulls strategy from config."""
         mock_config = Mock()
         mock_config.config = {
-            "rate_limit": {
-                "auto_switch_profiles": True,
-                "show_countdown": True,
-                "default_timeout_minutes": 30
-            }
+            "rate_limit": {"auto_switch_profiles": True, "show_countdown": True, "default_timeout_minutes": 30}
         }
         mock_config.get_rate_limit_strategy.return_value = "wait"
         mock_config.get_timeout_minutes.return_value = 45
@@ -68,19 +64,19 @@ class TestRateLimitHandler:
         mock_response = Mock()
         reset_time = int((datetime.now() + timedelta(minutes=30)).timestamp())
         mock_response.headers = {
-            'X-RateLimit-Limit': '5000',
-            'X-RateLimit-Remaining': '100',
-            'X-RateLimit-Reset': str(reset_time)
+            "X-RateLimit-Limit": "5000",
+            "X-RateLimit-Remaining": "100",
+            "X-RateLimit-Reset": str(reset_time),
         }
 
         info = handler.extract_rate_limit_info(mock_response)
 
-        assert info['limit'] == 5000
-        assert info['remaining'] == 100
-        assert info['reset_timestamp'] == reset_time
-        assert isinstance(info['reset_time'], datetime)
+        assert info["limit"] == 5000
+        assert info["remaining"] == 100
+        assert info["reset_timestamp"] == reset_time
+        assert isinstance(info["reset_time"], datetime)
 
-    @patch('builtins.input', return_value='n')
+    @patch("builtins.input", return_value="n")
     def test_check_upfront_no_token_declined(self, mock_input):
         """Test upfront check with no token, user declines."""
         handler = RateLimitHandler(token=None, interactive=True)
@@ -90,7 +86,7 @@ class TestRateLimitHandler:
         assert result is False
         mock_input.assert_called_once()
 
-    @patch('builtins.input', return_value='y')
+    @patch("builtins.input", return_value="y")
     def test_check_upfront_no_token_accepted(self, mock_input):
         """Test upfront check with no token, user accepts."""
         handler = RateLimitHandler(token=None, interactive=True)
@@ -109,18 +105,14 @@ class TestRateLimitHandler:
         # Should proceed without prompting
         assert result is True
 
-    @patch('requests.get')
-    @patch('skill_seekers.cli.rate_limit_handler.get_config_manager')
+    @patch("requests.get")
+    @patch("skill_seekers.cli.rate_limit_handler.get_config_manager")
     def test_check_upfront_with_token_good_status(self, mock_get_config, mock_get):
         """Test upfront check with token and good rate limit status."""
         # Mock config
         mock_config = Mock()
         mock_config.config = {
-            "rate_limit": {
-                "auto_switch_profiles": False,
-                "show_countdown": True,
-                "default_timeout_minutes": 30
-            }
+            "rate_limit": {"auto_switch_profiles": False, "show_countdown": True, "default_timeout_minutes": 30}
         }
         mock_config.get_rate_limit_strategy.return_value = "prompt"
         mock_config.get_timeout_minutes.return_value = 30
@@ -129,13 +121,7 @@ class TestRateLimitHandler:
         # Mock rate limit check
         reset_time = int((datetime.now() + timedelta(minutes=60)).timestamp())
         mock_response = Mock()
-        mock_response.json.return_value = {
-            'rate': {
-                'limit': 5000,
-                'remaining': 4500,
-                'reset': reset_time
-            }
-        }
+        mock_response.json.return_value = {"rate": {"limit": 5000, "remaining": 4500, "reset": reset_time}}
         mock_response.raise_for_status = Mock()
         mock_get.return_value = mock_response
 
@@ -161,24 +147,18 @@ class TestRateLimitHandler:
 
         mock_response = Mock()
         mock_response.status_code = 403
-        mock_response.json.return_value = {
-            'message': 'Forbidden - not rate limit'
-        }
+        mock_response.json.return_value = {"message": "Forbidden - not rate limit"}
 
         result = handler.check_response(mock_response)
 
         assert result is True
 
-    @patch('skill_seekers.cli.rate_limit_handler.get_config_manager')
+    @patch("skill_seekers.cli.rate_limit_handler.get_config_manager")
     def test_non_interactive_fail_strategy(self, mock_get_config):
         """Test non-interactive mode with fail strategy raises error."""
         mock_config = Mock()
         mock_config.config = {
-            "rate_limit": {
-                "auto_switch_profiles": False,
-                "show_countdown": True,
-                "default_timeout_minutes": 30
-            }
+            "rate_limit": {"auto_switch_profiles": False, "show_countdown": True, "default_timeout_minutes": 30}
         }
         mock_config.get_rate_limit_strategy.return_value = "fail"
         mock_config.get_timeout_minutes.return_value = 30
@@ -187,11 +167,7 @@ class TestRateLimitHandler:
         handler = RateLimitHandler(token="ghp_test", interactive=False)
 
         reset_time = datetime.now() + timedelta(minutes=30)
-        rate_info = {
-            'limit': 5000,
-            'remaining': 0,
-            'reset_time': reset_time
-        }
+        rate_info = {"limit": 5000, "remaining": 0, "reset_time": reset_time}
 
         with pytest.raises(RateLimitError):
             handler.handle_rate_limit(rate_info)
@@ -243,7 +219,7 @@ class TestConfigManagerIntegration:
             description="Test profile",
             rate_limit_strategy="wait",
             timeout_minutes=45,
-            set_as_default=True
+            set_as_default=True,
         )
 
         # Retrieve token
diff --git a/tests/test_real_world_fastmcp.py b/tests/test_real_world_fastmcp.py
index 81e9999..0db1e7d 100644
--- a/tests/test_real_world_fastmcp.py
+++ b/tests/test_real_world_fastmcp.py
@@ -15,12 +15,12 @@ Validates:
 This is a comprehensive E2E test that exercises the entire system.
 """
 
-import os
 import json
-import tempfile
-import pytest
-from pathlib import Path
+import os
 from datetime import datetime
+from pathlib import Path
+
+import pytest
 
 # Mark as integration test (slow)
 pytestmark = pytest.mark.integration
@@ -41,12 +41,12 @@ class TestRealWorldFastMCP:
     @pytest.fixture(scope="class")
     def github_token(self):
         """Get GitHub token from environment (optional)."""
-        token = os.getenv('GITHUB_TOKEN')
+        token = os.getenv("GITHUB_TOKEN")
         if token:
-            print(f"\n✅ GitHub token found - using authenticated API")
+            print("\n✅ GitHub token found - using authenticated API")
         else:
-            print(f"\n⚠️  No GitHub token - using public API (lower rate limits)")
-            print(f"   Set GITHUB_TOKEN environment variable for higher rate limits")
+            print("\n⚠️  No GitHub token - using public API (lower rate limits)")
+            print("   Set GITHUB_TOKEN environment variable for higher rate limits")
         return token
 
     @pytest.fixture(scope="class")
@@ -66,13 +66,13 @@ class TestRealWorldFastMCP:
         """
         from skill_seekers.cli.unified_codebase_analyzer import UnifiedCodebaseAnalyzer
 
-        print(f"\n{'='*80}")
-        print(f"🚀 REAL-WORLD TEST: FastMCP GitHub Repository")
-        print(f"{'='*80}")
-        print(f"Repository: https://github.com/jlowin/fastmcp")
+        print(f"\n{'=' * 80}")
+        print("🚀 REAL-WORLD TEST: FastMCP GitHub Repository")
+        print(f"{'=' * 80}")
+        print("Repository: https://github.com/jlowin/fastmcp")
         print(f"Test started: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
         print(f"Output: {output_dir}")
-        print(f"{'='*80}\n")
+        print(f"{'=' * 80}\n")
 
         # Run unified analyzer with C3.x depth
         analyzer = UnifiedCodebaseAnalyzer(github_token=github_token)
@@ -80,10 +80,10 @@ class TestRealWorldFastMCP:
         try:
             # Start with basic analysis (fast) to verify three-stream architecture
             # Can be changed to "c3x" for full analysis (20-60 minutes)
-            depth_mode = os.getenv('TEST_DEPTH', 'basic')  # Use 'basic' for quick test, 'c3x' for full
+            depth_mode = os.getenv("TEST_DEPTH", "basic")  # Use 'basic' for quick test, 'c3x' for full
 
             print(f"📊 Analysis depth: {depth_mode}")
-            if depth_mode == 'basic':
+            if depth_mode == "basic":
                 print("   (Set TEST_DEPTH=c3x environment variable for full C3.x analysis)")
             print()
 
@@ -91,11 +91,11 @@ class TestRealWorldFastMCP:
                 source="https://github.com/jlowin/fastmcp",
                 depth=depth_mode,
                 fetch_github_metadata=True,
-                output_dir=output_dir
+                output_dir=output_dir,
             )
 
-            print(f"\n✅ Analysis complete!")
-            print(f"{'='*80}\n")
+            print("\n✅ Analysis complete!")
+            print(f"{'=' * 80}\n")
 
             return result
 
@@ -104,24 +104,24 @@ class TestRealWorldFastMCP:
 
     def test_01_three_streams_present(self, fastmcp_analysis):
         """Test that all 3 streams are present and populated."""
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("TEST 1: Verify All 3 Streams Present")
-        print("="*80)
+        print("=" * 80)
 
         result = fastmcp_analysis
 
         # Verify result structure
         assert result is not None, "Analysis result is None"
-        assert result.source_type == 'github', f"Expected source_type 'github', got '{result.source_type}'"
+        assert result.source_type == "github", f"Expected source_type 'github', got '{result.source_type}'"
         # Depth can be 'basic' or 'c3x' depending on TEST_DEPTH env var
-        assert result.analysis_depth in ['basic', 'c3x'], f"Invalid depth '{result.analysis_depth}'"
+        assert result.analysis_depth in ["basic", "c3x"], f"Invalid depth '{result.analysis_depth}'"
         print(f"\n📊 Analysis depth: {result.analysis_depth}")
 
         # STREAM 1: Code Analysis
         print("\n📊 STREAM 1: Code Analysis")
         assert result.code_analysis is not None, "Code analysis missing"
-        assert 'files' in result.code_analysis, "Files list missing from code analysis"
-        files = result.code_analysis['files']
+        assert "files" in result.code_analysis, "Files list missing from code analysis"
+        files = result.code_analysis["files"]
         print(f"   ✅ Files analyzed: {len(files)}")
         assert len(files) > 0, "No files found in code analysis"
 
@@ -129,29 +129,29 @@ class TestRealWorldFastMCP:
         print("\n📄 STREAM 2: GitHub Documentation")
         assert result.github_docs is not None, "GitHub docs missing"
 
-        readme = result.github_docs.get('readme')
+        readme = result.github_docs.get("readme")
         assert readme is not None, "README missing from GitHub docs"
         print(f"   ✅ README length: {len(readme)} chars")
         assert len(readme) > 100, "README too short (< 100 chars)"
-        assert 'fastmcp' in readme.lower() or 'mcp' in readme.lower(), "README doesn't mention FastMCP/MCP"
+        assert "fastmcp" in readme.lower() or "mcp" in readme.lower(), "README doesn't mention FastMCP/MCP"
 
-        contributing = result.github_docs.get('contributing')
+        contributing = result.github_docs.get("contributing")
         if contributing:
             print(f"   ✅ CONTRIBUTING.md length: {len(contributing)} chars")
 
-        docs_files = result.github_docs.get('docs_files', [])
+        docs_files = result.github_docs.get("docs_files", [])
         print(f"   ✅ Additional docs files: {len(docs_files)}")
 
         # STREAM 3: GitHub Insights
         print("\n🐛 STREAM 3: GitHub Insights")
         assert result.github_insights is not None, "GitHub insights missing"
 
-        metadata = result.github_insights.get('metadata', {})
+        metadata = result.github_insights.get("metadata", {})
         assert metadata, "Metadata missing from GitHub insights"
 
-        stars = metadata.get('stars', 0)
-        language = metadata.get('language', 'Unknown')
-        description = metadata.get('description', '')
+        stars = metadata.get("stars", 0)
+        language = metadata.get("language", "Unknown")
+        description = metadata.get("description", "")
 
         print(f"   ✅ Stars: {stars}")
         print(f"   ✅ Language: {language}")
@@ -160,9 +160,9 @@ class TestRealWorldFastMCP:
         assert stars >= 0, "Stars count invalid"
         assert language, "Language not detected"
 
-        common_problems = result.github_insights.get('common_problems', [])
-        known_solutions = result.github_insights.get('known_solutions', [])
-        top_labels = result.github_insights.get('top_labels', [])
+        common_problems = result.github_insights.get("common_problems", [])
+        known_solutions = result.github_insights.get("known_solutions", [])
+        top_labels = result.github_insights.get("top_labels", [])
 
         print(f"   ✅ Common problems: {len(common_problems)}")
         print(f"   ✅ Known solutions: {len(known_solutions)}")
@@ -172,15 +172,15 @@ class TestRealWorldFastMCP:
 
     def test_02_c3x_components_populated(self, fastmcp_analysis):
         """Test that C3.x components have ACTUAL data (not placeholders)."""
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("TEST 2: Verify C3.x Components Populated (NOT Placeholders)")
-        print("="*80)
+        print("=" * 80)
 
         result = fastmcp_analysis
         code_analysis = result.code_analysis
 
         # Skip C3.x checks if running in basic mode
-        if result.analysis_depth == 'basic':
+        if result.analysis_depth == "basic":
             print("\n⚠️  Skipping C3.x component checks (running in basic mode)")
             print("   Set TEST_DEPTH=c3x to run full C3.x analysis")
             pytest.skip("C3.x analysis not run in basic mode")
@@ -189,50 +189,50 @@ class TestRealWorldFastMCP:
         print("\n🔍 Checking C3.x Components:")
 
         # C3.1: Design Patterns
-        c3_1 = code_analysis.get('c3_1_patterns', [])
-        print(f"\n   C3.1 - Design Patterns:")
+        c3_1 = code_analysis.get("c3_1_patterns", [])
+        print("\n   C3.1 - Design Patterns:")
         print(f"   ✅ Count: {len(c3_1)}")
         if len(c3_1) > 0:
             print(f"   ✅ Sample: {c3_1[0].get('name', 'N/A')} ({c3_1[0].get('count', 0)} instances)")
             # Verify it's not empty/placeholder
-            assert c3_1[0].get('name'), "Pattern has no name"
-            assert c3_1[0].get('count', 0) > 0, "Pattern has zero count"
+            assert c3_1[0].get("name"), "Pattern has no name"
+            assert c3_1[0].get("count", 0) > 0, "Pattern has zero count"
         else:
-            print(f"   ⚠️  No patterns detected (may be valid for small repos)")
+            print("   ⚠️  No patterns detected (may be valid for small repos)")
 
         # C3.2: Test Examples
-        c3_2 = code_analysis.get('c3_2_examples', [])
-        c3_2_count = code_analysis.get('c3_2_examples_count', 0)
-        print(f"\n   C3.2 - Test Examples:")
+        c3_2 = code_analysis.get("c3_2_examples", [])
+        c3_2_count = code_analysis.get("c3_2_examples_count", 0)
+        print("\n   C3.2 - Test Examples:")
         print(f"   ✅ Count: {c3_2_count}")
         if len(c3_2) > 0:
             # C3.2 examples use 'test_name' and 'file_path' fields
-            test_name = c3_2[0].get('test_name', c3_2[0].get('name', 'N/A'))
-            file_path = c3_2[0].get('file_path', c3_2[0].get('file', 'N/A'))
+            test_name = c3_2[0].get("test_name", c3_2[0].get("name", "N/A"))
+            file_path = c3_2[0].get("file_path", c3_2[0].get("file", "N/A"))
             print(f"   ✅ Sample: {test_name} from {file_path}")
             # Verify it's not empty/placeholder
-            assert test_name and test_name != 'N/A', "Example has no test_name"
-            assert file_path and file_path != 'N/A', "Example has no file_path"
+            assert test_name and test_name != "N/A", "Example has no test_name"
+            assert file_path and file_path != "N/A", "Example has no file_path"
         else:
-            print(f"   ⚠️  No test examples found")
+            print("   ⚠️  No test examples found")
 
         # C3.3: How-to Guides
-        c3_3 = code_analysis.get('c3_3_guides', [])
-        print(f"\n   C3.3 - How-to Guides:")
+        c3_3 = code_analysis.get("c3_3_guides", [])
+        print("\n   C3.3 - How-to Guides:")
         print(f"   ✅ Count: {len(c3_3)}")
         if len(c3_3) > 0:
             print(f"   ✅ Sample: {c3_3[0].get('title', 'N/A')}")
 
         # C3.4: Config Patterns
-        c3_4 = code_analysis.get('c3_4_configs', [])
-        print(f"\n   C3.4 - Config Patterns:")
+        c3_4 = code_analysis.get("c3_4_configs", [])
+        print("\n   C3.4 - Config Patterns:")
         print(f"   ✅ Count: {len(c3_4)}")
         if len(c3_4) > 0:
             print(f"   ✅ Sample: {c3_4[0].get('file', 'N/A')}")
 
         # C3.7: Architecture
-        c3_7 = code_analysis.get('c3_7_architecture', [])
-        print(f"\n   C3.7 - Architecture:")
+        c3_7 = code_analysis.get("c3_7_architecture", [])
+        print("\n   C3.7 - Architecture:")
         print(f"   ✅ Count: {len(c3_7)}")
         if len(c3_7) > 0:
             print(f"   ✅ Sample: {c3_7[0].get('pattern', 'N/A')}")
@@ -243,66 +243,66 @@ class TestRealWorldFastMCP:
 
         print(f"\n📊 Total C3.x items: {total_c3x_items}")
 
-        assert total_c3x_items > 0, \
+        assert total_c3x_items > 0, (
             "❌ CRITICAL: No C3.x data found! This suggests placeholders are being used instead of actual analysis."
+        )
 
         print("\n✅ C3.x components verified - ACTUAL data present (not placeholders)!\n")
 
     def test_03_router_generation(self, fastmcp_analysis, output_dir):
         """Test router generation with GitHub integration."""
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("TEST 3: Router Generation with GitHub Integration")
-        print("="*80)
+        print("=" * 80)
 
         from skill_seekers.cli.generate_router import RouterGenerator
-        from skill_seekers.cli.github_fetcher import ThreeStreamData, CodeStream, DocsStream, InsightsStream
+        from skill_seekers.cli.github_fetcher import CodeStream, DocsStream, InsightsStream, ThreeStreamData
 
         result = fastmcp_analysis
 
         # Create mock sub-skill configs
         config1 = output_dir / "fastmcp-oauth.json"
-        config1.write_text(json.dumps({
-            "name": "fastmcp-oauth",
-            "description": "OAuth authentication for FastMCP",
-            "categories": {
-                "oauth": ["oauth", "auth", "provider", "google", "azure"]
-            }
-        }))
+        config1.write_text(
+            json.dumps(
+                {
+                    "name": "fastmcp-oauth",
+                    "description": "OAuth authentication for FastMCP",
+                    "categories": {"oauth": ["oauth", "auth", "provider", "google", "azure"]},
+                }
+            )
+        )
 
         config2 = output_dir / "fastmcp-async.json"
-        config2.write_text(json.dumps({
-            "name": "fastmcp-async",
-            "description": "Async patterns for FastMCP",
-            "categories": {
-                "async": ["async", "await", "asyncio"]
-            }
-        }))
+        config2.write_text(
+            json.dumps(
+                {
+                    "name": "fastmcp-async",
+                    "description": "Async patterns for FastMCP",
+                    "categories": {"async": ["async", "await", "asyncio"]},
+                }
+            )
+        )
 
         # Reconstruct ThreeStreamData from result
         github_streams = ThreeStreamData(
-            code_stream=CodeStream(
-                directory=Path(output_dir),
-                files=[]
-            ),
+            code_stream=CodeStream(directory=Path(output_dir), files=[]),
             docs_stream=DocsStream(
-                readme=result.github_docs.get('readme'),
-                contributing=result.github_docs.get('contributing'),
-                docs_files=result.github_docs.get('docs_files', [])
+                readme=result.github_docs.get("readme"),
+                contributing=result.github_docs.get("contributing"),
+                docs_files=result.github_docs.get("docs_files", []),
             ),
             insights_stream=InsightsStream(
-                metadata=result.github_insights.get('metadata', {}),
-                common_problems=result.github_insights.get('common_problems', []),
-                known_solutions=result.github_insights.get('known_solutions', []),
-                top_labels=result.github_insights.get('top_labels', [])
-            )
+                metadata=result.github_insights.get("metadata", {}),
+                common_problems=result.github_insights.get("common_problems", []),
+                known_solutions=result.github_insights.get("known_solutions", []),
+                top_labels=result.github_insights.get("top_labels", []),
+            ),
         )
 
         # Generate router
         print("\n🧭 Generating router...")
         generator = RouterGenerator(
-            config_paths=[str(config1), str(config2)],
-            router_name="fastmcp",
-            github_streams=github_streams
+            config_paths=[str(config1), str(config2)], router_name="fastmcp", github_streams=github_streams
         )
 
         skill_md = generator.generate_skill_md()
@@ -317,21 +317,21 @@ class TestRealWorldFastMCP:
 
         # Check basic structure
         assert "fastmcp" in skill_md.lower(), "Router doesn't mention FastMCP"
-        print(f"   ✅ Contains 'fastmcp'")
+        print("   ✅ Contains 'fastmcp'")
 
         # Check GitHub metadata
         if "Repository:" in skill_md or "github.com" in skill_md:
-            print(f"   ✅ Contains repository URL")
+            print("   ✅ Contains repository URL")
 
         if "⭐" in skill_md or "Stars:" in skill_md:
-            print(f"   ✅ Contains star count")
+            print("   ✅ Contains star count")
 
-        if "Python" in skill_md or result.github_insights['metadata'].get('language') in skill_md:
-            print(f"   ✅ Contains language")
+        if "Python" in skill_md or result.github_insights["metadata"].get("language") in skill_md:
+            print("   ✅ Contains language")
 
         # Check README content
         if "Quick Start" in skill_md or "README" in skill_md:
-            print(f"   ✅ Contains README quick start")
+            print("   ✅ Contains README quick start")
 
         # Check common issues
         if "Common Issues" in skill_md or "Issue #" in skill_md:
@@ -340,28 +340,28 @@ class TestRealWorldFastMCP:
 
         # Check routing
         if "fastmcp-oauth" in skill_md:
-            print(f"   ✅ Contains sub-skill routing")
+            print("   ✅ Contains sub-skill routing")
 
         # Measure router size
-        router_lines = len(skill_md.split('\n'))
+        router_lines = len(skill_md.split("\n"))
         print(f"\n📏 Router size: {router_lines} lines")
 
         # Architecture target: 60-250 lines
         # With GitHub integration: expect higher end of range
         if router_lines < 60:
-            print(f"   ⚠️  Router smaller than target (60-250 lines)")
+            print("   ⚠️  Router smaller than target (60-250 lines)")
         elif router_lines > 250:
-            print(f"   ⚠️  Router larger than target (60-250 lines)")
+            print("   ⚠️  Router larger than target (60-250 lines)")
         else:
-            print(f"   ✅ Router size within target range")
+            print("   ✅ Router size within target range")
 
         print("\n✅ Router generation verified!\n")
 
     def test_04_quality_metrics(self, fastmcp_analysis, output_dir):
         """Test that quality metrics meet architecture targets."""
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("TEST 4: Quality Metrics Validation")
-        print("="*80)
+        print("=" * 80)
 
         result = fastmcp_analysis
 
@@ -372,47 +372,47 @@ class TestRealWorldFastMCP:
         # Estimate GitHub overhead from insights
         metadata_lines = 3  # Repository, Stars, Language
         readme_estimate = 10  # Quick start section
-        issue_count = len(result.github_insights.get('common_problems', []))
+        issue_count = len(result.github_insights.get("common_problems", []))
         issue_lines = min(issue_count * 3, 25)  # Max 5 issues shown
 
         total_overhead = metadata_lines + readme_estimate + issue_lines
         print(f"   Estimated: {total_overhead} lines")
 
         if 20 <= total_overhead <= 60:
-            print(f"   ✅ Within target range")
+            print("   ✅ Within target range")
         else:
-            print(f"   ⚠️  Outside target range (may be acceptable)")
+            print("   ⚠️  Outside target range (may be acceptable)")
 
         # Metric 2: Data Quality
         print("\n📊 Metric 2: Data Quality")
 
-        code_files = len(result.code_analysis.get('files', []))
+        code_files = len(result.code_analysis.get("files", []))
         print(f"   Code files: {code_files}")
         assert code_files > 0, "No code files found"
-        print(f"   ✅ Code files present")
+        print("   ✅ Code files present")
 
-        readme_len = len(result.github_docs.get('readme', ''))
+        readme_len = len(result.github_docs.get("readme", ""))
         print(f"   README length: {readme_len} chars")
         assert readme_len > 100, "README too short"
-        print(f"   ✅ README has content")
+        print("   ✅ README has content")
 
-        stars = result.github_insights['metadata'].get('stars', 0)
+        stars = result.github_insights["metadata"].get("stars", 0)
         print(f"   Repository stars: {stars}")
-        print(f"   ✅ Metadata present")
+        print("   ✅ Metadata present")
 
         # Metric 3: C3.x Coverage
         print("\n📊 Metric 3: C3.x Coverage")
 
-        if result.analysis_depth == 'basic':
+        if result.analysis_depth == "basic":
             print("   ⚠️  Running in basic mode - C3.x components not analyzed")
             print("   Set TEST_DEPTH=c3x to enable C3.x analysis")
         else:
             c3x_components = {
-                'Patterns': len(result.code_analysis.get('c3_1_patterns', [])),
-                'Examples': result.code_analysis.get('c3_2_examples_count', 0),
-                'Guides': len(result.code_analysis.get('c3_3_guides', [])),
-                'Configs': len(result.code_analysis.get('c3_4_configs', [])),
-                'Architecture': len(result.code_analysis.get('c3_7_architecture', []))
+                "Patterns": len(result.code_analysis.get("c3_1_patterns", [])),
+                "Examples": result.code_analysis.get("c3_2_examples_count", 0),
+                "Guides": len(result.code_analysis.get("c3_3_guides", [])),
+                "Configs": len(result.code_analysis.get("c3_4_configs", [])),
+                "Architecture": len(result.code_analysis.get("c3_7_architecture", [])),
             }
 
             for name, count in c3x_components.items():
@@ -422,15 +422,15 @@ class TestRealWorldFastMCP:
             total_c3x = sum(c3x_components.values())
             print(f"   Total C3.x items: {total_c3x}")
             assert total_c3x > 0, "No C3.x data extracted"
-            print(f"   ✅ C3.x analysis successful")
+            print("   ✅ C3.x analysis successful")
 
         print("\n✅ Quality metrics validated!\n")
 
     def test_05_skill_quality_assessment(self, output_dir):
         """Manual quality assessment of generated router skill."""
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("TEST 5: Skill Quality Assessment")
-        print("="*80)
+        print("=" * 80)
 
         router_file = output_dir / "fastmcp_router_SKILL.md"
 
@@ -442,32 +442,32 @@ class TestRealWorldFastMCP:
         print("\n📝 Quality Checklist:")
 
         # 1. Has frontmatter
-        has_frontmatter = content.startswith('---')
+        has_frontmatter = content.startswith("---")
         print(f"   {'✅' if has_frontmatter else '❌'} Has YAML frontmatter")
 
         # 2. Has main heading
-        has_heading = '# ' in content
+        has_heading = "# " in content
         print(f"   {'✅' if has_heading else '❌'} Has main heading")
 
         # 3. Has sections
-        section_count = content.count('## ')
+        section_count = content.count("## ")
         print(f"   {'✅' if section_count >= 3 else '❌'} Has {section_count} sections (need 3+)")
 
         # 4. Has code blocks
-        code_block_count = content.count('```')
+        code_block_count = content.count("```")
         has_code = code_block_count >= 2
         print(f"   {'✅' if has_code else '⚠️ '} Has {code_block_count // 2} code blocks")
 
         # 5. No placeholders
-        no_todos = 'TODO' not in content and '[Add' not in content
+        no_todos = "TODO" not in content and "[Add" not in content
         print(f"   {'✅' if no_todos else '❌'} No TODO placeholders")
 
         # 6. Has GitHub content
-        has_github = any(marker in content for marker in ['Repository:', '⭐', 'Issue #', 'github.com'])
+        has_github = any(marker in content for marker in ["Repository:", "⭐", "Issue #", "github.com"])
         print(f"   {'✅' if has_github else '⚠️ '} Has GitHub integration")
 
         # 7. Has routing
-        has_routing = 'skill' in content.lower() and 'use' in content.lower()
+        has_routing = "skill" in content.lower() and "use" in content.lower()
         print(f"   {'✅' if has_routing else '⚠️ '} Has routing guidance")
 
         # Calculate quality score
@@ -477,13 +477,13 @@ class TestRealWorldFastMCP:
         print(f"\n📊 Quality Score: {score:.0f}%")
 
         if score >= 85:
-            print(f"   ✅ Excellent quality")
+            print("   ✅ Excellent quality")
         elif score >= 70:
-            print(f"   ✅ Good quality")
+            print("   ✅ Good quality")
         elif score >= 50:
-            print(f"   ⚠️  Acceptable quality")
+            print("   ⚠️  Acceptable quality")
         else:
-            print(f"   ❌ Poor quality")
+            print("   ❌ Poor quality")
 
         assert score >= 50, f"Quality score too low: {score}%"
 
@@ -491,14 +491,14 @@ class TestRealWorldFastMCP:
 
     def test_06_final_report(self, fastmcp_analysis, output_dir):
         """Generate final test report."""
-        print("\n" + "="*80)
+        print("\n" + "=" * 80)
         print("FINAL REPORT: Real-World FastMCP Test")
-        print("="*80)
+        print("=" * 80)
 
         result = fastmcp_analysis
 
         print("\n📊 Summary:")
-        print(f"   Repository: https://github.com/jlowin/fastmcp")
+        print("   Repository: https://github.com/jlowin/fastmcp")
         print(f"   Analysis: {result.analysis_depth}")
         print(f"   Source type: {result.source_type}")
         print(f"   Test completed: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
@@ -516,17 +516,17 @@ class TestRealWorldFastMCP:
         print(f"   ✅ Architecture: {len(result.code_analysis.get('c3_7_architecture', []))}")
 
         print("\n✅ Quality Metrics:")
-        print(f"   ✅ All 3 streams present and populated")
-        print(f"   ✅ C3.x actual data (not placeholders)")
-        print(f"   ✅ Router generated with GitHub integration")
-        print(f"   ✅ Quality metrics within targets")
+        print("   ✅ All 3 streams present and populated")
+        print("   ✅ C3.x actual data (not placeholders)")
+        print("   ✅ Router generated with GitHub integration")
+        print("   ✅ Quality metrics within targets")
 
         print("\n🎉 SUCCESS: System working correctly with real repository!")
         print(f"\n📁 Test artifacts saved to: {output_dir}")
         print(f"   - Router: {output_dir}/fastmcp_router_SKILL.md")
 
-        print(f"\n{'='*80}\n")
+        print(f"\n{'=' * 80}\n")
 
 
-if __name__ == '__main__':
-    pytest.main([__file__, '-v', '-s', '--tb=short'])
+if __name__ == "__main__":
+    pytest.main([__file__, "-v", "-s", "--tb=short"])
diff --git a/tests/test_scraper_features.py b/tests/test_scraper_features.py
index a4b789e..77228d8 100644
--- a/tests/test_scraper_features.py
+++ b/tests/test_scraper_features.py
@@ -4,10 +4,10 @@ Test suite for doc_scraper core features
 Tests URL validation, language detection, pattern extraction, and categorization
 """
 
-import sys
 import os
+import sys
 import unittest
-from unittest.mock import Mock, MagicMock
+
 from bs4 import BeautifulSoup
 
 # Add parent directory to path
@@ -22,65 +22,55 @@ class TestURLValidation(unittest.TestCase):
     def setUp(self):
         """Set up test converter"""
         self.config = {
-            'name': 'test',
-            'base_url': 'https://docs.example.com/',
-            'url_patterns': {
-                'include': ['/guide/', '/api/'],
-                'exclude': ['/blog/', '/about/']
-            },
-            'selectors': {
-                'main_content': 'article',
-                'title': 'h1',
-                'code_blocks': 'pre code'
-            },
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://docs.example.com/",
+            "url_patterns": {"include": ["/guide/", "/api/"], "exclude": ["/blog/", "/about/"]},
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         self.converter = DocToSkillConverter(self.config, dry_run=True)
 
     def test_valid_url_with_include_pattern(self):
         """Test URL matching include pattern"""
-        url = 'https://docs.example.com/guide/getting-started'
+        url = "https://docs.example.com/guide/getting-started"
         self.assertTrue(self.converter.is_valid_url(url))
 
     def test_valid_url_with_api_pattern(self):
         """Test URL matching API pattern"""
-        url = 'https://docs.example.com/api/reference'
+        url = "https://docs.example.com/api/reference"
         self.assertTrue(self.converter.is_valid_url(url))
 
     def test_invalid_url_with_exclude_pattern(self):
         """Test URL matching exclude pattern"""
-        url = 'https://docs.example.com/blog/announcement'
+        url = "https://docs.example.com/blog/announcement"
         self.assertFalse(self.converter.is_valid_url(url))
 
     def test_invalid_url_different_domain(self):
         """Test URL from different domain"""
-        url = 'https://other-site.com/guide/tutorial'
+        url = "https://other-site.com/guide/tutorial"
         self.assertFalse(self.converter.is_valid_url(url))
 
     def test_invalid_url_no_include_match(self):
         """Test URL not matching any include pattern"""
-        url = 'https://docs.example.com/download/installer'
+        url = "https://docs.example.com/download/installer"
         self.assertFalse(self.converter.is_valid_url(url))
 
     def test_url_validation_no_patterns(self):
         """Test URL validation with no include/exclude patterns"""
         config = {
-            'name': 'test',
-            'base_url': 'https://docs.example.com/',
-            'url_patterns': {
-                'include': [],
-                'exclude': []
-            },
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://docs.example.com/",
+            "url_patterns": {"include": [], "exclude": []},
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         converter = DocToSkillConverter(config, dry_run=True)
 
         # Should accept any URL under base_url
-        self.assertTrue(converter.is_valid_url('https://docs.example.com/anything'))
-        self.assertFalse(converter.is_valid_url('https://other.com/anything'))
+        self.assertTrue(converter.is_valid_url("https://docs.example.com/anything"))
+        self.assertFalse(converter.is_valid_url("https://other.com/anything"))
 
 
 class TestLanguageDetection(unittest.TestCase):
@@ -89,167 +79,167 @@ class TestLanguageDetection(unittest.TestCase):
     def setUp(self):
         """Set up test converter"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         self.converter = DocToSkillConverter(config, dry_run=True)
 
     def test_detect_language_from_class(self):
         """Test language detection from CSS class"""
         html = '<code class="language-python">print("hello")</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        elem = BeautifulSoup(html, "html.parser").find("code")
         lang = self.converter.detect_language(elem, 'print("hello")')
-        self.assertEqual(lang, 'python')
+        self.assertEqual(lang, "python")
 
     def test_detect_language_from_lang_class(self):
         """Test language detection from lang- prefix"""
         html = '<code class="lang-javascript">console.log("hello")</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        elem = BeautifulSoup(html, "html.parser").find("code")
         lang = self.converter.detect_language(elem, 'console.log("hello")')
-        self.assertEqual(lang, 'javascript')
+        self.assertEqual(lang, "javascript")
 
     def test_detect_language_from_parent(self):
         """Test language detection from parent pre element"""
         html = '<pre class="language-cpp"><code>int main() {}</code></pre>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
-        lang = self.converter.detect_language(elem, 'int main() {}')
-        self.assertEqual(lang, 'cpp')
+        elem = BeautifulSoup(html, "html.parser").find("code")
+        lang = self.converter.detect_language(elem, "int main() {}")
+        self.assertEqual(lang, "cpp")
 
     def test_detect_python_from_heuristics(self):
         """Test Python detection from code content"""
-        html = '<code>import os\nfrom pathlib import Path</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>import os\nfrom pathlib import Path</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'python')
+        self.assertEqual(lang, "python")
 
     def test_detect_python_from_def(self):
         """Test Python detection from def keyword"""
-        html = '<code>def my_function():\n    pass</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>def my_function():\n    pass</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'python')
+        self.assertEqual(lang, "python")
 
     def test_detect_javascript_from_const(self):
         """Test JavaScript detection from const keyword"""
-        html = '<code>const myVar = 10;</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>const myVar = 10;</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'javascript')
+        self.assertEqual(lang, "javascript")
 
     def test_detect_javascript_from_arrow(self):
         """Test JavaScript detection from arrow function"""
-        html = '<code>const add = (a, b) => a + b;</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>const add = (a, b) => a + b;</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'javascript')
+        self.assertEqual(lang, "javascript")
 
     def test_detect_gdscript(self):
         """Test GDScript detection"""
-        html = '<code>func _ready():\n    var x = 5</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>func _ready():\n    var x = 5</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'gdscript')
+        self.assertEqual(lang, "gdscript")
 
     def test_detect_cpp(self):
         """Test C++ detection"""
-        html = '<code>#include <iostream>\nint main() { return 0; }</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>#include <iostream>\nint main() { return 0; }</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'cpp')
+        self.assertEqual(lang, "cpp")
 
     def test_detect_unknown(self):
         """Test unknown language detection"""
-        html = '<code>some random text without clear indicators</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>some random text without clear indicators</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'unknown')
+        self.assertEqual(lang, "unknown")
 
     def test_detect_brush_pattern_in_pre(self):
         """Test brush: pattern in pre element"""
         html = '<pre class="brush: python"><code>x</code></pre>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
-        lang = self.converter.detect_language(elem, 'x')
-        self.assertEqual(lang, 'python', 'Should detect python from brush: python pattern')
+        elem = BeautifulSoup(html, "html.parser").find("code")
+        lang = self.converter.detect_language(elem, "x")
+        self.assertEqual(lang, "python", "Should detect python from brush: python pattern")
 
     def test_detect_bare_class_in_pre(self):
         """Test bare class name in pre element"""
         html = '<pre class="python"><code>x</code></pre>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
-        lang = self.converter.detect_language(elem, 'x')
-        self.assertEqual(lang, 'python', 'Should detect python from bare class name')
+        elem = BeautifulSoup(html, "html.parser").find("code")
+        lang = self.converter.detect_language(elem, "x")
+        self.assertEqual(lang, "python", "Should detect python from bare class name")
 
     def test_detect_bare_class_in_code(self):
         """Test bare class name in code element"""
         html = '<code class="python">x</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
-        lang = self.converter.detect_language(elem, 'x')
-        self.assertEqual(lang, 'python', 'Should detect python from bare class name')
+        elem = BeautifulSoup(html, "html.parser").find("code")
+        lang = self.converter.detect_language(elem, "x")
+        self.assertEqual(lang, "python", "Should detect python from bare class name")
 
     def test_detect_csharp_from_using_system(self):
         """Test C# detection from 'using System' keyword"""
-        html = '<code>using System;\nnamespace MyApp { }</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>using System;\nnamespace MyApp { }</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'csharp', 'Should detect C# from using System')
+        self.assertEqual(lang, "csharp", "Should detect C# from using System")
 
     def test_detect_csharp_from_namespace(self):
         """Test C# detection from 'namespace' keyword"""
-        html = '<code>namespace MyNamespace\n{\n    public class Test { }\n}</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>namespace MyNamespace\n{\n    public class Test { }\n}</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'csharp', 'Should detect C# from namespace')
+        self.assertEqual(lang, "csharp", "Should detect C# from namespace")
 
     def test_detect_csharp_from_property_syntax(self):
         """Test C# detection from property syntax"""
-        html = '<code>public string Name { get; set; }</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>public string Name { get; set; }</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'csharp', 'Should detect C# from { get; set; } syntax')
+        self.assertEqual(lang, "csharp", "Should detect C# from { get; set; } syntax")
 
     def test_detect_csharp_from_public_class(self):
         """Test C# detection from 'public class' keyword"""
-        html = '<code>public class MyClass\n{\n    private int value;\n}</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>public class MyClass\n{\n    private int value;\n}</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'csharp', 'Should detect C# from public class')
+        self.assertEqual(lang, "csharp", "Should detect C# from public class")
 
     def test_detect_csharp_from_private_class(self):
         """Test C# detection from 'private class' keyword"""
-        html = '<code>private class Helper { }</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        html = "<code>private class Helper { }</code>"
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'csharp', 'Should detect C# from private class')
+        self.assertEqual(lang, "csharp", "Should detect C# from private class")
 
     def test_detect_csharp_from_public_static_void(self):
         """Test C# detection from 'public static void' keyword"""
         html = '<code>public static void Main(string[] args)\n{\n    Console.WriteLine("Test");\n}</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'csharp', 'Should detect C# from public static void')
+        self.assertEqual(lang, "csharp", "Should detect C# from public static void")
 
     def test_detect_csharp_from_class_attribute(self):
         """Test C# detection from CSS class attribute"""
         html = '<code class="language-csharp">var x = 5;</code>'
-        elem = BeautifulSoup(html, 'html.parser').find('code')
+        elem = BeautifulSoup(html, "html.parser").find("code")
         code = elem.get_text()
         lang = self.converter.detect_language(elem, code)
-        self.assertEqual(lang, 'csharp', 'Should detect C# from language-csharp class')
+        self.assertEqual(lang, "csharp", "Should detect C# from language-csharp class")
 
 
 class TestPatternExtraction(unittest.TestCase):
@@ -258,53 +248,53 @@ class TestPatternExtraction(unittest.TestCase):
     def setUp(self):
         """Set up test converter"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         self.converter = DocToSkillConverter(config, dry_run=True)
 
     def test_extract_pattern_with_example_marker(self):
         """Test pattern extraction with 'Example:' marker"""
-        html = '''
+        html = """
         <article>
             <p>Example: Here's how to use it</p>
             <pre><code>print("hello")</code></pre>
         </article>
-        '''
-        soup = BeautifulSoup(html, 'html.parser')
-        main = soup.find('article')
+        """
+        soup = BeautifulSoup(html, "html.parser")
+        main = soup.find("article")
         patterns = self.converter.extract_patterns(main, [])
 
         self.assertGreater(len(patterns), 0)
-        self.assertIn('example', patterns[0]['description'].lower())
+        self.assertIn("example", patterns[0]["description"].lower())
 
     def test_extract_pattern_with_usage_marker(self):
         """Test pattern extraction with 'Usage:' marker"""
-        html = '''
+        html = """
         <article>
             <p>Usage: Call this function like so</p>
             <pre><code>my_function(arg)</code></pre>
         </article>
-        '''
-        soup = BeautifulSoup(html, 'html.parser')
-        main = soup.find('article')
+        """
+        soup = BeautifulSoup(html, "html.parser")
+        main = soup.find("article")
         patterns = self.converter.extract_patterns(main, [])
 
         self.assertGreater(len(patterns), 0)
-        self.assertIn('usage', patterns[0]['description'].lower())
+        self.assertIn("usage", patterns[0]["description"].lower())
 
     def test_extract_pattern_limit(self):
         """Test pattern extraction limits to 5 patterns"""
-        html = '<article>'
+        html = "<article>"
         for i in range(10):
-            html += f'<p>Example {i}: Test</p><pre><code>code_{i}</code></pre>'
-        html += '</article>'
+            html += f"<p>Example {i}: Test</p><pre><code>code_{i}</code></pre>"
+        html += "</article>"
 
-        soup = BeautifulSoup(html, 'html.parser')
-        main = soup.find('article')
+        soup = BeautifulSoup(html, "html.parser")
+        main = soup.find("article")
         patterns = self.converter.extract_patterns(main, [])
 
         self.assertLessEqual(len(patterns), 5, "Should limit to 5 patterns max")
@@ -316,81 +306,75 @@ class TestCategorization(unittest.TestCase):
     def setUp(self):
         """Set up test converter"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'categories': {
-                'getting_started': ['intro', 'tutorial', 'getting-started'],
-                'api': ['api', 'reference', 'class'],
-                'guides': ['guide', 'how-to']
+            "name": "test",
+            "base_url": "https://example.com/",
+            "categories": {
+                "getting_started": ["intro", "tutorial", "getting-started"],
+                "api": ["api", "reference", "class"],
+                "guides": ["guide", "how-to"],
             },
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         self.converter = DocToSkillConverter(config, dry_run=True)
 
     def test_categorize_by_url(self):
         """Test categorization based on URL"""
-        pages = [{
-            'url': 'https://example.com/api/reference',
-            'title': 'Some Title',
-            'content': 'Some content'
-        }]
+        pages = [{"url": "https://example.com/api/reference", "title": "Some Title", "content": "Some content"}]
         categories = self.converter.smart_categorize(pages)
 
         # Should categorize to 'api' based on URL containing 'api'
-        self.assertIn('api', categories)
-        self.assertEqual(len(categories['api']), 1)
+        self.assertIn("api", categories)
+        self.assertEqual(len(categories["api"]), 1)
 
     def test_categorize_by_title(self):
         """Test categorization based on title"""
-        pages = [{
-            'url': 'https://example.com/docs/page',
-            'title': 'API Reference Documentation',
-            'content': 'Some content'
-        }]
+        pages = [
+            {"url": "https://example.com/docs/page", "title": "API Reference Documentation", "content": "Some content"}
+        ]
         categories = self.converter.smart_categorize(pages)
 
-        self.assertIn('api', categories)
-        self.assertEqual(len(categories['api']), 1)
+        self.assertIn("api", categories)
+        self.assertEqual(len(categories["api"]), 1)
 
     def test_categorize_by_content(self):
         """Test categorization based on content (lower priority)"""
-        pages = [{
-            'url': 'https://example.com/docs/page',
-            'title': 'Some Page',
-            'content': 'This is a tutorial for beginners. An intro to the system.'
-        }]
+        pages = [
+            {
+                "url": "https://example.com/docs/page",
+                "title": "Some Page",
+                "content": "This is a tutorial for beginners. An intro to the system.",
+            }
+        ]
         categories = self.converter.smart_categorize(pages)
 
         # Should categorize based on 'tutorial' and 'intro' in content
-        self.assertIn('getting_started', categories)
+        self.assertIn("getting_started", categories)
 
     def test_categorize_to_other(self):
         """Test pages that don't match any category go to 'other'"""
-        pages = [{
-            'url': 'https://example.com/random/page',
-            'title': 'Random Page',
-            'content': 'Random content with no keywords'
-        }]
+        pages = [
+            {
+                "url": "https://example.com/random/page",
+                "title": "Random Page",
+                "content": "Random content with no keywords",
+            }
+        ]
         categories = self.converter.smart_categorize(pages)
 
-        self.assertIn('other', categories)
-        self.assertEqual(len(categories['other']), 1)
+        self.assertIn("other", categories)
+        self.assertEqual(len(categories["other"]), 1)
 
     def test_empty_categories_removed(self):
         """Test empty categories are removed"""
-        pages = [{
-            'url': 'https://example.com/api/reference',
-            'title': 'API Reference',
-            'content': 'API documentation'
-        }]
+        pages = [{"url": "https://example.com/api/reference", "title": "API Reference", "content": "API documentation"}]
         categories = self.converter.smart_categorize(pages)
 
         # Only 'api' should exist, not empty 'guides' or 'getting_started'
         # (categories with no pages are removed)
-        self.assertIn('api', categories)
-        self.assertNotIn('guides', categories)
+        self.assertIn("api", categories)
+        self.assertNotIn("guides", categories)
 
 
 class TestLinkExtraction(unittest.TestCase):
@@ -399,21 +383,18 @@ class TestLinkExtraction(unittest.TestCase):
     def setUp(self):
         """Set up test converter"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre code'},
-            'url_patterns': {
-                'include': [],
-                'exclude': []
-            },
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre code"},
+            "url_patterns": {"include": [], "exclude": []},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         self.converter = DocToSkillConverter(config, dry_run=True)
 
     def test_extract_links_strips_anchor_fragments(self):
         """Test that anchor fragments (#anchor) are stripped from extracted links"""
-        html = '''
+        html = """
         <article>
             <h1>Test Page</h1>
             <p>Content with links</p>
@@ -421,19 +402,19 @@ class TestLinkExtraction(unittest.TestCase):
             <a href="https://example.com/docs/page.html#section2">Link 2</a>
             <a href="https://example.com/docs/other.html">Link 3</a>
         </article>
-        '''
-        soup = BeautifulSoup(html, 'html.parser')
-        page = self.converter.extract_content(soup, 'https://example.com/')
+        """
+        soup = BeautifulSoup(html, "html.parser")
+        page = self.converter.extract_content(soup, "https://example.com/")
 
         # Should have 2 unique URLs (page.html and other.html), not 3
         # The two links with different anchors should be deduplicated
-        self.assertEqual(len(page['links']), 2)
-        self.assertIn('https://example.com/docs/page.html', page['links'])
-        self.assertIn('https://example.com/docs/other.html', page['links'])
+        self.assertEqual(len(page["links"]), 2)
+        self.assertIn("https://example.com/docs/page.html", page["links"])
+        self.assertIn("https://example.com/docs/other.html", page["links"])
 
     def test_extract_links_no_anchor_duplicates(self):
         """Test that multiple anchor links to same page don't create duplicates"""
-        html = '''
+        html = """
         <article>
             <h1>Test Page</h1>
             <a href="https://example.com/docs/api.html#cb1-1">Anchor 1</a>
@@ -442,46 +423,46 @@ class TestLinkExtraction(unittest.TestCase):
             <a href="https://example.com/docs/api.html#cb1-4">Anchor 4</a>
             <a href="https://example.com/docs/api.html#cb1-5">Anchor 5</a>
         </article>
-        '''
-        soup = BeautifulSoup(html, 'html.parser')
-        page = self.converter.extract_content(soup, 'https://example.com/')
+        """
+        soup = BeautifulSoup(html, "html.parser")
+        page = self.converter.extract_content(soup, "https://example.com/")
 
         # All 5 links point to the same page, should result in only 1 URL
-        self.assertEqual(len(page['links']), 1)
-        self.assertEqual(page['links'][0], 'https://example.com/docs/api.html')
+        self.assertEqual(len(page["links"]), 1)
+        self.assertEqual(page["links"][0], "https://example.com/docs/api.html")
 
     def test_extract_links_preserves_query_params(self):
         """Test that query parameters are preserved when stripping anchors"""
-        html = '''
+        html = """
         <article>
             <h1>Test Page</h1>
             <a href="https://example.com/search?q=test#result1">Search Result</a>
         </article>
-        '''
-        soup = BeautifulSoup(html, 'html.parser')
-        page = self.converter.extract_content(soup, 'https://example.com/')
+        """
+        soup = BeautifulSoup(html, "html.parser")
+        page = self.converter.extract_content(soup, "https://example.com/")
 
         # Query params should be preserved, only anchor stripped
-        self.assertEqual(len(page['links']), 1)
-        self.assertEqual(page['links'][0], 'https://example.com/search?q=test')
+        self.assertEqual(len(page["links"]), 1)
+        self.assertEqual(page["links"][0], "https://example.com/search?q=test")
 
     def test_extract_links_relative_urls_with_anchors(self):
         """Test that relative URLs with anchors are handled correctly"""
-        html = '''
+        html = """
         <article>
             <h1>Test Page</h1>
             <a href="/docs/guide.html#intro">Relative Link 1</a>
             <a href="/docs/guide.html#advanced">Relative Link 2</a>
             <a href="/docs/tutorial.html#start">Relative Link 3</a>
         </article>
-        '''
-        soup = BeautifulSoup(html, 'html.parser')
-        page = self.converter.extract_content(soup, 'https://example.com/')
+        """
+        soup = BeautifulSoup(html, "html.parser")
+        page = self.converter.extract_content(soup, "https://example.com/")
 
         # Should have 2 unique URLs (guide.html and tutorial.html)
-        self.assertEqual(len(page['links']), 2)
-        self.assertIn('https://example.com/docs/guide.html', page['links'])
-        self.assertIn('https://example.com/docs/tutorial.html', page['links'])
+        self.assertEqual(len(page["links"]), 2)
+        self.assertIn("https://example.com/docs/guide.html", page["links"])
+        self.assertIn("https://example.com/docs/tutorial.html", page["links"])
 
 
 class TestTextCleaning(unittest.TestCase):
@@ -490,11 +471,11 @@ class TestTextCleaning(unittest.TestCase):
     def setUp(self):
         """Set up test converter"""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article', 'title': 'h1', 'code_blocks': 'pre'},
-            'rate_limit': 0.1,
-            'max_pages': 10
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article", "title": "h1", "code_blocks": "pre"},
+            "rate_limit": 0.1,
+            "max_pages": 10,
         }
         self.converter = DocToSkillConverter(config, dry_run=True)
 
@@ -523,5 +504,5 @@ class TestTextCleaning(unittest.TestCase):
         self.assertEqual(cleaned, "Hello world")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_server_fastmcp_http.py b/tests/test_server_fastmcp_http.py
index 0f7675d..0e49c12 100644
--- a/tests/test_server_fastmcp_http.py
+++ b/tests/test_server_fastmcp_http.py
@@ -3,14 +3,15 @@
 Tests for FastMCP server HTTP transport support.
 """
 
-import pytest
-import asyncio
 import sys
 
+import pytest
+
 # Skip all tests if mcp package is not installed
 pytest.importorskip("mcp.server")
 
 from starlette.testclient import TestClient
+
 from skill_seekers.mcp.server_fastmcp import mcp
 
 
@@ -104,7 +105,6 @@ class TestArgumentParsing:
     def test_parse_args_default(self):
         """Test default argument parsing (stdio mode)."""
         from skill_seekers.mcp.server_fastmcp import parse_args
-        import sys
 
         # Save original argv
         original_argv = sys.argv
@@ -124,7 +124,6 @@ class TestArgumentParsing:
     def test_parse_args_http_mode(self):
         """Test HTTP mode argument parsing."""
         from skill_seekers.mcp.server_fastmcp import parse_args
-        import sys
 
         original_argv = sys.argv
 
@@ -141,7 +140,6 @@ class TestArgumentParsing:
     def test_parse_args_log_level(self):
         """Test log level argument parsing."""
         from skill_seekers.mcp.server_fastmcp import parse_args
-        import sys
 
         original_argv = sys.argv
 
diff --git a/tests/test_setup_scripts.py b/tests/test_setup_scripts.py
index 3b67e38..0a3e25c 100644
--- a/tests/test_setup_scripts.py
+++ b/tests/test_setup_scripts.py
@@ -5,9 +5,10 @@ Test setup scripts for correctness and path validation.
 Tests that bash scripts reference correct paths and are syntactically valid.
 """
 
-import subprocess
 import re
+import subprocess
 from pathlib import Path
+
 import pytest
 
 
@@ -22,7 +23,7 @@ class TestSetupMCPScript:
     @pytest.fixture
     def script_content(self, script_path):
         """Read setup_mcp.sh content"""
-        with open(script_path, 'r') as f:
+        with open(script_path) as f:
             return f.read()
 
     def test_setup_mcp_exists(self, script_path):
@@ -32,67 +33,73 @@ class TestSetupMCPScript:
 
     def test_bash_syntax_valid(self, script_path):
         """Test that setup_mcp.sh has valid bash syntax"""
-        result = subprocess.run(
-            ["bash", "-n", str(script_path)],
-            capture_output=True,
-            text=True
-        )
+        result = subprocess.run(["bash", "-n", str(script_path)], capture_output=True, text=True)
         assert result.returncode == 0, f"Bash syntax error: {result.stderr}"
 
     def test_references_correct_mcp_directory(self, script_content):
         """Test that script references src/skill_seekers/mcp/ (v2.4.0 MCP 2025 upgrade)"""
         # Should NOT reference old mcp/ or skill_seeker_mcp/ directories
-        old_mcp_refs = re.findall(r'(?:^|[^a-z_])(?<!/)mcp/(?!\.json)', script_content, re.MULTILINE)
-        old_skill_seeker_refs = re.findall(r'skill_seeker_mcp/', script_content)
+        old_mcp_refs = re.findall(r"(?:^|[^a-z_])(?<!/)mcp/(?!\.json)", script_content, re.MULTILINE)
+        old_skill_seeker_refs = re.findall(r"skill_seeker_mcp/", script_content)
 
         # Allow /mcp/ (as in src/skill_seekers/mcp/) but not standalone mcp/
         assert len(old_mcp_refs) == 0, f"Found {len(old_mcp_refs)} references to old 'mcp/' directory: {old_mcp_refs}"
-        assert len(old_skill_seeker_refs) == 0, f"Found {len(old_skill_seeker_refs)} references to old 'skill_seeker_mcp/': {old_skill_seeker_refs}"
+        assert len(old_skill_seeker_refs) == 0, (
+            f"Found {len(old_skill_seeker_refs)} references to old 'skill_seeker_mcp/': {old_skill_seeker_refs}"
+        )
 
         # SHOULD reference skill_seekers.mcp module (via -m flag) or src/skill_seekers/mcp/
         # MCP 2025 uses: python3 -m skill_seekers.mcp.server_fastmcp
-        new_refs = re.findall(r'skill_seekers\.mcp', script_content)
-        assert len(new_refs) >= 2, f"Expected at least 2 references to 'skill_seekers.mcp' module, found {len(new_refs)}"
+        new_refs = re.findall(r"skill_seekers\.mcp", script_content)
+        assert len(new_refs) >= 2, (
+            f"Expected at least 2 references to 'skill_seekers.mcp' module, found {len(new_refs)}"
+        )
 
     def test_requirements_txt_path(self, script_content):
         """Test that script uses pip install -e . (v2.0.0 modern packaging)"""
         # v2.0.0 uses '-e .' (editable install) instead of requirements files
         # The actual command is "$PIP_INSTALL_CMD -e ."
-        assert " -e ." in script_content or " -e." in script_content, \
+        assert " -e ." in script_content or " -e." in script_content, (
             "Should use '-e .' for editable install (modern packaging)"
+        )
 
         # Should NOT reference old requirements.txt paths
         import re
-        old_skill_seeker_refs = re.findall(r'skill_seeker_mcp/requirements\.txt', script_content)
-        old_mcp_refs = re.findall(r'(?<!skill_seeker_)mcp/requirements\.txt', script_content)
 
-        assert len(old_skill_seeker_refs) == 0, \
+        old_skill_seeker_refs = re.findall(r"skill_seeker_mcp/requirements\.txt", script_content)
+        old_mcp_refs = re.findall(r"(?<!skill_seeker_)mcp/requirements\.txt", script_content)
+
+        assert len(old_skill_seeker_refs) == 0, (
             f"Should NOT reference 'skill_seeker_mcp/requirements.txt' (found {len(old_skill_seeker_refs)})"
-        assert len(old_mcp_refs) == 0, \
-            f"Should NOT reference old 'mcp/requirements.txt' (found {len(old_mcp_refs)})"
+        )
+        assert len(old_mcp_refs) == 0, f"Should NOT reference old 'mcp/requirements.txt' (found {len(old_mcp_refs)})"
 
     def test_server_py_path(self, script_content):
         """Test that server_fastmcp.py module is referenced (v2.4.0 MCP 2025 upgrade)"""
         import re
+
         # MCP 2025 uses: python3 -m skill_seekers.mcp.server_fastmcp
-        assert "skill_seekers.mcp.server_fastmcp" in script_content, \
+        assert "skill_seekers.mcp.server_fastmcp" in script_content, (
             "Should reference skill_seekers.mcp.server_fastmcp module"
+        )
 
         # Should NOT reference old server.py directly
-        old_server_refs = re.findall(r'src/skill_seekers/mcp/server\.py', script_content)
-        assert len(old_server_refs) == 0, \
+        old_server_refs = re.findall(r"src/skill_seekers/mcp/server\.py", script_content)
+        assert len(old_server_refs) == 0, (
             f"Should use module import (-m) instead of direct path (found {len(old_server_refs)} refs to server.py)"
+        )
 
     def test_referenced_files_exist(self):
         """Test that all files referenced in setup_mcp.sh actually exist"""
         # Check critical paths (v2.4.0 MCP 2025 upgrade)
-        assert Path("src/skill_seekers/mcp/server_fastmcp.py").exists(), \
+        assert Path("src/skill_seekers/mcp/server_fastmcp.py").exists(), (
             "src/skill_seekers/mcp/server_fastmcp.py should exist (MCP 2025)"
-        assert Path("requirements.txt").exists(), \
-            "requirements.txt should exist (root level)"
+        )
+        assert Path("requirements.txt").exists(), "requirements.txt should exist (root level)"
         # Legacy server.py should still exist as compatibility shim
-        assert Path("src/skill_seekers/mcp/server.py").exists(), \
+        assert Path("src/skill_seekers/mcp/server.py").exists(), (
             "src/skill_seekers/mcp/server.py should exist (compatibility shim)"
+        )
 
     def test_config_directory_exists(self):
         """Test that referenced config directory exists"""
@@ -102,14 +109,14 @@ class TestSetupMCPScript:
     def test_script_is_executable(self, script_path):
         """Test that setup_mcp.sh is executable"""
         import os
+
         assert os.access(script_path, os.X_OK), "setup_mcp.sh should be executable"
 
     def test_json_config_path_format(self, script_content):
         """Test that JSON config examples use correct format (v2.4.0 MCP 2025 upgrade)"""
         # MCP 2025 uses module import: python3 -m skill_seekers.mcp.server_fastmcp
         # Config should show the server_fastmcp.py path for stdio examples
-        assert "server_fastmcp.py" in script_content, \
-            "Config should reference server_fastmcp.py (MCP 2025 upgrade)"
+        assert "server_fastmcp.py" in script_content, "Config should reference server_fastmcp.py (MCP 2025 upgrade)"
 
     def test_no_hardcoded_paths(self, script_content):
         """Test that script doesn't contain hardcoded absolute paths"""
@@ -121,8 +128,7 @@ class TestSetupMCPScript:
         """Test that pytest commands reference correct test files"""
         # Check for test file references
         if "pytest" in script_content:
-            assert "tests/test_mcp_server.py" in script_content, \
-                "Should reference correct test file path"
+            assert "tests/test_mcp_server.py" in script_content, "Should reference correct test file path"
 
 
 class TestBashScriptGeneral:
@@ -137,7 +143,7 @@ class TestBashScriptGeneral:
     def test_all_scripts_have_shebang(self, all_bash_scripts):
         """Test that all bash scripts have proper shebang"""
         for script in all_bash_scripts:
-            with open(script, 'r') as f:
+            with open(script) as f:
                 first_line = f.readline()
             assert first_line.startswith("#!"), f"{script} should have shebang"
             assert "bash" in first_line.lower(), f"{script} should use bash"
@@ -145,38 +151,28 @@ class TestBashScriptGeneral:
     def test_all_scripts_syntax_valid(self, all_bash_scripts):
         """Test that all bash scripts have valid syntax"""
         for script in all_bash_scripts:
-            result = subprocess.run(
-                ["bash", "-n", str(script)],
-                capture_output=True,
-                text=True
-            )
-            assert result.returncode == 0, \
-                f"{script} has syntax error: {result.stderr}"
+            result = subprocess.run(["bash", "-n", str(script)], capture_output=True, text=True)
+            assert result.returncode == 0, f"{script} has syntax error: {result.stderr}"
 
     def test_all_scripts_use_set_e(self, all_bash_scripts):
         """Test that scripts use 'set -e' for error handling"""
         for script in all_bash_scripts:
-            with open(script, 'r') as f:
+            with open(script) as f:
                 content = f.read()
             # Check for set -e or set -o errexit
-            has_error_handling = (
-                re.search(r'set\s+-[a-z]*e', content) or
-                re.search(r'set\s+-o\s+errexit', content)
-            )
-            assert has_error_handling, \
-                f"{script} should use 'set -e' for error handling"
+            has_error_handling = re.search(r"set\s+-[a-z]*e", content) or re.search(r"set\s+-o\s+errexit", content)
+            assert has_error_handling, f"{script} should use 'set -e' for error handling"
 
     def test_no_deprecated_backticks(self, all_bash_scripts):
         """Test that scripts use $() instead of deprecated backticks"""
         for script in all_bash_scripts:
-            with open(script, 'r') as f:
+            with open(script) as f:
                 content = f.read()
             # Allow backticks in comments
-            lines = [line for line in content.split('\n') if not line.strip().startswith('#')]
-            code_content = '\n'.join(lines)
-            backticks = re.findall(r'`[^`]+`', code_content)
-            assert len(backticks) == 0, \
-                f"{script} uses deprecated backticks: {backticks}. Use $() instead"
+            lines = [line for line in content.split("\n") if not line.strip().startswith("#")]
+            code_content = "\n".join(lines)
+            backticks = re.findall(r"`[^`]+`", code_content)
+            assert len(backticks) == 0, f"{script} uses deprecated backticks: {backticks}. Use $() instead"
 
 
 class TestMCPServerPaths:
@@ -186,21 +182,22 @@ class TestMCPServerPaths:
         """Test that GitHub workflows reference correct MCP paths"""
         workflow_file = Path(".github/workflows/tests.yml")
         if workflow_file.exists():
-            with open(workflow_file, 'r') as f:
+            with open(workflow_file) as f:
                 content = f.read()
             # Should NOT reference old mcp/ directory
-            assert "mcp/requirements.txt" not in content or "skill_seeker_mcp/requirements.txt" in content, \
+            assert "mcp/requirements.txt" not in content or "skill_seeker_mcp/requirements.txt" in content, (
                 "GitHub workflow should use correct MCP paths"
+            )
 
     def test_readme_references_correct_paths(self):
         """Test that README references correct MCP paths"""
         readme = Path("README.md")
         if readme.exists():
-            with open(readme, 'r') as f:
+            with open(readme) as f:
                 content = f.read()
             # Check for old mcp/ directory paths (but allow mcp.json and "mcp" package name)
             # Use negative lookbehind to exclude skill_seeker_mcp/
-            old_mcp_refs = re.findall(r'(?<!skill_seeker_)mcp/(server\.py|requirements\.txt)', content)
+            old_mcp_refs = re.findall(r"(?<!skill_seeker_)mcp/(server\.py|requirements\.txt)", content)
             if len(old_mcp_refs) > 0:
                 pytest.fail(f"README references old mcp/ directory: {old_mcp_refs}")
 
@@ -208,10 +205,10 @@ class TestMCPServerPaths:
         """Test that documentation files reference correct MCP paths"""
         doc_files = list(Path("docs/").glob("*.md")) if Path("docs/").exists() else []
         for doc_file in doc_files:
-            with open(doc_file, 'r') as f:
+            with open(doc_file) as f:
                 content = f.read()
             # Check for old mcp/ directory paths (but allow mcp.json and "mcp" package name)
-            old_mcp_refs = re.findall(r'(?<!skill_seeker_)mcp/(server\.py|requirements\.txt)', content)
+            old_mcp_refs = re.findall(r"(?<!skill_seeker_)mcp/(server\.py|requirements\.txt)", content)
             if len(old_mcp_refs) > 0:
                 pytest.fail(f"{doc_file} references old mcp/ directory: {old_mcp_refs}")
 
@@ -229,14 +226,16 @@ def test_mcp_directory_structure():
     old_skill_seeker_mcp = Path("skill_seeker_mcp")
     if old_mcp.exists():
         # If it exists, it should not contain server.py (might be leftover empty dir)
-        assert not (old_mcp / "server.py").exists(), \
+        assert not (old_mcp / "server.py").exists(), (
             "Old mcp/server.py should not exist - migrated to src/skill_seekers/mcp/"
+        )
     if old_skill_seeker_mcp.exists():
-        assert not (old_skill_seeker_mcp / "server.py").exists(), \
+        assert not (old_skill_seeker_mcp / "server.py").exists(), (
             "Old skill_seeker_mcp/server.py should not exist - migrated to src/skill_seekers/mcp/"
+        )
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     print("=" * 60)
     print("Testing Setup Scripts")
     print("=" * 60)
diff --git a/tests/test_skip_llms_txt.py b/tests/test_skip_llms_txt.py
index f863b43..0a251f5 100644
--- a/tests/test_skip_llms_txt.py
+++ b/tests/test_skip_llms_txt.py
@@ -10,8 +10,7 @@ which is useful when:
 import os
 import tempfile
 import unittest
-import logging
-from unittest.mock import patch, Mock, MagicMock
+from unittest.mock import patch
 
 from skill_seekers.cli.doc_scraper import DocToSkillConverter
 
@@ -21,11 +20,7 @@ class TestSkipLlmsTxtConfig(unittest.TestCase):
 
     def test_default_skip_llms_txt_is_false(self):
         """Test that skip_llms_txt defaults to False when not specified."""
-        config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'}
-        }
+        config = {"name": "test", "base_url": "https://example.com/", "selectors": {"main_content": "article"}}
 
         converter = DocToSkillConverter(config, dry_run=True)
         self.assertFalse(converter.skip_llms_txt)
@@ -33,10 +28,10 @@ class TestSkipLlmsTxtConfig(unittest.TestCase):
     def test_skip_llms_txt_can_be_set_true(self):
         """Test that skip_llms_txt can be explicitly set to True."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': True
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": True,
         }
 
         converter = DocToSkillConverter(config, dry_run=True)
@@ -45,10 +40,10 @@ class TestSkipLlmsTxtConfig(unittest.TestCase):
     def test_skip_llms_txt_can_be_set_false(self):
         """Test that skip_llms_txt can be explicitly set to False."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': False
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": False,
         }
 
         converter = DocToSkillConverter(config, dry_run=True)
@@ -61,10 +56,10 @@ class TestSkipLlmsTxtSyncBehavior(unittest.TestCase):
     def test_llms_txt_tried_when_not_skipped(self):
         """Test that _try_llms_txt is called when skip_llms_txt is False."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': False
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": False,
         }
 
         original_cwd = os.getcwd()
@@ -73,9 +68,9 @@ class TestSkipLlmsTxtSyncBehavior(unittest.TestCase):
                 os.chdir(tmpdir)
                 converter = DocToSkillConverter(config, dry_run=False)
 
-                with patch.object(converter, '_try_llms_txt', return_value=False) as mock_try:
-                    with patch.object(converter, 'scrape_page'):
-                        with patch.object(converter, 'save_summary'):
+                with patch.object(converter, "_try_llms_txt", return_value=False) as mock_try:
+                    with patch.object(converter, "scrape_page"):
+                        with patch.object(converter, "save_summary"):
                             converter.scrape_all()
                             mock_try.assert_called_once()
             finally:
@@ -84,10 +79,10 @@ class TestSkipLlmsTxtSyncBehavior(unittest.TestCase):
     def test_llms_txt_skipped_when_skip_true(self):
         """Test that _try_llms_txt is NOT called when skip_llms_txt is True."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': True
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": True,
         }
 
         original_cwd = os.getcwd()
@@ -96,9 +91,9 @@ class TestSkipLlmsTxtSyncBehavior(unittest.TestCase):
                 os.chdir(tmpdir)
                 converter = DocToSkillConverter(config, dry_run=False)
 
-                with patch.object(converter, '_try_llms_txt') as mock_try:
-                    with patch.object(converter, 'scrape_page'):
-                        with patch.object(converter, 'save_summary'):
+                with patch.object(converter, "_try_llms_txt") as mock_try:
+                    with patch.object(converter, "scrape_page"):
+                        with patch.object(converter, "save_summary"):
                             converter.scrape_all()
                             mock_try.assert_not_called()
             finally:
@@ -107,10 +102,10 @@ class TestSkipLlmsTxtSyncBehavior(unittest.TestCase):
     def test_llms_txt_skipped_in_dry_run_mode(self):
         """Test that _try_llms_txt is NOT called in dry-run mode regardless of skip setting."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': False  # Even when False
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": False,  # Even when False
         }
 
         original_cwd = os.getcwd()
@@ -119,8 +114,8 @@ class TestSkipLlmsTxtSyncBehavior(unittest.TestCase):
                 os.chdir(tmpdir)
                 converter = DocToSkillConverter(config, dry_run=True)
 
-                with patch.object(converter, '_try_llms_txt') as mock_try:
-                    with patch.object(converter, 'save_summary'):
+                with patch.object(converter, "_try_llms_txt") as mock_try:
+                    with patch.object(converter, "save_summary"):
                         converter.scrape_all()
                         mock_try.assert_not_called()
             finally:
@@ -133,11 +128,11 @@ class TestSkipLlmsTxtAsyncBehavior(unittest.TestCase):
     def test_async_llms_txt_tried_when_not_skipped(self):
         """Test that _try_llms_txt is called in async mode when skip_llms_txt is False."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': True,
-            'skip_llms_txt': False
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": True,
+            "skip_llms_txt": False,
         }
 
         original_cwd = os.getcwd()
@@ -146,9 +141,9 @@ class TestSkipLlmsTxtAsyncBehavior(unittest.TestCase):
                 os.chdir(tmpdir)
                 converter = DocToSkillConverter(config, dry_run=False)
 
-                with patch.object(converter, '_try_llms_txt', return_value=False) as mock_try:
-                    with patch.object(converter, 'scrape_page_async', return_value=None):
-                        with patch.object(converter, 'save_summary'):
+                with patch.object(converter, "_try_llms_txt", return_value=False) as mock_try:
+                    with patch.object(converter, "scrape_page_async", return_value=None):
+                        with patch.object(converter, "save_summary"):
                             converter.scrape_all()
                             mock_try.assert_called_once()
             finally:
@@ -157,11 +152,11 @@ class TestSkipLlmsTxtAsyncBehavior(unittest.TestCase):
     def test_async_llms_txt_skipped_when_skip_true(self):
         """Test that _try_llms_txt is NOT called in async mode when skip_llms_txt is True."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'async_mode': True,
-            'skip_llms_txt': True
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "async_mode": True,
+            "skip_llms_txt": True,
         }
 
         original_cwd = os.getcwd()
@@ -170,9 +165,9 @@ class TestSkipLlmsTxtAsyncBehavior(unittest.TestCase):
                 os.chdir(tmpdir)
                 converter = DocToSkillConverter(config, dry_run=False)
 
-                with patch.object(converter, '_try_llms_txt') as mock_try:
-                    with patch.object(converter, 'scrape_page_async', return_value=None):
-                        with patch.object(converter, 'save_summary'):
+                with patch.object(converter, "_try_llms_txt") as mock_try:
+                    with patch.object(converter, "scrape_page_async", return_value=None):
+                        with patch.object(converter, "save_summary"):
                             converter.scrape_all()
                             mock_try.assert_not_called()
             finally:
@@ -185,37 +180,30 @@ class TestSkipLlmsTxtWithRealConfig(unittest.TestCase):
     def test_telegram_bots_config_pattern(self):
         """Test the telegram-bots config pattern which uses skip_llms_txt."""
         config = {
-            'name': 'telegram-bots',
-            'description': 'Telegram bot documentation',
-            'base_url': 'https://core.telegram.org/bots',
-            'skip_llms_txt': True,  # Telegram doesn't have useful llms.txt
-            'start_urls': [
-                'https://core.telegram.org/bots',
-                'https://core.telegram.org/bots/api'
-            ],
-            'selectors': {
-                'main_content': '#dev_page_content, main, article',
-                'title': 'h1, title',
-                'code_blocks': 'pre code, pre'
-            }
+            "name": "telegram-bots",
+            "description": "Telegram bot documentation",
+            "base_url": "https://core.telegram.org/bots",
+            "skip_llms_txt": True,  # Telegram doesn't have useful llms.txt
+            "start_urls": ["https://core.telegram.org/bots", "https://core.telegram.org/bots/api"],
+            "selectors": {
+                "main_content": "#dev_page_content, main, article",
+                "title": "h1, title",
+                "code_blocks": "pre code, pre",
+            },
         }
 
         converter = DocToSkillConverter(config, dry_run=True)
         self.assertTrue(converter.skip_llms_txt)
-        self.assertEqual(converter.name, 'telegram-bots')
+        self.assertEqual(converter.name, "telegram-bots")
 
     def test_skip_llms_txt_with_multiple_start_urls(self):
         """Test skip_llms_txt works correctly with multiple start URLs."""
         config = {
-            'name': 'test-multi',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': True,
-            'start_urls': [
-                'https://example.com/docs/',
-                'https://example.com/api/',
-                'https://example.com/guide/'
-            ]
+            "name": "test-multi",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": True,
+            "start_urls": ["https://example.com/docs/", "https://example.com/api/", "https://example.com/guide/"],
         }
 
         converter = DocToSkillConverter(config, dry_run=True)
@@ -230,66 +218,66 @@ class TestSkipLlmsTxtEdgeCases(unittest.TestCase):
     def test_skip_llms_txt_with_int_zero_logs_warning(self):
         """Test that integer 0 logs warning and defaults to False."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': 0  # Invalid type
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": 0,  # Invalid type
         }
 
-        with self.assertLogs('skill_seekers.cli.doc_scraper', level='WARNING') as cm:
+        with self.assertLogs("skill_seekers.cli.doc_scraper", level="WARNING") as cm:
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertFalse(converter.skip_llms_txt)
-            self.assertTrue(any('Invalid value' in log and '0' in log for log in cm.output))
+            self.assertTrue(any("Invalid value" in log and "0" in log for log in cm.output))
 
     def test_skip_llms_txt_with_int_one_logs_warning(self):
         """Test that integer 1 logs warning and defaults to False."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': 1  # Invalid type
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": 1,  # Invalid type
         }
 
-        with self.assertLogs('skill_seekers.cli.doc_scraper', level='WARNING') as cm:
+        with self.assertLogs("skill_seekers.cli.doc_scraper", level="WARNING") as cm:
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertFalse(converter.skip_llms_txt)
-            self.assertTrue(any('Invalid value' in log and '1' in log for log in cm.output))
+            self.assertTrue(any("Invalid value" in log and "1" in log for log in cm.output))
 
     def test_skip_llms_txt_with_string_logs_warning(self):
         """Test that string values log warning and default to False."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': "true"  # Invalid type
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": "true",  # Invalid type
         }
 
-        with self.assertLogs('skill_seekers.cli.doc_scraper', level='WARNING') as cm:
+        with self.assertLogs("skill_seekers.cli.doc_scraper", level="WARNING") as cm:
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertFalse(converter.skip_llms_txt)
-            self.assertTrue(any('Invalid value' in log and 'true' in log for log in cm.output))
+            self.assertTrue(any("Invalid value" in log and "true" in log for log in cm.output))
 
     def test_skip_llms_txt_with_none_logs_warning(self):
         """Test that None logs warning and defaults to False."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': None  # Invalid type
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": None,  # Invalid type
         }
 
-        with self.assertLogs('skill_seekers.cli.doc_scraper', level='WARNING') as cm:
+        with self.assertLogs("skill_seekers.cli.doc_scraper", level="WARNING") as cm:
             converter = DocToSkillConverter(config, dry_run=True)
             self.assertFalse(converter.skip_llms_txt)
-            self.assertTrue(any('Invalid value' in log and 'None' in log for log in cm.output))
+            self.assertTrue(any("Invalid value" in log and "None" in log for log in cm.output))
 
     def test_scraping_proceeds_when_llms_txt_skipped(self):
         """Test that HTML scraping proceeds normally when llms.txt is skipped."""
         config = {
-            'name': 'test',
-            'base_url': 'https://example.com/',
-            'selectors': {'main_content': 'article'},
-            'skip_llms_txt': True
+            "name": "test",
+            "base_url": "https://example.com/",
+            "selectors": {"main_content": "article"},
+            "skip_llms_txt": True,
         }
 
         original_cwd = os.getcwd()
@@ -305,8 +293,8 @@ class TestSkipLlmsTxtEdgeCases(unittest.TestCase):
                     scrape_called.append(url)
                     return None
 
-                with patch.object(converter, 'scrape_page', side_effect=mock_scrape):
-                    with patch.object(converter, 'save_summary'):
+                with patch.object(converter, "scrape_page", side_effect=mock_scrape):
+                    with patch.object(converter, "save_summary"):
                         converter.scrape_all()
                         # Should have attempted to scrape the base URL
                         self.assertTrue(len(scrape_called) > 0)
@@ -314,5 +302,5 @@ class TestSkipLlmsTxtEdgeCases(unittest.TestCase):
                 os.chdir(original_cwd)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_smart_summarization.py b/tests/test_smart_summarization.py
index 0cd905e..9788fd1 100644
--- a/tests/test_smart_summarization.py
+++ b/tests/test_smart_summarization.py
@@ -6,7 +6,7 @@ compatibility with Claude CLI's character limits.
 """
 
 import pytest
-from pathlib import Path
+
 from skill_seekers.cli.enhance_skill_local import LocalSkillEnhancer
 
 
@@ -165,7 +165,12 @@ Another paragraph of content.
 
         # Create large reference file (>12K chars to trigger per-file truncation)
         # Note: read_reference_files() skips index.md, so use api.md
-        large_content = "\n".join([f"# Section {i}\n\nContent here with more text to make it substantial.\n\n```python\ndef func_{i}(): pass\n```\n" for i in range(200)])
+        large_content = "\n".join(
+            [
+                f"# Section {i}\n\nContent here with more text to make it substantial.\n\n```python\ndef func_{i}(): pass\n```\n"
+                for i in range(200)
+            ]
+        )
         (refs_dir / "api.md").write_text(large_content)
 
         enhancer = LocalSkillEnhancer(skill_dir)
@@ -193,11 +198,18 @@ Another paragraph of content.
 
         # Create content that exceeds 30K threshold
         # Note: read_reference_files() skips index.md, so use different names
-        large_content = "\n".join([f"# Section {i}\n\n" + "Content with detailed explanations " * 50 + "\n\n```python\ndef func_{i}(): pass\n```\n" for i in range(150)])
+        large_content = "\n".join(
+            [
+                f"# Section {i}\n\n"
+                + "Content with detailed explanations " * 50
+                + "\n\n```python\ndef func_{i}(): pass\n```\n"
+                for i in range(150)
+            ]
+        )
         (refs_dir / "api.md").write_text(large_content)
         # Add more reference files to ensure we exceed 30K
         (refs_dir / "guide.md").write_text(large_content)
-        (refs_dir / "tutorial.md").write_text(large_content[:len(large_content)//2])  # Half size
+        (refs_dir / "tutorial.md").write_text(large_content[: len(large_content) // 2])  # Half size
 
         enhancer = LocalSkillEnhancer(skill_dir)
 
@@ -205,7 +217,7 @@ Another paragraph of content.
         def mock_headless(prompt_file, timeout):
             return True
 
-        monkeypatch.setattr(enhancer, '_run_headless', mock_headless)
+        monkeypatch.setattr(enhancer, "_run_headless", mock_headless)
 
         # Run enhancement
         result = enhancer.run(headless=True)
diff --git a/tests/test_source_manager.py b/tests/test_source_manager.py
index 8fba7ad..b759fa6 100644
--- a/tests/test_source_manager.py
+++ b/tests/test_source_manager.py
@@ -4,9 +4,9 @@ Tests for SourceManager class (config source registry management)
 """
 
 import json
-import pytest
 from pathlib import Path
-from datetime import datetime, timezone
+
+import pytest
 
 from skill_seekers.mcp.source_manager import SourceManager
 
@@ -44,7 +44,7 @@ class TestSourceManagerInit:
         assert registry_file.exists()
 
         # Verify initial structure
-        with open(registry_file, 'r') as f:
+        with open(registry_file) as f:
             data = json.load(f)
             assert data == {"version": "1.0", "sources": []}
 
@@ -53,18 +53,15 @@ class TestSourceManagerInit:
         registry_file = temp_config_dir / "sources.json"
 
         # Create existing registry
-        existing_data = {
-            "version": "1.0",
-            "sources": [{"name": "test", "git_url": "https://example.com/repo.git"}]
-        }
-        with open(registry_file, 'w') as f:
+        existing_data = {"version": "1.0", "sources": [{"name": "test", "git_url": "https://example.com/repo.git"}]}
+        with open(registry_file, "w") as f:
             json.dump(existing_data, f)
 
         # Initialize manager
         manager = SourceManager(config_dir=str(temp_config_dir))
 
         # Verify data preserved
-        with open(registry_file, 'r') as f:
+        with open(registry_file) as f:
             data = json.load(f)
             assert len(data["sources"]) == 1
 
@@ -81,10 +78,7 @@ class TestAddSource:
 
     def test_add_source_minimal(self, source_manager):
         """Test adding source with minimal parameters."""
-        source = source_manager.add_source(
-            name="team",
-            git_url="https://github.com/myorg/configs.git"
-        )
+        source = source_manager.add_source(name="team", git_url="https://github.com/myorg/configs.git")
 
         assert source["name"] == "team"
         assert source["git_url"] == "https://github.com/myorg/configs.git"
@@ -105,7 +99,7 @@ class TestAddSource:
             token_env="CUSTOM_TOKEN",
             branch="develop",
             priority=1,
-            enabled=False
+            enabled=False,
         )
 
         assert source["name"] == "company"
@@ -117,44 +111,29 @@ class TestAddSource:
 
     def test_add_source_normalizes_name(self, source_manager):
         """Test that source names are normalized to lowercase."""
-        source = source_manager.add_source(
-            name="MyTeam",
-            git_url="https://github.com/org/repo.git"
-        )
+        source = source_manager.add_source(name="MyTeam", git_url="https://github.com/org/repo.git")
 
         assert source["name"] == "myteam"
 
     def test_add_source_invalid_name_empty(self, source_manager):
         """Test that empty source names are rejected."""
         with pytest.raises(ValueError, match="Invalid source name"):
-            source_manager.add_source(
-                name="",
-                git_url="https://github.com/org/repo.git"
-            )
+            source_manager.add_source(name="", git_url="https://github.com/org/repo.git")
 
     def test_add_source_invalid_name_special_chars(self, source_manager):
         """Test that source names with special characters are rejected."""
         with pytest.raises(ValueError, match="Invalid source name"):
-            source_manager.add_source(
-                name="team@company",
-                git_url="https://github.com/org/repo.git"
-            )
+            source_manager.add_source(name="team@company", git_url="https://github.com/org/repo.git")
 
     def test_add_source_valid_name_with_hyphens(self, source_manager):
         """Test that source names with hyphens are allowed."""
-        source = source_manager.add_source(
-            name="team-alpha",
-            git_url="https://github.com/org/repo.git"
-        )
+        source = source_manager.add_source(name="team-alpha", git_url="https://github.com/org/repo.git")
 
         assert source["name"] == "team-alpha"
 
     def test_add_source_valid_name_with_underscores(self, source_manager):
         """Test that source names with underscores are allowed."""
-        source = source_manager.add_source(
-            name="team_alpha",
-            git_url="https://github.com/org/repo.git"
-        )
+        source = source_manager.add_source(name="team_alpha", git_url="https://github.com/org/repo.git")
 
         assert source["name"] == "team_alpha"
 
@@ -165,26 +144,17 @@ class TestAddSource:
 
     def test_add_source_strips_git_url(self, source_manager):
         """Test that git URLs are stripped of whitespace."""
-        source = source_manager.add_source(
-            name="team",
-            git_url="  https://github.com/org/repo.git  "
-        )
+        source = source_manager.add_source(name="team", git_url="  https://github.com/org/repo.git  ")
 
         assert source["git_url"] == "https://github.com/org/repo.git"
 
     def test_add_source_updates_existing(self, source_manager):
         """Test that adding existing source updates it."""
         # Add initial source
-        source1 = source_manager.add_source(
-            name="team",
-            git_url="https://github.com/org/repo1.git"
-        )
+        source1 = source_manager.add_source(name="team", git_url="https://github.com/org/repo1.git")
 
         # Update source
-        source2 = source_manager.add_source(
-            name="team",
-            git_url="https://github.com/org/repo2.git"
-        )
+        source2 = source_manager.add_source(name="team", git_url="https://github.com/org/repo2.git")
 
         # Verify updated
         assert source2["git_url"] == "https://github.com/org/repo2.git"
@@ -197,14 +167,11 @@ class TestAddSource:
 
     def test_add_source_persists_to_file(self, source_manager, temp_config_dir):
         """Test that added sources are persisted to file."""
-        source_manager.add_source(
-            name="team",
-            git_url="https://github.com/org/repo.git"
-        )
+        source_manager.add_source(name="team", git_url="https://github.com/org/repo.git")
 
         # Read file directly
         registry_file = temp_config_dir / "sources.json"
-        with open(registry_file, 'r') as f:
+        with open(registry_file) as f:
             data = json.load(f)
 
         assert len(data["sources"]) == 1
@@ -346,7 +313,7 @@ class TestRemoveSource:
 
         # Read file directly
         registry_file = temp_config_dir / "sources.json"
-        with open(registry_file, 'r') as f:
+        with open(registry_file) as f:
             data = json.load(f)
 
         assert len(data["sources"]) == 1
@@ -405,11 +372,7 @@ class TestUpdateSource:
         source_manager.add_source(name="team", git_url="https://github.com/org/repo.git")
 
         updated = source_manager.update_source(
-            name="team",
-            git_url="https://gitlab.com/org/repo.git",
-            type="gitlab",
-            branch="develop",
-            priority=1
+            name="team", git_url="https://gitlab.com/org/repo.git", type="gitlab", branch="develop", priority=1
         )
 
         assert updated["git_url"] == "https://gitlab.com/org/repo.git"
@@ -449,30 +412,20 @@ class TestDefaultTokenEnv:
 
     def test_default_token_env_github(self, source_manager):
         """Test GitHub sources get GITHUB_TOKEN."""
-        source = source_manager.add_source(
-            name="team",
-            git_url="https://github.com/org/repo.git",
-            source_type="github"
-        )
+        source = source_manager.add_source(name="team", git_url="https://github.com/org/repo.git", source_type="github")
 
         assert source["token_env"] == "GITHUB_TOKEN"
 
     def test_default_token_env_gitlab(self, source_manager):
         """Test GitLab sources get GITLAB_TOKEN."""
-        source = source_manager.add_source(
-            name="team",
-            git_url="https://gitlab.com/org/repo.git",
-            source_type="gitlab"
-        )
+        source = source_manager.add_source(name="team", git_url="https://gitlab.com/org/repo.git", source_type="gitlab")
 
         assert source["token_env"] == "GITLAB_TOKEN"
 
     def test_default_token_env_gitea(self, source_manager):
         """Test Gitea sources get GITEA_TOKEN."""
         source = source_manager.add_source(
-            name="team",
-            git_url="https://gitea.example.com/org/repo.git",
-            source_type="gitea"
+            name="team", git_url="https://gitea.example.com/org/repo.git", source_type="gitea"
         )
 
         assert source["token_env"] == "GITEA_TOKEN"
@@ -480,9 +433,7 @@ class TestDefaultTokenEnv:
     def test_default_token_env_bitbucket(self, source_manager):
         """Test Bitbucket sources get BITBUCKET_TOKEN."""
         source = source_manager.add_source(
-            name="team",
-            git_url="https://bitbucket.org/org/repo.git",
-            source_type="bitbucket"
+            name="team", git_url="https://bitbucket.org/org/repo.git", source_type="bitbucket"
         )
 
         assert source["token_env"] == "BITBUCKET_TOKEN"
@@ -490,9 +441,7 @@ class TestDefaultTokenEnv:
     def test_default_token_env_custom(self, source_manager):
         """Test custom sources get GIT_TOKEN."""
         source = source_manager.add_source(
-            name="team",
-            git_url="https://git.example.com/org/repo.git",
-            source_type="custom"
+            name="team", git_url="https://git.example.com/org/repo.git", source_type="custom"
         )
 
         assert source["token_env"] == "GIT_TOKEN"
@@ -500,10 +449,7 @@ class TestDefaultTokenEnv:
     def test_override_token_env(self, source_manager):
         """Test that custom token_env overrides default."""
         source = source_manager.add_source(
-            name="team",
-            git_url="https://github.com/org/repo.git",
-            source_type="github",
-            token_env="MY_CUSTOM_TOKEN"
+            name="team", git_url="https://github.com/org/repo.git", source_type="github", token_env="MY_CUSTOM_TOKEN"
         )
 
         assert source["token_env"] == "MY_CUSTOM_TOKEN"
diff --git a/tests/test_swift_detection.py b/tests/test_swift_detection.py
index 3c4a252..dc7195c 100644
--- a/tests/test_swift_detection.py
+++ b/tests/test_swift_detection.py
@@ -16,6 +16,7 @@ Run with: pytest tests/test_swift_detection.py -v
 
 import pytest
 from bs4 import BeautifulSoup
+
 from skill_seekers.cli.language_detector import LanguageDetector
 
 
@@ -25,30 +26,30 @@ class TestSwiftCSSClassDetection:
     def test_language_swift_class(self):
         """Test language-swift CSS class"""
         detector = LanguageDetector()
-        classes = ['language-swift', 'highlight']
-        assert detector.extract_language_from_classes(classes) == 'swift'
+        classes = ["language-swift", "highlight"]
+        assert detector.extract_language_from_classes(classes) == "swift"
 
     def test_lang_swift_class(self):
         """Test lang-swift CSS class"""
         detector = LanguageDetector()
-        classes = ['lang-swift', 'code']
-        assert detector.extract_language_from_classes(classes) == 'swift'
+        classes = ["lang-swift", "code"]
+        assert detector.extract_language_from_classes(classes) == "swift"
 
     def test_bare_swift_class(self):
         """Test bare 'swift' class name"""
         detector = LanguageDetector()
-        classes = ['swift', 'highlight']
-        assert detector.extract_language_from_classes(classes) == 'swift'
+        classes = ["swift", "highlight"]
+        assert detector.extract_language_from_classes(classes) == "swift"
 
     def test_detect_from_html_swift_class(self):
         """Test HTML element with Swift CSS class"""
         detector = LanguageDetector()
         html = '<code class="language-swift">let x = 5</code>'
-        soup = BeautifulSoup(html, 'html.parser')
-        elem = soup.find('code')
+        soup = BeautifulSoup(html, "html.parser")
+        elem = soup.find("code")
 
-        lang, confidence = detector.detect_from_html(elem, 'let x = 5')
-        assert lang == 'swift'
+        lang, confidence = detector.detect_from_html(elem, "let x = 5")
+        assert lang == "swift"
         assert confidence == 1.0  # CSS class = high confidence
 
 
@@ -64,7 +65,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
     def test_struct_declaration(self):
@@ -77,7 +78,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.6
 
     def test_protocol_declaration(self):
@@ -90,7 +91,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_extension_declaration(self):
@@ -104,7 +105,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_guard_let_unwrapping(self):
@@ -119,7 +120,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_if_let_unwrapping(self):
@@ -131,7 +132,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
     def test_closure_syntax(self):
@@ -143,7 +144,7 @@ class TestPureSwiftDetection:
         let filtered = numbers.filter { (num) in num > 2 }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
     def test_error_handling(self):
@@ -164,7 +165,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_async_await(self):
@@ -183,7 +184,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_actor_declaration(self):
@@ -203,7 +204,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.6
 
     def test_generics_with_constraints(self):
@@ -218,7 +219,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.6
 
     def test_enum_with_associated_values(self):
@@ -237,7 +238,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.4  # Enums without strong Swift keywords have lower confidence
 
     def test_opaque_types(self):
@@ -249,7 +250,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
     def test_property_observers(self):
@@ -268,7 +269,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
     def test_memory_management_weak(self):
@@ -285,7 +286,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
     def test_memory_management_weak_self_in_closure(self):
@@ -302,7 +303,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_memory_management_unowned(self):
@@ -318,7 +319,7 @@ class TestPureSwiftDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
     def test_string_interpolation(self):
@@ -331,7 +332,7 @@ class TestPureSwiftDetection:
         print("Current value: \\(someVar)")
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.4
 
 
@@ -360,7 +361,7 @@ class TestUIKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_iboutlet_ibaction(self):
@@ -378,7 +379,7 @@ class TestUIKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_tableview_delegate(self):
@@ -398,7 +399,7 @@ class TestUIKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_auto_layout_constraints(self):
@@ -416,7 +417,7 @@ class TestUIKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_dispatch_queue(self):
@@ -434,7 +435,7 @@ class TestUIKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_codable_json(self):
@@ -457,7 +458,7 @@ class TestUIKitDetection:
         let user = try decoder.decode(User.self, from: jsonData)
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
 
@@ -486,7 +487,7 @@ class TestAppKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_nswindow_controller(self):
@@ -503,7 +504,7 @@ class TestAppKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_nstableview_delegate(self):
@@ -523,7 +524,7 @@ class TestAppKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_nsapplication_delegate(self):
@@ -544,7 +545,7 @@ class TestAppKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_nsmenu_toolbar(self):
@@ -561,7 +562,7 @@ class TestAppKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_nspanel_dialogs(self):
@@ -590,7 +591,7 @@ class TestAppKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_nsstatusbar_menubar_extra(self):
@@ -611,7 +612,7 @@ class TestAppKitDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
 
@@ -631,7 +632,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_state_binding(self):
@@ -652,7 +653,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_observable_object(self):
@@ -673,7 +674,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_environment_object(self):
@@ -692,7 +693,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_swiftui_stacks(self):
@@ -716,7 +717,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_swiftui_navigation(self):
@@ -735,7 +736,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_swiftui_modifiers(self):
@@ -754,7 +755,7 @@ class TestSwiftUIDetection:
             }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_swiftui_list_foreach(self):
@@ -774,7 +775,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_swiftui_sheet_alert(self):
@@ -797,7 +798,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_swiftui_macos_window_group(self):
@@ -825,7 +826,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.95
 
     def test_swiftui_navigation_split_view(self):
@@ -854,7 +855,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_swift_observation(self):
@@ -880,7 +881,7 @@ class TestSwiftUIDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
 
@@ -916,7 +917,7 @@ class TestCombineDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
     def test_combine_subjects(self):
@@ -939,7 +940,7 @@ class TestCombineDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.9
 
 
@@ -953,7 +954,7 @@ class TestSwiftConfidenceScoring:
         # Use guard let which is Swift-unique and gets high confidence
         code = "guard let value = optional else { return }"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5  # guard let is very Swift-specific
 
     def test_high_confidence_full_app(self):
@@ -997,7 +998,7 @@ class TestSwiftConfidenceScoring:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.95
 
     def test_swift_vs_similar_languages(self):
@@ -1024,7 +1025,7 @@ class TestSwiftConfidenceScoring:
         }
         """
         lang, _ = detector.detect_from_code(go_code)
-        assert lang == 'go', f"Expected 'go', got '{lang}'"
+        assert lang == "go", f"Expected 'go', got '{lang}'"
 
         # Rust code (also uses 'struct', 'fn')
         rust_code = """
@@ -1034,7 +1035,7 @@ class TestSwiftConfidenceScoring:
         }
         """
         lang, _ = detector.detect_from_code(rust_code)
-        assert lang == 'rust', f"Expected 'rust', got '{lang}'"
+        assert lang == "rust", f"Expected 'rust', got '{lang}'"
 
         # TypeScript code (similar type annotation syntax with ':')
         ts_code = """
@@ -1050,7 +1051,7 @@ class TestSwiftConfidenceScoring:
         export type Status = 'active' | 'inactive';
         """
         lang, _ = detector.detect_from_code(ts_code)
-        assert lang == 'typescript', f"Expected 'typescript', got '{lang}'"
+        assert lang == "typescript", f"Expected 'typescript', got '{lang}'"
 
 
 class TestSwiftEdgeCases:
@@ -1061,7 +1062,7 @@ class TestSwiftEdgeCases:
         detector = LanguageDetector()
         code = "guard let x = optional else { return }"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.3
 
     def test_swift_import_swiftui_only(self):
@@ -1069,7 +1070,7 @@ class TestSwiftEdgeCases:
         detector = LanguageDetector()
         code = "import SwiftUI"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.4
 
     def test_swift_import_uikit_only(self):
@@ -1077,7 +1078,7 @@ class TestSwiftEdgeCases:
         detector = LanguageDetector()
         code = "import UIKit"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.4
 
     def test_swift_import_appkit_only(self):
@@ -1085,7 +1086,7 @@ class TestSwiftEdgeCases:
         detector = LanguageDetector()
         code = "import AppKit"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.4
 
     def test_swift_with_comments(self):
@@ -1103,7 +1104,7 @@ class TestSwiftEdgeCases:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_swift_core_data(self):
@@ -1126,7 +1127,7 @@ class TestSwiftEdgeCases:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
     def test_swift_data(self):
@@ -1150,7 +1151,7 @@ class TestSwiftEdgeCases:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.8
 
 
@@ -1162,7 +1163,7 @@ class TestFoundationModelsDetection:
         detector = LanguageDetector()
         code = "import FoundationModels"
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.4
 
     def test_generable_macro(self):
@@ -1179,7 +1180,7 @@ class TestFoundationModelsDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_language_model_session(self):
@@ -1193,7 +1194,7 @@ class TestFoundationModelsDetection:
         print(response)
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_system_language_model(self):
@@ -1209,7 +1210,7 @@ class TestFoundationModelsDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_streaming_response(self):
@@ -1222,7 +1223,7 @@ class TestFoundationModelsDetection:
         }
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.7
 
     def test_guided_generation(self):
@@ -1236,7 +1237,7 @@ class TestFoundationModelsDetection:
         print(response.title)
         """
         lang, confidence = detector.detect_from_code(code)
-        assert lang == 'swift'
+        assert lang == "swift"
         assert confidence >= 0.5
 
 
@@ -1249,8 +1250,8 @@ class TestSwiftErrorHandling:
 
         # Invalid weight (too high)
         invalid_patterns = {
-            'test_lang': [
-                (r'valid_pattern', 10),  # Weight must be 1-5
+            "test_lang": [
+                (r"valid_pattern", 10),  # Weight must be 1-5
             ]
         }
 
@@ -1263,7 +1264,7 @@ class TestSwiftErrorHandling:
 
         # Invalid pattern (not a string)
         invalid_patterns = {
-            'test_lang': [
+            "test_lang": [
                 (12345, 5),  # Pattern must be string
             ]
         }
@@ -1277,7 +1278,7 @@ class TestSwiftErrorHandling:
 
         # Invalid structure (not a tuple)
         invalid_patterns = {
-            'test_lang': [
+            "test_lang": [
                 "not_a_tuple",  # Should be (pattern, weight) tuple
             ]
         }
@@ -1287,12 +1288,12 @@ class TestSwiftErrorHandling:
 
     def test_malformed_regex_patterns_are_skipped(self):
         """Test that invalid regex patterns are logged and skipped without crashing"""
-        from skill_seekers.cli.language_detector import LanguageDetector
-        import logging
         from unittest.mock import patch
 
+        from skill_seekers.cli.language_detector import LanguageDetector
+
         # Create detector - malformed patterns should be skipped during compilation
-        with patch('skill_seekers.cli.language_detector.logger') as mock_logger:
+        with patch("skill_seekers.cli.language_detector.logger") as mock_logger:
             # Inject a language with a malformed pattern
             import skill_seekers.cli.language_detector as ld_module
 
@@ -1301,19 +1302,18 @@ class TestSwiftErrorHandling:
 
             try:
                 # Add malformed pattern
-                ld_module.LANGUAGE_PATTERNS['test_malformed'] = [
-                    (r'(?P<invalid)', 5),  # Invalid regex group
-                    (r'valid_pattern', 3),  # Valid pattern
+                ld_module.LANGUAGE_PATTERNS["test_malformed"] = [
+                    (r"(?P<invalid)", 5),  # Invalid regex group
+                    (r"valid_pattern", 3),  # Valid pattern
                 ]
 
                 # Create new detector - should skip malformed pattern
                 detector = LanguageDetector()
 
                 # Verify error was logged
-                assert any(
-                    'Invalid regex pattern' in str(call)
-                    for call in mock_logger.error.call_args_list
-                ), "Expected error log for malformed pattern"
+                assert any("Invalid regex pattern" in str(call) for call in mock_logger.error.call_args_list), (
+                    "Expected error log for malformed pattern"
+                )
 
             finally:
                 # Restore original patterns
@@ -1326,11 +1326,13 @@ class TestSwiftErrorHandling:
 
         # Remove module from cache
         for mod in list(sys.modules.keys()):
-            if 'skill_seekers.cli' in mod:
+            if "skill_seekers.cli" in mod:
                 del sys.modules[mod]
 
         # Mock empty SWIFT_PATTERNS during import
-        with patch.dict('sys.modules', {'skill_seekers.cli.swift_patterns': type('MockModule', (), {'SWIFT_PATTERNS': {}})}):
+        with patch.dict(
+            "sys.modules", {"skill_seekers.cli.swift_patterns": type("MockModule", (), {"SWIFT_PATTERNS": {}})}
+        ):
             from skill_seekers.cli.language_detector import LanguageDetector
 
             # Create detector - should handle empty patterns gracefully
@@ -1346,11 +1348,11 @@ class TestSwiftErrorHandling:
 
     def test_non_string_pattern_handled_during_compilation(self):
         """Test that non-string patterns are caught during compilation"""
-        from skill_seekers.cli.language_detector import LanguageDetector
         from unittest.mock import patch
-        import logging
 
-        with patch('skill_seekers.cli.language_detector.logger') as mock_logger:
+        from skill_seekers.cli.language_detector import LanguageDetector
+
+        with patch("skill_seekers.cli.language_detector.logger") as mock_logger:
             import skill_seekers.cli.language_detector as ld_module
 
             # Save original
@@ -1358,7 +1360,7 @@ class TestSwiftErrorHandling:
 
             try:
                 # Add non-string pattern
-                ld_module.LANGUAGE_PATTERNS['test_nonstring'] = [
+                ld_module.LANGUAGE_PATTERNS["test_nonstring"] = [
                     (None, 5),  # None instead of string
                 ]
 
@@ -1366,10 +1368,9 @@ class TestSwiftErrorHandling:
                 detector = LanguageDetector()
 
                 # Verify TypeError was logged
-                assert any(
-                    'not a string' in str(call)
-                    for call in mock_logger.error.call_args_list
-                ), "Expected error log for non-string pattern"
+                assert any("not a string" in str(call) for call in mock_logger.error.call_args_list), (
+                    "Expected error log for non-string pattern"
+                )
 
             finally:
                 ld_module.LANGUAGE_PATTERNS = original
@@ -1381,16 +1382,17 @@ class TestSwiftErrorHandling:
         # but we can verify the try/except block exists in the code
 
         import inspect
+
         from skill_seekers.cli import swift_patterns
 
         # Read the source code of the module
         source = inspect.getsource(swift_patterns)
 
         # Verify error handling is present
-        assert 'try:' in source, "Expected try block for validation"
-        assert '_validate_patterns(SWIFT_PATTERNS)' in source, "Expected validation call"
-        assert 'except ValueError' in source, "Expected ValueError handling"
-        assert 'SWIFT_PATTERNS = {}' in source, "Expected pattern clearing on error"
+        assert "try:" in source, "Expected try block for validation"
+        assert "_validate_patterns(SWIFT_PATTERNS)" in source, "Expected validation call"
+        assert "except ValueError" in source, "Expected ValueError handling"
+        assert "SWIFT_PATTERNS = {}" in source, "Expected pattern clearing on error"
 
 
 if __name__ == "__main__":
diff --git a/tests/test_terminal_detection.py b/tests/test_terminal_detection.py
index 690ed7f..915dd93 100644
--- a/tests/test_terminal_detection.py
+++ b/tests/test_terminal_detection.py
@@ -5,16 +5,16 @@ This module tests the detect_terminal_app() function and terminal launching logi
 to ensure correct terminal selection across different environments.
 """
 
-import unittest
 import os
 import sys
-from unittest.mock import patch, MagicMock
+import unittest
 from pathlib import Path
+from unittest.mock import MagicMock, patch
 
 # Add parent directory to path for imports
 sys.path.insert(0, str(Path(__file__).parent.parent))
 
-from skill_seekers.cli.enhance_skill_local import detect_terminal_app, LocalSkillEnhancer
+from skill_seekers.cli.enhance_skill_local import LocalSkillEnhancer, detect_terminal_app
 
 
 class TestDetectTerminalApp(unittest.TestCase):
@@ -25,141 +25,142 @@ class TestDetectTerminalApp(unittest.TestCase):
 
     def setUp(self):
         """Save original environment variables."""
-        self.original_skill_seeker = os.environ.get('SKILL_SEEKER_TERMINAL')
-        self.original_term_program = os.environ.get('TERM_PROGRAM')
+        self.original_skill_seeker = os.environ.get("SKILL_SEEKER_TERMINAL")
+        self.original_term_program = os.environ.get("TERM_PROGRAM")
 
     def tearDown(self):
         """Restore original environment variables."""
         # Remove test env vars
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
-        if 'TERM_PROGRAM' in os.environ:
-            del os.environ['TERM_PROGRAM']
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
+        if "TERM_PROGRAM" in os.environ:
+            del os.environ["TERM_PROGRAM"]
 
         # Restore originals if they existed
         if self.original_skill_seeker is not None:
-            os.environ['SKILL_SEEKER_TERMINAL'] = self.original_skill_seeker
+            os.environ["SKILL_SEEKER_TERMINAL"] = self.original_skill_seeker
         if self.original_term_program is not None:
-            os.environ['TERM_PROGRAM'] = self.original_term_program
+            os.environ["TERM_PROGRAM"] = self.original_term_program
 
     # HIGH PRIORITY TESTS
 
     def test_detect_terminal_with_skill_seeker_env(self):
         """Test that SKILL_SEEKER_TERMINAL env var takes highest priority."""
-        os.environ['SKILL_SEEKER_TERMINAL'] = 'Ghostty'
+        os.environ["SKILL_SEEKER_TERMINAL"] = "Ghostty"
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'Ghostty')
-        self.assertEqual(detection_method, 'SKILL_SEEKER_TERMINAL')
+        self.assertEqual(terminal_app, "Ghostty")
+        self.assertEqual(detection_method, "SKILL_SEEKER_TERMINAL")
 
     def test_detect_terminal_with_term_program_known(self):
         """Test detection from TERM_PROGRAM with known terminal (iTerm)."""
         # Ensure SKILL_SEEKER_TERMINAL is not set
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
 
-        os.environ['TERM_PROGRAM'] = 'iTerm.app'
+        os.environ["TERM_PROGRAM"] = "iTerm.app"
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'iTerm')
-        self.assertEqual(detection_method, 'TERM_PROGRAM')
+        self.assertEqual(terminal_app, "iTerm")
+        self.assertEqual(detection_method, "TERM_PROGRAM")
 
     def test_detect_terminal_with_term_program_ghostty(self):
         """Test detection from TERM_PROGRAM with Ghostty terminal."""
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
 
-        os.environ['TERM_PROGRAM'] = 'ghostty'
+        os.environ["TERM_PROGRAM"] = "ghostty"
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'Ghostty')
-        self.assertEqual(detection_method, 'TERM_PROGRAM')
+        self.assertEqual(terminal_app, "Ghostty")
+        self.assertEqual(detection_method, "TERM_PROGRAM")
 
     def test_detect_terminal_with_term_program_apple_terminal(self):
         """Test detection from TERM_PROGRAM with Apple Terminal."""
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
 
-        os.environ['TERM_PROGRAM'] = 'Apple_Terminal'
+        os.environ["TERM_PROGRAM"] = "Apple_Terminal"
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'Terminal')
-        self.assertEqual(detection_method, 'TERM_PROGRAM')
+        self.assertEqual(terminal_app, "Terminal")
+        self.assertEqual(detection_method, "TERM_PROGRAM")
 
     def test_detect_terminal_with_term_program_wezterm(self):
         """Test detection from TERM_PROGRAM with WezTerm."""
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
 
-        os.environ['TERM_PROGRAM'] = 'WezTerm'
+        os.environ["TERM_PROGRAM"] = "WezTerm"
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'WezTerm')
-        self.assertEqual(detection_method, 'TERM_PROGRAM')
+        self.assertEqual(terminal_app, "WezTerm")
+        self.assertEqual(detection_method, "TERM_PROGRAM")
 
     def test_detect_terminal_with_term_program_unknown(self):
         """Test fallback behavior when TERM_PROGRAM is unknown (e.g., IDE terminals)."""
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
 
-        os.environ['TERM_PROGRAM'] = 'zed'
+        os.environ["TERM_PROGRAM"] = "zed"
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'Terminal')
-        self.assertEqual(detection_method, 'unknown TERM_PROGRAM (zed)')
+        self.assertEqual(terminal_app, "Terminal")
+        self.assertEqual(detection_method, "unknown TERM_PROGRAM (zed)")
 
     def test_detect_terminal_default_fallback(self):
         """Test default fallback when no environment variables are set."""
         # Remove both env vars
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
-        if 'TERM_PROGRAM' in os.environ:
-            del os.environ['TERM_PROGRAM']
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
+        if "TERM_PROGRAM" in os.environ:
+            del os.environ["TERM_PROGRAM"]
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'Terminal')
-        self.assertEqual(detection_method, 'default')
+        self.assertEqual(terminal_app, "Terminal")
+        self.assertEqual(detection_method, "default")
 
     def test_detect_terminal_priority_order(self):
         """Test that SKILL_SEEKER_TERMINAL takes priority over TERM_PROGRAM."""
-        os.environ['SKILL_SEEKER_TERMINAL'] = 'Ghostty'
-        os.environ['TERM_PROGRAM'] = 'iTerm.app'
+        os.environ["SKILL_SEEKER_TERMINAL"] = "Ghostty"
+        os.environ["TERM_PROGRAM"] = "iTerm.app"
 
         terminal_app, detection_method = detect_terminal_app()
 
         # SKILL_SEEKER_TERMINAL should win
-        self.assertEqual(terminal_app, 'Ghostty')
-        self.assertEqual(detection_method, 'SKILL_SEEKER_TERMINAL')
+        self.assertEqual(terminal_app, "Ghostty")
+        self.assertEqual(detection_method, "SKILL_SEEKER_TERMINAL")
 
-    @patch('subprocess.Popen')
+    @patch("subprocess.Popen")
     def test_subprocess_popen_called_with_correct_args(self, mock_popen):
         """Test that subprocess.Popen is called with correct arguments on macOS."""
         # Only test on macOS
-        if sys.platform != 'darwin':
+        if sys.platform != "darwin":
             self.skipTest("This test only runs on macOS")
 
         # Setup
-        os.environ['SKILL_SEEKER_TERMINAL'] = 'Ghostty'
+        os.environ["SKILL_SEEKER_TERMINAL"] = "Ghostty"
 
         # Create a test skill directory with minimal setup
         import tempfile
+
         with tempfile.TemporaryDirectory() as tmpdir:
-            skill_dir = Path(tmpdir) / 'test_skill'
+            skill_dir = Path(tmpdir) / "test_skill"
             skill_dir.mkdir()
 
             # Create references directory (required by LocalSkillEnhancer)
-            (skill_dir / 'references').mkdir()
-            (skill_dir / 'references' / 'test.md').write_text('# Test')
+            (skill_dir / "references").mkdir()
+            (skill_dir / "references" / "test.md").write_text("# Test")
 
             # Create SKILL.md (required)
-            (skill_dir / 'SKILL.md').write_text('---\nname: test\n---\n# Test')
+            (skill_dir / "SKILL.md").write_text("---\nname: test\n---\n# Test")
 
             # Mock Popen to prevent actual terminal launch
             mock_popen.return_value = MagicMock()
@@ -173,68 +174,70 @@ class TestDetectTerminalApp(unittest.TestCase):
 
             # Verify call arguments
             call_args = mock_popen.call_args[0][0]
-            self.assertEqual(call_args[0], 'open')
-            self.assertEqual(call_args[1], '-a')
-            self.assertEqual(call_args[2], 'Ghostty')
+            self.assertEqual(call_args[0], "open")
+            self.assertEqual(call_args[1], "-a")
+            self.assertEqual(call_args[2], "Ghostty")
             # call_args[3] should be the script file path
-            self.assertTrue(call_args[3].endswith('.sh'))
+            self.assertTrue(call_args[3].endswith(".sh"))
 
     # MEDIUM PRIORITY TESTS
 
     def test_detect_terminal_whitespace_handling(self):
         """Test that whitespace is stripped from environment variables."""
-        os.environ['SKILL_SEEKER_TERMINAL'] = '  Ghostty  '
+        os.environ["SKILL_SEEKER_TERMINAL"] = "  Ghostty  "
 
         terminal_app, detection_method = detect_terminal_app()
 
-        self.assertEqual(terminal_app, 'Ghostty')
-        self.assertEqual(detection_method, 'SKILL_SEEKER_TERMINAL')
+        self.assertEqual(terminal_app, "Ghostty")
+        self.assertEqual(detection_method, "SKILL_SEEKER_TERMINAL")
 
     def test_detect_terminal_empty_string_env_vars(self):
         """Test that empty string env vars fall through to next priority."""
-        os.environ['SKILL_SEEKER_TERMINAL'] = ''
-        os.environ['TERM_PROGRAM'] = 'iTerm.app'
+        os.environ["SKILL_SEEKER_TERMINAL"] = ""
+        os.environ["TERM_PROGRAM"] = "iTerm.app"
 
         terminal_app, detection_method = detect_terminal_app()
 
         # Should skip empty SKILL_SEEKER_TERMINAL and use TERM_PROGRAM
-        self.assertEqual(terminal_app, 'iTerm')
-        self.assertEqual(detection_method, 'TERM_PROGRAM')
+        self.assertEqual(terminal_app, "iTerm")
+        self.assertEqual(detection_method, "TERM_PROGRAM")
 
     def test_detect_terminal_empty_string_both_vars(self):
         """Test that empty strings on both vars falls back to default."""
-        os.environ['SKILL_SEEKER_TERMINAL'] = ''
-        os.environ['TERM_PROGRAM'] = ''
+        os.environ["SKILL_SEEKER_TERMINAL"] = ""
+        os.environ["TERM_PROGRAM"] = ""
 
         terminal_app, detection_method = detect_terminal_app()
 
         # Should fall back to default
-        self.assertEqual(terminal_app, 'Terminal')
+        self.assertEqual(terminal_app, "Terminal")
         # Empty TERM_PROGRAM should be treated as not set
-        self.assertEqual(detection_method, 'default')
+        self.assertEqual(detection_method, "default")
 
-    @patch('subprocess.Popen')
+    @patch("subprocess.Popen")
     def test_terminal_launch_error_handling(self, mock_popen):
         """Test error handling when terminal launch fails."""
         # Only test on macOS
-        if sys.platform != 'darwin':
+        if sys.platform != "darwin":
             self.skipTest("This test only runs on macOS")
 
         # Setup Popen to raise exception
         mock_popen.side_effect = Exception("Terminal not found")
 
         import tempfile
+
         with tempfile.TemporaryDirectory() as tmpdir:
-            skill_dir = Path(tmpdir) / 'test_skill'
+            skill_dir = Path(tmpdir) / "test_skill"
             skill_dir.mkdir()
-            (skill_dir / 'references').mkdir()
-            (skill_dir / 'references' / 'test.md').write_text('# Test')
-            (skill_dir / 'SKILL.md').write_text('---\nname: test\n---\n# Test')
+            (skill_dir / "references").mkdir()
+            (skill_dir / "references" / "test.md").write_text("# Test")
+            (skill_dir / "SKILL.md").write_text("---\nname: test\n---\n# Test")
 
             enhancer = LocalSkillEnhancer(skill_dir)
 
             # Capture stdout to check error message
             from io import StringIO
+
             captured_output = StringIO()
             old_stdout = sys.stdout
             sys.stdout = captured_output
@@ -250,35 +253,37 @@ class TestDetectTerminalApp(unittest.TestCase):
 
             # Should print error message
             output = captured_output.getvalue()
-            self.assertIn('Error launching', output)
+            self.assertIn("Error launching", output)
 
     def test_output_message_unknown_terminal(self):
         """Test that unknown terminal prints warning message."""
-        if sys.platform != 'darwin':
+        if sys.platform != "darwin":
             self.skipTest("This test only runs on macOS")
 
-        os.environ['TERM_PROGRAM'] = 'vscode'
-        if 'SKILL_SEEKER_TERMINAL' in os.environ:
-            del os.environ['SKILL_SEEKER_TERMINAL']
+        os.environ["TERM_PROGRAM"] = "vscode"
+        if "SKILL_SEEKER_TERMINAL" in os.environ:
+            del os.environ["SKILL_SEEKER_TERMINAL"]
 
         import tempfile
+
         with tempfile.TemporaryDirectory() as tmpdir:
-            skill_dir = Path(tmpdir) / 'test_skill'
+            skill_dir = Path(tmpdir) / "test_skill"
             skill_dir.mkdir()
-            (skill_dir / 'references').mkdir()
-            (skill_dir / 'references' / 'test.md').write_text('# Test')
-            (skill_dir / 'SKILL.md').write_text('---\nname: test\n---\n# Test')
+            (skill_dir / "references").mkdir()
+            (skill_dir / "references" / "test.md").write_text("# Test")
+            (skill_dir / "SKILL.md").write_text("---\nname: test\n---\n# Test")
 
             enhancer = LocalSkillEnhancer(skill_dir)
 
             # Capture stdout
             from io import StringIO
+
             captured_output = StringIO()
             old_stdout = sys.stdout
             sys.stdout = captured_output
 
             # Mock Popen to prevent actual launch
-            with patch('subprocess.Popen') as mock_popen:
+            with patch("subprocess.Popen") as mock_popen:
                 mock_popen.return_value = MagicMock()
                 # Run in interactive mode (not headless) to test terminal detection
                 enhancer.run(headless=False)
@@ -289,10 +294,10 @@ class TestDetectTerminalApp(unittest.TestCase):
             output = captured_output.getvalue()
 
             # Should contain warning about unknown terminal
-            self.assertIn('⚠️', output)
-            self.assertIn('unknown TERM_PROGRAM', output)
-            self.assertIn('vscode', output)
-            self.assertIn('Using Terminal.app as fallback', output)
+            self.assertIn("⚠️", output)
+            self.assertIn("unknown TERM_PROGRAM", output)
+            self.assertIn("vscode", output)
+            self.assertIn("Using Terminal.app as fallback", output)
 
 
 class TestTerminalMapCompleteness(unittest.TestCase):
@@ -306,27 +311,27 @@ class TestTerminalMapCompleteness(unittest.TestCase):
         # We need to test this indirectly by checking each known terminal
 
         known_terminals = [
-            ('Apple_Terminal', 'Terminal'),
-            ('iTerm.app', 'iTerm'),
-            ('ghostty', 'Ghostty'),
-            ('WezTerm', 'WezTerm'),
+            ("Apple_Terminal", "Terminal"),
+            ("iTerm.app", "iTerm"),
+            ("ghostty", "Ghostty"),
+            ("WezTerm", "WezTerm"),
         ]
 
         for term_program_value, expected_app_name in known_terminals:
             # Set TERM_PROGRAM and verify detection
-            os.environ['TERM_PROGRAM'] = term_program_value
-            if 'SKILL_SEEKER_TERMINAL' in os.environ:
-                del os.environ['SKILL_SEEKER_TERMINAL']
+            os.environ["TERM_PROGRAM"] = term_program_value
+            if "SKILL_SEEKER_TERMINAL" in os.environ:
+                del os.environ["SKILL_SEEKER_TERMINAL"]
 
             terminal_app, detection_method = detect_terminal_app()
 
             self.assertEqual(
                 terminal_app,
                 expected_app_name,
-                f"TERM_PROGRAM='{term_program_value}' should map to '{expected_app_name}'"
+                f"TERM_PROGRAM='{term_program_value}' should map to '{expected_app_name}'",
             )
-            self.assertEqual(detection_method, 'TERM_PROGRAM')
+            self.assertEqual(detection_method, "TERM_PROGRAM")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_test_example_extractor.py b/tests/test_test_example_extractor.py
index 0cbfa2d..ed195c3 100644
--- a/tests/test_test_example_extractor.py
+++ b/tests/test_test_example_extractor.py
@@ -10,23 +10,23 @@ Test Coverage:
 - End-to-end (1 test) - Full workflow
 """
 
-import unittest
-import sys
 import os
-from pathlib import Path
-import tempfile
 import shutil
+import sys
+import tempfile
+import unittest
+from pathlib import Path
 
 # Add src to path
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 from skill_seekers.cli.test_example_extractor import (
-    TestExample,
-    ExampleReport,
-    PythonTestAnalyzer,
-    GenericTestAnalyzer,
     ExampleQualityFilter,
-    TestExampleExtractor
+    ExampleReport,
+    GenericTestAnalyzer,
+    PythonTestAnalyzer,
+    TestExample,
+    TestExampleExtractor,
 )
 
 
@@ -154,9 +154,7 @@ def test_query(database):
 
         # Check for pytest markers or tags
         has_pytest_indicator = any(
-            'pytest' in ' '.join(ex.tags).lower() or
-            'pytest' in ex.description.lower()
-            for ex in examples
+            "pytest" in " ".join(ex.tags).lower() or "pytest" in ex.description.lower() for ex in examples
         )
         self.assertTrue(has_pytest_indicator or len(examples) > 0)  # At least extracted something
 
@@ -209,11 +207,11 @@ def test_complete_workflow():
     def test_confidence_scoring(self):
         """Test confidence scores are calculated correctly"""
         # Simple instantiation
-        simple_code = '''
+        simple_code = """
 def test_simple():
     obj = MyClass()
     assert obj is not None
-'''
+"""
         simple_examples = self.analyzer.extract("test_simple.py", simple_code)
 
         # Complex instantiation
@@ -246,7 +244,7 @@ class TestGenericTestAnalyzer(unittest.TestCase):
 
     def test_extract_javascript_instantiation(self):
         """Test JavaScript object instantiation extraction"""
-        code = '''
+        code = """
 describe("Database", () => {
     test("should connect to database", () => {
         const db = new Database({
@@ -256,7 +254,7 @@ describe("Database", () => {
         expect(db.isConnected()).toBe(true);
     });
 });
-'''
+"""
         examples = self.analyzer.extract("test_db.js", code, "JavaScript")
 
         self.assertGreater(len(examples), 0)
@@ -265,7 +263,7 @@ describe("Database", () => {
 
     def test_extract_go_table_tests(self):
         """Test Go table-driven test extraction"""
-        code = '''
+        code = """
 func TestAdd(t *testing.T) {
     result := Add(1, 2)
     if result != 3 {
@@ -280,7 +278,7 @@ func TestSubtract(t *testing.T) {
         t.Errorf("Subtract(5, 3) = %d; want 2", result)
     }
 }
-'''
+"""
         examples = self.analyzer.extract("add_test.go", code, "Go")
 
         # Should extract at least test function or instantiation
@@ -290,7 +288,7 @@ func TestSubtract(t *testing.T) {
 
     def test_extract_rust_assertions(self):
         """Test Rust test assertion extraction"""
-        code = '''
+        code = """
 #[test]
 fn test_add() {
     let result = add(2, 2);
@@ -302,7 +300,7 @@ fn test_subtract() {
     let calc = Calculator::new();
     assert_eq!(calc.subtract(5, 3), 2);
 }
-'''
+"""
         examples = self.analyzer.extract("lib_test.rs", code, "Rust")
 
         self.assertGreater(len(examples), 0)
@@ -310,12 +308,12 @@ fn test_subtract() {
 
     def test_language_fallback(self):
         """Test handling of unsupported languages"""
-        code = '''
+        code = """
 test("example", () => {
     const x = 1;
     expect(x).toBe(1);
 });
-'''
+"""
         # Unsupported language should return empty list
         examples = self.analyzer.extract("test.unknown", code, "Unknown")
         self.assertEqual(len(examples), 0)
@@ -344,7 +342,7 @@ class TestExampleQualityFilter(unittest.TestCase):
                 complexity_score=0.5,
                 confidence=0.8,
                 tags=[],
-                dependencies=[]
+                dependencies=[],
             ),
             TestExample(
                 example_id="2",
@@ -360,8 +358,8 @@ class TestExampleQualityFilter(unittest.TestCase):
                 complexity_score=0.5,
                 confidence=0.4,
                 tags=[],
-                dependencies=[]
-            )
+                dependencies=[],
+            ),
         ]
 
         filtered = self.filter.filter(examples)
@@ -387,7 +385,7 @@ class TestExampleQualityFilter(unittest.TestCase):
                 complexity_score=0.5,
                 confidence=0.8,
                 tags=[],
-                dependencies=[]
+                dependencies=[],
             ),
             TestExample(
                 example_id="2",
@@ -403,8 +401,8 @@ class TestExampleQualityFilter(unittest.TestCase):
                 complexity_score=0.6,
                 confidence=0.8,
                 tags=[],
-                dependencies=[]
-            )
+                dependencies=[],
+            ),
         ]
 
         filtered = self.filter.filter(examples)
@@ -430,7 +428,7 @@ class TestExampleQualityFilter(unittest.TestCase):
                 complexity_score=0.1,
                 confidence=0.8,
                 tags=[],
-                dependencies=[]
+                dependencies=[],
             ),
             TestExample(
                 example_id="2",
@@ -446,8 +444,8 @@ class TestExampleQualityFilter(unittest.TestCase):
                 complexity_score=0.6,
                 confidence=0.8,
                 tags=[],
-                dependencies=[]
-            )
+                dependencies=[],
+            ),
         ]
 
         filtered = self.filter.filter(examples)
@@ -489,20 +487,20 @@ def test_addition():
         """Test filtering by programming language"""
         # Create Python test
         py_file = self.temp_dir / "test_py.py"
-        py_file.write_text('''
+        py_file.write_text("""
 def test_python():
     obj = MyClass(param="value")
     assert obj is not None
-''')
+""")
 
         # Create JavaScript test
         js_file = self.temp_dir / "test_js.js"
-        js_file.write_text('''
+        js_file.write_text("""
 test("javascript test", () => {
     const obj = new MyClass();
     expect(obj).toBeDefined();
 });
-''')
+""")
 
         # Extract Python only
         python_extractor = TestExampleExtractor(languages=["python"])
@@ -583,6 +581,6 @@ def test_workflow():
             self.assertLessEqual(example.confidence, 1.0)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     # Run tests with verbose output
     unittest.main(verbosity=2)
diff --git a/tests/test_unified.py b/tests/test_unified.py
index aa6afa7..b2f41b0 100644
--- a/tests/test_unified.py
+++ b/tests/test_unified.py
@@ -9,44 +9,38 @@ Covers:
 - Skill building
 """
 
-import os
-import sys
 import json
-import pytest
+import os
 import tempfile
 from pathlib import Path
 
+import pytest
+
 from skill_seekers.cli.config_validator import ConfigValidator, validate_config
-from skill_seekers.cli.conflict_detector import ConflictDetector, Conflict
+from skill_seekers.cli.conflict_detector import Conflict, ConflictDetector
 from skill_seekers.cli.merge_sources import RuleBasedMerger
 from skill_seekers.cli.unified_skill_builder import UnifiedSkillBuilder
 
-
 # ===========================
 # Config Validation Tests
 # ===========================
 
+
 def test_detect_unified_format():
     """Test unified format detection"""
-    import tempfile
     import json
+    import tempfile
 
     unified_config = {
         "name": "test",
         "description": "Test skill",
-        "sources": [
-            {"type": "documentation", "base_url": "https://example.com"}
-        ]
+        "sources": [{"type": "documentation", "base_url": "https://example.com"}],
     }
 
-    legacy_config = {
-        "name": "test",
-        "description": "Test skill",
-        "base_url": "https://example.com"
-    }
+    legacy_config = {"name": "test", "description": "Test skill", "base_url": "https://example.com"}
 
     # Test unified detection
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(unified_config, f)
         config_path = f.name
 
@@ -57,7 +51,7 @@ def test_detect_unified_format():
         os.unlink(config_path)
 
     # Test legacy detection
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(legacy_config, f)
         config_path = f.name
 
@@ -76,13 +70,13 @@ def test_validate_unified_sources():
         "sources": [
             {"type": "documentation", "base_url": "https://example.com"},
             {"type": "github", "repo": "user/repo"},
-            {"type": "pdf", "path": "/path/to.pdf"}
-        ]
+            {"type": "pdf", "path": "/path/to.pdf"},
+        ],
     }
 
     validator = ConfigValidator(config)
     validator.validate()
-    assert len(validator.config['sources']) == 3
+    assert len(validator.config["sources"]) == 3
 
 
 def test_validate_invalid_source_type():
@@ -90,9 +84,7 @@ def test_validate_invalid_source_type():
     config = {
         "name": "test",
         "description": "Test",
-        "sources": [
-            {"type": "invalid_type", "url": "https://example.com"}
-        ]
+        "sources": [{"type": "invalid_type", "url": "https://example.com"}],
     }
 
     validator = ConfigValidator(config)
@@ -108,8 +100,8 @@ def test_needs_api_merge():
         "description": "Test",
         "sources": [
             {"type": "documentation", "base_url": "https://example.com", "extract_api": True},
-            {"type": "github", "repo": "user/repo", "include_code": True}
-        ]
+            {"type": "github", "repo": "user/repo", "include_code": True},
+        ],
     }
 
     validator = ConfigValidator(config_needs_merge)
@@ -119,9 +111,7 @@ def test_needs_api_merge():
     config_no_merge = {
         "name": "test",
         "description": "Test",
-        "sources": [
-            {"type": "documentation", "base_url": "https://example.com"}
-        ]
+        "sources": [{"type": "documentation", "base_url": "https://example.com"}],
     }
 
     validator = ConfigValidator(config_no_merge)
@@ -135,48 +125,45 @@ def test_backward_compatibility():
         "description": "Test skill",
         "base_url": "https://example.com",
         "selectors": {"main_content": "article"},
-        "max_pages": 100
+        "max_pages": 100,
     }
 
     validator = ConfigValidator(legacy_config)
     unified = validator.convert_legacy_to_unified()
 
-    assert 'sources' in unified
-    assert len(unified['sources']) == 1
-    assert unified['sources'][0]['type'] == 'documentation'
-    assert unified['sources'][0]['base_url'] == 'https://example.com'
+    assert "sources" in unified
+    assert len(unified["sources"]) == 1
+    assert unified["sources"][0]["type"] == "documentation"
+    assert unified["sources"][0]["base_url"] == "https://example.com"
 
 
 # ===========================
 # Conflict Detection Tests
 # ===========================
 
+
 def test_detect_missing_in_docs():
     """Test detection of APIs missing in documentation"""
     docs_data = {
-        'pages': [
+        "pages": [
             {
-                'url': 'https://example.com/api',
-                'apis': [
-                    {
-                        'name': 'documented_func',
-                        'parameters': [{'name': 'x', 'type': 'int'}],
-                        'return_type': 'str'
-                    }
-                ]
+                "url": "https://example.com/api",
+                "apis": [
+                    {"name": "documented_func", "parameters": [{"name": "x", "type": "int"}], "return_type": "str"}
+                ],
             }
         ]
     }
 
     github_data = {
-        'code_analysis': {
-            'analyzed_files': [
+        "code_analysis": {
+            "analyzed_files": [
                 {
-                    'functions': [
+                    "functions": [
                         {
-                            'name': 'undocumented_func',
-                            'parameters': [{'name': 'y', 'type_hint': 'float'}],
-                            'return_type': 'bool'
+                            "name": "undocumented_func",
+                            "parameters": [{"name": "y", "type_hint": "float"}],
+                            "return_type": "bool",
                         }
                     ]
                 }
@@ -188,70 +175,54 @@ def test_detect_missing_in_docs():
     conflicts = detector._find_missing_in_docs()
 
     assert len(conflicts) > 0
-    assert any(c.type == 'missing_in_docs' for c in conflicts)
-    assert any(c.api_name == 'undocumented_func' for c in conflicts)
+    assert any(c.type == "missing_in_docs" for c in conflicts)
+    assert any(c.api_name == "undocumented_func" for c in conflicts)
 
 
 def test_detect_missing_in_code():
     """Test detection of APIs missing in code"""
     docs_data = {
-        'pages': [
+        "pages": [
             {
-                'url': 'https://example.com/api',
-                'apis': [
-                    {
-                        'name': 'obsolete_func',
-                        'parameters': [{'name': 'x', 'type': 'int'}],
-                        'return_type': 'str'
-                    }
-                ]
+                "url": "https://example.com/api",
+                "apis": [{"name": "obsolete_func", "parameters": [{"name": "x", "type": "int"}], "return_type": "str"}],
             }
         ]
     }
 
-    github_data = {
-        'code_analysis': {
-            'analyzed_files': []
-        }
-    }
+    github_data = {"code_analysis": {"analyzed_files": []}}
 
     detector = ConflictDetector(docs_data, github_data)
     conflicts = detector._find_missing_in_code()
 
     assert len(conflicts) > 0
-    assert any(c.type == 'missing_in_code' for c in conflicts)
-    assert any(c.api_name == 'obsolete_func' for c in conflicts)
+    assert any(c.type == "missing_in_code" for c in conflicts)
+    assert any(c.api_name == "obsolete_func" for c in conflicts)
 
 
 def test_detect_signature_mismatch():
     """Test detection of signature mismatches"""
     docs_data = {
-        'pages': [
+        "pages": [
             {
-                'url': 'https://example.com/api',
-                'apis': [
-                    {
-                        'name': 'func',
-                        'parameters': [{'name': 'x', 'type': 'int'}],
-                        'return_type': 'str'
-                    }
-                ]
+                "url": "https://example.com/api",
+                "apis": [{"name": "func", "parameters": [{"name": "x", "type": "int"}], "return_type": "str"}],
             }
         ]
     }
 
     github_data = {
-        'code_analysis': {
-            'analyzed_files': [
+        "code_analysis": {
+            "analyzed_files": [
                 {
-                    'functions': [
+                    "functions": [
                         {
-                            'name': 'func',
-                            'parameters': [
-                                {'name': 'x', 'type_hint': 'int'},
-                                {'name': 'y', 'type_hint': 'bool', 'default': 'False'}
+                            "name": "func",
+                            "parameters": [
+                                {"name": "x", "type_hint": "int"},
+                                {"name": "y", "type_hint": "bool", "default": "False"},
                             ],
-                            'return_type': 'str'
+                            "return_type": "str",
                         }
                     ]
                 }
@@ -263,57 +234,52 @@ def test_detect_signature_mismatch():
     conflicts = detector._find_signature_mismatches()
 
     assert len(conflicts) > 0
-    assert any(c.type == 'signature_mismatch' for c in conflicts)
-    assert any(c.api_name == 'func' for c in conflicts)
+    assert any(c.type == "signature_mismatch" for c in conflicts)
+    assert any(c.api_name == "func" for c in conflicts)
 
 
 def test_conflict_severity():
     """Test conflict severity assignment"""
     # High severity: missing_in_code
     conflict_high = Conflict(
-        type='missing_in_code',
-        severity='high',
-        api_name='test',
-        docs_info={'name': 'test'},
+        type="missing_in_code",
+        severity="high",
+        api_name="test",
+        docs_info={"name": "test"},
         code_info=None,
-        difference='API documented but not in code'
+        difference="API documented but not in code",
     )
-    assert conflict_high.severity == 'high'
+    assert conflict_high.severity == "high"
 
     # Medium severity: missing_in_docs
     conflict_medium = Conflict(
-        type='missing_in_docs',
-        severity='medium',
-        api_name='test',
+        type="missing_in_docs",
+        severity="medium",
+        api_name="test",
         docs_info=None,
-        code_info={'name': 'test'},
-        difference='API in code but not documented'
+        code_info={"name": "test"},
+        difference="API in code but not documented",
     )
-    assert conflict_medium.severity == 'medium'
+    assert conflict_medium.severity == "medium"
 
 
 # ===========================
 # Merge Tests
 # ===========================
 
+
 def test_rule_based_merge_docs_only():
     """Test rule-based merge for docs-only APIs"""
     docs_data = {
-        'pages': [
+        "pages": [
             {
-                'url': 'https://example.com/api',
-                'apis': [
-                    {
-                        'name': 'docs_only_api',
-                        'parameters': [{'name': 'x', 'type': 'int'}],
-                        'return_type': 'str'
-                    }
-                ]
+                "url": "https://example.com/api",
+                "apis": [{"name": "docs_only_api", "parameters": [{"name": "x", "type": "int"}], "return_type": "str"}],
             }
         ]
     }
 
-    github_data = {'code_analysis': {'analyzed_files': []}}
+    github_data = {"code_analysis": {"analyzed_files": []}}
 
     detector = ConflictDetector(docs_data, github_data)
     conflicts = detector.detect_all_conflicts()
@@ -321,24 +287,24 @@ def test_rule_based_merge_docs_only():
     merger = RuleBasedMerger(docs_data, github_data, conflicts)
     merged = merger.merge_all()
 
-    assert 'apis' in merged
-    assert 'docs_only_api' in merged['apis']
-    assert merged['apis']['docs_only_api']['status'] == 'docs_only'
+    assert "apis" in merged
+    assert "docs_only_api" in merged["apis"]
+    assert merged["apis"]["docs_only_api"]["status"] == "docs_only"
 
 
 def test_rule_based_merge_code_only():
     """Test rule-based merge for code-only APIs"""
-    docs_data = {'pages': []}
+    docs_data = {"pages": []}
 
     github_data = {
-        'code_analysis': {
-            'analyzed_files': [
+        "code_analysis": {
+            "analyzed_files": [
                 {
-                    'functions': [
+                    "functions": [
                         {
-                            'name': 'code_only_api',
-                            'parameters': [{'name': 'y', 'type_hint': 'float'}],
-                            'return_type': 'bool'
+                            "name": "code_only_api",
+                            "parameters": [{"name": "y", "type_hint": "float"}],
+                            "return_type": "bool",
                         }
                     ]
                 }
@@ -352,38 +318,28 @@ def test_rule_based_merge_code_only():
     merger = RuleBasedMerger(docs_data, github_data, conflicts)
     merged = merger.merge_all()
 
-    assert 'apis' in merged
-    assert 'code_only_api' in merged['apis']
-    assert merged['apis']['code_only_api']['status'] == 'code_only'
+    assert "apis" in merged
+    assert "code_only_api" in merged["apis"]
+    assert merged["apis"]["code_only_api"]["status"] == "code_only"
 
 
 def test_rule_based_merge_matched():
     """Test rule-based merge for matched APIs"""
     docs_data = {
-        'pages': [
+        "pages": [
             {
-                'url': 'https://example.com/api',
-                'apis': [
-                    {
-                        'name': 'matched_api',
-                        'parameters': [{'name': 'x', 'type': 'int'}],
-                        'return_type': 'str'
-                    }
-                ]
+                "url": "https://example.com/api",
+                "apis": [{"name": "matched_api", "parameters": [{"name": "x", "type": "int"}], "return_type": "str"}],
             }
         ]
     }
 
     github_data = {
-        'code_analysis': {
-            'analyzed_files': [
+        "code_analysis": {
+            "analyzed_files": [
                 {
-                    'functions': [
-                        {
-                            'name': 'matched_api',
-                            'parameters': [{'name': 'x', 'type_hint': 'int'}],
-                            'return_type': 'str'
-                        }
+                    "functions": [
+                        {"name": "matched_api", "parameters": [{"name": "x", "type_hint": "int"}], "return_type": "str"}
                     ]
                 }
             ]
@@ -396,34 +352,28 @@ def test_rule_based_merge_matched():
     merger = RuleBasedMerger(docs_data, github_data, conflicts)
     merged = merger.merge_all()
 
-    assert 'apis' in merged
-    assert 'matched_api' in merged['apis']
-    assert merged['apis']['matched_api']['status'] == 'matched'
+    assert "apis" in merged
+    assert "matched_api" in merged["apis"]
+    assert merged["apis"]["matched_api"]["status"] == "matched"
 
 
 def test_merge_summary():
     """Test merge summary statistics"""
     docs_data = {
-        'pages': [
+        "pages": [
             {
-                'url': 'https://example.com/api',
-                'apis': [
-                    {'name': 'api1', 'parameters': [], 'return_type': 'str'},
-                    {'name': 'api2', 'parameters': [], 'return_type': 'int'}
-                ]
+                "url": "https://example.com/api",
+                "apis": [
+                    {"name": "api1", "parameters": [], "return_type": "str"},
+                    {"name": "api2", "parameters": [], "return_type": "int"},
+                ],
             }
         ]
     }
 
     github_data = {
-        'code_analysis': {
-            'analyzed_files': [
-                {
-                    'functions': [
-                        {'name': 'api3', 'parameters': [], 'return_type': 'bool'}
-                    ]
-                }
-            ]
+        "code_analysis": {
+            "analyzed_files": [{"functions": [{"name": "api3", "parameters": [], "return_type": "bool"}]}]
         }
     }
 
@@ -433,32 +383,26 @@ def test_merge_summary():
     merger = RuleBasedMerger(docs_data, github_data, conflicts)
     merged = merger.merge_all()
 
-    assert 'summary' in merged
-    assert merged['summary']['total_apis'] == 3
-    assert merged['summary']['docs_only'] == 2
-    assert merged['summary']['code_only'] == 1
+    assert "summary" in merged
+    assert merged["summary"]["total_apis"] == 3
+    assert merged["summary"]["docs_only"] == 2
+    assert merged["summary"]["code_only"] == 1
 
 
 # ===========================
 # Skill Builder Tests
 # ===========================
 
+
 def test_skill_builder_basic():
     """Test basic skill building"""
     config = {
-        'name': 'test_skill',
-        'description': 'Test skill description',
-        'sources': [
-            {'type': 'documentation', 'base_url': 'https://example.com'}
-        ]
+        "name": "test_skill",
+        "description": "Test skill description",
+        "sources": [{"type": "documentation", "base_url": "https://example.com"}],
     }
 
-    scraped_data = {
-        'documentation': {
-            'pages': [],
-            'data_file': '/tmp/test.json'
-        }
-    }
+    scraped_data = {"documentation": {"pages": [], "data_file": "/tmp/test.json"}}
 
     with tempfile.TemporaryDirectory() as tmpdir:
         # Override output directory
@@ -468,35 +412,35 @@ def test_skill_builder_basic():
         builder._generate_skill_md()
 
         # Check SKILL.md was created
-        skill_md = Path(tmpdir) / 'SKILL.md'
+        skill_md = Path(tmpdir) / "SKILL.md"
         assert skill_md.exists()
 
         content = skill_md.read_text()
-        assert 'test_skill' in content.lower()
-        assert 'Test skill description' in content
+        assert "test_skill" in content.lower()
+        assert "Test skill description" in content
 
 
 def test_skill_builder_with_conflicts():
     """Test skill building with conflicts"""
     config = {
-        'name': 'test_skill',
-        'description': 'Test',
-        'sources': [
-            {'type': 'documentation', 'base_url': 'https://example.com'},
-            {'type': 'github', 'repo': 'user/repo'}
-        ]
+        "name": "test_skill",
+        "description": "Test",
+        "sources": [
+            {"type": "documentation", "base_url": "https://example.com"},
+            {"type": "github", "repo": "user/repo"},
+        ],
     }
 
     scraped_data = {}
 
     conflicts = [
         Conflict(
-            type='missing_in_code',
-            severity='high',
-            api_name='test_api',
-            docs_info={'name': 'test_api'},
+            type="missing_in_code",
+            severity="high",
+            api_name="test_api",
+            docs_info={"name": "test_api"},
             code_info=None,
-            difference='Test difference'
+            difference="Test difference",
         )
     ]
 
@@ -506,31 +450,27 @@ def test_skill_builder_with_conflicts():
 
         builder._generate_skill_md()
 
-        skill_md = Path(tmpdir) / 'SKILL.md'
+        skill_md = Path(tmpdir) / "SKILL.md"
         content = skill_md.read_text()
 
-        assert '1 conflicts detected' in content
-        assert 'missing_in_code' in content
+        assert "1 conflicts detected" in content
+        assert "missing_in_code" in content
 
 
 def test_skill_builder_merged_apis():
     """Test skill building with merged APIs"""
-    config = {
-        'name': 'test',
-        'description': 'Test',
-        'sources': []
-    }
+    config = {"name": "test", "description": "Test", "sources": []}
 
     scraped_data = {}
 
     merged_data = {
-        'apis': {
-            'test_api': {
-                'name': 'test_api',
-                'status': 'matched',
-                'merged_signature': 'test_api(x: int) -> str',
-                'merged_description': 'Test API',
-                'source': 'both'
+        "apis": {
+            "test_api": {
+                "name": "test_api",
+                "status": "matched",
+                "merged_signature": "test_api(x: int) -> str",
+                "merged_description": "Test API",
+                "source": "both",
             }
         }
     }
@@ -541,14 +481,15 @@ def test_skill_builder_merged_apis():
 
         content = builder._format_merged_apis()
 
-        assert '✅ Verified APIs' in content
-        assert 'test_api' in content
+        assert "✅ Verified APIs" in content
+        assert "test_api" in content
 
 
 # ===========================
 # Integration Tests
 # ===========================
 
+
 def test_full_workflow_unified_config():
     """Test complete workflow with unified config"""
     # Create test config
@@ -557,18 +498,9 @@ def test_full_workflow_unified_config():
         "description": "Test unified workflow",
         "merge_mode": "rule-based",
         "sources": [
-            {
-                "type": "documentation",
-                "base_url": "https://example.com",
-                "extract_api": True
-            },
-            {
-                "type": "github",
-                "repo": "user/repo",
-                "include_code": True,
-                "code_analysis_depth": "surface"
-            }
-        ]
+            {"type": "documentation", "base_url": "https://example.com", "extract_api": True},
+            {"type": "github", "repo": "user/repo", "include_code": True, "code_analysis_depth": "surface"},
+        ],
     }
 
     # Validate config
@@ -580,13 +512,11 @@ def test_full_workflow_unified_config():
 
 def test_config_file_validation():
     """Test validation from config file"""
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         config = {
             "name": "test",
             "description": "Test",
-            "sources": [
-                {"type": "documentation", "base_url": "https://example.com"}
-            ]
+            "sources": [{"type": "documentation", "base_url": "https://example.com"}],
         }
         json.dump(config, f)
         config_path = f.name
@@ -599,5 +529,5 @@ def test_config_file_validation():
 
 
 # Run tests
-if __name__ == '__main__':
-    pytest.main([__file__, '-v'])
+if __name__ == "__main__":
+    pytest.main([__file__, "-v"])
diff --git a/tests/test_unified_analyzer.py b/tests/test_unified_analyzer.py
index 22325e6..a43a28d 100644
--- a/tests/test_unified_analyzer.py
+++ b/tests/test_unified_analyzer.py
@@ -11,24 +11,16 @@ Analysis modes:
 """
 
 import os
+from unittest.mock import Mock, patch
+
 import pytest
-from pathlib import Path
-from unittest.mock import Mock, patch, MagicMock
-from skill_seekers.cli.unified_codebase_analyzer import (
-    AnalysisResult,
-    UnifiedCodebaseAnalyzer
-)
-from skill_seekers.cli.github_fetcher import (
-    CodeStream,
-    DocsStream,
-    InsightsStream,
-    ThreeStreamData
-)
+
+from skill_seekers.cli.github_fetcher import CodeStream, DocsStream, InsightsStream, ThreeStreamData
+from skill_seekers.cli.unified_codebase_analyzer import AnalysisResult, UnifiedCodebaseAnalyzer
 
 # Skip marker for tests requiring GitHub access
 requires_github = pytest.mark.skipif(
-    not os.environ.get('GITHUB_TOKEN'),
-    reason="GITHUB_TOKEN not set - skipping tests that require GitHub access"
+    not os.environ.get("GITHUB_TOKEN"), reason="GITHUB_TOKEN not set - skipping tests that require GitHub access"
 )
 
 
@@ -37,29 +29,25 @@ class TestAnalysisResult:
 
     def test_analysis_result_basic(self):
         """Test basic AnalysisResult creation."""
-        result = AnalysisResult(
-            code_analysis={'files': []},
-            source_type='local',
-            analysis_depth='basic'
-        )
-        assert result.code_analysis == {'files': []}
-        assert result.source_type == 'local'
-        assert result.analysis_depth == 'basic'
+        result = AnalysisResult(code_analysis={"files": []}, source_type="local", analysis_depth="basic")
+        assert result.code_analysis == {"files": []}
+        assert result.source_type == "local"
+        assert result.analysis_depth == "basic"
         assert result.github_docs is None
         assert result.github_insights is None
 
     def test_analysis_result_with_github(self):
         """Test AnalysisResult with GitHub data."""
         result = AnalysisResult(
-            code_analysis={'files': []},
-            github_docs={'readme': '# README'},
-            github_insights={'metadata': {'stars': 1234}},
-            source_type='github',
-            analysis_depth='c3x'
+            code_analysis={"files": []},
+            github_docs={"readme": "# README"},
+            github_insights={"metadata": {"stars": 1234}},
+            source_type="github",
+            analysis_depth="c3x",
         )
         assert result.github_docs is not None
         assert result.github_insights is not None
-        assert result.source_type == 'github'
+        assert result.source_type == "github"
 
 
 class TestURLDetection:
@@ -98,12 +86,12 @@ class TestBasicAnalysis:
         (tmp_path / "README.md").write_text("# README")
 
         analyzer = UnifiedCodebaseAnalyzer()
-        result = analyzer.analyze(source=str(tmp_path), depth='basic')
+        result = analyzer.analyze(source=str(tmp_path), depth="basic")
 
-        assert result.source_type == 'local'
-        assert result.analysis_depth == 'basic'
-        assert result.code_analysis['analysis_type'] == 'basic'
-        assert len(result.code_analysis['files']) >= 3
+        assert result.source_type == "local"
+        assert result.analysis_depth == "basic"
+        assert result.code_analysis["analysis_type"] == "basic"
+        assert len(result.code_analysis["files"]) >= 3
 
     def test_list_files(self, tmp_path):
         """Test file listing."""
@@ -116,10 +104,10 @@ class TestBasicAnalysis:
         files = analyzer.list_files(tmp_path)
 
         assert len(files) == 3
-        paths = [f['path'] for f in files]
-        assert 'file1.py' in paths
-        assert 'file2.js' in paths
-        assert 'subdir/file3.ts' in paths
+        paths = [f["path"] for f in files]
+        assert "file1.py" in paths
+        assert "file2.js" in paths
+        assert "subdir/file3.ts" in paths
 
     def test_get_directory_structure(self, tmp_path):
         """Test directory structure extraction."""
@@ -131,13 +119,13 @@ class TestBasicAnalysis:
         analyzer = UnifiedCodebaseAnalyzer()
         structure = analyzer.get_directory_structure(tmp_path)
 
-        assert structure['type'] == 'directory'
-        assert len(structure['children']) >= 3
+        assert structure["type"] == "directory"
+        assert len(structure["children"]) >= 3
 
-        child_names = [c['name'] for c in structure['children']]
-        assert 'src' in child_names
-        assert 'tests' in child_names
-        assert 'README.md' in child_names
+        child_names = [c["name"] for c in structure["children"]]
+        assert "src" in child_names
+        assert "tests" in child_names
+        assert "README.md" in child_names
 
     def test_extract_imports_python(self, tmp_path):
         """Test Python import extraction."""
@@ -154,10 +142,10 @@ def main():
         analyzer = UnifiedCodebaseAnalyzer()
         imports = analyzer.extract_imports(tmp_path)
 
-        assert '.py' in imports
-        python_imports = imports['.py']
-        assert any('import os' in imp for imp in python_imports)
-        assert any('from pathlib import Path' in imp for imp in python_imports)
+        assert ".py" in imports
+        python_imports = imports[".py"]
+        assert any("import os" in imp for imp in python_imports)
+        assert any("from pathlib import Path" in imp for imp in python_imports)
 
     def test_extract_imports_javascript(self, tmp_path):
         """Test JavaScript import extraction."""
@@ -172,9 +160,9 @@ function App() {}
         analyzer = UnifiedCodebaseAnalyzer()
         imports = analyzer.extract_imports(tmp_path)
 
-        assert '.js' in imports
-        js_imports = imports['.js']
-        assert any('import React' in imp for imp in js_imports)
+        assert ".js" in imports
+        js_imports = imports[".js"]
+        assert any("import React" in imp for imp in js_imports)
 
     def test_find_entry_points(self, tmp_path):
         """Test entry point detection."""
@@ -185,9 +173,9 @@ function App() {}
         analyzer = UnifiedCodebaseAnalyzer()
         entry_points = analyzer.find_entry_points(tmp_path)
 
-        assert 'main.py' in entry_points
-        assert 'setup.py' in entry_points
-        assert 'package.json' in entry_points
+        assert "main.py" in entry_points
+        assert "setup.py" in entry_points
+        assert "package.json" in entry_points
 
     def test_compute_statistics(self, tmp_path):
         """Test statistics computation."""
@@ -198,12 +186,12 @@ function App() {}
         analyzer = UnifiedCodebaseAnalyzer()
         stats = analyzer.compute_statistics(tmp_path)
 
-        assert stats['total_files'] == 3
-        assert stats['total_size_bytes'] == 450  # 100 + 200 + 150
-        assert stats['file_types']['.py'] == 2
-        assert stats['file_types']['.js'] == 1
-        assert stats['languages']['Python'] == 2
-        assert stats['languages']['JavaScript'] == 1
+        assert stats["total_files"] == 3
+        assert stats["total_size_bytes"] == 450  # 100 + 200 + 150
+        assert stats["file_types"][".py"] == 2
+        assert stats["file_types"][".js"] == 1
+        assert stats["languages"]["Python"] == 2
+        assert stats["languages"]["JavaScript"] == 1
 
 
 class TestC3xAnalysis:
@@ -215,46 +203,46 @@ class TestC3xAnalysis:
         (tmp_path / "main.py").write_text("import os\nprint('hello')")
 
         analyzer = UnifiedCodebaseAnalyzer()
-        result = analyzer.analyze(source=str(tmp_path), depth='c3x')
+        result = analyzer.analyze(source=str(tmp_path), depth="c3x")
 
-        assert result.source_type == 'local'
-        assert result.analysis_depth == 'c3x'
-        assert result.code_analysis['analysis_type'] == 'c3x'
+        assert result.source_type == "local"
+        assert result.analysis_depth == "c3x"
+        assert result.code_analysis["analysis_type"] == "c3x"
 
         # Check C3.x components are populated (not None)
-        assert 'c3_1_patterns' in result.code_analysis
-        assert 'c3_2_examples' in result.code_analysis
-        assert 'c3_3_guides' in result.code_analysis
-        assert 'c3_4_configs' in result.code_analysis
-        assert 'c3_7_architecture' in result.code_analysis
+        assert "c3_1_patterns" in result.code_analysis
+        assert "c3_2_examples" in result.code_analysis
+        assert "c3_3_guides" in result.code_analysis
+        assert "c3_4_configs" in result.code_analysis
+        assert "c3_7_architecture" in result.code_analysis
 
         # C3.x components should be lists (may be empty if analysis didn't find anything)
-        assert isinstance(result.code_analysis['c3_1_patterns'], list)
-        assert isinstance(result.code_analysis['c3_2_examples'], list)
-        assert isinstance(result.code_analysis['c3_3_guides'], list)
-        assert isinstance(result.code_analysis['c3_4_configs'], list)
-        assert isinstance(result.code_analysis['c3_7_architecture'], list)
+        assert isinstance(result.code_analysis["c3_1_patterns"], list)
+        assert isinstance(result.code_analysis["c3_2_examples"], list)
+        assert isinstance(result.code_analysis["c3_3_guides"], list)
+        assert isinstance(result.code_analysis["c3_4_configs"], list)
+        assert isinstance(result.code_analysis["c3_7_architecture"], list)
 
     def test_c3x_includes_basic_analysis(self, tmp_path):
         """Test that C3.x includes all basic analysis data."""
         (tmp_path / "main.py").write_text("code")
 
         analyzer = UnifiedCodebaseAnalyzer()
-        result = analyzer.analyze(source=str(tmp_path), depth='c3x')
+        result = analyzer.analyze(source=str(tmp_path), depth="c3x")
 
         # Should include basic analysis fields
-        assert 'files' in result.code_analysis
-        assert 'structure' in result.code_analysis
-        assert 'imports' in result.code_analysis
-        assert 'entry_points' in result.code_analysis
-        assert 'statistics' in result.code_analysis
+        assert "files" in result.code_analysis
+        assert "structure" in result.code_analysis
+        assert "imports" in result.code_analysis
+        assert "entry_points" in result.code_analysis
+        assert "statistics" in result.code_analysis
 
 
 class TestGitHubAnalysis:
     """Test GitHub repository analysis."""
 
     @requires_github
-    @patch('skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher')
+    @patch("skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher")
     def test_analyze_github_basic(self, mock_fetcher_class, tmp_path):
         """Test basic analysis of GitHub repository."""
         # Mock three-stream fetcher
@@ -265,10 +253,7 @@ class TestGitHubAnalysis:
         code_stream = CodeStream(directory=tmp_path, files=[tmp_path / "main.py"])
         docs_stream = DocsStream(readme="# README", contributing=None, docs_files=[])
         insights_stream = InsightsStream(
-            metadata={'stars': 1234},
-            common_problems=[],
-            known_solutions=[],
-            top_labels=[]
+            metadata={"stars": 1234}, common_problems=[], known_solutions=[], top_labels=[]
         )
         three_streams = ThreeStreamData(code_stream, docs_stream, insights_stream)
         mock_fetcher.fetch.return_value = three_streams
@@ -277,21 +262,17 @@ class TestGitHubAnalysis:
         (tmp_path / "main.py").write_text("print('hello')")
 
         analyzer = UnifiedCodebaseAnalyzer()
-        result = analyzer.analyze(
-            source="https://github.com/test/repo",
-            depth="basic",
-            fetch_github_metadata=True
-        )
+        result = analyzer.analyze(source="https://github.com/test/repo", depth="basic", fetch_github_metadata=True)
 
-        assert result.source_type == 'github'
-        assert result.analysis_depth == 'basic'
+        assert result.source_type == "github"
+        assert result.analysis_depth == "basic"
         assert result.github_docs is not None
         assert result.github_insights is not None
-        assert result.github_docs['readme'] == "# README"
-        assert result.github_insights['metadata']['stars'] == 1234
+        assert result.github_docs["readme"] == "# README"
+        assert result.github_insights["metadata"]["stars"] == 1234
 
     @requires_github
-    @patch('skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher')
+    @patch("skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher")
     def test_analyze_github_c3x(self, mock_fetcher_class, tmp_path):
         """Test C3.x analysis of GitHub repository."""
         # Mock three-stream fetcher
@@ -307,16 +288,13 @@ class TestGitHubAnalysis:
         (tmp_path / "main.py").write_text("code")
 
         analyzer = UnifiedCodebaseAnalyzer()
-        result = analyzer.analyze(
-            source="https://github.com/test/repo",
-            depth="c3x"
-        )
+        result = analyzer.analyze(source="https://github.com/test/repo", depth="c3x")
 
-        assert result.analysis_depth == 'c3x'
-        assert result.code_analysis['analysis_type'] == 'c3x'
+        assert result.analysis_depth == "c3x"
+        assert result.code_analysis["analysis_type"] == "c3x"
 
     @requires_github
-    @patch('skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher')
+    @patch("skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher")
     def test_analyze_github_without_metadata(self, mock_fetcher_class, tmp_path):
         """Test GitHub analysis without fetching metadata."""
         mock_fetcher = Mock()
@@ -331,11 +309,7 @@ class TestGitHubAnalysis:
         (tmp_path / "main.py").write_text("code")
 
         analyzer = UnifiedCodebaseAnalyzer()
-        result = analyzer.analyze(
-            source="https://github.com/test/repo",
-            depth="basic",
-            fetch_github_metadata=False
-        )
+        result = analyzer.analyze(source="https://github.com/test/repo", depth="basic", fetch_github_metadata=False)
 
         # Should not include GitHub docs/insights
         assert result.github_docs is None
@@ -373,8 +347,8 @@ class TestTokenHandling:
     """Test GitHub token handling."""
 
     @requires_github
-    @patch.dict('os.environ', {'GITHUB_TOKEN': 'test_token'})
-    @patch('skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher')
+    @patch.dict("os.environ", {"GITHUB_TOKEN": "test_token"})
+    @patch("skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher")
     def test_github_token_from_env(self, mock_fetcher_class, tmp_path):
         """Test GitHub token loaded from environment."""
         mock_fetcher = Mock()
@@ -394,10 +368,10 @@ class TestTokenHandling:
         # Verify fetcher was created with token
         mock_fetcher_class.assert_called_once()
         args = mock_fetcher_class.call_args[0]
-        assert args[1] == 'test_token'  # Second arg is github_token
+        assert args[1] == "test_token"  # Second arg is github_token
 
     @requires_github
-    @patch('skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher')
+    @patch("skill_seekers.cli.unified_codebase_analyzer.GitHubThreeStreamFetcher")
     def test_github_token_explicit(self, mock_fetcher_class, tmp_path):
         """Test explicit GitHub token parameter."""
         mock_fetcher = Mock()
@@ -411,12 +385,12 @@ class TestTokenHandling:
 
         (tmp_path / "main.py").write_text("code")
 
-        analyzer = UnifiedCodebaseAnalyzer(github_token='custom_token')
+        analyzer = UnifiedCodebaseAnalyzer(github_token="custom_token")
         result = analyzer.analyze(source="https://github.com/test/repo", depth="basic")
 
         mock_fetcher_class.assert_called_once()
         args = mock_fetcher_class.call_args[0]
-        assert args[1] == 'custom_token'
+        assert args[1] == "custom_token"
 
 
 class TestIntegration:
@@ -433,7 +407,7 @@ class TestIntegration:
         local_result = analyzer.analyze(source=str(tmp_path), depth="basic")
 
         # Both should have same core analysis structure
-        assert 'files' in local_result.code_analysis
-        assert 'structure' in local_result.code_analysis
-        assert 'imports' in local_result.code_analysis
-        assert local_result.code_analysis['analysis_type'] == 'basic'
+        assert "files" in local_result.code_analysis
+        assert "structure" in local_result.code_analysis
+        assert "imports" in local_result.code_analysis
+        assert local_result.code_analysis["analysis_type"] == "basic"
diff --git a/tests/test_unified_mcp_integration.py b/tests/test_unified_mcp_integration.py
index 5d4a0c1..d8de2f2 100644
--- a/tests/test_unified_mcp_integration.py
+++ b/tests/test_unified_mcp_integration.py
@@ -5,21 +5,23 @@ Test MCP Integration with Unified Scraping
 Tests that the MCP server correctly handles unified configs.
 """
 
-import sys
-import os
-import json
-import tempfile
 import asyncio
-import pytest
+import json
+import os
+import sys
+import tempfile
 from pathlib import Path
 
+import pytest
+
 # WORKAROUND for shadowing issue: Temporarily change to /tmp to import external mcp
 # This avoids any local mcp/ directory being in the import path
 _original_dir = os.getcwd()
 MCP_AVAILABLE = False
 try:
-    os.chdir('/tmp')  # Change away from project directory
+    os.chdir("/tmp")  # Change away from project directory
     from mcp.types import TextContent
+
     MCP_AVAILABLE = True
 except ImportError:
     pass
@@ -30,7 +32,7 @@ finally:
 pytestmark = pytest.mark.anyio
 
 if MCP_AVAILABLE:
-    from skill_seekers.mcp.server import validate_config_tool, scrape_docs_tool
+    from skill_seekers.mcp.server import scrape_docs_tool, validate_config_tool
 else:
     validate_config_tool = None
     scrape_docs_tool = None
@@ -93,17 +95,10 @@ async def test_mcp_scrape_docs_detection():
         "name": "test_mcp_unified",
         "description": "Test unified via MCP",
         "merge_mode": "rule-based",
-        "sources": [
-            {
-                "type": "documentation",
-                "base_url": "https://example.com",
-                "extract_api": True,
-                "max_pages": 5
-            }
-        ]
+        "sources": [{"type": "documentation", "base_url": "https://example.com", "extract_api": True, "max_pages": 5}],
     }
 
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(unified_config, f)
         unified_config_path = f.name
 
@@ -112,27 +107,27 @@ async def test_mcp_scrape_docs_detection():
         "name": "test_mcp_legacy",
         "description": "Test legacy via MCP",
         "base_url": "https://example.com",
-        "max_pages": 5
+        "max_pages": 5,
     }
 
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(legacy_config, f)
         legacy_config_path = f.name
 
     try:
         # Test unified detection
-        with open(unified_config_path, 'r') as f:
+        with open(unified_config_path) as f:
             config = json.load(f)
 
-        is_unified = 'sources' in config and isinstance(config['sources'], list)
+        is_unified = "sources" in config and isinstance(config["sources"], list)
         assert is_unified, "Should detect unified format"
         print("  ✅ Unified format detected correctly")
 
         # Test legacy detection
-        with open(legacy_config_path, 'r') as f:
+        with open(legacy_config_path) as f:
             config = json.load(f)
 
-        is_unified = 'sources' in config and isinstance(config['sources'], list)
+        is_unified = "sources" in config and isinstance(config["sources"], list)
         assert not is_unified, "Should detect legacy format"
         print("  ✅ Legacy format detected correctly")
 
@@ -152,12 +147,10 @@ async def test_mcp_merge_mode_override():
         "name": "test_merge_override",
         "description": "Test merge mode override",
         "merge_mode": "rule-based",
-        "sources": [
-            {"type": "documentation", "base_url": "https://example.com"}
-        ]
+        "sources": [{"type": "documentation", "base_url": "https://example.com"}],
     }
 
-    with tempfile.NamedTemporaryFile(mode='w', suffix='.json', delete=False) as f:
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
         json.dump(config, f)
         config_path = f.name
 
@@ -165,7 +158,7 @@ async def test_mcp_merge_mode_override():
         # Test that we can override merge_mode in args
         args = {
             "config_path": config_path,
-            "merge_mode": "claude-enhanced"  # Override
+            "merge_mode": "claude-enhanced",  # Override
         }
 
         # Check that args has merge_mode
@@ -198,9 +191,10 @@ async def run_all_tests():
     except Exception as e:
         print(f"\n❌ Unexpected error: {e}")
         import traceback
+
         traceback.print_exc()
         sys.exit(1)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     asyncio.run(run_all_tests())
diff --git a/tests/test_upload_skill.py b/tests/test_upload_skill.py
index 27a1e66..000e8e7 100644
--- a/tests/test_upload_skill.py
+++ b/tests/test_upload_skill.py
@@ -3,12 +3,11 @@
 Tests for cli/upload_skill.py functionality
 """
 
-import unittest
-import tempfile
-import zipfile
 import os
+import tempfile
+import unittest
+import zipfile
 from pathlib import Path
-import sys
 
 from skill_seekers.cli.upload_skill import upload_skill_api
 
@@ -18,20 +17,20 @@ class TestUploadSkillAPI(unittest.TestCase):
 
     def setUp(self):
         """Store original API key state"""
-        self.original_api_key = os.environ.get('ANTHROPIC_API_KEY')
+        self.original_api_key = os.environ.get("ANTHROPIC_API_KEY")
 
     def tearDown(self):
         """Restore original API key state"""
         if self.original_api_key:
-            os.environ['ANTHROPIC_API_KEY'] = self.original_api_key
-        elif 'ANTHROPIC_API_KEY' in os.environ:
-            del os.environ['ANTHROPIC_API_KEY']
+            os.environ["ANTHROPIC_API_KEY"] = self.original_api_key
+        elif "ANTHROPIC_API_KEY" in os.environ:
+            del os.environ["ANTHROPIC_API_KEY"]
 
     def create_test_zip(self, tmpdir):
         """Helper to create a test .zip file"""
         zip_path = Path(tmpdir) / "test-skill.zip"
 
-        with zipfile.ZipFile(zip_path, 'w') as zf:
+        with zipfile.ZipFile(zip_path, "w") as zf:
             zf.writestr("SKILL.md", "---\nname: test\n---\n# Test Skill")
             zf.writestr("references/index.md", "# Index")
 
@@ -40,8 +39,8 @@ class TestUploadSkillAPI(unittest.TestCase):
     def test_upload_without_api_key(self):
         """Test that upload fails gracefully without API key"""
         # Remove API key
-        if 'ANTHROPIC_API_KEY' in os.environ:
-            del os.environ['ANTHROPIC_API_KEY']
+        if "ANTHROPIC_API_KEY" in os.environ:
+            del os.environ["ANTHROPIC_API_KEY"]
 
         with tempfile.TemporaryDirectory() as tmpdir:
             zip_path = self.create_test_zip(tmpdir)
@@ -50,22 +49,22 @@ class TestUploadSkillAPI(unittest.TestCase):
 
             self.assertFalse(success)
             # Check for api_key (with underscore) in message
-            self.assertTrue('api_key' in message.lower() or 'api key' in message.lower())
+            self.assertTrue("api_key" in message.lower() or "api key" in message.lower())
 
     def test_upload_with_nonexistent_file(self):
         """Test upload with nonexistent file"""
-        os.environ['ANTHROPIC_API_KEY'] = 'sk-ant-test-key'
+        os.environ["ANTHROPIC_API_KEY"] = "sk-ant-test-key"
 
         success, message = upload_skill_api("/nonexistent/file.zip")
 
         self.assertFalse(success)
-        self.assertIn('not found', message.lower())
+        self.assertIn("not found", message.lower())
 
     def test_upload_with_invalid_zip(self):
         """Test upload with invalid zip file (not a zip)"""
-        os.environ['ANTHROPIC_API_KEY'] = 'sk-ant-test-key'
+        os.environ["ANTHROPIC_API_KEY"] = "sk-ant-test-key"
 
-        with tempfile.NamedTemporaryFile(suffix='.zip', delete=False) as tmpfile:
+        with tempfile.NamedTemporaryFile(suffix=".zip", delete=False) as tmpfile:
             tmpfile.write(b"Not a valid zip file")
             tmpfile.flush()
 
@@ -79,7 +78,7 @@ class TestUploadSkillAPI(unittest.TestCase):
 
     def test_upload_accepts_path_object(self):
         """Test that upload_skill_api accepts Path objects"""
-        os.environ['ANTHROPIC_API_KEY'] = 'sk-ant-test-key'
+        os.environ["ANTHROPIC_API_KEY"] = "sk-ant-test-key"
 
         with tempfile.TemporaryDirectory() as tmpdir:
             zip_path = self.create_test_zip(tmpdir)
@@ -99,17 +98,12 @@ class TestUploadSkillCLI(unittest.TestCase):
         import subprocess
 
         try:
-            result = subprocess.run(
-                ['skill-seekers', 'upload', '--help'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers", "upload", "--help"], capture_output=True, text=True, timeout=5)
 
             # argparse may return 0 or 2 for --help
             self.assertIn(result.returncode, [0, 2])
             output = result.stdout + result.stderr
-            self.assertTrue('usage:' in output.lower() or 'upload' in output.lower())
+            self.assertTrue("usage:" in output.lower() or "upload" in output.lower())
         except FileNotFoundError:
             self.skipTest("skill-seekers command not installed")
 
@@ -118,12 +112,7 @@ class TestUploadSkillCLI(unittest.TestCase):
         import subprocess
 
         try:
-            result = subprocess.run(
-                ['skill-seekers-upload', '--help'],
-                capture_output=True,
-                text=True,
-                timeout=5
-            )
+            result = subprocess.run(["skill-seekers-upload", "--help"], capture_output=True, text=True, timeout=5)
 
             # argparse may return 0 or 2 for --help
             self.assertIn(result.returncode, [0, 2])
@@ -134,17 +123,11 @@ class TestUploadSkillCLI(unittest.TestCase):
         """Test that CLI requires zip file argument"""
         import subprocess
 
-        result = subprocess.run(
-            ['python3', 'cli/upload_skill.py'],
-            capture_output=True,
-            text=True
-        )
+        result = subprocess.run(["python3", "cli/upload_skill.py"], capture_output=True, text=True)
 
         # Should fail or show usage
-        self.assertTrue(
-            result.returncode != 0 or 'usage' in result.stderr.lower() or 'usage' in result.stdout.lower()
-        )
+        self.assertTrue(result.returncode != 0 or "usage" in result.stderr.lower() or "usage" in result.stdout.lower())
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/tests/test_utilities.py b/tests/test_utilities.py
index 5604a2c..2f3124e 100644
--- a/tests/test_utilities.py
+++ b/tests/test_utilities.py
@@ -3,23 +3,22 @@
 Tests for cli/utils.py utility functions
 """
 
-import unittest
-import tempfile
 import os
+import tempfile
+import unittest
 import zipfile
 from pathlib import Path
-import sys
 
 from skill_seekers.cli.utils import (
-    has_api_key,
+    format_file_size,
     get_api_key,
     get_upload_url,
-    format_file_size,
-    validate_skill_directory,
-    validate_zip_file,
+    has_api_key,
     print_upload_instructions,
     retry_with_backoff,
-    retry_with_backoff_async
+    retry_with_backoff_async,
+    validate_skill_directory,
+    validate_zip_file,
 )
 
 
@@ -28,51 +27,51 @@ class TestAPIKeyFunctions(unittest.TestCase):
 
     def setUp(self):
         """Store original API key state"""
-        self.original_api_key = os.environ.get('ANTHROPIC_API_KEY')
+        self.original_api_key = os.environ.get("ANTHROPIC_API_KEY")
 
     def tearDown(self):
         """Restore original API key state"""
         if self.original_api_key:
-            os.environ['ANTHROPIC_API_KEY'] = self.original_api_key
-        elif 'ANTHROPIC_API_KEY' in os.environ:
-            del os.environ['ANTHROPIC_API_KEY']
+            os.environ["ANTHROPIC_API_KEY"] = self.original_api_key
+        elif "ANTHROPIC_API_KEY" in os.environ:
+            del os.environ["ANTHROPIC_API_KEY"]
 
     def test_has_api_key_when_set(self):
         """Test has_api_key returns True when key is set"""
-        os.environ['ANTHROPIC_API_KEY'] = 'sk-ant-test-key'
+        os.environ["ANTHROPIC_API_KEY"] = "sk-ant-test-key"
         self.assertTrue(has_api_key())
 
     def test_has_api_key_when_not_set(self):
         """Test has_api_key returns False when key is not set"""
-        if 'ANTHROPIC_API_KEY' in os.environ:
-            del os.environ['ANTHROPIC_API_KEY']
+        if "ANTHROPIC_API_KEY" in os.environ:
+            del os.environ["ANTHROPIC_API_KEY"]
         self.assertFalse(has_api_key())
 
     def test_has_api_key_when_empty_string(self):
         """Test has_api_key returns False when key is empty string"""
-        os.environ['ANTHROPIC_API_KEY'] = ''
+        os.environ["ANTHROPIC_API_KEY"] = ""
         self.assertFalse(has_api_key())
 
     def test_has_api_key_when_whitespace_only(self):
         """Test has_api_key returns False when key is whitespace"""
-        os.environ['ANTHROPIC_API_KEY'] = '   '
+        os.environ["ANTHROPIC_API_KEY"] = "   "
         self.assertFalse(has_api_key())
 
     def test_get_api_key_returns_key(self):
         """Test get_api_key returns the actual key"""
-        os.environ['ANTHROPIC_API_KEY'] = 'sk-ant-test-key'
-        self.assertEqual(get_api_key(), 'sk-ant-test-key')
+        os.environ["ANTHROPIC_API_KEY"] = "sk-ant-test-key"
+        self.assertEqual(get_api_key(), "sk-ant-test-key")
 
     def test_get_api_key_returns_none_when_not_set(self):
         """Test get_api_key returns None when not set"""
-        if 'ANTHROPIC_API_KEY' in os.environ:
-            del os.environ['ANTHROPIC_API_KEY']
+        if "ANTHROPIC_API_KEY" in os.environ:
+            del os.environ["ANTHROPIC_API_KEY"]
         self.assertIsNone(get_api_key())
 
     def test_get_api_key_strips_whitespace(self):
         """Test get_api_key strips whitespace from key"""
-        os.environ['ANTHROPIC_API_KEY'] = '  sk-ant-test-key  '
-        self.assertEqual(get_api_key(), 'sk-ant-test-key')
+        os.environ["ANTHROPIC_API_KEY"] = "  sk-ant-test-key  "
+        self.assertEqual(get_api_key(), "sk-ant-test-key")
 
 
 class TestGetUploadURL(unittest.TestCase):
@@ -165,7 +164,7 @@ class TestValidateZipFile(unittest.TestCase):
             zip_path = Path(tmpdir) / "test-skill.zip"
 
             # Create a real zip file
-            with zipfile.ZipFile(zip_path, 'w') as zf:
+            with zipfile.ZipFile(zip_path, "w") as zf:
                 zf.writestr("SKILL.md", "# Test")
 
             is_valid, error = validate_zip_file(zip_path)
@@ -187,7 +186,7 @@ class TestValidateZipFile(unittest.TestCase):
 
     def test_wrong_extension(self):
         """Test validation of file with wrong extension"""
-        with tempfile.NamedTemporaryFile(suffix='.txt') as tmpfile:
+        with tempfile.NamedTemporaryFile(suffix=".txt") as tmpfile:
             is_valid, error = validate_zip_file(tmpfile.name)
             self.assertFalse(is_valid)
             self.assertIn("not a .zip file", error.lower())
@@ -297,9 +296,7 @@ class TestRetryWithBackoffAsync(unittest.TestCase):
         async def operation():
             return "async success"
 
-        result = asyncio.run(
-            retry_with_backoff_async(operation, max_attempts=3)
-        )
+        result = asyncio.run(retry_with_backoff_async(operation, max_attempts=3))
         self.assertEqual(result, "async success")
 
     def test_async_retry_then_success(self):
@@ -315,9 +312,7 @@ class TestRetryWithBackoffAsync(unittest.TestCase):
                 raise ConnectionError("Async failure")
             return "async success"
 
-        result = asyncio.run(
-            retry_with_backoff_async(operation, max_attempts=3, base_delay=0.01)
-        )
+        result = asyncio.run(retry_with_backoff_async(operation, max_attempts=3, base_delay=0.01))
         self.assertEqual(result, "async success")
         self.assertEqual(call_count, 2)
 
@@ -329,10 +324,8 @@ class TestRetryWithBackoffAsync(unittest.TestCase):
             raise ConnectionError("Persistent async failure")
 
         with self.assertRaises(ConnectionError):
-            asyncio.run(
-                retry_with_backoff_async(operation, max_attempts=2, base_delay=0.01)
-            )
+            asyncio.run(retry_with_backoff_async(operation, max_attempts=2, base_delay=0.01))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     unittest.main()
diff --git a/uv.lock b/uv.lock
index 4b3168f..01ffb02 100644
--- a/uv.lock
+++ b/uv.lock
@@ -904,6 +904,79 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
 ]
 
+[[package]]
+name = "librt"
+version = "0.7.8"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e7/24/5f3646ff414285e0f7708fa4e946b9bf538345a41d1c375c439467721a5e/librt-0.7.8.tar.gz", hash = "sha256:1a4ede613941d9c3470b0368be851df6bb78ab218635512d0370b27a277a0862", size = 148323, upload-time = "2026-01-14T12:56:16.876Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/44/13/57b06758a13550c5f09563893b004f98e9537ee6ec67b7df85c3571c8832/librt-0.7.8-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b45306a1fc5f53c9330fbee134d8b3227fe5da2ab09813b892790400aa49352d", size = 56521, upload-time = "2026-01-14T12:54:40.066Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/24/bbea34d1452a10612fb45ac8356f95351ba40c2517e429602160a49d1fd0/librt-0.7.8-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:864c4b7083eeee250ed55135d2127b260d7eb4b5e953a9e5df09c852e327961b", size = 58456, upload-time = "2026-01-14T12:54:41.471Z" },
+    { url = "https://files.pythonhosted.org/packages/04/72/a168808f92253ec3a810beb1eceebc465701197dbc7e865a1c9ceb3c22c7/librt-0.7.8-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:6938cc2de153bc927ed8d71c7d2f2ae01b4e96359126c602721340eb7ce1a92d", size = 164392, upload-time = "2026-01-14T12:54:42.843Z" },
+    { url = "https://files.pythonhosted.org/packages/14/5c/4c0d406f1b02735c2e7af8ff1ff03a6577b1369b91aa934a9fa2cc42c7ce/librt-0.7.8-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:66daa6ac5de4288a5bbfbe55b4caa7bf0cd26b3269c7a476ffe8ce45f837f87d", size = 172959, upload-time = "2026-01-14T12:54:44.602Z" },
+    { url = "https://files.pythonhosted.org/packages/82/5f/3e85351c523f73ad8d938989e9a58c7f59fb9c17f761b9981b43f0025ce7/librt-0.7.8-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4864045f49dc9c974dadb942ac56a74cd0479a2aafa51ce272c490a82322ea3c", size = 186717, upload-time = "2026-01-14T12:54:45.986Z" },
+    { url = "https://files.pythonhosted.org/packages/08/f8/18bfe092e402d00fe00d33aa1e01dda1bd583ca100b393b4373847eade6d/librt-0.7.8-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:a36515b1328dc5b3ffce79fe204985ca8572525452eacabee2166f44bb387b2c", size = 184585, upload-time = "2026-01-14T12:54:47.139Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/fc/f43972ff56fd790a9fa55028a52ccea1875100edbb856b705bd393b601e3/librt-0.7.8-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:b7e7f140c5169798f90b80d6e607ed2ba5059784968a004107c88ad61fb3641d", size = 180497, upload-time = "2026-01-14T12:54:48.946Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/3a/25e36030315a410d3ad0b7d0f19f5f188e88d1613d7d3fd8150523ea1093/librt-0.7.8-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:ff71447cb778a4f772ddc4ce360e6ba9c95527ed84a52096bd1bbf9fee2ec7c0", size = 200052, upload-time = "2026-01-14T12:54:50.382Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/b8/f3a5a1931ae2a6ad92bf6893b9ef44325b88641d58723529e2c2935e8abe/librt-0.7.8-cp310-cp310-win32.whl", hash = "sha256:047164e5f68b7a8ebdf9fae91a3c2161d3192418aadd61ddd3a86a56cbe3dc85", size = 43477, upload-time = "2026-01-14T12:54:51.815Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/91/c4202779366bc19f871b4ad25db10fcfa1e313c7893feb942f32668e8597/librt-0.7.8-cp310-cp310-win_amd64.whl", hash = "sha256:d6f254d096d84156a46a84861183c183d30734e52383602443292644d895047c", size = 49806, upload-time = "2026-01-14T12:54:53.149Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/a3/87ea9c1049f2c781177496ebee29430e4631f439b8553a4969c88747d5d8/librt-0.7.8-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:ff3e9c11aa260c31493d4b3197d1e28dd07768594a4f92bec4506849d736248f", size = 56507, upload-time = "2026-01-14T12:54:54.156Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/4a/23bcef149f37f771ad30203d561fcfd45b02bc54947b91f7a9ac34815747/librt-0.7.8-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ddb52499d0b3ed4aa88746aaf6f36a08314677d5c346234c3987ddc506404eac", size = 58455, upload-time = "2026-01-14T12:54:55.978Z" },
+    { url = "https://files.pythonhosted.org/packages/22/6e/46eb9b85c1b9761e0f42b6e6311e1cc544843ac897457062b9d5d0b21df4/librt-0.7.8-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:e9c0afebbe6ce177ae8edba0c7c4d626f2a0fc12c33bb993d163817c41a7a05c", size = 164956, upload-time = "2026-01-14T12:54:57.311Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/3f/aa7c7f6829fb83989feb7ba9aa11c662b34b4bd4bd5b262f2876ba3db58d/librt-0.7.8-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:631599598e2c76ded400c0a8722dec09217c89ff64dc54b060f598ed68e7d2a8", size = 174364, upload-time = "2026-01-14T12:54:59.089Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/2d/d57d154b40b11f2cb851c4df0d4c4456bacd9b1ccc4ecb593ddec56c1a8b/librt-0.7.8-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9c1ba843ae20db09b9d5c80475376168feb2640ce91cd9906414f23cc267a1ff", size = 188034, upload-time = "2026-01-14T12:55:00.141Z" },
+    { url = "https://files.pythonhosted.org/packages/59/f9/36c4dad00925c16cd69d744b87f7001792691857d3b79187e7a673e812fb/librt-0.7.8-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:b5b007bb22ea4b255d3ee39dfd06d12534de2fcc3438567d9f48cdaf67ae1ae3", size = 186295, upload-time = "2026-01-14T12:55:01.303Z" },
+    { url = "https://files.pythonhosted.org/packages/23/9b/8a9889d3df5efb67695a67785028ccd58e661c3018237b73ad081691d0cb/librt-0.7.8-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:dbd79caaf77a3f590cbe32dc2447f718772d6eea59656a7dcb9311161b10fa75", size = 181470, upload-time = "2026-01-14T12:55:02.492Z" },
+    { url = "https://files.pythonhosted.org/packages/43/64/54d6ef11afca01fef8af78c230726a9394759f2addfbf7afc5e3cc032a45/librt-0.7.8-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:87808a8d1e0bd62a01cafc41f0fd6818b5a5d0ca0d8a55326a81643cdda8f873", size = 201713, upload-time = "2026-01-14T12:55:03.919Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/29/73e7ed2991330b28919387656f54109139b49e19cd72902f466bd44415fd/librt-0.7.8-cp311-cp311-win32.whl", hash = "sha256:31724b93baa91512bd0a376e7cf0b59d8b631ee17923b1218a65456fa9bda2e7", size = 43803, upload-time = "2026-01-14T12:55:04.996Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/de/66766ff48ed02b4d78deea30392ae200bcbd99ae61ba2418b49fd50a4831/librt-0.7.8-cp311-cp311-win_amd64.whl", hash = "sha256:978e8b5f13e52cf23a9e80f3286d7546baa70bc4ef35b51d97a709d0b28e537c", size = 50080, upload-time = "2026-01-14T12:55:06.489Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/e3/33450438ff3a8c581d4ed7f798a70b07c3206d298cf0b87d3806e72e3ed8/librt-0.7.8-cp311-cp311-win_arm64.whl", hash = "sha256:20e3946863d872f7cabf7f77c6c9d370b8b3d74333d3a32471c50d3a86c0a232", size = 43383, upload-time = "2026-01-14T12:55:07.49Z" },
+    { url = "https://files.pythonhosted.org/packages/56/04/79d8fcb43cae376c7adbab7b2b9f65e48432c9eced62ac96703bcc16e09b/librt-0.7.8-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:9b6943885b2d49c48d0cff23b16be830ba46b0152d98f62de49e735c6e655a63", size = 57472, upload-time = "2026-01-14T12:55:08.528Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/ba/60b96e93043d3d659da91752689023a73981336446ae82078cddf706249e/librt-0.7.8-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:46ef1f4b9b6cc364b11eea0ecc0897314447a66029ee1e55859acb3dd8757c93", size = 58986, upload-time = "2026-01-14T12:55:09.466Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/26/5215e4cdcc26e7be7eee21955a7e13cbf1f6d7d7311461a6014544596fac/librt-0.7.8-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:907ad09cfab21e3c86e8f1f87858f7049d1097f77196959c033612f532b4e592", size = 168422, upload-time = "2026-01-14T12:55:10.499Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/84/e8d1bc86fa0159bfc24f3d798d92cafd3897e84c7fea7fe61b3220915d76/librt-0.7.8-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2991b6c3775383752b3ca0204842743256f3ad3deeb1d0adc227d56b78a9a850", size = 177478, upload-time = "2026-01-14T12:55:11.577Z" },
+    { url = "https://files.pythonhosted.org/packages/57/11/d0268c4b94717a18aa91df1100e767b010f87b7ae444dafaa5a2d80f33a6/librt-0.7.8-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:03679b9856932b8c8f674e87aa3c55ea11c9274301f76ae8dc4d281bda55cf62", size = 192439, upload-time = "2026-01-14T12:55:12.7Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/56/1e8e833b95fe684f80f8894ae4d8b7d36acc9203e60478fcae599120a975/librt-0.7.8-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3968762fec1b2ad34ce57458b6de25dbb4142713e9ca6279a0d352fa4e9f452b", size = 191483, upload-time = "2026-01-14T12:55:13.838Z" },
+    { url = "https://files.pythonhosted.org/packages/17/48/f11cf28a2cb6c31f282009e2208312aa84a5ee2732859f7856ee306176d5/librt-0.7.8-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:bb7a7807523a31f03061288cc4ffc065d684c39db7644c676b47d89553c0d714", size = 185376, upload-time = "2026-01-14T12:55:15.017Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/6a/d7c116c6da561b9155b184354a60a3d5cdbf08fc7f3678d09c95679d13d9/librt-0.7.8-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:ad64a14b1e56e702e19b24aae108f18ad1bf7777f3af5fcd39f87d0c5a814449", size = 206234, upload-time = "2026-01-14T12:55:16.571Z" },
+    { url = "https://files.pythonhosted.org/packages/61/de/1975200bb0285fc921c5981d9978ce6ce11ae6d797df815add94a5a848a3/librt-0.7.8-cp312-cp312-win32.whl", hash = "sha256:0241a6ed65e6666236ea78203a73d800dbed896cf12ae25d026d75dc1fcd1dac", size = 44057, upload-time = "2026-01-14T12:55:18.077Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/cd/724f2d0b3461426730d4877754b65d39f06a41ac9d0a92d5c6840f72b9ae/librt-0.7.8-cp312-cp312-win_amd64.whl", hash = "sha256:6db5faf064b5bab9675c32a873436b31e01d66ca6984c6f7f92621656033a708", size = 50293, upload-time = "2026-01-14T12:55:19.179Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/cf/7e899acd9ee5727ad8160fdcc9994954e79fab371c66535c60e13b968ffc/librt-0.7.8-cp312-cp312-win_arm64.whl", hash = "sha256:57175aa93f804d2c08d2edb7213e09276bd49097611aefc37e3fa38d1fb99ad0", size = 43574, upload-time = "2026-01-14T12:55:20.185Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/fe/b1f9de2829cf7fc7649c1dcd202cfd873837c5cc2fc9e526b0e7f716c3d2/librt-0.7.8-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:4c3995abbbb60b3c129490fa985dfe6cac11d88fc3c36eeb4fb1449efbbb04fc", size = 57500, upload-time = "2026-01-14T12:55:21.219Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/d4/4a60fbe2e53b825f5d9a77325071d61cd8af8506255067bf0c8527530745/librt-0.7.8-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:44e0c2cbc9bebd074cf2cdbe472ca185e824be4e74b1c63a8e934cea674bebf2", size = 59019, upload-time = "2026-01-14T12:55:22.256Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/37/61ff80341ba5159afa524445f2d984c30e2821f31f7c73cf166dcafa5564/librt-0.7.8-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:4d2f1e492cae964b3463a03dc77a7fe8742f7855d7258c7643f0ee32b6651dd3", size = 169015, upload-time = "2026-01-14T12:55:23.24Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/86/13d4f2d6a93f181ebf2fc953868826653ede494559da8268023fe567fca3/librt-0.7.8-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:451e7ffcef8f785831fdb791bd69211f47e95dc4c6ddff68e589058806f044c6", size = 178161, upload-time = "2026-01-14T12:55:24.826Z" },
+    { url = "https://files.pythonhosted.org/packages/88/26/e24ef01305954fc4d771f1f09f3dd682f9eb610e1bec188ffb719374d26e/librt-0.7.8-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3469e1af9f1380e093ae06bedcbdd11e407ac0b303a56bbe9afb1d6824d4982d", size = 193015, upload-time = "2026-01-14T12:55:26.04Z" },
+    { url = "https://files.pythonhosted.org/packages/88/a0/92b6bd060e720d7a31ed474d046a69bd55334ec05e9c446d228c4b806ae3/librt-0.7.8-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f11b300027ce19a34f6d24ebb0a25fd0e24a9d53353225a5c1e6cadbf2916b2e", size = 192038, upload-time = "2026-01-14T12:55:27.208Z" },
+    { url = "https://files.pythonhosted.org/packages/06/bb/6f4c650253704279c3a214dad188101d1b5ea23be0606628bc6739456624/librt-0.7.8-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:4adc73614f0d3c97874f02f2c7fd2a27854e7e24ad532ea6b965459c5b757eca", size = 186006, upload-time = "2026-01-14T12:55:28.594Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/00/1c409618248d43240cadf45f3efb866837fa77e9a12a71481912135eb481/librt-0.7.8-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:60c299e555f87e4c01b2eca085dfccda1dde87f5a604bb45c2906b8305819a93", size = 206888, upload-time = "2026-01-14T12:55:30.214Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/83/b2cfe8e76ff5c1c77f8a53da3d5de62d04b5ebf7cf913e37f8bca43b5d07/librt-0.7.8-cp313-cp313-win32.whl", hash = "sha256:b09c52ed43a461994716082ee7d87618096851319bf695d57ec123f2ab708951", size = 44126, upload-time = "2026-01-14T12:55:31.44Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/0b/c59d45de56a51bd2d3a401fc63449c0ac163e4ef7f523ea8b0c0dee86ec5/librt-0.7.8-cp313-cp313-win_amd64.whl", hash = "sha256:f8f4a901a3fa28969d6e4519deceab56c55a09d691ea7b12ca830e2fa3461e34", size = 50262, upload-time = "2026-01-14T12:55:33.01Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/b9/973455cec0a1ec592395250c474164c4a58ebf3e0651ee920fef1a2623f1/librt-0.7.8-cp313-cp313-win_arm64.whl", hash = "sha256:43d4e71b50763fcdcf64725ac680d8cfa1706c928b844794a7aa0fa9ac8e5f09", size = 43600, upload-time = "2026-01-14T12:55:34.054Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/73/fa8814c6ce2d49c3827829cadaa1589b0bf4391660bd4510899393a23ebc/librt-0.7.8-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:be927c3c94c74b05128089a955fba86501c3b544d1d300282cc1b4bd370cb418", size = 57049, upload-time = "2026-01-14T12:55:35.056Z" },
+    { url = "https://files.pythonhosted.org/packages/53/fe/f6c70956da23ea235fd2e3cc16f4f0b4ebdfd72252b02d1164dd58b4e6c3/librt-0.7.8-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:7b0803e9008c62a7ef79058233db7ff6f37a9933b8f2573c05b07ddafa226611", size = 58689, upload-time = "2026-01-14T12:55:36.078Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/4d/7a2481444ac5fba63050d9abe823e6bc16896f575bfc9c1e5068d516cdce/librt-0.7.8-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:79feb4d00b2a4e0e05c9c56df707934f41fcb5fe53fd9efb7549068d0495b758", size = 166808, upload-time = "2026-01-14T12:55:37.595Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/3c/10901d9e18639f8953f57c8986796cfbf4c1c514844a41c9197cf87cb707/librt-0.7.8-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b9122094e3f24aa759c38f46bd8863433820654927370250f460ae75488b66ea", size = 175614, upload-time = "2026-01-14T12:55:38.756Z" },
+    { url = "https://files.pythonhosted.org/packages/db/01/5cbdde0951a5090a80e5ba44e6357d375048123c572a23eecfb9326993a7/librt-0.7.8-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7e03bea66af33c95ce3addf87a9bf1fcad8d33e757bc479957ddbc0e4f7207ac", size = 189955, upload-time = "2026-01-14T12:55:39.939Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/b4/e80528d2f4b7eaf1d437fcbd6fc6ba4cbeb3e2a0cb9ed5a79f47c7318706/librt-0.7.8-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:f1ade7f31675db00b514b98f9ab9a7698c7282dad4be7492589109471852d398", size = 189370, upload-time = "2026-01-14T12:55:41.057Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/ab/938368f8ce31a9787ecd4becb1e795954782e4312095daf8fd22420227c8/librt-0.7.8-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:a14229ac62adcf1b90a15992f1ab9c69ae8b99ffb23cb64a90878a6e8a2f5b81", size = 183224, upload-time = "2026-01-14T12:55:42.328Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/10/559c310e7a6e4014ac44867d359ef8238465fb499e7eb31b6bfe3e3f86f5/librt-0.7.8-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5bcaaf624fd24e6a0cb14beac37677f90793a96864c67c064a91458611446e83", size = 203541, upload-time = "2026-01-14T12:55:43.501Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/db/a0db7acdb6290c215f343835c6efda5b491bb05c3ddc675af558f50fdba3/librt-0.7.8-cp314-cp314-win32.whl", hash = "sha256:7aa7d5457b6c542ecaed79cec4ad98534373c9757383973e638ccced0f11f46d", size = 40657, upload-time = "2026-01-14T12:55:44.668Z" },
+    { url = "https://files.pythonhosted.org/packages/72/e0/4f9bdc2a98a798511e81edcd6b54fe82767a715e05d1921115ac70717f6f/librt-0.7.8-cp314-cp314-win_amd64.whl", hash = "sha256:3d1322800771bee4a91f3b4bd4e49abc7d35e65166821086e5afd1e6c0d9be44", size = 46835, upload-time = "2026-01-14T12:55:45.655Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/3d/59c6402e3dec2719655a41ad027a7371f8e2334aa794ed11533ad5f34969/librt-0.7.8-cp314-cp314-win_arm64.whl", hash = "sha256:5363427bc6a8c3b1719f8f3845ea53553d301382928a86e8fab7984426949bce", size = 39885, upload-time = "2026-01-14T12:55:47.138Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/9c/2481d80950b83085fb14ba3c595db56330d21bbc7d88a19f20165f3538db/librt-0.7.8-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:ca916919793a77e4a98d4a1701e345d337ce53be4a16620f063191f7322ac80f", size = 59161, upload-time = "2026-01-14T12:55:48.45Z" },
+    { url = "https://files.pythonhosted.org/packages/96/79/108df2cfc4e672336765d54e3ff887294c1cc36ea4335c73588875775527/librt-0.7.8-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:54feb7b4f2f6706bb82325e836a01be805770443e2400f706e824e91f6441dde", size = 61008, upload-time = "2026-01-14T12:55:49.527Z" },
+    { url = "https://files.pythonhosted.org/packages/46/f2/30179898f9994a5637459d6e169b6abdc982012c0a4b2d4c26f50c06f911/librt-0.7.8-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:39a4c76fee41007070f872b648cc2f711f9abf9a13d0c7162478043377b52c8e", size = 187199, upload-time = "2026-01-14T12:55:50.587Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/da/f7563db55cebdc884f518ba3791ad033becc25ff68eb70902b1747dc0d70/librt-0.7.8-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ac9c8a458245c7de80bc1b9765b177055efff5803f08e548dd4bb9ab9a8d789b", size = 198317, upload-time = "2026-01-14T12:55:51.991Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/6c/4289acf076ad371471fa86718c30ae353e690d3de6167f7db36f429272f1/librt-0.7.8-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:95b67aa7eff150f075fda09d11f6bfb26edffd300f6ab1666759547581e8f666", size = 210334, upload-time = "2026-01-14T12:55:53.682Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/7f/377521ac25b78ac0a5ff44127a0360ee6d5ddd3ce7327949876a30533daa/librt-0.7.8-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:535929b6eff670c593c34ff435d5440c3096f20fa72d63444608a5aef64dd581", size = 211031, upload-time = "2026-01-14T12:55:54.827Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/b1/e1e96c3e20b23d00cf90f4aad48f0deb4cdfec2f0ed8380d0d85acf98bbf/librt-0.7.8-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:63937bd0f4d1cb56653dc7ae900d6c52c41f0015e25aaf9902481ee79943b33a", size = 204581, upload-time = "2026-01-14T12:55:56.811Z" },
+    { url = "https://files.pythonhosted.org/packages/43/71/0f5d010e92ed9747e14bef35e91b6580533510f1e36a8a09eb79ee70b2f0/librt-0.7.8-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:cf243da9e42d914036fd362ac3fa77d80a41cadcd11ad789b1b5eec4daaf67ca", size = 224731, upload-time = "2026-01-14T12:55:58.175Z" },
+    { url = "https://files.pythonhosted.org/packages/22/f0/07fb6ab5c39a4ca9af3e37554f9d42f25c464829254d72e4ebbd81da351c/librt-0.7.8-cp314-cp314t-win32.whl", hash = "sha256:171ca3a0a06c643bd0a2f62a8944e1902c94aa8e5da4db1ea9a8daf872685365", size = 41173, upload-time = "2026-01-14T12:55:59.315Z" },
+    { url = "https://files.pythonhosted.org/packages/24/d4/7e4be20993dc6a782639625bd2f97f3c66125c7aa80c82426956811cfccf/librt-0.7.8-cp314-cp314t-win_amd64.whl", hash = "sha256:445b7304145e24c60288a2f172b5ce2ca35c0f81605f5299f3fa567e189d2e32", size = 47668, upload-time = "2026-01-14T12:56:00.261Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/85/69f92b2a7b3c0f88ffe107c86b952b397004b5b8ea5a81da3d9c04c04422/librt-0.7.8-cp314-cp314t-win_arm64.whl", hash = "sha256:8766ece9de08527deabcd7cb1b4f1a967a385d26e33e536d6d8913db6ef74f06", size = 40550, upload-time = "2026-01-14T12:56:01.542Z" },
+]
+
 [[package]]
 name = "mcp"
 version = "1.25.0"
@@ -929,6 +1002,61 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e2/fc/6dc7659c2ae5ddf280477011f4213a74f806862856b796ef08f028e664bf/mcp-1.25.0-py3-none-any.whl", hash = "sha256:b37c38144a666add0862614cc79ec276e97d72aa8ca26d622818d4e278b9721a", size = 233076, upload-time = "2025-12-19T10:19:55.416Z" },
 ]
 
+[[package]]
+name = "mypy"
+version = "1.19.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "librt", marker = "platform_python_implementation != 'PyPy'" },
+    { name = "mypy-extensions" },
+    { name = "pathspec" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f5/db/4efed9504bc01309ab9c2da7e352cc223569f05478012b5d9ece38fd44d2/mypy-1.19.1.tar.gz", hash = "sha256:19d88bb05303fe63f71dd2c6270daca27cb9401c4ca8255fe50d1d920e0eb9ba", size = 3582404, upload-time = "2025-12-15T05:03:48.42Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2f/63/e499890d8e39b1ff2df4c0c6ce5d371b6844ee22b8250687a99fd2f657a8/mypy-1.19.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:5f05aa3d375b385734388e844bc01733bd33c644ab48e9684faa54e5389775ec", size = 13101333, upload-time = "2025-12-15T05:03:03.28Z" },
+    { url = "https://files.pythonhosted.org/packages/72/4b/095626fc136fba96effc4fd4a82b41d688ab92124f8c4f7564bffe5cf1b0/mypy-1.19.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:022ea7279374af1a5d78dfcab853fe6a536eebfda4b59deab53cd21f6cd9f00b", size = 12164102, upload-time = "2025-12-15T05:02:33.611Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/5b/952928dd081bf88a83a5ccd49aaecfcd18fd0d2710c7ff07b8fb6f7032b9/mypy-1.19.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee4c11e460685c3e0c64a4c5de82ae143622410950d6be863303a1c4ba0e36d6", size = 12765799, upload-time = "2025-12-15T05:03:28.44Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/0d/93c2e4a287f74ef11a66fb6d49c7a9f05e47b0a4399040e6719b57f500d2/mypy-1.19.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:de759aafbae8763283b2ee5869c7255391fbc4de3ff171f8f030b5ec48381b74", size = 13522149, upload-time = "2025-12-15T05:02:36.011Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/0e/33a294b56aaad2b338d203e3a1d8b453637ac36cb278b45005e0901cf148/mypy-1.19.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:ab43590f9cd5108f41aacf9fca31841142c786827a74ab7cc8a2eacb634e09a1", size = 13810105, upload-time = "2025-12-15T05:02:40.327Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/fd/3e82603a0cb66b67c5e7abababce6bf1a929ddf67bf445e652684af5c5a0/mypy-1.19.1-cp310-cp310-win_amd64.whl", hash = "sha256:2899753e2f61e571b3971747e302d5f420c3fd09650e1951e99f823bc3089dac", size = 10057200, upload-time = "2025-12-15T05:02:51.012Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/47/6b3ebabd5474d9cdc170d1342fbf9dddc1b0ec13ec90bf9004ee6f391c31/mypy-1.19.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:d8dfc6ab58ca7dda47d9237349157500468e404b17213d44fc1cb77bce532288", size = 13028539, upload-time = "2025-12-15T05:03:44.129Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/a6/ac7c7a88a3c9c54334f53a941b765e6ec6c4ebd65d3fe8cdcfbe0d0fd7db/mypy-1.19.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e3f276d8493c3c97930e354b2595a44a21348b320d859fb4a2b9f66da9ed27ab", size = 12083163, upload-time = "2025-12-15T05:03:37.679Z" },
+    { url = "https://files.pythonhosted.org/packages/67/af/3afa9cf880aa4a2c803798ac24f1d11ef72a0c8079689fac5cfd815e2830/mypy-1.19.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2abb24cf3f17864770d18d673c85235ba52456b36a06b6afc1e07c1fdcd3d0e6", size = 12687629, upload-time = "2025-12-15T05:02:31.526Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/46/20f8a7114a56484ab268b0ab372461cb3a8f7deed31ea96b83a4e4cfcfca/mypy-1.19.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a009ffa5a621762d0c926a078c2d639104becab69e79538a494bcccb62cc0331", size = 13436933, upload-time = "2025-12-15T05:03:15.606Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/f8/33b291ea85050a21f15da910002460f1f445f8007adb29230f0adea279cb/mypy-1.19.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f7cee03c9a2e2ee26ec07479f38ea9c884e301d42c6d43a19d20fb014e3ba925", size = 13661754, upload-time = "2025-12-15T05:02:26.731Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/a3/47cbd4e85bec4335a9cd80cf67dbc02be21b5d4c9c23ad6b95d6c5196bac/mypy-1.19.1-cp311-cp311-win_amd64.whl", hash = "sha256:4b84a7a18f41e167f7995200a1d07a4a6810e89d29859df936f1c3923d263042", size = 10055772, upload-time = "2025-12-15T05:03:26.179Z" },
+    { url = "https://files.pythonhosted.org/packages/06/8a/19bfae96f6615aa8a0604915512e0289b1fad33d5909bf7244f02935d33a/mypy-1.19.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a8174a03289288c1f6c46d55cef02379b478bfbc8e358e02047487cad44c6ca1", size = 13206053, upload-time = "2025-12-15T05:03:46.622Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/34/3e63879ab041602154ba2a9f99817bb0c85c4df19a23a1443c8986e4d565/mypy-1.19.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ffcebe56eb09ff0c0885e750036a095e23793ba6c2e894e7e63f6d89ad51f22e", size = 12219134, upload-time = "2025-12-15T05:03:24.367Z" },
+    { url = "https://files.pythonhosted.org/packages/89/cc/2db6f0e95366b630364e09845672dbee0cbf0bbe753a204b29a944967cd9/mypy-1.19.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b64d987153888790bcdb03a6473d321820597ab8dd9243b27a92153c4fa50fd2", size = 12731616, upload-time = "2025-12-15T05:02:44.725Z" },
+    { url = "https://files.pythonhosted.org/packages/00/be/dd56c1fd4807bc1eba1cf18b2a850d0de7bacb55e158755eb79f77c41f8e/mypy-1.19.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c35d298c2c4bba75feb2195655dfea8124d855dfd7343bf8b8c055421eaf0cf8", size = 13620847, upload-time = "2025-12-15T05:03:39.633Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/42/332951aae42b79329f743bf1da088cd75d8d4d9acc18fbcbd84f26c1af4e/mypy-1.19.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:34c81968774648ab5ac09c29a375fdede03ba253f8f8287847bd480782f73a6a", size = 13834976, upload-time = "2025-12-15T05:03:08.786Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/63/e7493e5f90e1e085c562bb06e2eb32cae27c5057b9653348d38b47daaecc/mypy-1.19.1-cp312-cp312-win_amd64.whl", hash = "sha256:b10e7c2cd7870ba4ad9b2d8a6102eb5ffc1f16ca35e3de6bfa390c1113029d13", size = 10118104, upload-time = "2025-12-15T05:03:10.834Z" },
+    { url = "https://files.pythonhosted.org/packages/de/9f/a6abae693f7a0c697dbb435aac52e958dc8da44e92e08ba88d2e42326176/mypy-1.19.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e3157c7594ff2ef1634ee058aafc56a82db665c9438fd41b390f3bde1ab12250", size = 13201927, upload-time = "2025-12-15T05:02:29.138Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/a4/45c35ccf6e1c65afc23a069f50e2c66f46bd3798cbe0d680c12d12935caa/mypy-1.19.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bdb12f69bcc02700c2b47e070238f42cb87f18c0bc1fc4cdb4fb2bc5fd7a3b8b", size = 12206730, upload-time = "2025-12-15T05:03:01.325Z" },
+    { url = "https://files.pythonhosted.org/packages/05/bb/cdcf89678e26b187650512620eec8368fded4cfd99cfcb431e4cdfd19dec/mypy-1.19.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f859fb09d9583a985be9a493d5cfc5515b56b08f7447759a0c5deaf68d80506e", size = 12724581, upload-time = "2025-12-15T05:03:20.087Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/32/dd260d52babf67bad8e6770f8e1102021877ce0edea106e72df5626bb0ec/mypy-1.19.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c9a6538e0415310aad77cb94004ca6482330fece18036b5f360b62c45814c4ef", size = 13616252, upload-time = "2025-12-15T05:02:49.036Z" },
+    { url = "https://files.pythonhosted.org/packages/71/d0/5e60a9d2e3bd48432ae2b454b7ef2b62a960ab51292b1eda2a95edd78198/mypy-1.19.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:da4869fc5e7f62a88f3fe0b5c919d1d9f7ea3cef92d3689de2823fd27e40aa75", size = 13840848, upload-time = "2025-12-15T05:02:55.95Z" },
+    { url = "https://files.pythonhosted.org/packages/98/76/d32051fa65ecf6cc8c6610956473abdc9b4c43301107476ac03559507843/mypy-1.19.1-cp313-cp313-win_amd64.whl", hash = "sha256:016f2246209095e8eda7538944daa1d60e1e8134d98983b9fc1e92c1fc0cb8dd", size = 10135510, upload-time = "2025-12-15T05:02:58.438Z" },
+    { url = "https://files.pythonhosted.org/packages/de/eb/b83e75f4c820c4247a58580ef86fcd35165028f191e7e1ba57128c52782d/mypy-1.19.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:06e6170bd5836770e8104c8fdd58e5e725cfeb309f0a6c681a811f557e97eac1", size = 13199744, upload-time = "2025-12-15T05:03:30.823Z" },
+    { url = "https://files.pythonhosted.org/packages/94/28/52785ab7bfa165f87fcbb61547a93f98bb20e7f82f90f165a1f69bce7b3d/mypy-1.19.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:804bd67b8054a85447c8954215a906d6eff9cabeabe493fb6334b24f4bfff718", size = 12215815, upload-time = "2025-12-15T05:02:42.323Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/c6/bdd60774a0dbfb05122e3e925f2e9e846c009e479dcec4821dad881f5b52/mypy-1.19.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:21761006a7f497cb0d4de3d8ef4ca70532256688b0523eee02baf9eec895e27b", size = 12740047, upload-time = "2025-12-15T05:03:33.168Z" },
+    { url = "https://files.pythonhosted.org/packages/32/2a/66ba933fe6c76bd40d1fe916a83f04fed253152f451a877520b3c4a5e41e/mypy-1.19.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:28902ee51f12e0f19e1e16fbe2f8f06b6637f482c459dd393efddd0ec7f82045", size = 13601998, upload-time = "2025-12-15T05:03:13.056Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/da/5055c63e377c5c2418760411fd6a63ee2b96cf95397259038756c042574f/mypy-1.19.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:481daf36a4c443332e2ae9c137dfee878fcea781a2e3f895d54bd3002a900957", size = 13807476, upload-time = "2025-12-15T05:03:17.977Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/09/4ebd873390a063176f06b0dbf1f7783dd87bd120eae7727fa4ae4179b685/mypy-1.19.1-cp314-cp314-win_amd64.whl", hash = "sha256:8bb5c6f6d043655e055be9b542aa5f3bdd30e4f3589163e85f93f3640060509f", size = 10281872, upload-time = "2025-12-15T05:03:05.549Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/f4/4ce9a05ce5ded1de3ec1c1d96cf9f9504a04e54ce0ed55cfa38619a32b8d/mypy-1.19.1-py3-none-any.whl", hash = "sha256:f1235f5ea01b7db5468d53ece6aaddf1ad0b88d9e7462b86ef96fe04995d7247", size = 2471239, upload-time = "2025-12-15T05:03:07.248Z" },
+]
+
+[[package]]
+name = "mypy-extensions"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/6e/371856a3fb9d31ca8dac321cda606860fa4548858c0cc45d9d1d4ca2628b/mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558", size = 6343, upload-time = "2025-04-22T14:54:24.164Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" },
+]
+
 [[package]]
 name = "networkx"
 version = "3.4.2"
@@ -1662,9 +1790,35 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/64/8d/0133e4eb4beed9e425d9a98ed6e081a55d195481b7632472be1af08d2f6b/rsa-4.9.1-py3-none-any.whl", hash = "sha256:68635866661c6836b8d39430f97a996acbd61bfa49406748ea243539fe239762", size = 34696, upload-time = "2025-04-16T09:51:17.142Z" },
 ]
 
+[[package]]
+name = "ruff"
+version = "0.14.13"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/50/0a/1914efb7903174b381ee2ffeebb4253e729de57f114e63595114c8ca451f/ruff-0.14.13.tar.gz", hash = "sha256:83cd6c0763190784b99650a20fec7633c59f6ebe41c5cc9d45ee42749563ad47", size = 6059504, upload-time = "2026-01-15T20:15:16.918Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c3/ae/0deefbc65ca74b0ab1fd3917f94dc3b398233346a74b8bbb0a916a1a6bf6/ruff-0.14.13-py3-none-linux_armv6l.whl", hash = "sha256:76f62c62cd37c276cb03a275b198c7c15bd1d60c989f944db08a8c1c2dbec18b", size = 13062418, upload-time = "2026-01-15T20:14:50.779Z" },
+    { url = "https://files.pythonhosted.org/packages/47/df/5916604faa530a97a3c154c62a81cb6b735c0cb05d1e26d5ad0f0c8ac48a/ruff-0.14.13-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:914a8023ece0528d5cc33f5a684f5f38199bbb566a04815c2c211d8f40b5d0ed", size = 13442344, upload-time = "2026-01-15T20:15:07.94Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/f3/e0e694dd69163c3a1671e102aa574a50357536f18a33375050334d5cd517/ruff-0.14.13-py3-none-macosx_11_0_arm64.whl", hash = "sha256:d24899478c35ebfa730597a4a775d430ad0d5631b8647a3ab368c29b7e7bd063", size = 12354720, upload-time = "2026-01-15T20:15:09.854Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/e8/67f5fcbbaee25e8fc3b56cc33e9892eca7ffe09f773c8e5907757a7e3bdb/ruff-0.14.13-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9aaf3870f14d925bbaf18b8a2347ee0ae7d95a2e490e4d4aea6813ed15ebc80e", size = 12774493, upload-time = "2026-01-15T20:15:20.908Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/ce/d2e9cb510870b52a9565d885c0d7668cc050e30fa2c8ac3fb1fda15c083d/ruff-0.14.13-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac5b7f63dd3b27cc811850f5ffd8fff845b00ad70e60b043aabf8d6ecc304e09", size = 12815174, upload-time = "2026-01-15T20:15:05.74Z" },
+    { url = "https://files.pythonhosted.org/packages/88/00/c38e5da58beebcf4fa32d0ddd993b63dfacefd02ab7922614231330845bf/ruff-0.14.13-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:78d2b1097750d90ba82ce4ba676e85230a0ed694178ca5e61aa9b459970b3eb9", size = 13680909, upload-time = "2026-01-15T20:15:14.537Z" },
+    { url = "https://files.pythonhosted.org/packages/61/61/cd37c9dd5bd0a3099ba79b2a5899ad417d8f3b04038810b0501a80814fd7/ruff-0.14.13-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:7d0bf87705acbbcb8d4c24b2d77fbb73d40210a95c3903b443cd9e30824a5032", size = 15144215, upload-time = "2026-01-15T20:15:22.886Z" },
+    { url = "https://files.pythonhosted.org/packages/56/8a/85502d7edbf98c2df7b8876f316c0157359165e16cdf98507c65c8d07d3d/ruff-0.14.13-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a3eb5da8e2c9e9f13431032fdcbe7681de9ceda5835efee3269417c13f1fed5c", size = 14706067, upload-time = "2026-01-15T20:14:48.271Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/2f/de0df127feb2ee8c1e54354dc1179b4a23798f0866019528c938ba439aca/ruff-0.14.13-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:642442b42957093811cd8d2140dfadd19c7417030a7a68cf8d51fcdd5f217427", size = 14133916, upload-time = "2026-01-15T20:14:57.357Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/77/9b99686bb9fe07a757c82f6f95e555c7a47801a9305576a9c67e0a31d280/ruff-0.14.13-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4acdf009f32b46f6e8864af19cbf6841eaaed8638e65c8dac845aea0d703c841", size = 13859207, upload-time = "2026-01-15T20:14:55.111Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/46/2bdcb34a87a179a4d23022d818c1c236cb40e477faf0d7c9afb6813e5876/ruff-0.14.13-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:591a7f68860ea4e003917d19b5c4f5ac39ff558f162dc753a2c5de897fd5502c", size = 14043686, upload-time = "2026-01-15T20:14:52.841Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/a9/5c6a4f56a0512c691cf143371bcf60505ed0f0860f24a85da8bd123b2bf1/ruff-0.14.13-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:774c77e841cc6e046fc3e91623ce0903d1cd07e3a36b1a9fe79b81dab3de506b", size = 12663837, upload-time = "2026-01-15T20:15:18.921Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/bb/b920016ece7651fa7fcd335d9d199306665486694d4361547ccb19394c44/ruff-0.14.13-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:61f4e40077a1248436772bb6512db5fc4457fe4c49e7a94ea7c5088655dd21ae", size = 12805867, upload-time = "2026-01-15T20:14:59.272Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/b3/0bd909851e5696cd21e32a8fc25727e5f58f1934b3596975503e6e85415c/ruff-0.14.13-py3-none-musllinux_1_2_i686.whl", hash = "sha256:6d02f1428357fae9e98ac7aa94b7e966fd24151088510d32cf6f902d6c09235e", size = 13208528, upload-time = "2026-01-15T20:15:03.732Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/3b/e2d94cb613f6bbd5155a75cbe072813756363eba46a3f2177a1fcd0cd670/ruff-0.14.13-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:e399341472ce15237be0c0ae5fbceca4b04cd9bebab1a2b2c979e015455d8f0c", size = 13929242, upload-time = "2026-01-15T20:15:11.918Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/c5/abd840d4132fd51a12f594934af5eba1d5d27298a6f5b5d6c3be45301caf/ruff-0.14.13-py3-none-win32.whl", hash = "sha256:ef720f529aec113968b45dfdb838ac8934e519711da53a0456038a0efecbd680", size = 12919024, upload-time = "2026-01-15T20:14:43.647Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/55/6384b0b8ce731b6e2ade2b5449bf07c0e4c31e8a2e68ea65b3bafadcecc5/ruff-0.14.13-py3-none-win_amd64.whl", hash = "sha256:6070bd026e409734b9257e03e3ef18c6e1a216f0435c6751d7a8ec69cb59abef", size = 14097887, upload-time = "2026-01-15T20:15:01.48Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/e1/7348090988095e4e39560cfc2f7555b1b2a7357deba19167b600fdf5215d/ruff-0.14.13-py3-none-win_arm64.whl", hash = "sha256:7ab819e14f1ad9fe39f246cfcc435880ef7a9390d81a2b6ac7e01039083dd247", size = 13080224, upload-time = "2026-01-15T20:14:45.853Z" },
+]
+
 [[package]]
 name = "skill-seekers"
-version = "2.6.0"
+version = "2.7.0"
 source = { editable = "." }
 dependencies = [
     { name = "beautifulsoup4" },
@@ -1721,9 +1875,11 @@ openai = [
 [package.dev-dependencies]
 dev = [
     { name = "coverage" },
+    { name = "mypy" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
     { name = "pytest-cov" },
+    { name = "ruff" },
 ]
 
 [package.metadata]
@@ -1770,9 +1926,11 @@ provides-extras = ["mcp", "gemini", "openai", "all-llms", "all"]
 [package.metadata.requires-dev]
 dev = [
     { name = "coverage", specifier = ">=7.11.0" },
+    { name = "mypy", specifier = ">=1.19.1" },
     { name = "pytest", specifier = ">=8.4.2" },
     { name = "pytest-asyncio", specifier = ">=0.24.0" },
     { name = "pytest-cov", specifier = ">=7.0.0" },
+    { name = "ruff", specifier = ">=0.14.13" },
 ]
 
 [[package]]