Files
skill-seekers-reference/docs
yusyus 4f87de6b56 fix: improve MiniMax adaptor from PR #318 review (#319)
* feat: add MiniMax AI as LLM platform adaptor

Original implementation by octo-patch in PR #318.
This commit includes comprehensive improvements and documentation.

Code Improvements:
- Fix API key validation to properly check JWT format (eyJ prefix)
- Add specific exception handling for timeout and connection errors
- Remove unused variable in upload method

Dependencies:
- Add MiniMax to [all-llms] extra group in pyproject.toml

Tests:
- Remove duplicate setUp method in integration test class
- Add 4 new test methods:
  * test_package_excludes_backup_files
  * test_upload_success_mocked (with OpenAI mocking)
  * test_upload_network_error
  * test_upload_connection_error
  * test_validate_api_key_jwt_format
- Update test_validate_api_key_valid to use JWT format keys
- Fix test assertions for error message matching

Documentation:
- Create comprehensive MINIMAX_INTEGRATION.md guide (380+ lines)
- Update MULTI_LLM_SUPPORT.md with MiniMax platform entry
- Update 01-installation.md extras table
- Update INTEGRATIONS.md AI platforms table
- Update AGENTS.md adaptor import pattern example
- Fix README.md platform count from 4 to 5

All tests pass (33 passed, 3 skipped)
Lint checks pass

Co-authored-by: octo-patch <octo-patch@users.noreply.github.com>

* fix: improve MiniMax adaptor — typed exceptions, key validation, tests, docs

- Remove invalid "minimax" self-reference from all-llms dependency group
- Use typed OpenAI exceptions (APITimeoutError, APIConnectionError)
  instead of string-matching on generic Exception
- Replace incorrect JWT assumption in validate_api_key with length check
- Use DEFAULT_API_ENDPOINT constant instead of hardcoded URLs (3 sites)
- Add Path() cast for output_path before .is_dir() call
- Add sys.modules mock to test_enhance_missing_library
- Add mocked test_enhance_success with backup/content verification
- Update test assertions for new exception types and key validation
- Add MiniMax to __init__.py docstrings (module, get_adaptor, list_platforms)
- Add MiniMax sections to MULTI_LLM_SUPPORT.md (install, format, API key,
  workflow example, export-to-all)

Follows up on PR #318 by @octo-patch (feat: add MiniMax AI as LLM platform adaptor).

Co-Authored-By: Octopus <octo-patch@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: octo-patch <octo-patch@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 22:12:23 +03:00
..

Skill Seekers Documentation

Complete documentation for Skill Seekers v3.2.0


Welcome!

This is the official documentation for Skill Seekers - the universal tool for converting 17 source types (documentation sites, GitHub repos, PDFs, videos, Word docs, EPUB books, Jupyter notebooks, local HTML, OpenAPI specs, AsciiDoc, PowerPoint, RSS/Atom feeds, man pages, Confluence, Notion, Slack/Discord, and local codebases) into AI-ready skills for 16+ platforms.


Where Should I Start?

🚀 I'm New Here

Start with our Getting Started guides:

  1. Installation - Install Skill Seekers
  2. Quick Start - Create your first skill in 3 commands
  3. Your First Skill - Complete walkthrough
  4. Next Steps - Where to go from here

📖 I Want to Learn

Explore our User Guides:

📚 I Need Reference

Look up specific information:

🚀 I'm Ready for Advanced Topics

Power user features:


Quick Reference

The 3 Commands

# 1. Install
pip install skill-seekers

# 2. Create skill
skill-seekers create https://docs.django.com/

# 3. Package for Claude
skill-seekers package output/django --target claude

Common Commands

# Auto-detect any source type
skill-seekers create https://docs.django.com/
skill-seekers create facebook/react
skill-seekers create manual.pdf
skill-seekers create notebook.ipynb

# Scrape documentation
skill-seekers scrape --config react

# Analyze GitHub repo
skill-seekers github --repo facebook/react

# Extract PDF
skill-seekers pdf manual.pdf --name docs

# Convert other formats
skill-seekers word report.docx --name report
skill-seekers epub book.epub --name handbook
skill-seekers jupyter analysis.ipynb --name analysis
skill-seekers openapi spec.yaml --name my-api
skill-seekers pptx slides.pptx --name deck
skill-seekers video https://youtube.com/watch?v=... --name tutorial

# Import from platforms
skill-seekers confluence --space DOCS --name wiki
skill-seekers notion --database DB_ID --name notes
skill-seekers chat --platform slack --export-dir ./export

# Analyze local code
skill-seekers analyze --directory ./my-project

# Enhance skill
skill-seekers enhance output/my-skill/

# Package for platform
skill-seekers package output/my-skill/ --target claude

# Upload
skill-seekers upload output/my-skill-claude.zip

# List workflows
skill-seekers workflows list

Documentation Structure

docs/
├── README.md                 # This file - start here
├── ARCHITECTURE.md          # How docs are organized
│
├── getting-started/         # For new users
│   ├── 01-installation.md
│   ├── 02-quick-start.md
│   ├── 03-your-first-skill.md
│   └── 04-next-steps.md
│
├── user-guide/              # Common tasks
│   ├── 01-core-concepts.md
│   ├── 02-scraping.md
│   ├── 03-enhancement.md
│   ├── 04-packaging.md
│   ├── 05-workflows.md
│   └── 06-troubleshooting.md
│
├── reference/               # Technical reference
│   ├── CLI_REFERENCE.md     # 20 commands
│   ├── MCP_REFERENCE.md     # 26 MCP tools
│   ├── CONFIG_FORMAT.md     # JSON spec
│   └── ENVIRONMENT_VARIABLES.md
│
└── advanced/                # Power user topics
    ├── mcp-server.md
    ├── mcp-tools.md
    ├── custom-workflows.md
    └── multi-source.md

By Use Case

I Want to Build AI Skills

For Claude, Gemini, ChatGPT:

  1. Quick Start
  2. Enhancement Guide
  3. Workflows Guide

I Want to Build RAG Pipelines

For LangChain, LlamaIndex, vector DBs:

  1. Core Concepts
  2. Packaging Guide
  3. MCP Reference

I Want AI Coding Assistance

For Cursor, Windsurf, Cline:

  1. Your First Skill
  2. Local Codebase Analysis
  3. skill-seekers install-agent --agent cursor

Version Information

  • Current Version: 3.2.0
  • Last Updated: 2026-03-15
  • Source Types: 17
  • Python Required: 3.10+

Contributing to Documentation

Found an issue? Want to improve docs?

  1. Edit files in the docs/ directory
  2. Follow the existing structure
  3. Submit a PR

See Contributing Guide for details.



License

MIT License - see LICENSE file.


Happy skill building! 🚀