btrace: Skill for Claude Code

.agents/skills/qe-explore/SKILL.md

qe-explore is a skill for Claude Code, Codex from btraceio/btrace. It costs 66 tokens per session (1,291 once invoked), scanned A, original, Apache-2.0.

A quality-testing workflow for finding new misuse cases and specification gaps in BTrace, a Java tracing tool. It turns checked ideas into YAML test cases for review.

In plain words
What is it for?
It is for reading BTrace code and documentation, inventing test cases, checking them against real Java runtimes, and preparing novel cases for the corpus.
Why use it?
It helps expand a repeatable abuse test collection without duplicating cases or accepting findings that lack evidence.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Claude Code; installed under .agents/ (shared by several agents).

This is btraceio/btrace's own configuration. It tells Claude Code and Codex how to work on btrace itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything btrace configures →

About the project

BTrace is a Java diagnostic tool that dynamically inserts tracing into running Java applications without restarting or recompiling them. Java developers and operations teams use it to inspect methods, timings, fields, allocations, and other runtime behavior in production environments. Catalogue add-ons provide instructions for using BTrace.

btraceio/btrace · 5,997 stars · on GitHub

Reuse

Borrowing it

Nothing to install: this file belongs to btraceio/btrace. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/btraceio/btrace/develop/.agents/skills/qe-explore/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/btraceio/btrace

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for qe-explore

README.md
[![agentmods](https://agentmods.dev/badge/skills/btraceio/btrace/qe-explore/github.svg)](https://agentmods.dev/skills/btraceio/btrace/qe-explore)
Your own site
<a href="https://agentmods.dev/skills/btraceio/btrace/qe-explore"><img src="https://agentmods.dev/badge/skills/btraceio/btrace/qe-explore/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for qe-explore

Your own site · 80×15
<a href="https://agentmods.dev/skills/btraceio/btrace/qe-explore"><img src="https://agentmods.dev/badge/skills/btraceio/btrace/qe-explore.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 66 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,291 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00066 $0.01291
Opus 5.5 $0.00026 $0.00516
Sonnet 5.5 $0.00013 $0.00258
Haiku 4.5 $0.00007 $0.00129

Measured 3d ago against content hash 3ea4050aacf5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

qe-explore scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/qe-explore/SKILL.md · 67 lines

How it starts

The opening of the file, as written. The whole thing — 67 lines — stays where its author put it; the contents beside it link to each section on GitHub.

QE Explore

Overview

btrace-qe is deterministic: it only runs committed YAML cases. This skill is where new ideas come from. You read code and docs, invent abuse cases, prove each one against real JVMs, and hand over a batch for human review. A case is worth committing only if it is grounded, novel, portable, and its verdict was checked against its own evidence.

Arguments: [surface] [count] — /qe-explore cli 2 in Claude Code, /skill:qe-explore cli 2 in Pi. Default: next surface in rotation (see log), 3 cases kept.

Workflow

  1. Inventory. Read btrace-qe/EXPLORATION.md (ideas already tried, rejected, blocked, leads), list btrace-qe/cases/**, and read the schema + pitfalls in reference.md (this directory).
  2. Pick a surface. Use the argument, or the least-covered surface in the log. Spread the batch over at least two mutation lenses (reference.md). Don't re-use an idea already in the corpus or the log under a new id.
  3. Ground each idea before writing YAML. Record one of:
    • code: the file:line where BTrace uses the value (parses it, branches on it, opens it). A key constant in Args.java names the option; it is not grounding. If you can't find the use site, the input may never reach code — find it or drop the idea. Copy option names from btrace-core/src/main/java/io/btrace/core/Args.java or the client's Main arg loop; never type one from memory.
    • doc: a verbatim claim from docs/*.md, for a conformance case.
  4. Decide the expectation from the grounding, not from intuition.
    • Input invalid per code/docs → messageMustMention = what the user must fix: the option or flag they typed, plus the offending value when it's distinctive (e.g. ["port", "70000"]). Tokens come from the user's input, decided before you run the case — never from BTrace's current output. If BTrace's message would miss your tokens, that miss is the finding; keep the tokens.
    • Input valid-but-odd, or you can't tell → no messageMustMention (resilience only). A guessed token creates a false S4.
    • Documented behavior → intent: conformance, spec.doc + verbatim spec.claim, exitCode if the doc implies one.
  5. Write the case using only schema keys and step verbs from reference.md. Inputs must be portable: paths under ${runDir} or ${probeClassesDir}, never host paths like /etc/hosts.
  6. Run each case alone: GRADLE_USER_HOME=$(pwd)/.gradle-user ./gradlew :btrace-qe:qe -Pqe.case=<id> > <log> 2>&1. Read btrace-qe/build/qe-report/runs/<id>/steps.log and stderr.log — not just the report summary.
  7. Classify the outcome and act:

Read the full file on GitHub · 67 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 67 lines · 66 tokens per session scan A 3ea4050aacf5

Subscribe to this mod's changes

qe-explore is a skill published in the GitHub repository btraceio/btrace (5,997 stars, last pushed yesterday), licensed Apache-2.0. It adds 66 tokens to every session and 1,291 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-26.

Related

Other skills, from other repositories

java-affected-tests

Use before opening or updating an OpenMetadata PR that changes Java, a JSON schema, an index mapping, a SQL migration, seed data or a pom — PR CI no longer runs the Java integration tests (they run only in the merge queue) and the JavaUIIT/search-it suites run only nightly, so this selects the unit tests and…

open-metadata/OpenMetadata · 120 tokens

oss-fuzz

Run Tika's OSS-Fuzz Jazzer targets locally against a working-tree checkout — build the image, build fuzzers from local source, fuzz a target, run a corpus as a regression pass, reproduce a crash, and add seeds. Use for "fuzz the OneNote parser", "run OneNoteParserFuzzer against these files", "reproduce an OSS-Fuzz…

apache/tika · 90 tokens

tika-eval-compare

Compare extracts from two Tika builds over a corpus to detect regressions in content, encoding, exceptions, and embedded-document handling. Use for "compare before/after extracts", "eval this change against the corpus".

apache/tika · 50 tokens

cosmos-run-integration-tests

Run azure-cosmos integration/customer-workflow tests locally, closely following the CI pipeline (build+install, then failsafe verify with a test profile) using one consistent JDK for both steps. USE WHEN: asked to run cosmos integration tests, customer-workflow tests (fi-customer-workflows / fi-sm-customer-workflows)…

Azure/azure-sdk-for-java · 142 tokens

run-tests

Run project tests using Maven (mvn). Use when the user asks to run tests.

Azure/azure-sdk-for-java · 21 tokens

test-proxy

Push test-proxy recordings/assets using the test-proxy CLI (e.g., test-proxy push -a assets.json). Use when publishing recordings.

Azure/azure-sdk-for-java · 34 tokens