Skill SeekersでURLやローカルドキュメントからClaude Codeのスキルを生成してみる

Python 3.13.9
skill-seekers 3.5.0

$ uv pip install skill-seekers

# SPA対応（playwright）が必要な場合
$ uv pip install "skill-seekers[browser]"

# 動画処理が必要な場合
$ uv pip install "skill-seekers[video]"

# 全部入り
$ uv pip install "skill-seekers[all]"

# Step 1: ソースの取り込み・解析・構造化
$ skill-seekers create <source>

# Step 2: AI強化でSKILL.mdを生成
$ skill-seekers enhance output/<skill-name>/

# Step 3: パッケージング
$ skill-seekers package output/<skill-name> --target claude

# Step 4: Claude Codeにインストール
$ skill-seekers install-agent output/<skill-name> --agent claude

$ skill-seekers create https://dev.classmethod.jp/articles/pytest-tavern/
INFO: Detected source type: web
INFO: Routing to web scraper...
INFO: Swift patterns loaded successfully: 431 patterns for language detection

🔍 Checking for llms.txt at https://dev.classmethod.jp/articles/python-sql-sqlglot/...
✅ Found 1 llms.txt variant(s)
  📥 Downloading standard...
     ✓ llms.md (6194 chars)
  💾 Saved llms.md

📄 Parsing llms.md for skill building...
  ✓ Cleaned 9 URLs to 9 unique URLs (anchors stripped, will validate during crawl)

🔗 Found 9 URLs in llms.txt (9 unique), starting BFS crawl...
  📋 1 URLs added to crawl queue after filtering

============================================================
SCRAPING: dev
============================================================
Base URL: https://dev.classmethod.jp/articles/python-sql-sqlglot/
Output: output/dev_data

  https://dev.classmethod.jp/articles/python-sql-sqlglot/

✅ Scraped 1 pages (1 saved)

============================================================
BUILDING SKILL: dev
============================================================

Loading scraped data...
  ✓ Loaded 1 pages

Categorizing pages...
  ✓ Created 1 categories

Generating quick reference...
  ✓ Extracted 0 patterns

Creating reference files...
  ✓ other.md (1 pages)
  ✓ index.md

Creating SKILL.md...
  ✓ SKILL.md (enhanced with 1 examples)

✅ Skill built: output/dev/

================================================================================
🤖 Traditional AI Enhancement (LOCAL mode, level 2)
================================================================================

usage: skill-seekers-enhance [-h] [--target PLATFORM] [--api-key KEY] [--dry-run] [--agent AGENT] [--agent-cmd CMD] [--interactive-enhancement] [--background] [--daemon] [--no-force] [--timeout SECONDS] skill_directory
skill-seekers-enhance: error: unrecognized arguments: --enhance-level 2

⚠ Enhancement failed, but skill was still built

📦 Package your skill:
  skill-seekers-package output/dev/

$ skill-seekers create facebook/react

$ skill-seekers create facebook/react
INFO: Detected source type: github
INFO: Routing to github scraper...
Starting GitHub scrape for: facebook/react
Fetching repository: facebook/react
Repository fetched: facebook/react (244378 stars)
Extracting README...
README found: README.md
Extracting code structure...
Detecting programming languages...
Unexpected error during scraping: unsupported operand type(s) for +: 'int' and 'str'
Error: unsupported operand type(s) for +: 'int' and 'str'

$ pip install git+https://github.com/yusufkaraaslan/Skill_Seekers.git@development

$ skill-seekers create ./my-project

# PDFから生成
$ skill-seekers create project-doc.pdf

# Wordドキュメントから生成
$ skill-seekers create project-report.docx

output/<skill-name>/
├── SKILL.md          # メインのスキルファイル（AI強化済み）
├── references/       # カテゴリ別リファレンスドキュメント
├── scripts/          # 関連スクリプト
└── assets/           # アセット

$ skill-seekers enhance output/dev
🤖 Enhancement mode: API (openai)

============================================================
ENHANCING SKILL: output/dev
Platform: OpenAI ChatGPT
============================================================

📖 Reading reference documentation...
  ✓ Read 3 reference files
  ✓ Total size: 8,686 characters

  ℹ Found existing SKILL.md (1972 chars)

🤖 Asking GPT-4o to enhance SKILL.md...
   Input: 12,233 characters
  ✓ Generated enhanced SKILL.md (2338 chars)

  💾 Backed up original to: SKILL.md.backup
  ✅ Saved enhanced SKILL.md

✅ Enhancement complete!

Next steps:
  1. Review: output/dev/SKILL.md
  2. If you don't like it, restore backup: output/dev/SKILL.md.backup
  3. Package your skill:
     skill-seekers package output/dev/ --target openai

$ skill-seekers package output/<skill-name> --target claude
============================================================
QUALITY CHECK
============================================================

============================================================
QUALITY REPORT: dev
============================================================

Quality Score: 85.0/100 (Grade: B)

⚠️  WARNINGS (3):
   [enhancement] Only 0 sections found - SKILL.md may be too basic (SKILL.md)
   [content] Found 5 code blocks without language tags (SKILL.md)
   [content] Missing "When to Use This Skill" section (SKILL.md)

✓ GOOD! No errors, but some warnings to review.

============================================================

Continue with packaging? (y/n): y

📦 Packaging skill: dev
   Target: Claude AI (Anthropic)
   Source: output/dev
   Output: output/dev.zip

✅ Package created: output/dev.zip
   Size: 5,980 bytes (5.8 KB)

📂 Opening folder: output

╔══════════════════════════════════════════════════════════╗
║                     NEXT STEP                            ║
╚══════════════════════════════════════════════════════════╝

📤 Upload to Claude: https://claude.ai/skills

1. Go to https://claude.ai/skills
2. Click "Upload Skill"
3. Select: output/dev.zip
4. Done! ✅

$ skill-seekers install-agent output/<skill-name> --agent claude

📋 Installing skill: dev
   Agent:  claude
✅ Installation complete!

Skill 'dev' installed to claude
Location: ~/.claude/skills/dev

Restart Claude Code to load the new skill.

{
  "name": "my-skill",
  "description": "My custom skill",
  "sources": [
    {
      "url": "https://docs.example.com/",
      "selectors": {
        "main_content": "article.main",
        "title": "h1",
        "code_blocks": "pre code"
      },
      "url_patterns": {
        "include": ["/docs/", "/api/"],
        "exclude": ["/blog/", "/changelog/"]
      }
    }
  ],
  "categories": ["getting-started", "api-reference", "guides"],
  "max_pages": 50,
  "rate_limit": 1.0
}

$ skill-seekers scrape --config configs/my-skill.json --max-pages 50

# Gemini向け
$ skill-seekers package output/my-skill --target gemini

# LangChain向け
$ skill-seekers package output/my-skill --target langchain