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

grepai-ignore-patterns — скилл для Claude Code: как настроить

Скилл grepai-ignore-patterns помогает настроить исключения в .grepai/config.yaml, чтобы GrepAI не тратил ресурсы на тесты, кэш и сгенерированный код при индексации.

MIT 712 установок ★ 20 обновлён 2026-02-01

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

Что делает grepai-ignore-patterns

Скилл учит ИИ-агента правильно настраивать фильтры индексации в файле .grepai/config.yaml. По умолчанию GrepAI считывает .gitignore, но для средних и больших репозиториев этого мало: фикстуры тестов, сгенерированные файлы Protobuf или OpenAPI и пакетные блокировки забивают поисковый индекс.

В правилах собраны синтаксис глобов, маски каталогов и готовые списки исключений под стек проекта: JavaScript, Go, Python, Rust или Java. Для тестов предложена альтернатива полному исключению: штрафной коэффициент релевантности через секцию search.boost.penalties.

Строки со спецсимволами вроде *.min.js в YAML-конфигурации обязательно оборачивать в кавычки, иначе синтаксический парсер завершится сбоем. После правок конфига поисковую базу сбрасывают вручную: останавливают демон командой grepai watch --stop, удаляют файл .grepai/index.gob и запускают grepai watch заново.

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

  • Исключить автосгенерированный код и моки из результатов поиска GrepAI
  • Уменьшить размер файла индекса .grepai/index.gob
  • Настроить шаблоны игнорирования тестов или понизить их поисковый вес
  • Собрать базовый .grepai/config.yaml под Go, Python или Node.js

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

  • Создай конфиг .grepai/config.yaml для Go-проекта, исключи protobuf и моки
  • Как настроить в GrepAI штрафы релевантности для тестов вместо их полного игнорирования?
  • Уменьши индекс GrepAI: добавь в игнор сгенерированные файлы и локфайлы

Как установить grepai-ignore-patterns

1Через Skills CLI (Vercel)

npx skills add yoanbernabeu/grepai-skills --skill grepai-ignore-patterns -a claude-code

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

~/.claude/skills/grepai-ignore-patterns/SKILL.md

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

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

Вопросы о grepai-ignore-patterns

Как установить grepai-ignore-patterns в Claude Code?

Выполните команду npx skills add yoanbernabeu/grepai-skills --skill grepai-ignore-patterns -a claude-code. Файл навыка запишется по пути ~/.claude/skills/grepai-ignore-patterns/SKILL.md.

Что делает grepai-ignore-patterns?

Скилл передаёт агенту правила и примеры синтаксиса для конфигурации .grepai/config.yaml. Это позволяет исключать ненужные директории и файлы из поискового индекса GrepAI.

Как переиндексировать проект после обновления правил?

Остановите сервис через grepai watch --stop, удалите .grepai/index.gob и выполните grepai watch. Текущее число проиндексированных файлов проверяется через grepai status.

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

SKILL.md · MIT
---
name: grepai-ignore-patterns
description: Configure ignore patterns in GrepAI. Use this skill when excluding files and directories from indexing.
---

# GrepAI Ignore Patterns

This skill covers how to configure ignore patterns to exclude files and directories from GrepAI indexing.

## When to Use This Skill

- Excluding test files from search results
- Ignoring generated or vendored code
- Reducing index size by excluding unnecessary files
- Customizing which files GrepAI indexes

## How Ignore Patterns Work

GrepAI uses two sources for ignore patterns:

1. **`.grepai/config.yaml`** - Custom patterns you define
2. **`.gitignore`** - Automatically respected

## Configuration Location

```yaml
# .grepai/config.yaml
ignore:
  - pattern1
  - pattern2
```

## Pattern Syntax

### Directory Patterns

```yaml
ignore:
  # Exact directory name (matches anywhere)
  - node_modules
  - vendor
  - __pycache__

  # With trailing slash (explicit directory)
  - dist/
  - build/
  - coverage/
```

### File Patterns

```yaml
ignore:
  # Exact filename
  - package-lock.json
  - yarn.lock

  # Wildcard patterns
  - "*.min.js"
  - "*.min.css"
  - "*.map"
  - "*.lock"
```

### Path Patterns

```yaml
ignore:
  # Paths containing substring
  - /tests/
  - /spec/
  - /__tests__/

  # Specific paths
  - src/generated/
  - api/swagger/
```

### Glob Patterns

```yaml
ignore:
  # Double star (recursive)
  - "**/test/**"
  - "**/mock/**"

  # Single star (single level)
  - "*.test.js"
  - "*.spec.ts"
  - "*_test.go"
```

## Default Ignore Patterns

GrepAI's default configuration includes:

```yaml
ignore:
  # Version control
  - .git
  - .svn
  - .hg

  # GrepAI itself
  - .grepai

  # Package managers
  - node_modules
  - vendor
  - .npm
  - .yarn

  # Build outputs
  - target
  - dist
  - build
  - out

  # Cache directories
  - __pycache__
  - .pytest_cache
  - .mypy_cache
  - .cache

  # Framework outputs
  - .next
  - .nuxt
  - .output
```

## Common Ignore Configurations

### JavaScript/TypeScript Project

```yaml
ignore:
  - node_modules
  - dist
  - build
  - coverage
  - .nyc_output
  - "*.min.js"
  - "*.bundle.js"
  - "*.map"
  - package-lock.json
  - yarn.lock
  - pnpm-lock.yaml
```

### Go Project

```yaml
ignore:
  - vendor
  - bin
  - "*.pb.go"       # Protobuf generated
  - "*_mock.go"     # Mocks
  - "mocks/"
  - go.sum
```

### Python Project

```yaml
ignore:
  - __pycache__
  - .pytest_cache
  - .mypy_cache
  - .venv
  - venv
  - env
  - "*.pyc"
  - "*.pyo"
  - .eggs
  - "*.egg-info"
  - dist
  - build
```

### Rust Project

```yaml
ignore:
  - target
  - Cargo.lock
  - "*.rlib"
```

### Java/Kotlin Project

```yaml
ignore:
  - target
  - build
  - .gradle
  - "*.class"
  - "*.jar"
  - "*.war"
```

### Monorepo

```yaml
ignore:
  # Common
  - node_modules
  - dist
  - build
  - coverage

  # Specific packages to exclude
  - packages/legacy/
  - packages/deprecated/

  # Generated
  - "**/generated/**"
  - "**/__generated__/**"
```

## Excluding Test Files

To focus search on production code:

```yaml
ignore:
  # Test directories
  - tests/
  - test/
  - __tests__/
  - spec/

  # Test files by pattern
  - "*.test.js"
  - "*.test.ts"
  - "*.spec.js"
  - "*.spec.ts"
  - "*_test.go"
  - "test_*.py"
  - "*_test.py"
```

**Alternative:** Use search boosting instead to penalize (not exclude) tests:

```yaml
search:
  boost:
    penalties:
      - pattern: /tests/
        factor: 0.5
      - pattern: _test.
        factor: 0.5
```

## Excluding Generated Code

```yaml
ignore:
  # Generated markers
  - "**/generated/**"
  - "*.generated.*"
  - "*.gen.*"

  # Specific generators
  - "*.pb.go"           # Protobuf
  - "*.graphql.ts"      # GraphQL codegen
  - "*.d.ts"            # TypeScript declarations
  - "swagger_*.go"      # Swagger
  - "openapi_*.ts"      # OpenAPI
```

## Excluding Documentation

```yaml
ignore:
  - docs/
  - documentation/
  - "*.md"
  - "*.mdx"
  - "*.rst"
```

## Verifying Ignore Patterns

Check what's being indexed:

```bash
# Check index status
grepai status

# Output shows file count
# If too high, add more ignore patterns
```

## Common Issues

❌ **Problem:** Index is too large
✅ **Solution:** Add more ignore patterns for dependencies and generated files

❌ **Problem:** Search returns vendor/test code
✅ **Solution:** Either ignore or use boosting penalties

❌ **Problem:** Pattern not working
✅ **Solution:** Check syntax - use quotes for patterns with special characters:
```yaml
ignore:
  - "*.min.js"  # Correct
  - *.min.js    # May cause YAML parsing issues
```

❌ **Problem:** Need to include previously ignored files
✅ **Solution:** Remove from ignore list and re-run `grepai watch`

## Best Practices

1. **Start with defaults:** Add patterns as needed
2. **Exclude dependencies:** Always ignore `node_modules`, `vendor`, etc.
3. **Exclude build outputs:** `dist`, `build`, `target`
4. **Exclude lock files:** Large, not useful for search
5. **Consider boosting vs ignoring:** Penalize instead of exclude for test files
6. **Quote special characters:** `"*.min.js"` not `*.min.js`

## Re-indexing After Changes

After modifying ignore patterns:

```bash
# Stop existing daemon
grepai watch --stop

# Clear index and restart
rm .grepai/index.gob
grepai watch
```

## Output Format

After configuring ignore patterns:

```
✅ Ignore Patterns Configured

   Patterns: 15 configured

   Categories:
   - Directories: node_modules, vendor, dist, build
   - File types: *.min.js, *.map, *.lock
   - Paths: /tests/, /docs/

   Also respecting: .gitignore

   Run 'grepai watch' to re-index with new patterns.
```

© yoanbernabeu · MIT · yoanbernabeu/grepai-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
Nia nozomio-labs Индексирует репозитории, документацию, статьи, датасеты и рабочие чаты, ищет по ним через API Nia — возвращает полный исходник вместо обрезанной веб-выдачи. CX Codex +1 56 300установок ccc cocoindex-io Скилл подключает семантический поиск по репозиторию через утилиту ccc. Он ищет фрагменты по смыслу запроса и сам обновляет индекс проекта. CX Codex +1 6 400установок docs-search davila7 Скилл docs-search ищет по автосгенерированной документации проекта: сигнатуры функций, классы, интерфейсы. Пригодится перед правками, чтобы не угадывать API. CX Codex +1 256установок aidex CSCSoftware Локальный MCP-сервер aidex для Claude Code и Codex: индексирует код, ищет семантически и ведёт журнал задач — агент делает один запрос вместо чтения десятков файлов. CX Codex +1 ★ 49звёзд репо ast-grep pproenca Скилл с набором правил по написанию и отладке ast-grep-запросов: поиск по AST, линтинг и переписывание кода. CX Codex +1 346установок sql-optimization-patterns Seth Hobson Скилл sql-optimization-patterns разбирает медленные SQL-запросы, планы EXPLAIN и стратегию индексов. Нужен при поиске Seq Scan, проблемах с JOIN и N+1. CX Codex +1 19 717установок

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

Весь набор →
grepai-watch-daemon Скилл grepai-watch-daemon учит агента запускать и настраивать демон grepai watch: первичная индексация проекта, слежение за файлами, фоновый режим и разбор сбоев. CX Codex +1 732установок grepai-troubleshooting Скилл grepai-troubleshooting помогает найти причину сбоев GrepAI: пустой или устаревший индекс, плохие результаты поиска, ошибки подключения и конфигурации. CX Codex +1 727установок grepai-config-reference Скилл grepai-config-reference описывает все параметры файла .grepai/config.yaml — эмбеддер, хранилище, чанкинг, трассировку вызовов и правила игнорирования. CX Codex +1 727установок grepai-workspaces Скилл grepai-workspaces настраивает мультипроектные воркспейсы GrepAI с общим векторным хранилищем для монорепо и связанных сервисов. Агент сам разбирается с индексацией и поиском по нескольким проектам сразу. CX Codex +1 721установок grepai-storage-gob Скилл grepai-storage-gob настраивает локальное хранилище GOB для GrepAI без внешних баз данных. Пригодится соло-разработчикам на небольших проектах до 10 000 файлов. CX Codex +1 701установок grepai-mcp-claude Скилл grepai-mcp-claude для Claude Code подключает GrepAI через MCP и включает семантический поиск по коду. Запускается при настройке сервера или поиске причин сбоев интеграции. CX Codex +1 618установок grepai-mcp-cursor Скилл помогает настроить интеграцию GrepAI с Cursor через MCP для семантического поиска по коду и построения графа вызовов. CX Codex +1 601установок grepai-storage-qdrant Скилл grepai-storage-qdrant настраивает векторную базу данных Qdrant в роли хранилища для поискового движка GrepAI. Инструкция подключает локальный Docker-контейнер или кластер Qdrant Cloud через gRPC на порту 6334. CX Codex +1 570установок

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

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