search-docs — скилл для Claude Code: что делает и как установить
Скилл учит агента переформулировать вопросы пользователя и искать ответы по документации ImageKit через инструмент search_docs.
npx skills add imagekit-developer/skills --skill search-docs -a claude-codeЧто делает search-docs
Скилл задаёт правила для поиска по базе знаний ImageKit. Перед вызовом инструмента search_docs агент превращает размытый запрос пользователя в чёткую поисковую фразу. Например, вместо короткого слова «upload» помощник сформирует запрос об API загрузки файлов.
Инструкция управляет выбором источников. По умолчанию поиск идёт по официальным руководствам imagekit_guides и пользовательскому сообществу imagekit_community. Если задача касается кода или параметров эндпоинтов, агент подключает imagekit_api_references или imagekit_sdk.
Все ответы дополняются блоком ссылок на конкретные страницы. Скилл регламентирует только логику подготовки запросов: без зарегистрированного инструмента search_docs в среде разработки агент не сможет извлечь данные.
Какие задачи решает
- переформулировать неточные вопросы о возможностях ImageKit в поисковые запросы
- находить примеры интеграции SDK и параметры API ImageKit
- подбирать параметры трансформации медиафайлов и ограничения сервиса
- оформлять ссылки на официальную документацию и решения сообщества
Примеры запросов агенту
- Как настроить удаление фона на изображениях через API ImageKit?
- Покажи пример инициализации ImageKit SDK и загрузки файла.
- Какие тарифные планы и лимиты действуют в ImageKit?
Как установить search-docs
1Через Skills CLI (Vercel)
npx skills add imagekit-developer/skills --skill search-docs -a claude-code2Вручную: положить файлы
~/.claude/skills/search-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/search-docs/
1Через Skills CLI (Vercel)
npx skills add imagekit-developer/skills --skill search-docs -a codex2Вручную: положить файлы
.agents/skills/search-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add imagekit-developer/skills --skill search-docs -a cursor2Вручную: положить файлы
.cursor/skills/search-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install imagekit-developer/skills search-docs2Вручную: положить файлы
.github/skills/search-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add imagekit-developer/skills --skill search-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/imagekit-developer/skills --path skills/search-docsВручную: положить файлы
.devin/skills/search-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add imagekit-developer/skills --skill search-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о search-docs
Как установить search-docs в Claude Code?
Выполните команду npx skills add imagekit-developer/skills --skill search-docs -a claude-code в терминале.
Что делает скилл search-docs?
Он инструктирует ассистента, как составлять точные запросы к документации ImageKit, выбирать подходящие разделы базы знаний и прикреплять ссылки на первоисточники.
Какие источники документации поддерживает поиск?
В правилах заданы четыре источника: imagekit_guides, imagekit_community, imagekit_api_references и imagekit_sdk. По умолчанию поиск задействует руководства и материалы сообщества.
Исходный текст
SKILL.md · MIT
---
name: search-docs
description: "Guidance for searching ImageKit documentation with the search_docs tool — how to craft effective queries, select the right sources, and handle results. Use before calling search_docs to look up ImageKit features, APIs, configuration, pricing, or SDK examples."
---
# Documentation Search Skill
Prepare your query and source selection using the guidelines below, then call `search_docs` and present the results following the rules here.
## When to use
- User asks about ImageKit features, capabilities, or services
- Transformation builder fails and you need parameter/limit info
- User asks about APIs, configuration, pricing, or DAM features
- Need to verify if ImageKit supports a specific feature
- Need to find SDK usage examples or API reference details
## Tool Parameters
**Required**: `query` - Clear, specific question about ImageKit (see Query Crafting below)
**Optional**: `sources` array (default: `["imagekit_guides", "imagekit_community"]`)
- `imagekit_guides`: Official guides and tutorials
- `imagekit_community`: User-generated content, practical solutions. Great for troubleshooting and real-world use cases.
- `imagekit_api_references`: Technical API details
- `imagekit_sdk`: SDK implementation examples
## Query Crafting
**Rule: Always rewrite vague user questions into specific, searchable queries before calling the tool.**
| User Says | Bad Query (don't pass this) | Good Query |
|---|---|---|
| "Tell me about ImageKit" | "tell me about ImageKit" | "ImageKit features overview image optimization CDN" |
| "How do I upload?" | "upload" | "How to upload files using ImageKit upload API" |
| "Pricing info" | "pricing" | "ImageKit pricing plans and extension unit costs" |
| "Can it do background removal?" | "background removal" | "How to apply background removal using ImageKit AI transformation" |
## Source Selection
| Use Case | Sources |
|----------|---------|
| General features | `["imagekit_guides", "imagekit_community"]` |
| API details | `["imagekit_guides", "imagekit_api_references"]` |
| SDK examples | `["imagekit_sdk", "imagekit_guides", "imagekit_community"]` |
| Troubleshooting | `["imagekit_community", "imagekit_guides"]` |
## Imagekit Community
- Valuable for real-world solutions, troubleshooting, and user experiences
- May contain practical tips not found in official guides
- Always include community sources. They often provide insights and solutions that official documentation may not cover, especially for troubleshooting and real-world use cases.
## Handling Results
Always cite sources:
```
References:
1. [Title]: [URL]
```
If results don't answer the question, acknowledge the limitation and suggest contacting ImageKit support.
## Gotchas
- Specific queries yield better results ("How to apply background removal using API" not "tell me about ImageKit")
- Multiple searches may be needed; refine query if first search is insufficient
- Community sources provide real-world solutions; official guides are authoritative
© imagekit-developer · MIT · imagekit-developer/skills