Agent skill

Staged Discovery

by mondoohq in mondoohq/mql

Add staged discovery support to a provider. An agent skill from mondoohq/mql.

Custom licenceAuto-check passedDevOps & Cloud

Install Staged Discovery

skills CLI
$ npx skills add mondoohq/mql --skill staged-discovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mondoohq/mql staged-discovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mondoohq/mql.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/staged-discovery .claude/skills/staged-discovery && rm -rf skills-src

Use ~/.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/

Facts

Skill name
staged-discovery
GitHub stars
412
Token cost
~2.9k tokens
SKILL.md length
748 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Custom licence

At a glance

Add staged discovery support to a provider. An agent skill from mondoohq/mql.

  • Works in 8 steps: Identify the discovery entry point → Add the staged discovery router → Implement Stage 1 (root/top-level scope) → …
  • The user wants to implement staged/phased discovery
  • SKILL.md covers Prerequisites, Step-by-Step Implementation and Checklist
  • Calls make and go

What it does

Staged Discovery is an agent skill from mondoohq/mql. Add staged discovery support to a provider. Use when the user wants to implement staged/phased discovery, break down discovery into stages, add OptionStagedDiscovery support, or optimize a provider's memory usage during discovery. Triggers on requests like "add staged discovery to gcp", "implement staged discovery for aws", "break down discovery for <provider", or "optimize <provider discovery".

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud. It works with Amazon Web Services, Google Cloud, Kubernetes and Microsoft Azure. The repository describes itself as: open source, cloud-native, graph-based query language.

When your agent uses it

  • The user wants to implement staged/phased discovery
  • Break down discovery into stages
  • Add OptionStagedDiscovery support
  • Optimize a providers memory usage during discovery

Example prompts

  • “s memory usage during discovery. Triggers on requests like”
  • “implement staged discovery for aws”
  • “break down discovery for <provider”
  • “/staged-discovery”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Identify the discovery entry point
  2. Add the staged discovery router
  3. Implement Stage 1 (root/top-level scope)
  4. Implement Stage 2+ (scoped discovery)
  5. Strip platform IDs from non-targeted intermediate assets
  6. Gate resource methods at higher scopes (if needed)
  7. Verify both paths and discovery targets
  8. Update .lr.versions if new resources were added

What it can do on your machine

Read from SKILL.md and the folder at commit d9f1bd2. 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:

    • make
    • 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

Staged Discovery loads about 2.9k tokens when it runs. Until then it costs about 104 tokens; SKILL.md has 748 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~104
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k

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 748 words (~2,901 tokens).

“Implement staged (multi-phase) discovery for a provider so that AssetExplorer can traverse the provider's resource hierarchy one level at a time, releasing memory after each scope is closed.”

— opening of SKILL.md by mondoohq, Custom licence
name
staged-discovery
argument-hint
<provider-name> (e.g., aws, gcp, k8s, azure)

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/staged-discovery of mondoohq/mql.

Open the folder on GitHubat commit d9f1bd2

Compare with similar skills

Staged Discovery 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.

Staged Discovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Staged Discovery this skillmondoohq/mql412—~2.9kAutomated safety check: PassCustom licence
Kcli Cluster Deploymentkarmab/kcli653—~1.5kAutomated safety check: PassApache-2.0
Extend Discovery Typerunwhen-contrib/runwhen-local163—~1.7kAutomated safety check: PassApache-2.0
Kclikarmab/kcli653—~2.6kAutomated safety check: WarnApache-2.0
Multi Cloud ArchitectureHermeticOrmus/LibreUIUX-Claude-Code11211 repos~1.2kAutomated safety check: PassMIT
Kcli Configurationkarmab/kcli653—~1.5kAutomated safety check: WarnApache-2.0

Similar skills

  • Guides deployment and management of Kubernetes clusters with kcli.

    653 GitHub stars~1.5k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Extend Discovery Type

    runwhen-contrib/runwhen-local

    Add or enrich a resource type in an existing RunWhen Local discovery indexer (Azure azureapi, GCP gcpapi, AWS, or Kubernetes).

    163 GitHub stars~1.7k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Kcli

    karmab/kcli

    Comprehensive guide for kcli usage. An agent skill from karmab/kcli.

    653 GitHub stars~2.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: warnings
  • Multi Cloud Architecture

    HermeticOrmus/LibreUIUX-Claude-Code

    Design multi-cloud architectures using a decision framework to select and integrate services across AWS, Azure, and GCP.

    112 GitHub starsUsed in 11 repos~1.2k tokens
    DevOps & CloudAuto-check passed
  • Guides kcli configuration and provider setup. An agent skill from karmab/kcli.

    653 GitHub stars~1.5k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: warnings
  • Azure Arc

    vinayaklatthe/microsoft-security-skills

    Guidance for Azure Arc — projecting on-premises, multicloud (AWS/GCP), and edge servers, Kubernetes, and data services into Azure Resource Manager for unified governance, security, and management.

    175 GitHub stars~1.9k tokensUpdated 3 mo ago
    DevOps & CloudAuto-check passed

More from mondoohq/mql

All 9 skills in this repo
  • Deep static code review of an mql provider for logic errors, nil-handling bugs, pagination truncation, caching/id collisions, and other defects that silently give users wrong data.

    412 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Verify mql provider resource/field changes against real cloud infrastructure.

    412 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Upgrade an mql provider's vendored SDKs (all providers or a named subset), audit the new versions for breaking changes and fix call sites while keeping shipped MQL fields backwards-compatible, check…

    412 GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • New Provider

    mondoohq/mql

    Scaffold a new mql provider. An agent skill from mondoohq/mql.

    412 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • New Resource

    mondoohq/mql

    Add or change a resource in an existing mql provider — schema, codegen, implementation, tests, and verification against a real target.

    412 GitHub stars~5.6k tokensUpdated today
    Auto-check passed
  • Provider Release

    mondoohq/mql

    Release mql providers and cut mql/cnspec releases, stable or pre-release.

    412 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Staged Discovery

What does Staged Discovery do?

Add staged discovery support to a provider. An agent skill from mondoohq/mql. Staged Discovery is an agent skill from mondoohq/mql. Add staged discovery support to a provider.

When should I use Staged Discovery?

Staged Discovery fits situations like: the user wants to implement staged/phased discovery; break down discovery into stages; add OptionStagedDiscovery support; optimize a providers memory usage during discovery.

How do I install Staged Discovery in Claude Code?

Run `npx skills add mondoohq/mql --skill staged-discovery -a claude-code`. Or copy the skill folder (.agents/skills/staged-discovery in mondoohq/mql) into .claude/skills/staged-discovery in your project. Claude Code loads it when a task matches its description.

How do I install Staged Discovery in Codex?

Run `npx skills add mondoohq/mql --skill staged-discovery -a codex`. Or copy the skill folder (.agents/skills/staged-discovery in mondoohq/mql) into .agents/skills/staged-discovery in your project. Codex loads it when a task matches its description.

Can I use Staged Discovery 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 mondoohq/mql --skill staged-discovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/staged-discovery, .gemini/skills/staged-discovery, .github/skills/staged-discovery and .opencode/skills/staged-discovery in your project.

What does Staged Discovery need to run?

Going by SKILL.md and its folder, Staged Discovery needs the command-line tools its instructions call (make and go).

Does Staged Discovery 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 Staged Discovery 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 Staged Discovery use?

Staged Discovery 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 Staged Discovery use?

About 2.9k tokens (SKILL.md is roughly 12k 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 Staged Discovery?

Skills that share tags, products or a category with Staged Discovery: Kcli Cluster Deployment (karmab/kcli, 653 stars), Extend Discovery Type (runwhen-contrib/runwhen-local, 163 stars), Kcli (karmab/kcli, 653 stars) and Multi Cloud Architecture (HermeticOrmus/LibreUIUX-Claude-Code, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Staged Discovery?

mondoohq (a GitHub organization) maintains it in mondoohq/mql, which has 412 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 11, 2026.

Source: mondoohq/mql on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.