sqry Skills + Plugin

Agent skills and first-class plugin for sqry — AST-based semantic code search (compiler-grade, not embeddings).

These skills and the plugin bundle are aligned with public verivus-oss/sqry v20.0.5

Plugin Installation (Recommended for Grok Build & Claude Code)

Grok Build and Claude Code automatically discover Claude-compatible plugins. The sqry-skills repo root is the plugin.

# Clone into Grok's plugins directory (or any location)
git clone --depth 1 https://github.com/verivus-oss/sqry-skills ~/.grok/plugins/sqry

# Or use --plugin-dir for testing
# grok --plugin-dir /path/to/sqry-skills
# claude --plugin-dir /path/to/sqry-skills

Then in the Grok TUI:

• /plugins → enable sqry
• /reload-plugins
• /skills and /mcps will now show sqry entries

Benefits:

• All 8 skills auto-loaded (namespaced under the sqry plugin)
• sqry-mcp auto-registered via .mcp.json (standalone --no-daemon: 37 tools + MCP docs resources)
• sqry-lsp registered via .lsp.json
• scripts/doctor.sh and scripts/install-sqry.sh available
• Works for Grok Build, Claude Code, and other Claude-compat hosts with zero extra config

After enabling, run the doctor from the plugin or project:

~/.grok/plugins/sqry/scripts/doctor.sh --workspace /path/to/your/project

Skills-Only Installation (npx, Codex, Gemini, minimal setups)

# All skills
npx skills add https://github.com/verivus-oss/sqry-skills

# Individual skills
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-semantic-search
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-claude
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-codex
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-gemini
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-grok
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-opencode
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-antigravity
npx skills add https://github.com/verivus-oss/sqry-skills --skill sqry-mistralvibe

Skills

Skill	Agent	Description
sqry-semantic-search	All	Core skill: MCP routing, CLI fallback, disambiguation, output size guidance
sqry-claude	Claude Code	Setup and MCP configuration for Claude Code
sqry-codex	OpenAI Codex	Setup and MCP configuration for Codex CLI (~/.codex/config.toml)
sqry-gemini	Gemini CLI	Setup and MCP configuration for Gemini CLI (~/.gemini/settings.json)
sqry-grok	Grok	CLI-first recovery + plugin guidance for Grok Build
sqry-opencode	OpenCode	Setup and MCP configuration for OpenCode (opencode.json)
sqry-antigravity	Antigravity	Setup and MCP configuration for Google Antigravity IDE and CLI
sqry-mistralvibe	Mistral Vibe	CLI-first usage and config.toml MCP setup for the Vibe CLI

Note: Skills now live under the skills/ subdirectory (modern layout). Both npx skills add (recursive discovery) and Grok/Claude plugin auto-discovery continue to work. The plugin layout also provides .mcp.json / .lsp.json and scripts.

Doctor & Scripts

The plugin includes two scripts in scripts/:

• install-sqry.sh — thin wrapper around the official sqry installer (--component all).
• doctor.sh — comprehensive health check:
  • Binary presence + version (sqry, sqry-mcp, sqry-lsp, sqryd)
  • Index health via sqry index --status --json
  • Graph staleness heuristics + manifest checks
  • MCP config scan across .claude.json, ~/.grok/config.toml, Codex/Gemini locations, sqry mcp status
  • Plugin context verification
  • Quick functional query test

# From project root (or specify workspace)
~/.grok/plugins/sqry/scripts/doctor.sh --workspace .

# JSON output for CI / agents
~/.grok/plugins/sqry/scripts/doctor.sh --json

# Verbose
~/.grok/plugins/sqry/scripts/doctor.sh --verbose

doctor.sh exits 0 (healthy), 1 (warnings), or 2 (critical). It is the single command to run when Grok or Claude reports "unknown plugin IDs", empty results, or transport errors.

Marketplace Path (Grok + Claude)

Grok discovers marketplace sources from:

• [[marketplace.sources]] in ~/.grok/config.toml
• ~/.grok/plugins/known_marketplaces.json
• Claude-compatible marketplace files (also read automatically)

To make sqry appear in the Grok TUI Marketplace tab without manual git clone:

1. Create (or contribute to) a small Verivus marketplace index repo.
2. Add an entry pointing to this repository as a plugin:

   {
     "name": "sqry",
     "description": "AST semantic code search plugin",
     "repository": "https://github.com/verivus-oss/sqry-skills",
     "type": "plugin"
   }

3. Users add the marketplace once; sqry then appears for one-click install.

This is the "include sqry" route that requires no xAI approval.

Two Tracks

Immediate (this plugin): Local stdio sqry-mcp / sqry-lsp via Grok Build / Claude Code plugin system. Full skills + auto-MCP + doctor today.

Later: Remote MCP (HTTPS Streaming or SSE) for Grok web/API "Custom MCP connectors". The current sqry-mcp is stdio-only; a hosted bridge or HTTP/SSE mode in sqry will be needed. The plugin remains the local experience for the CLI/TUI.

Architecture: Live MCP Resources + Reliable CLI Fallback

sqry skills use a resource delegation architecture. Tool reference, query syntax, workflow recipes, and language support are served live by the sqry-mcp binary as MCP resources, so they match the installed sqry version.

Skills contain stable, agent-facing content:

• install, index, and MCP setup instructions;
• tool naming and discovery conventions for each agent;
• CLI fallback commands for sessions where MCP is not connected;
• disambiguation tips, output size guidance, and troubleshooting.

When sqry adds tools or languages, upgrade the sqry binary and read the live MCP resources. Reinstalling skills is only needed when agent setup guidance changes.

MCP Resources

Resource	Content
sqry://meta/manifest	Version, tool count, language count, snapshot format, defaults
sqry://docs/capability-map	Task-oriented tool routing
sqry://docs/tool-guide	Complete tool reference with parameters
sqry://docs/query-syntax	Query language reference
sqry://docs/patterns	Workflow recipes
sqry://docs/architecture	Graph internals

Current sqry Notes

Public verivus-oss/sqry v20.0.5 uses:

• Rust 1.94+, Edition 2024
• 37 languages: 28 with full relation support, 9 with symbol extraction
  • 37 MCP tools
• snapshot format V7
• default MCP redaction preset: minimal
• default query timeout: 60s
• default index timeout: 600s

Install or upgrade sqry:

curl -fsSL https://raw.githubusercontent.com/verivus-oss/sqry/main/scripts/install.sh | bash -s -- --component all
sqry --version
sqry-mcp --version
sqry-lsp --version
sqryd --version

For normal setup, build the index from the project root:

sqry index .
sqry index --status --json .

After upgrading across versions that change graph semantics, force a rebuild:

sqry index --force .
sqry index --status --json .

If a stale graph reports unknown plugin IDs, remove persisted graph artifacts and rebuild:

rm -rf .sqry/graph .sqry/graphs .sqry/analysis
sqry index --force .

The MCP manifest reports the compiled language/tool surface. The CLI sqry --list-languages command may show only the default-enabled language plugins unless high-cost or optional plugins are enabled for indexing.

MCP mode: Plugin .mcp.json uses standalone sqry-mcp --no-daemon (37 tools, six resources including sqry://meta/manifest). Daemon mode (sqry-mcp --daemon) exposes only 16 tools and zero MCP resources — use it only when you do not need manifest/docs resources.

After upgrading sqry, regenerate pinned version/tool-count lines in this repo:

./scripts/sync-versions.sh

What is sqry?

sqry parses source code into ASTs and builds a graph of symbols and relationships. It answers structural questions such as callers, callees, references, unused symbols, cycles, duplicates, dependency impact, and semantic diffs from the indexed graph instead of guessing from source text.

License

MIT