adaption-ai — скилл для Claude Code: что делает и как установить
Помогает настраивать аугментацию датасетов и генерацию синтетических данных через SDK Adaption AI прямо в диалоге с агентом.
MIT 1 установок ★ 12 обновлён 2026-10-29
npx skills add svngoku/coding-agents-skills --skill adaption-ai -a claude-codeЧто делает adaption-ai
Скилл даёт агенту инструкции по работе с библиотекой adaption на Python. Он охватывает цикл подготовки данных для тонкой настройки: загрузку локальных файлов (.csv, .json, .parquet), импорт из Hugging Face и Kaggle, запуск задач адаптации и экспорт готового датасета по временной ссылке S3.
В вызове client.datasets.run() обязательно нужно передавать словарь column_mapping хотя бы с ключом prompt, иначе сервис вернёт ошибку. Скилл настраивает добавление цепочек рассуждений (reasoning traces), подготовку пар для DPO (preference pairs) и заземление через поиск для снижения галлюцинаций.
Импорт из Hugging Face и Kaggle выполняется асинхронно. Если запустить задачу до появления счётчика строк, обработается пустой датасет. Для вызовов понадобится ключ ADAPTION_API_KEY и установленный пакет adaption.
Какие задачи решает
- сгенерировать пары предпочтений для DPO-обучения
- обогатить обучающий датасет цепочками рассуждений
- настроить заземление через поиск для снижения галлюцинаций
- загрузить данные из Hugging Face или Kaggle в пайплайн адаптации
Примеры запросов агенту
- Напиши скрипт на Python для загрузки
train.csvв Adaption AI и запуска генерации reasoning traces. - Сделай пайплайн с DPO-парами и фильтрацией дубликатов через библиотеку
adaption. - Проверь статус задачи адаптации датасета и скачай готовый результат.
Как установить adaption-ai
1Через Skills CLI (Vercel)
npx skills add svngoku/coding-agents-skills --skill adaption-ai -a claude-code2Вручную: положить файлы
~/.claude/skills/adaption-ai/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/adaption-ai/
1Через Skills CLI (Vercel)
npx skills add svngoku/coding-agents-skills --skill adaption-ai -a codex2Вручную: положить файлы
.agents/skills/adaption-ai/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add svngoku/coding-agents-skills --skill adaption-ai -a cursor2Вручную: положить файлы
.cursor/skills/adaption-ai/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install svngoku/coding-agents-skills skills/adaption-ai2Вручную: положить файлы
.github/skills/adaption-ai/SKILL.md1Через Skills CLI (Vercel)
npx skills add svngoku/coding-agents-skills --skill adaption-ai -a gemini-cli2Командой платформы
gemini skills install https://github.com/svngoku/coding-agents-skills --path skills/adaption-aiВручную: положить файлы
.devin/skills/adaption-ai/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add svngoku/coding-agents-skills --skill adaption-ai -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об adaption-ai
Как установить adaption-ai в Claude Code?
Выполните команду npx skills add svngoku/coding-agents-skills --skill adaption-ai -a claude-code. Также можно скопировать файл в ~/.claude/skills/adaption-ai/SKILL.md.
Что делает скилл adaption-ai?
Он обучает агента строить пайплайны подготовки синтетических данных, настраивать параметры качества и экспортировать результаты через SDK Adaption.
Что обязательно передавать при запуске задачи адаптации?
Методу client.datasets.run() необходимы идентификатор dataset_id и словарь column_mapping, где ключ prompt обязателен.
Исходный текст
SKILL.md · MIT
---
name: adaption-ai
description: Adaption AI SDK for synthetic data augmentation and dataset adaptation. Use when building data pipelines with the Adaption Python SDK, uploading datasets (local files, Hugging Face, Kaggle), running augmentation/adaptation jobs, configuring brand controls (hallucination mitigation, safety categories, length), recipe specifications (reasoning traces, deduplication, preference pairs, prompt rephrase), evaluating dataset quality, downloading results, or any workflow involving `pip install adaption`, `from adaption import Adaption`, Adaptive Data, or the adaptionlabs.ai API. Also trigger when the user mentions synthetic data generation for fine-tuning, dataset augmentation pipelines, DPO preference pair generation, or grounding-based hallucination reduction on training data.
---
# Adaption AI SDK Skill
Build dataset augmentation pipelines with [Adaption's Adaptive Data](https://docs.adaptionlabs.ai/) platform. This skill covers the full lifecycle: ingest → adapt → wait → evaluate → export.
## Quick Reference
```bash
pip install adaption
```
```python
from adaption import Adaption
client = Adaption(api_key="pt_live_...") # or set ADAPTION_API_KEY env var
```
**Async client**: `from adaption import AsyncAdaption`
## Core Lifecycle
1. **Ingest** — Upload local file, import from HuggingFace, or import from Kaggle
2. **Adapt** — Start an augmentation run with column mapping + optional controls
3. **Wait** — Poll for completion with exponential backoff
4. **Evaluate** — Fetch quality metrics (score_before/after, improvement %)
5. **Export** — Download augmented dataset via presigned URL
## Ingest Methods
### Local file upload
Supported formats: `.csv`, `.json`, `.jsonl`, `.parquet`
```python
result = client.datasets.upload_file("training_data.csv")
result = client.datasets.upload_file("data.csv", name="my-dataset") # custom name
dataset_id = result.dataset_id
```
### Hugging Face import (async on server — poll before running)
```python
resp = client.datasets.create_from_huggingface(
url="https://huggingface.co/datasets/org/repo",
files=["train.csv"],
)
```
### Kaggle import (requires Kaggle API creds registered in Adaption settings)
```python
resp = client.datasets.create_from_kaggle(
url="https://www.kaggle.com/datasets/org/dataset-name",
files=["data.csv"],
)
```
## Running Adaptation Jobs
### `datasets.run()` — the central method
**Required**: `dataset_id`, `column_mapping` with at least `"prompt"` key.
```python
run = client.datasets.run(
dataset_id,
column_mapping={
"prompt": "instruction", # required
"completion": "response", # optional
# "chat": "conversation", # optional — alternative to prompt+completion
# "context": ["source", "ref"],# optional — list of context columns
},
# --- Optional controls (see references/ for details) ---
brand_controls={...},
recipe_specification={...},
job_specification={...},
estimate=True, # dry-run: get cost quote without starting
)
```
**Response fields**: `run.run_id`, `run.estimated_credits_consumed`, `run.estimated_minutes`
### Brand Controls (`brand_controls`)
| Key | Type | Purpose |
|-----|------|---------|
| `hallucination_mitigation` | `bool` | Web-search grounding to reduce fabricated content |
| `length` | `"minimal"│"concise"│"detailed"│"extensive"` | Target verbosity |
| `safety_categories` | `list[str]` | Content categories to enforce (e.g. `["harassment","hate"]`) |
### Recipe Specification (`recipe_specification`)
```python
recipe_specification={
"recipes": {
"reasoning_traces": True, # chain-of-thought in completions
"deduplication": True, # remove near-duplicates
"preference_pairs": True, # DPO chosen/rejected pairs
"prompt_rephrase": True, # rephrase prompts for variety
"prompt_metadata_injection": True, # inject context into prompts
},
"version": "...", # optional schema version
}
```
### Job Specification (`job_specification`)
```python
job_specification={
"max_rows": 500, # subsample for pilots
"idempotency_key": "...", # safe retries
}
```
## Wait, Evaluate, Export
```python
from adaption import DatasetTimeout
# Wait (exponential backoff 2s→30s, default timeout 1hr)
try:
status = client.datasets.wait_for_completion(dataset_id, timeout=600)
except DatasetTimeout as e:
print(f"Still running after {e.timeout}s")
# Evaluate quality
ev = client.datasets.get_evaluation(dataset_id)
# ev.status: pending | running | succeeded | failed | skipped
# ev.quality.score_before, ev.quality.score_after, ev.quality.improvement_percent
# Download
url = client.datasets.download(dataset_id) # presigned S3 URL
```
## When to read more
| Need | Read |
|------|------|
| Full run parameters, all API endpoints, HTTP/curl examples | `references/api-reference.md` |
| Hallucination mitigation, safety, length, reasoning traces guides | `references/guides.md` |
| End-to-end scripts (upload→adapt→evaluate→download) | `scripts/e2e_pipeline.py` |
| Async patterns | `scripts/async_pipeline.py` |
## Key Patterns
- **Always estimate first** on large datasets: `estimate=True` before real run
- **Poll after HF/Kaggle import**: ingestion is async; wait for `row_count is not None`
- **Evaluation lags adaptation**: run may show `succeeded` before eval finishes — poll `get_evaluation` separately
- **Combine controls freely**: `brand_controls` + `recipe_specification` + `job_specification` all compose on one `datasets.run()` call
## Anti-Patterns to Avoid
- **Running a real job without estimating first** — on large datasets, always call with `estimate=True` and check `estimated_credits_consumed` before spending budget
- **Reading results right after HF/Kaggle import** — ingestion is async; wait until `row_count is not None` before running a job, or you'll process an empty dataset
- **Treating run completion as evaluation completion** — the run can show `succeeded` while the evaluation is still `running`; poll `get_evaluation` separately
- **Retrying without an `idempotency_key`** — naive retries on network errors create duplicate jobs; set `job_specification.idempotency_key`
- **Missing the `prompt` key in `column_mapping`** — it is required; jobs fail with confusing errors when the mapping is incomplete
## When to Use / Not Use
**Use this skill when:**
- Generating synthetic training data or augmenting existing datasets for fine-tuning
- Building DPO preference pairs, reasoning traces, or grounded (hallucination-mitigated) training data
- Working with the Adaption Python SDK (`pip install adaption`) or the adaptionlabs.ai API
**Do NOT use this skill when:**
- The data only needs simple cleaning/formatting — a local pipeline is cheaper
- The work must stay fully on-premises with no external platform dependency
- You are not using Adaption's platform — use the generic dataset pipelines of the framework you're already on
© svngoku · MIT · svngoku/coding-agents-skills