GrepAI Skills

27 AI Agent Skills to master semantic code search with GrepAI.
Installation, configuration, search, tracing, MCP integration — everything you need.

Install • Skills • Usage • Contribute

Quick Install

npx skills add yoanbernabeu/grepai-skills

That's it. Works with Claude Code, Cursor, Codex, OpenCode, Windsurf, and 30+ AI agents.

One-Liners

# Install everything (27 skills)
npx skills add yoanbernabeu/grepai-skills

# Install only search skills
npx skills add yoanbernabeu/grepai-skills --skill grepai-search-basics

# Install globally (available in all projects)
npx skills add yoanbernabeu/grepai-skills -g

# List all available skills
npx skills add yoanbernabeu/grepai-skills --list

# Install to specific agents
npx skills add yoanbernabeu/grepai-skills -a claude-code -a cursor

# Non-interactive (CI/CD friendly)
npx skills add yoanbernabeu/grepai-skills --all -y

Other Installation Methods

Claude Code Plugin

/plugin marketplace add yoanbernabeu/grepai-skills
/plugin install grepai-complete@grepai-skills

Manual Installation

Copy the skills/ directory to:

Global: ~/.claude/skills/ (or ~/.cursor/skills/, etc.)
Project: .claude/skills/ (or .cursor/skills/, etc.)

What is GrepAI?

GrepAI is a semantic code search tool that:

Searches by meaning, not just text patterns
100% private with local embeddings (Ollama)
Real-time indexing with file watching
Call graph analysis to trace function dependencies
AI-ready with native MCP integration

Why These Skills?

Understanding a new codebase is hard. Traditional grep finds exact text, but you often don't know the exact words. GrepAI searches by meaning — but it has a learning curve. These skills give your AI agent expert-level knowledge of GrepAI so you can find code instantly.

Challenge	Skill That Helps
"How do I install GrepAI?"	`grepai-installation`
"How do I set up Ollama?"	`grepai-ollama-setup`
"My searches return poor results"	`grepai-search-tips`
"What calls this function?"	`grepai-trace-callers`
"How do I use with Claude Code?"	`grepai-mcp-claude`

All 27 Skills

Getting Started

Skill	What It Does
`grepai-installation`	Multi-platform installation (Homebrew, shell, Windows)
`grepai-ollama-setup`	Install and configure Ollama for local embeddings
`grepai-quickstart`	Get searching in 5 minutes

Configuration

Skill	What It Does
`grepai-init`	Initialize GrepAI in a project
`grepai-config-reference`	Complete configuration reference
`grepai-ignore-patterns`	Exclude files and directories from indexing

Embeddings Providers

Skill	What It Does
`grepai-embeddings-ollama`	Configure Ollama for local, private embeddings
`grepai-embeddings-openai`	Configure OpenAI for cloud embeddings
`grepai-embeddings-lmstudio`	Configure LM Studio with GUI interface

Storage Backends

Skill	What It Does
`grepai-storage-gob`	Local file storage (default, simple)
`grepai-storage-postgres`	PostgreSQL + pgvector for teams
`grepai-storage-qdrant`	Qdrant for high-performance search

Indexing

Skill	What It Does
`grepai-watch-daemon`	Configure and manage the watch daemon
`grepai-chunking`	Optimize how code is split for embedding

Semantic Search

Skill	What It Does
`grepai-search-basics`	Basic semantic code search
`grepai-search-advanced`	JSON output, compact mode, AI integration
`grepai-search-tips`	Write effective search queries
`grepai-search-boosting`	Prioritize source code over tests

Call Graph Analysis

Skill	What It Does
`grepai-trace-callers`	Find all callers of a function
`grepai-trace-callees`	Find all functions called by a function
`grepai-trace-graph`	Build complete dependency graphs

AI Agent Integration

Skill	What It Does
`grepai-mcp-claude`	Integrate with Claude Code via MCP
`grepai-mcp-cursor`	Integrate with Cursor IDE via MCP
`grepai-mcp-tools`	Reference for all MCP tools

Advanced

Skill	What It Does
`grepai-workspaces`	Multi-project workspace management
`grepai-languages`	Supported programming languages
`grepai-troubleshooting`	Diagnose and fix common issues

Skill Packs

Install skills by category:

Pack	Skills	Description
`grepai-getting-started`	3	Installation, Ollama setup, quickstart
`grepai-configuration`	3	Init, config reference, ignore patterns
`grepai-embeddings`	3	Ollama, OpenAI, LM Studio providers
`grepai-storage`	3	GOB, PostgreSQL, Qdrant backends
`grepai-indexing`	2	Watch daemon, chunking
`grepai-search`	4	Basics, advanced, tips, boosting
`grepai-trace`	3	Callers, callees, graphs
`grepai-integration`	3	Claude Code, Cursor, MCP tools
`grepai-advanced`	3	Workspaces, languages, troubleshooting
`grepai-complete`	27	All skills — complete toolkit

Supported AI Agents

Agent	Project Path	Global Path
Claude Code	`.claude/skills/`	`~/.claude/skills/`
Cursor	`.cursor/skills/`	`~/.cursor/skills/`
Codex	`.codex/skills/`	`~/.codex/skills/`
OpenCode	`.opencode/skill/`	`~/.config/opencode/skill/`
Windsurf	`.windsurf/skills/`	`~/.windsurf/skills/`

Example Usage

Just ask your AI agent:

"Help me install and configure GrepAI"

"Search for authentication code in this project"

"What functions call the Login function?"

"Set up GrepAI with Claude Code via MCP"

"Why are my search results poor?"

"Configure GrepAI to use OpenAI embeddings"

"How do I search across multiple projects?"

Quick Start Guide

Install: npx skills add yoanbernabeu/grepai-skills
Setup GrepAI: Follow grepai-installation skill
Setup Ollama: Follow grepai-ollama-setup skill
Initialize: grepai init in your project
Index: grepai watch to build the index
Search: grepai search "your query"
Integrate: Add MCP for your AI agent

Quick Reference

Essential Commands

# Initialize project
grepai init

# Start indexing
grepai watch

# Search semantically
grepai search "user authentication"

# Find callers
grepai trace callers "Login"

# Check status
grepai status

Search Examples

# Basic search
grepai search "error handling"

# Limit results
grepai search "database queries" --limit 5

# JSON for AI agents
grepai search "authentication" --json --compact

Resources

GrepAI Documentation
GrepAI GitHub
Skills CLI - The open agent skills tool
Skills Directory - Browse available skills

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

# Fork, clone, and create a branch
git checkout -b feature/new-skill

# Add your skill following the SKILL.md format
# Submit a pull request

License

MIT — Feel free to use, modify, and distribute.

Built by the community, for the community.

Star this repo if it helps you search code!