Agent skill

Query Logs

by voidhashcom in voidhashcom/lensflare

Translate a natural-language question about logs or telemetry into a Lensflare query and return the results.

MITAuto-check passed

Install Query Logs

skills CLI
$ npx skills add voidhashcom/lensflare --skill query-logs -a claude-code

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

GitHub CLI
$ gh skill install voidhashcom/lensflare query-logs --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/voidhashcom/lensflare.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/lensflare-desktop/skills/query-logs .claude/skills/query-logs && 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
query-logs
GitHub stars
100
Token cost
~366 tokens
SKILL.md length
163 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Translate a natural-language question about logs or telemetry into a Lensflare query and return the results.

  • Works in 5 steps: Identify the dataset. Use… → Translate the user's prose into a single… → Call lensflare:queryTelemetry with… → …
  • The user asks find logs that…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Describes a filter in prose that should map to a structured query

What it does

Query Logs is an agent skill from voidhashcom/lensflare. Translate a natural-language question about logs or telemetry into a Lensflare query and return the results. Use when the user asks "find logs that…", "show me…", or describes a filter in prose that should map to a structured query.

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

The licence is MIT.

When your agent uses it

  • The user asks find logs that…
  • Describes a filter in prose that should map to a structured query

Example prompts

  • “find logs that…”
  • “show me…”
  • “/query-logs”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify the dataset. Use lensflare:listDatasets if needed.
  2. Translate the user's prose into a single query string. Prefer structured comparisons over free-text — fewer false positives, easier to…
  3. Call lensflare:queryTelemetry with limit: 50 (or as requested). Use cursor from usage.nextPageCursor if the user asks for more.
  4. Summarise the page: counts, time range covered, dominant serviceName / level. Show a few example records inline (id, level, message or…
  5. Offer a refined query if the result set is too broad or too narrow.

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Query Logs loads about 366 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 163 words of instructions outside code blocks.

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

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

The full file from voidhashcom/lensflare at commit 77af210, republished under its MIT licence (© voidhashcom). 163 words, ~366 tokens.

Download SKILL.mdSave it as .claude/skills/query-logs/SKILL.md (or your agent's skills folder).
name
query-logs
description
Translate a natural-language question about logs or telemetry into a Lensflare query and return the results. Use when the user asks "find logs that…", "show me…", or describes a filter in prose that should map to a structured query.

Query Lensflare telemetry

You have access to a structured query language exposed via lensflare:queryTelemetry. The full grammar is in that tool's description — read it. Examples:

  • "errors from the api service" → serviceName = "api" and (level in ["error", "fatal"] or status = "error")
  • "slow requests" → durationUs >= 1000000
  • "anything that mentions ECONNRESET" → message ~= /ECONNRESET/
  • "logs with http status 500" → attributes.http.status_code = 500

Steps:

  1. Identify the dataset. Use lensflare:listDatasets if needed.
  2. Translate the user's prose into a single query string. Prefer structured comparisons over free-text — fewer false positives, easier to refine.
  3. Call lensflare:queryTelemetry with limit: 50 (or as requested). Use cursor from usage.nextPageCursor if the user asks for more.
  4. Summarise the page: counts, time range covered, dominant serviceName / level. Show a few example records inline (id, level, message or name, timestamp).
  5. Offer a refined query if the result set is too broad or too narrow.

Never invent fields — call queryTelemetry with no query first if you're unsure; the records show you the available shape.

© voidhashcom, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/lensflare-desktop/skills/query-logs of voidhashcom/lensflare.

Open the folder on GitHubat commit 77af210

Compare with similar skills

Query Logs 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.

Query Logs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Query Logs this skillvoidhashcom/lensflare100—~366Automated safety check: PassMIT
Translation Diff TranslateDevolutions/UniGetUI26k—~934Automated safety check: PassMIT
Plane UI Translationmakeplane/plane61k—~16kAutomated safety check: PassAGPL-3.0
Visa Doc Translateaffaan-m/ECC275k4 repos~1kAutomated safety check: PassMIT
Translatorholaboss-ai/holaOS11k—~617Automated safety check: PassCustom licence
Generate Translationspayloadcms/payload45k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Translation Diff Translate

    Devolutions/UniGetUI

    Translates a sparse UniGetUI JSON language patch, writes completed entries into the working copy, preserves placeholders and terminology, and prepares the patch for merge-back.

    26k GitHub stars~934 tokensUpdated today
    Writing & ContentAuto-check passed
  • Plane UI Translation

    makeplane/plane

    Sets the rules for translating and updating Plane's UI strings across locales: do-not-translate terms, plural forms, placeholders and AI translation review.

    61k GitHub stars~16k tokensUpdated today
    Writing & ContentAuto-check passed
  • Visa Doc Translate

    affaan-m/ECC

    Translate visa document images (bank deposit, employment, income, and retirement certificates; HEIC, PNG, or JPG) into English via OCR and produce a bilingual PDF pairing the original image with a…

    275k GitHub starsUsed in 4 repos~1k tokens
    Writing & ContentAuto-check passed
  • Translator

    holaboss-ai/holaOS

    Translate content across languages while preserving brand voice and cultural nuance.

    11k GitHub stars~617 tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Generate Translations

    payloadcms/payload

    A skill your agent uses when new translation keys are added to packages to generate new translations strings

    45k GitHub stars~1.1k tokensUpdated today
    Writing & ContentAuto-check passed
  • Translation

    doxygen/doxygen

    Keeps all Doxygen and Doxywizard translations up to date across three mechanisms: translator C++ classes (src/translatorxx.h), Qt .ts locale files for the Doxywizard GUI (addon/doxywizard/i18n/)…

    6.6k GitHub stars~5.2k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed

More from voidhashcom/lensflare

  • Analyze Trace

    voidhashcom/lensflare

    Walk a Lensflare trace span-by-span and explain timing, errors, and parent/child structure.

    100 GitHub stars~340 tokensUpdated 3 mo ago
    Auto-check passed
  • Find Error

    voidhashcom/lensflare

    Find recent errors in a Lensflare dataset and summarise their root cause.

    100 GitHub stars~355 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Query Logs

What does Query Logs do?

Translate a natural-language question about logs or telemetry into a Lensflare query and return the results. Query Logs is an agent skill from voidhashcom/lensflare. Translate a natural-language question about logs or telemetry into a Lensflare query and return the results.

When should I use Query Logs?

Query Logs fits situations like: the user asks find logs that…; describes a filter in prose that should map to a structured query.

How do I install Query Logs in Claude Code?

Run `npx skills add voidhashcom/lensflare --skill query-logs -a claude-code`. Or copy the skill folder (plugins/lensflare-desktop/skills/query-logs in voidhashcom/lensflare) into .claude/skills/query-logs in your project. Claude Code loads it when a task matches its description.

How do I install Query Logs in Codex?

Run `npx skills add voidhashcom/lensflare --skill query-logs -a codex`. Or copy the skill folder (plugins/lensflare-desktop/skills/query-logs in voidhashcom/lensflare) into .agents/skills/query-logs in your project. Codex loads it when a task matches its description.

Can I use Query Logs 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 voidhashcom/lensflare --skill query-logs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/query-logs, .gemini/skills/query-logs, .github/skills/query-logs and .opencode/skills/query-logs in your project.

What does Query Logs need to run?

SKILL.md names no scripts, command-line tools or credentials: Query Logs is instructions for the agent only.

Does Query Logs 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 Query Logs 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 Query Logs use?

Query Logs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Query Logs use?

About 366 tokens (SKILL.md is roughly 1.5k 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 Query Logs?

Skills that share tags, products or a category with Query Logs: Translation Diff Translate (Devolutions/UniGetUI, 26k stars), Plane UI Translation (makeplane/plane, 61k stars), Visa Doc Translate (affaan-m/ECC, 275k stars) and Translator (holaboss-ai/holaOS, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Query Logs?

voidhashcom (a GitHub organization) maintains it in voidhashcom/lensflare, which has 100 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on June 25, 2026.

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