AI Agent Skills

Install ready-to-use skills to help your AI agent master grepai

AI coding agents like Claude Code, Cursor, or Windsurf work better when they understand the tools at their disposal. grepai-skills is a collection of 27 skills that teach your AI agent how to use grepai effectively.

What are Skills?

Skills are knowledge modules that AI agents can load to understand how to use specific tools. Instead of the agent guessing how to use grepai, skills provide:

  • Step-by-step instructions for common workflows
  • Best practices for writing effective search queries
  • Troubleshooting guides for common issues
  • Configuration examples for different use cases

Installation

Install all 27 skills with a single command:

npx skills add yoanbernabeu/grepai-skills

This works with Claude Code, Cursor, Codex, OpenCode, Windsurf, and 30+ other AI agents.

Install specific skills

# Install only search-related 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

Claude Code Plugin

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

Manual installation

Copy the skills/ directory from the repository to:

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

Supported AI Agents

AgentProject PathGlobal 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/

Skill Packs

Install skills by category:

PackSkillsDescription
grepai-getting-started3Installation, Ollama setup, quickstart
grepai-configuration3Init, config reference, ignore patterns
grepai-embeddings3Ollama, OpenAI, LM Studio providers
grepai-storage3GOB, PostgreSQL, Qdrant backends
grepai-indexing2Watch daemon, chunking
grepai-search4Basics, advanced, tips, boosting
grepai-trace3Callers, callees, graphs
grepai-integration3Claude Code, Cursor, MCP tools
grepai-advanced3Workspaces, languages, troubleshooting
grepai-complete27All skills — complete toolkit

Available Skills

Getting Started

SkillDescription
grepai-installationMulti-platform installation (Homebrew, shell, Windows)
grepai-ollama-setupInstall and configure Ollama for local embeddings
grepai-quickstartGet searching in 5 minutes

Configuration

SkillDescription
grepai-initInitialize grepai in a project
grepai-config-referenceComplete configuration reference
grepai-ignore-patternsExclude files and directories from indexing

Embeddings Providers

SkillDescription
grepai-embeddings-ollamaConfigure Ollama for local, private embeddings
grepai-embeddings-openaiConfigure OpenAI for cloud embeddings
grepai-embeddings-lmstudioConfigure LM Studio with GUI interface

Storage Backends

SkillDescription
grepai-storage-gobLocal file storage (default, simple)
grepai-storage-postgresPostgreSQL + pgvector for teams
grepai-storage-qdrantQdrant for high-performance search

Indexing

SkillDescription
grepai-watch-daemonConfigure and manage the watch daemon
grepai-chunkingOptimize how code is split for embedding
SkillDescription
grepai-search-basicsBasic semantic code search
grepai-search-advancedJSON output, compact mode, AI integration
grepai-search-tipsWrite effective search queries
grepai-search-boostingPrioritize source code over tests

Call Graph Analysis

SkillDescription
grepai-trace-callersFind all callers of a function
grepai-trace-calleesFind all functions called by a function
grepai-trace-graphBuild complete dependency graphs

AI Agent Integration

SkillDescription
grepai-mcp-claudeIntegrate with Claude Code via MCP
grepai-mcp-cursorIntegrate with Cursor IDE via MCP
grepai-mcp-toolsReference for all MCP tools

Advanced

SkillDescription
grepai-workspacesMulti-project workspace management
grepai-languagesSupported programming languages
grepai-troubleshootingDiagnose and fix common issues

Usage

Once installed, just ask your AI agent naturally:

"Help me install and configure grepai"

"Search for authentication code in this project"

"What functions call the Login function?"

"Why are my search results poor?"

"Configure grepai to use OpenAI embeddings"

The agent will automatically use the relevant skills to provide accurate guidance.

Resources