Metadata-Version: 2.4
Name: doc-to-skill
Version: 0.2.0
Summary: Convert documentation to AI-ready skills for coding assistants
Author: User
License: MIT
Keywords: documentation,ai,skills,crawler,markdown
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: scrapy>=2.11
Requires-Dist: html2text>=2024.2
Requires-Dist: jinja2>=3.1
Requires-Dist: pyyaml>=6.0
Requires-Dist: click>=8.1
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: lxml>=5.0
Requires-Dist: httpx>=0.27
Requires-Dist: firecrawl-py>=1.0
Requires-Dist: gitpython>=3.1
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"

# Doc-to-Skill

Автоматический инструмент для скачивания документации и генерации AI-навыков (skills) для Code.

## Возможности

- 📥 **Скачивание документации** - рекурсивный краулинг сайтов с конвертацией в Markdown
- 🔧 **Генерация навыков** - автоматическое создание SKILL.md для AI-ассистентов
- 🚀 **Полный пайплайн** - одна команда для установки документации в проект
- 📋 **OpenAPI поддержка** - парсинг Swagger/OpenAPI спецификаций

## Установка

```bash
# Установка из локальной директории
pip install -e .

# Или установка зависимостей напрямую
pip install -r requirements.txt
```

## Использование

### Скачать документацию

```bash
doc-to-skill download https://docs.example.com -o ./docs/example
```

### Сгенерировать навык

```bash
doc-to-skill generate ./docs/example --name "Example API"
```

### Полный пайплайн (скачать + сгенерировать + установить)

```bash
doc-to-skill install https://docs.example.com ./my-project --name "Example API"
```

Это создаст:
- `./my-project/docs/api/example-api/` - скачанная документация
- `./my-project/.agent/skills/example-api/` - готовый навык

### Список установленных навыков

```bash
doc-to-skill list-skills
```

## Структура сгенерированного навыка

```
.agent/skills/example-api/
├── SKILL.md        # Краткий overview для AI
├── reference.md    # Полный API справочник
└── examples.md     # Примеры кода
```

## Пример SKILL.md

```markdown
---
name: Example API
description: API documentation and reference for Example API
---

# Example API Documentation

## When to Use This Skill

Use this skill when you need to:
- Work with Example API integration
- Implement authentication for Example API
- Find API endpoints and their parameters

## Quick Reference

### Documentation Paths

- **Full Reference**: reference.md
- **Code Examples**: examples.md
- **Raw Documentation**: docs/api/example-api/

### Common Endpoints

- **GET** `/api/users` - Get all users
- **POST** `/api/users` - Create user
...
```

## Опции команд

### download

| Опция | Описание | По умолчанию |
|-------|----------|--------------|
| `-o, --output-dir` | Директория для сохранения | `./docs` |
| `-d, --max-depth` | Максимальная глубина обхода | `3` |
| `-l, --limit` | Максимум страниц | `100` |

### generate

| Опция | Описание | По умолчанию |
|-------|----------|--------------|
| `-n, --name` | Имя сервиса/API (обязательно) | - |
| `-o, --output-dir` | Директория для навыка | `.agent/skills/<name>` |

### install

| Опция | Описание | По умолчанию |
|-------|----------|--------------|
| `-n, --name` | Имя сервиса/API (обязательно) | - |
| `-d, --max-depth` | Максимальная глубина обхода | `3` |
| `-l, --limit` | Максимум страниц | `100` |

## Лицензия

MIT
