# qveris

qveris finds external APIs from a capability description and runs the selected tool through QVeris. Use it for weather, search, finance, and data requests.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 484 installs · ★ 3
- Author: hqman
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hqman/qveris/tree/HEAD/SKILL.md
- Updated: 2026-01-31
- HTML: https://affpapa.org/en/nevibecode/skills/qveris

## What it does

qveris looks up an external tool by what it can do, then calls that tool with supplied arguments. The skill uses `scripts/qveris_tool.py`: `search` finds candidates, while `execute` runs one with its `tool_id` and the related `search-id`.

Set `QVERIS_API_KEY` before using it. Without that variable, QVeris cannot make the API request. Search results can be compared through `success_rate` and `avg_execution_time`; JSON arguments go through `--params`, and `--max-size` controls the response limit.

The skill supports Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Its listed use cases include weather, stock prices and history, web search, news, currency exchange, geolocation, and translation.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hqman/qveris --skill qveris -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/qveris/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/qveris/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hqman/qveris --skill qveris -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/qveris/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hqman/qveris --skill qveris -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/qveris/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hqman/qveris qveris
```

2. **Manually: put the files in place**
- File: `.github/skills/qveris/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hqman/qveris --skill qveris -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hqman/qveris
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/qveris/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add hqman/qveris --skill qveris -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hqman/qveris/tree/HEAD/SKILL.md

## When to use it
- find an API by capability
- retrieve current weather for a location
- check a stock or cryptocurrency price
- run an external tool with JSON arguments
- pull data from search or finance APIs

## Example prompts
- Find a tool for current weather and run it for Berlin.
- Choose an API for Tesla financial analysis and execute it.
- Find a currency-rate tool and return the result as JSON.

## Similar
- [replica-architect](https://affpapa.org/en/nevibecode/skills/replica-architect.md) — skill · 618 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs
- [convex-docs](https://affpapa.org/en/nevibecode/skills/convex-docs.md) — skill · 36400 installs
- [microservices-patterns](https://affpapa.org/en/nevibecode/skills/microservices-patterns.md) — skill · 13176 installs
- [reddit-search-api](https://affpapa.org/en/nevibecode/skills/reddit-search-api.md) — skill · 10600 installs
- [backend-patterns](https://affpapa.org/en/nevibecode/skills/backend-patterns.md) — skill · 6000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md