К основному содержанию
скилл CX Codex

semble — скилл для Claude Code: поиск кода и установка

Скилл semble для Claude Code ищет фрагменты кода по описанию задачи или имени символа. Запускается, когда агенту нужно найти реализацию или похожий участок кода в репозитории.

MIT 234 установок ★ 61 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add akillness/jeo-skills --skill semble -a claude-code
Открыть на GitHub

Что делает semble

semble индексирует локальный или удалённый репозиторий и возвращает подходящие фрагменты с путями и номерами строк. Запрос можно сформулировать обычным языком, указать имя символа или найти код, похожий на участок из известного файла. Для MCP в Claude Code нужен uv; API-ключ и GPU не требуются.

Скилл предназначен для поиска, а не для чтения целых файлов, списка директорий или запуска тестов. Для точного совпадения и регулярных выражений в исходнике рекомендуют Grep. Установить скилл в Claude Code можно командой npx skills add akillness/jeo-skills --skill semble -a claude-code; файл появится в ~/.claude/skills/semble/SKILL.md.

Какие задачи решает

  • найти обработчик по описанию его поведения
  • отыскать символ, не зная имени файла
  • обнаружить код, похожий на известный фрагмент
  • искать по удалённому Git-репозиторию без клонирования

Примеры запросов агенту

  • Найди, как в проекте обрабатывается ограничение запросов.
  • Найди символ save_pretrained в репозитории.
  • Найди код, похожий на участок src/auth.py, строка 42.

Как установить semble

1Через Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill semble -a claude-code

2Вручную: положить файлы

~/.claude/skills/semble/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/semble/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о semble

Как установить semble в Claude Code?

Выполни npx skills add akillness/jeo-skills --skill semble -a claude-code. Скилл установится в ~/.claude/skills/semble/SKILL.md.

Что делает semble?

Скилл ищет код в локальных и удалённых репозиториях по текстовому запросу или имени символа, а также находит похожие фрагменты. В результатах есть пути к файлам и номера строк.

Что нужно для работы semble?

Для установки скилла нужна команда npx. Для MCP-подключения в Claude Code требуется uv; API-ключ и GPU не нужны.

Исходный текст

SKILL.md · MIT
---
name: semble
description: >
  Fast, accurate code search for AI agents using ~98% fewer tokens than grep+read.
  Indexes any local or remote repository in under a second (~250ms on CPU, no GPU or API key needed).
  Supports natural-language and symbol queries, semantic similar-code discovery, and MCP server
  integration for Claude Code, Codex, Cursor, and OpenCode. Python library available for programmatic
  use. Triggers on: semble, code search, semantic code search, semble search, token-efficient search,
  find code, code search mcp, agent code search, semble find-related, semble savings.
allowed-tools: Read Write Bash Grep Glob WebFetch
metadata:
  tags: semble, code-search, semantic-search, mcp, token-efficient, agent-tools, python, cli, codebase-navigation
  platforms: Claude Code, Codex CLI, Gemini CLI, OpenCode, Cursor
  keyword: semble
  version: latest
  source: MinishLab/semble
  license: MIT
---

# semble — Fast Token-Efficient Code Search for Agents

> ~98% fewer tokens than grep+read. Index in ~250ms. Query in ~1.5ms. No GPU, no API key.

Semble returns only the relevant code snippets agents need, without grepping full files or reading directories. A natural-language or symbol query like `"authentication flow"` or `"save_pretrained"` returns exact chunks with file paths and line ranges — nothing more.

## Installation

### MCP (Claude Code — recommended)
```bash
# Requires uv: https://docs.astral.sh/uv/getting-started/installation/
claude mcp add semble -s user -- uvx --from "semble[mcp]" semble
```

### MCP (Codex)
```bash
codex mcp add semble -- uvx --from "semble[mcp]" semble
```

### MCP (Cursor / OpenCode)
Register `semble` as a local MCP server in your editor's MCP server settings UI with command `uvx` and args `["--from", "semble[mcp]", "semble"]`.

### CLI / pip
```bash
pip install semble        # pip
uv tool install semble    # uv (recommended for CLI use)
```

### Skill (any platform)
```bash
npx [email protected] add https://github.com/akillness/jeo-skills --skill semble
```

## When to use

- Search a codebase by describing behavior in natural language (`"how is rate limiting handled"`)
- Look up a symbol or identifier without knowing the exact file (`"save_pretrained"`)
- Discover code semantically similar to a known location (`find-related`)
- Give an agent token-efficient access to any repo via MCP instead of letting it grep/read full files
- Index a remote git repo without cloning first

## Do not use when

- You need to read a full file or directory listing → use native `Read`, `Glob` tools
- You need regex or exact-string search → `Grep` is more appropriate
- The repo is too small to justify indexing (a few files) — just read them directly
- You need to run tests, build, or execute code — this is a search-only tool

## CLI usage

```bash
# Natural-language search in a local repo
semble search "authentication flow" ./my-project

# Symbol search
semble search "save_pretrained" ./my-project

# Search with a limit on returned chunks
semble search "save model to disk" ./my-project --top-k 10

# Search a remote git repo (no clone needed)
semble search "save model to disk" https://github.com/MinishLab/model2vec

# Find semantically similar code given a known file+line
semble find-related src/auth.py 42 ./my-project

# Show token savings vs grep+read for the last query
semble savings
semble savings --verbose
```

## Python library

```python
from semble import SembleIndex

# Index local directory
index = SembleIndex.from_path("./my-project")

# Index remote repository (no clone required)
index = SembleIndex.from_git("https://github.com/MinishLab/model2vec")

# Natural-language or symbol query
results = index.search("save model to disk", top_k=3)

# Find semantically similar code to a known chunk
related = index.find_related(results[0], top_k=3)

# Inspect results
result = results[0]
print(result.chunk.file_path)   # "model2vec/model.py"
print(result.chunk.start_line)  # 127
print(result.chunk.end_line)    # 150
print(result.chunk.content)     # the function/class body
```

## AGENTS.md / CLAUDE.md integration

Add this section to your project's `AGENTS.md` or `CLAUDE.md` to enable semble for all agents:

````markdown
## Code Search

Use `semble search` to find code by describing what it does or naming a symbol, instead of grep:

```bash
semble search "authentication flow" ./my-project
semble search "save_pretrained" ./my-project
semble search "save model to disk" ./my-project --top-k 10
```

Use `semble find-related` to discover code similar to a known location (pass `file_path` and `line` from a prior search result):

```bash
semble find-related src/auth.py 42 ./my-project
```

`path` defaults to the current directory when omitted; git URLs are accepted.

If `semble` is not on `$PATH`, use `uvx --from "semble[mcp]" semble` in its place.
````

For Claude Code sub-agents, initialize once in the project root:
```bash
semble init
```

## Performance benchmarks

| Metric | Semble | grep+read |
|--------|--------|-----------|
| Indexing speed | ~250ms | n/a |
| Query speed | ~1.5ms | varies |
| Token use at 94% recall | ~2k tokens | ~100k tokens |
| NDCG@10 | 0.854 | — |
| vs 137M-param CodeRankEmbed | 99% quality | — |
| Indexing vs transformer | 218× faster | — |

## Operating rules

1. Prefer MCP installation for interactive agent use; prefer CLI/pip for scripting and CI.
2. Use `--top-k` to limit results and keep context small — default is often too generous for agent prompts.
3. Use `find-related` after `search` when you need to expand from one known chunk into similar code.
4. Use `semble init` in project roots to pre-warm the index for Claude Code sub-agents.
5. If `semble` is not on `$PATH`, replace with `uvx --from "semble[mcp]" semble` in scripts.
6. Treat semble as the first pass — read full files only when the returned chunk is insufficient context.

## Examples

```bash
# Search for how a feature is implemented
semble search "rate limiting middleware" ./api-service

# Find all code related to database migrations
semble search "database migration" ./backend --top-k 5

# Explore similar code patterns near a known function
semble find-related src/middleware/auth.py 88 ./api-service

# Index and query a remote library without cloning
semble search "tokenizer padding" https://github.com/huggingface/transformers
```

Source: [MinishLab/semble](https://github.com/MinishLab/semble) — MIT License

© akillness · MIT · akillness/jeo-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
ccc cocoindex-io Скилл подключает семантический поиск по репозиторию через утилиту ccc. Он ищет фрагменты по смыслу запроса и сам обновляет индекс проекта. CX Codex +1 6 400установок jevgrep dzhng Скилл jevgrep запускает семантический поиск по кодовой базе через CLI-утилиту jg. Он помогает понять поведение, жизненный цикл и логику незнакомого репозитория. CX Codex +1 1 600установок vexor sickn33 Направляет агента при поиске по файлам с помощью семантической утилиты Vexor. Помогает искать по смыслу, когда обычного поиска по строкам недостаточно. CX Codex +1 ★ 50 109звёзд репо github-search parcadei Ищет код, репозитории, задачи и PR на GitHub через MCP. Запускается с параметрами типа поиска и запроса, поддерживает синтаксис GitHub Search. CX Codex +1 746установок grepai-search-basics yoanbernabeu Скилл grepai-search-basics обучает ассистента семантическому поиску по кодовой базе через GrepAI вместо текстового поиска строк. CX Codex +1 945установок grepai-search-tips yoanbernabeu Скилл grepai-search-tips для Claude Code учит агента формулировать семантические запросы к GrepAI: описывать смысл функции вместо её названия. Повышает качество поиска по коду, когда стандартный grep выдаёт мусор. CX Codex +1 816установок

Из того же набора99

Весь набор →
payloadcms Проводит агента по работе с Payload CMS в репозитории: поднять приложение, поменять схему коллекций, отладить админку или API, подготовить миграции. CX Codex +1 253установок zeude Скилл zeude для Claude Code собирает метрики использования и синхронизирует настройки команды. На запросы разработчиков он предлагает подходящие скиллы. CX Codex +1 252установок hyperfine-benchmarking Скилл hyperfine-benchmarking для Claude Code запускает команды с прогревом и собирает статистику времени выполнения. Помогает сравнить варианты инструментов или валидировать изменения производительности перед PR с доказательствами. CX Codex +1 251установок ghgrab Скилл ghgrab помогает выбирать и скачивать отдельные файлы, папки и assets из GitHub через терминал, не клонируя весь репозиторий. CX Codex +1 251установок react-bits Скилл проводит агента по библиотеке react-bits: подобрать зависимости, встроить анимированный компонент в React-проект, починить GSAP и Three.js или отправить свой компонент в репозиторий. CX Codex +1 211установок deep-dive Скилл deep-dive для Claude Code ведёт три параллельные линии поиска причины, затем проводит интервью по требованиям с переносом находок. Для багов и правок в незнакомом коде. CX Codex +1 177установок spec-kit Ставит specify-cli от GitHub, разворачивает в проекте структуру разработки от спецификации и ведёт агента по цепочке /speckit.* — от конституции до реализации. CX Codex +1 167установок academic-research Скилл academic-research маршрутизирует запрос по теме исследования или тексту статьи в одну из четырёх смежных методик — от поиска литературы до рецензирования. Решение, какую ветку и режим запускать, принимает сам скилл. CX Codex +1 148установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой