{
  "markdown": "<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/Skills-27-brightgreen\" alt=\"27 Skills\">\n  <img src=\"https://img.shields.io/badge/License-MIT-blue\" alt=\"MIT License\">\n  <img src=\"https://img.shields.io/badge/PRs-Welcome-orange\" alt=\"PRs Welcome\">\n  <img src=\"https://img.shields.io/github/stars/yoanbernabeu/grepai-skills?style=social\" alt=\"GitHub Stars\">\n</p>\n\n<h1 align=\"center\">GrepAI Skills</h1>\n\n<p align=\"center\">\n  <strong>27 AI Agent Skills to master semantic code search with GrepAI.</strong><br>\n  Installation, configuration, search, tracing, MCP integration — everything you need.\n</p>\n\n<p align=\"center\">\n  <a href=\"#quick-install\">Install</a> •\n  <a href=\"#all-27-skills\">Skills</a> •\n  <a href=\"#example-usage\">Usage</a> •\n  <a href=\"#contributing\">Contribute</a>\n</p>\n\n---\n\n## Quick Install\n\n```bash\nnpx skills add yoanbernabeu/grepai-skills\n```\n\n**That's it.** Works with Claude Code, Cursor, Codex, OpenCode, Windsurf, and 30+ AI agents.\n\n### One-Liners\n\n```bash\n# Install everything (27 skills)\nnpx skills add yoanbernabeu/grepai-skills\n\n# Install only search skills\nnpx skills add yoanbernabeu/grepai-skills --skill grepai-search-basics\n\n# Install globally (available in all projects)\nnpx skills add yoanbernabeu/grepai-skills -g\n\n# List all available skills\nnpx skills add yoanbernabeu/grepai-skills --list\n\n# Install to specific agents\nnpx skills add yoanbernabeu/grepai-skills -a claude-code -a cursor\n\n# Non-interactive (CI/CD friendly)\nnpx skills add yoanbernabeu/grepai-skills --all -y\n```\n\n### Other Installation Methods\n\n<details>\n<summary><strong>Claude Code Plugin</strong></summary>\n\n```bash\n/plugin marketplace add yoanbernabeu/grepai-skills\n/plugin install grepai-complete@grepai-skills\n```\n</details>\n\n<details>\n<summary><strong>Manual Installation</strong></summary>\n\nCopy the `skills/` directory to:\n- **Global**: `~/.claude/skills/` (or `~/.cursor/skills/`, etc.)\n- **Project**: `.claude/skills/` (or `.cursor/skills/`, etc.)\n</details>\n\n---\n\n## What is GrepAI?\n\n[GrepAI](https://github.com/yoanbernabeu/grepai) is a semantic code search tool that:\n\n- **Searches by meaning**, not just text patterns\n- **100% private** with local embeddings (Ollama)\n- **Real-time indexing** with file watching\n- **Call graph analysis** to trace function dependencies\n- **AI-ready** with native MCP integration\n\n---\n\n## Why These Skills?\n\nUnderstanding 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.\n\n| Challenge | Skill That Helps |\n|-----------|------------------|\n| \"How do I install GrepAI?\" | `grepai-installation` |\n| \"How do I set up Ollama?\" | `grepai-ollama-setup` |\n| \"My searches return poor results\" | `grepai-search-tips` |\n| \"What calls this function?\" | `grepai-trace-callers` |\n| \"How do I use with Claude Code?\" | `grepai-mcp-claude` |\n\n---\n\n## All 27 Skills\n\n### Getting Started\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-installation` | Multi-platform installation (Homebrew, shell, Windows) |\n| `grepai-ollama-setup` | Install and configure Ollama for local embeddings |\n| `grepai-quickstart` | Get searching in 5 minutes |\n\n### Configuration\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-init` | Initialize GrepAI in a project |\n| `grepai-config-reference` | Complete configuration reference |\n| `grepai-ignore-patterns` | Exclude files and directories from indexing |\n\n### Embeddings Providers\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-embeddings-ollama` | Configure Ollama for local, private embeddings |\n| `grepai-embeddings-openai` | Configure OpenAI for cloud embeddings |\n| `grepai-embeddings-lmstudio` | Configure LM Studio with GUI interface |\n\n### Storage Backends\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-storage-gob` | Local file storage (default, simple) |\n| `grepai-storage-postgres` | PostgreSQL + pgvector for teams |\n| `grepai-storage-qdrant` | Qdrant for high-performance search |\n\n### Indexing\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-watch-daemon` | Configure and manage the watch daemon |\n| `grepai-chunking` | Optimize how code is split for embedding |\n\n### Semantic Search\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-search-basics` | Basic semantic code search |\n| `grepai-search-advanced` | JSON output, compact mode, AI integration |\n| `grepai-search-tips` | Write effective search queries |\n| `grepai-search-boosting` | Prioritize source code over tests |\n\n### Call Graph Analysis\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-trace-callers` | Find all callers of a function |\n| `grepai-trace-callees` | Find all functions called by a function |\n| `grepai-trace-graph` | Build complete dependency graphs |\n\n### AI Agent Integration\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-mcp-claude` | Integrate with Claude Code via MCP |\n| `grepai-mcp-cursor` | Integrate with Cursor IDE via MCP |\n| `grepai-mcp-tools` | Reference for all MCP tools |\n\n### Advanced\n| Skill | What It Does |\n|-------|--------------|\n| `grepai-workspaces` | Multi-project workspace management |\n| `grepai-languages` | Supported programming languages |\n| `grepai-troubleshooting` | Diagnose and fix common issues |\n\n---\n\n## Skill Packs\n\nInstall skills by category:\n\n| Pack | Skills | Description |\n|------|--------|-------------|\n| `grepai-getting-started` | 3 | Installation, Ollama setup, quickstart |\n| `grepai-configuration` | 3 | Init, config reference, ignore patterns |\n| `grepai-embeddings` | 3 | Ollama, OpenAI, LM Studio providers |\n| `grepai-storage` | 3 | GOB, PostgreSQL, Qdrant backends |\n| `grepai-indexing` | 2 | Watch daemon, chunking |\n| `grepai-search` | 4 | Basics, advanced, tips, boosting |\n| `grepai-trace` | 3 | Callers, callees, graphs |\n| `grepai-integration` | 3 | Claude Code, Cursor, MCP tools |\n| `grepai-advanced` | 3 | Workspaces, languages, troubleshooting |\n| **`grepai-complete`** | **27** | **All skills — complete toolkit** |\n\n---\n\n## Supported AI Agents\n\n| Agent | Project Path | Global Path |\n|-------|--------------|-------------|\n| Claude Code | `.claude/skills/` | `~/.claude/skills/` |\n| Cursor | `.cursor/skills/` | `~/.cursor/skills/` |\n| Codex | `.codex/skills/` | `~/.codex/skills/` |\n| OpenCode | `.opencode/skill/` | `~/.config/opencode/skill/` |\n| Windsurf | `.windsurf/skills/` | `~/.windsurf/skills/` |\n\n---\n\n## Example Usage\n\nJust ask your AI agent:\n\n```\n\"Help me install and configure GrepAI\"\n\n\"Search for authentication code in this project\"\n\n\"What functions call the Login function?\"\n\n\"Set up GrepAI with Claude Code via MCP\"\n\n\"Why are my search results poor?\"\n\n\"Configure GrepAI to use OpenAI embeddings\"\n\n\"How do I search across multiple projects?\"\n```\n\n---\n\n## Quick Start Guide\n\n1. **Install**: `npx skills add yoanbernabeu/grepai-skills`\n2. **Setup GrepAI**: Follow `grepai-installation` skill\n3. **Setup Ollama**: Follow `grepai-ollama-setup` skill\n4. **Initialize**: `grepai init` in your project\n5. **Index**: `grepai watch` to build the index\n6. **Search**: `grepai search \"your query\"`\n7. **Integrate**: Add MCP for your AI agent\n\n---\n\n## Quick Reference\n\n### Essential Commands\n\n```bash\n# Initialize project\ngrepai init\n\n# Start indexing\ngrepai watch\n\n# Search semantically\ngrepai search \"user authentication\"\n\n# Find callers\ngrepai trace callers \"Login\"\n\n# Check status\ngrepai status\n```\n\n### Search Examples\n\n```bash\n# Basic search\ngrepai search \"error handling\"\n\n# Limit results\ngrepai search \"database queries\" --limit 5\n\n# JSON for AI agents\ngrepai search \"authentication\" --json --compact\n```\n\n---\n\n## Resources\n\n- [GrepAI Documentation](https://yoanbernabeu.github.io/grepai/)\n- [GrepAI GitHub](https://github.com/yoanbernabeu/grepai)\n- [Skills CLI](https://github.com/vercel-labs/skills) - The open agent skills tool\n- [Skills Directory](https://skills.sh) - Browse available skills\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n```bash\n# Fork, clone, and create a branch\ngit checkout -b feature/new-skill\n\n# Add your skill following the SKILL.md format\n# Submit a pull request\n```\n\n---\n\n## License\n\n[MIT](LICENSE) — Feel free to use, modify, and distribute.\n\n---\n\n<p align=\"center\">\n  <strong>Built by the community, for the community.</strong><br><br>\n  <a href=\"https://github.com/yoanbernabeu/grepai-skills\">Star this repo</a> if it helps you search code!\n</p>\n",
  "bytes": 8592,
  "sha": "87615a409e63b6b576cbc9091b1ff414a14e9996aacbea97f9e68beb2545e449",
  "repo_slug": "yoanbernabeu/grepai-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_yoanbernabeu_grepai_skills_grepai_mcp_to_48927aad/readme"
}