Mail Time
veliovgroup/mail-time
A skill your agent uses when building, wiring, reviewing, or debugging MailTime and ostrio:mailer email queues for horizontally scaled Node.js, Bun, or Meteor apps.
Runs read-only lookups - list, describe, get - against a live YugabyteDB Anywhere control plane using the yba CLI, with mutating commands explicitly off-limits.
Install YBA Read-Only Query CLI
$ npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install yugabyte/yugabyte-db yba-query-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/yugabyte/yugabyte-db.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/yba-query-cli .claude/skills/yba-query-cli && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "yba-query-cli" agent skill from https://github.com/yugabyte/yugabyte-db/tree/master/.claude/skills/yba-query-cli into .claude/skills/yba-query-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yba-query-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/yugabyte/yugabyte-db/tree/master/.claude/skills/yba-query-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install yugabyte/yugabyte-db yba-query-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yugabyte/yugabyte-db.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/yba-query-cli .agents/skills/yba-query-cli && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "yba-query-cli" agent skill from https://github.com/yugabyte/yugabyte-db/tree/master/.claude/skills/yba-query-cli into .agents/skills/yba-query-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yba-query-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install yugabyte/yugabyte-db yba-query-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yugabyte/yugabyte-db.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/yba-query-cli .cursor/skills/yba-query-cli && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "yba-query-cli" agent skill from https://github.com/yugabyte/yugabyte-db/tree/master/.claude/skills/yba-query-cli into .cursor/skills/yba-query-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yba-query-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/yugabyte/yugabyte-db.git --path .claude/skills/yba-query-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install yugabyte/yugabyte-db yba-query-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yugabyte/yugabyte-db.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/yba-query-cli .gemini/skills/yba-query-cli && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "yba-query-cli" agent skill from https://github.com/yugabyte/yugabyte-db/tree/master/.claude/skills/yba-query-cli into .gemini/skills/yba-query-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yba-query-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install yugabyte/yugabyte-db yba-query-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/yugabyte/yugabyte-db.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/yba-query-cli .github/skills/yba-query-cli && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "yba-query-cli" agent skill from https://github.com/yugabyte/yugabyte-db/tree/master/.claude/skills/yba-query-cli into .github/skills/yba-query-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yba-query-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install yugabyte/yugabyte-db yba-query-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yugabyte/yugabyte-db.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/yba-query-cli .opencode/skills/yba-query-cli && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "yba-query-cli" agent skill from https://github.com/yugabyte/yugabyte-db/tree/master/.claude/skills/yba-query-cli into .opencode/skills/yba-query-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yba-query-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
yba-query-cli- GitHub stars
- 11k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 508 words
- Files
- 2
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Runs read-only lookups - list, describe, get - against a live YugabyteDB Anywhere control plane using the yba CLI, with mutating commands explicitly off-limits.
- Works in 3 steps: Get the yba binary → Point it at the right host + credentials → Run the query
- Checking what universes or tasks exist on a live YBA instance
- SKILL.md covers Step 1: Get the yba binary, Step 2: Point it at the right…, Step 3: Run the query and Notes
- Calls go
What it does
This skill is scoped strictly to read-only questions about a running YugabyteDB Anywhere instance - what universes exist, whether a task is running on a specific universe, what a provider's configuration looks like - never to changing anything. Its guardrail is explicit: only list, describe, get, the read-only tree command, and help are allowed; create, edit, delete, pause, resume, restart, upgrade, abort, retry and similar mutating verbs are treated as a separate, explicit request the user must make directly with its own confirmation.
It first checks whether the yba binary is already on the path and, if not, builds it from source with a plain Go build rather than running the full release pipeline, since that's enough for querying. Connecting needs a host and an API token, resolved in order from command-line flags, then environment variables, then a saved config file.
If a working config already exists it reuses it rather than re-authenticating, and otherwise it asks the user for the host and a token generated from the product's own UI, preferring per-invocation flags or session environment variables over a persistent auth command that could silently overwrite a config for a different YBA instance. It also explicitly avoids a password-based login flow for this read-only use case, since that command leaks the password into shell history and process listings and persists it to the config file - an API token is the right credential here instead.
When your agent uses it
- Checking what universes or tasks exist on a live YBA instance
- Looking up a provider's or alert's current configuration in YBA
- Inspecting YBA state without risking any mutating change
Example prompts
- “What universes exist on this YBA instance right now?”
- “Is there a task currently running on universe prod-east?”
- “Describe this provider's storage configuration in YBA.”
Requirements
- The yba CLI (built from managed/yba-cli or on PATH)
- A YBA host and API token
Workflow steps
3 steps, taken from the step headings in SKILL.md.
- Get the yba binary
- Point it at the right host + credentials
- Run the query
What it can do on your machine
Read from SKILL.md and the folder at commit cdf582d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
go
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
YBA Read-Only Query CLI loads about 1.1k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 508 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 508 words (~1,094 tokens).
“This skill is for read-only lookups against a live YugabyteDB Anywhere instance via the yba CLI, whose source lives at managed/yba-cli in this repo. It answers questions like "what universes exist on this YBA?", "is there a task running on…”
- name
- yba-query-cli
Files
SKILL.md and 1 other file in .claude/skills/yba-query-cli of yugabyte/yugabyte-db.
- SKILL.md
- reference.md
Open the folder on GitHubat commit cdf582d
Compare with similar skills
YBA Read-Only Query CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| YBA Read-Only Query CLI this skillyugabyte/yugabyte-db | 11k | — | ~1.1k | Automated safety check: Pass | Custom licence | |
| Mail Timeveliovgroup/mail-time | 143 | — | ~1k | Automated safety check: Pass | BSD-3-Clause | |
| DB Ops SopOpenDCAI/DataMind | 406 | — | ~388 | Automated safety check: Pass | Apache-2.0 | |
| Database Backupssickn33/agentic-awesome-skills | 47k | 2 repos | ~3.1k | Automated safety check: Notes | MIT | |
| Postgresql Devsecsickn33/agentic-awesome-skills | 47k | 2 repos | ~2.5k | Automated safety check: Notes | MIT | |
| Alloydb Basicsgoogle/skills | 21k | — | ~1.7k | Automated safety check: Pass | Apache-2.0 |
Similar skills
DB Ops Sop
OpenDCAI/DataMind
Database operations runbook — backup, recovery, performance tuning, troubleshooting.
Database Backups
sickn33/agentic-awesome-skills
Implement database backup strategies. An agent skill from sickn33/agentic-awesome-skills.
Postgresql Devsec
sickn33/agentic-awesome-skills
Administer PostgreSQL databases. An agent skill from sickn33/agentic-awesome-skills.
- Official
Alloydb Basics
google/skills
Manages clusters, instances, and backups for AlloyDB for PostgreSQL, and integrates with AlloyDB Model Context Protocol (MCP) tools for automated database operations.
Ue Mover
quodsoler/unreal-engine-skills
A skill your agent uses when writing or debugging movement built on the Mover plugin: custom movement modes, layered moves, movement modifiers, instant effects, mode transitions, input production…
More from yugabyte/yugabyte-db
YugabyteDB ASH Instrumentation
yugabyte/yugabyte-db
Procedure for adding or changing YugabyteDB Active Session History wait states in TServer and DocDB C++ code, including the macro to use for sync and async paths.
YugabyteDB Phorge Diff Creator
yugabyte/yugabyte-db
Creates a Phorge code review diff for the current branch with arc diff, while applying public-repo confidentiality rules since Phorge content later lands verbatim on the public GitHub repo.
YugabyteDB Issue Creator
yugabyte/yugabyte-db
Creates a GitHub issue or JIRA ticket for a YugabyteDB change or bug, after scrubbing customer data, secrets and unreleased details from anything public.
YugabyteDB Backport Review
yugabyte/yugabyte-db
Checks a YugabyteDB backport revision on Phorge against the original diff it was ported from and flags differences, tracing unexplained code back to master.
Create Fork Pull Request
yugabyte/yugabyte-db
Pushes the current branch to your fork and opens a cross-repository GitHub pull request, with a strict check against leaking customer data into public text.
cargo-pgrx Commands and Tests
yugabyte/yugabyte-db
Helps choose and run cargo-pgrx commands and decide whether a Rust test is a plain test or a pg_test, so code never crosses the Postgres boundary the wrong way.
Related
Categories
Questions about YBA Read-Only Query CLI
What does YBA Read-Only Query CLI do?
Runs read-only lookups - list, describe, get - against a live YugabyteDB Anywhere control plane using the yba CLI, with mutating commands explicitly off-limits. This skill is scoped strictly to read-only questions about a running YugabyteDB Anywhere instance - what universes exist, whether a task is running on a specific universe, what a provider's configuration looks like - never to changing anything. Its guardrail is explicit: only list, describe, get, the read-only tree command, and help are allowed; create, edit, delete, pause, resume, restart, upgrade, abort, retry and similar mutating verbs are treated as a separate, explicit request the user must make directly with its own confirmation.
When should I use YBA Read-Only Query CLI?
YBA Read-Only Query CLI fits situations like: checking what universes or tasks exist on a live YBA instance; looking up a provider's or alert's current configuration in YBA; inspecting YBA state without risking any mutating change.
How do I install YBA Read-Only Query CLI in Claude Code?
Run `npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a claude-code`. Or copy the skill folder (.claude/skills/yba-query-cli in yugabyte/yugabyte-db) into .claude/skills/yba-query-cli in your project. Claude Code loads it when a task matches its description.
How do I install YBA Read-Only Query CLI in Codex?
Run `npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a codex`. Or copy the skill folder (.claude/skills/yba-query-cli in yugabyte/yugabyte-db) into .agents/skills/yba-query-cli in your project. Codex loads it when a task matches its description.
Can I use YBA Read-Only Query CLI in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yugabyte/yugabyte-db --skill yba-query-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yba-query-cli, .gemini/skills/yba-query-cli, .github/skills/yba-query-cli and .opencode/skills/yba-query-cli in your project.
What does YBA Read-Only Query CLI need to run?
Going by SKILL.md and its folder, YBA Read-Only Query CLI needs the command-line tools its instructions call (go). Our summary lists: The yba CLI (built from managed/yba-cli or on PATH); A YBA host and API token.
Does YBA Read-Only Query CLI access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is YBA Read-Only Query CLI safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does YBA Read-Only Query CLI use?
YBA Read-Only Query CLI has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does YBA Read-Only Query CLI use?
About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to YBA Read-Only Query CLI?
Skills that share tags, products or a category with YBA Read-Only Query CLI: Mail Time (veliovgroup/mail-time, 143 stars), DB Ops Sop (OpenDCAI/DataMind, 406 stars), Database Backups (sickn33/agentic-awesome-skills, 47k stars) and Postgresql Devsec (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains YBA Read-Only Query CLI?
yugabyte (a GitHub organization) maintains it in yugabyte/yugabyte-db, which has 10,580 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.
Source: yugabyte/yugabyte-db on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.