New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Bug Hunter

by octanejs in octanejs/octane

Find and fix a bug in the octane monorepo. An agent skill from octanejs/octane.

MITAuto-check passedDevelopment

Install Bug Hunter

skills CLI
$ npx skills add octanejs/octane --skill bug-hunter -a claude-code

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

GitHub CLI
$ gh skill install octanejs/octane bug-hunter --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/octanejs/octane.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/bug-hunter .claude/skills/bug-hunter && 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
bug-hunter
GitHub stars
1.5k
Token cost
~707 tokens
SKILL.md length
298 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Find and fix a bug in the octane monorepo. An agent skill from octanejs/octane.

  • Works in 7 steps: State the suspected behavior → Reproduce before fixing → Minimize → …
  • Given a failing test
  • SKILL.md covers Read first, Workflow and Common traps
  • Calls pnpm

What it does

Bug Hunter is an agent skill from octanejs/octane. Find and fix a bug in the octane monorepo. Use when given a failing test, a regression, or a report that behavior differs from expectation, including deciding whether a React mismatch is an intentional divergence.

Its SKILL.md is about 710 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 Development, covering Failing and flaky tests and Monorepo tooling. It works with React. The repository describes itself as: React’s programming model, compiled. The successor to Inferno. The licence is MIT.

When your agent uses it

  • Given a failing test
  • A report that behavior differs from expectation
  • Including deciding whether a React mismatch is an intentional divergence

Example prompts

  • “/bug-hunter”

Workflow steps

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

  1. State the suspected behavior
  2. Reproduce before fixing
  3. Minimize
  4. Localize
  5. Patch carefully
  6. Validate
  7. Report

What it can do on your machine

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

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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

Bug Hunter loads about 707 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 298 words of instructions outside code blocks.

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

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 octanejs/octane at commit 961638e, republished under its MIT licence (© octanejs). 298 words, ~707 tokens.

Download SKILL.mdSave it as .claude/skills/bug-hunter/SKILL.md (or your agent's skills folder).
name
bug-hunter
description
Find and fix a bug in the octane monorepo. Use when given a failing test, a regression, or a report that behavior differs from expectation, including deciding whether a React mismatch is an intentional divergence.

Skill: Octane bug hunter

Use this to find, reproduce, minimize, and fix a suspected Octane bug.

Read first

  • AGENTS.md
  • Owning source and nearby tests
  • docs/differences-from-react.md before assuming React mismatch is a bug

Workflow

  1. State the suspected behavior

    • Expected behavior, actual behavior, package, environment, and reproduction path.
    • Decide whether the issue concerns runtime, compiler, SSR/hydration, Vite plugin, or an ecosystem binding.

  2. Reproduce before fixing

    • Add or locate the smallest failing test/fixture.
    • For compiler/runtime behavior, prefer packages/octane/tests/_fixtures/*.tsrx plus a focused *.test.ts.
    • For React parity, cite source React tests and use conformance/differential conventions.
    • For ecosystem packages, use that package's tests/ harness.

  3. Minimize

    • Remove unrelated props, effects, timing, and DOM.
    • Keep .tsrx fixtures tiny.
    • Confirm the test fails for the intended reason, not setup/aliasing/jsdom.

  4. Localize

    • Runtime: inspect packages/octane/src/runtime.ts comments and closest tests.
    • Compiler: inspect packages/octane/src/compiler/compile.js and emitted output if needed.
    • SSR: inspect runtime.server.ts, server/index.ts, hydration tests.
    • Bindings: compare existing package patterns and upstream React binding behavior.

  5. Patch carefully

    • Preserve documented intentional divergences.
    • Prefer fixing owning source over weakening tests.
    • Add regression coverage that would fail on the old behavior.
    • Keep changes minimal and idiomatic.

  6. Validate

    • Run the new failing test until it passes.
    • Run nearby affected tests.
    • If runtime/compiler changed, consider wider packages/octane/tests or pnpm test depending on scope.
    • Run pnpm typecheck when TS/API surfaces changed.

  7. Report

    • Root cause.
    • Files changed.
    • Tests added/updated and commands run.
    • Any remaining risks or intentional divergences.

Common traps

  • React synthetic onChange, StrictMode double invoke, and class components are not bugs by default. Controlled value/checked is supported, but text editing uses native onInput; OCTANE_NATIVE_TEXT_ONCHANGE warns about likely React-style host wiring without changing native behavior. Deliberate commit-on-blur uses suppressNativeChangeWarning.
  • Differential innerHTML cannot catch render counts, effect timing, refs, focus, or node move sets.
  • jsdom layout/focus limitations can masquerade as library bugs.

© octanejs, 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 .agents/skills/bug-hunter of octanejs/octane.

Open the folder on GitHubat commit 961638e

Compare with similar skills

Bug Hunter 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.

Bug Hunter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bug Hunter this skilloctanejs/octane1.5k—~707Automated safety check: PassMIT
Fix CIgronxb/hot-updater1.8k—~572Automated safety check: PassCustom licence
Electron Multi-Process ArchitectureiOfficeAI/AionUi33k1 repos~1.8kAutomated safety check: PassApache-2.0
Nullable New Paramsremotion-dev/remotion63k—~1kAutomated safety check: PassCustom licence
Pnpm Engineteambit/bit18k—~1.9kAutomated safety check: PassCustom licence
Test Guidelinesgetsentry/sentry-dart873—~3.1kAutomated safety check: PassMIT

Similar skills

  • Fix CI

    gronxb/hot-updater

    Run a local pnpm monorepo CI loop, fix failures, and stop only when the full sequence is green.

    1.8k GitHub stars~572 tokensUpdated today
    DevelopmentAuto-check passed

  • Electron Multi-Process Architecture

    iOfficeAI/AionUi

    Tells the agent where new code belongs in an Electron multi-process project and which APIs each process may use, with rules for new bridges, services, agents and workers.

    33k GitHub starsUsed in 1 repo~1.8k tokens
    DevelopmentAuto-check passed

  • Nullable New Params

    remotion-dev/remotion

    Official

    Fix newly added optional parameters, optional React props, and optional type/interface members in Remotion monorepo diffs by converting internal APIs to required nullable values and updating call…

    63k GitHub stars~1k tokensUpdated today
    DevelopmentAuto-check passed

  • Pnpm Engine

    teambit/bit

    Work on the pnpm Rust engine (@pnpm/napi, the pacquet crates) that bit install runs through.

    18k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed

  • Test Guidelines

    getsentry/sentry-dart

    Official

    Enforce Sentry Dart/Flutter SDK test conventions for naming, structure, and fixtures.

    873 GitHub stars~3.1k tokensUpdated yesterday
    Testing & QAAuto-check passed

  • Project Structure

    Eynzof/Hermes-CN-Desktop

    A skill your agent uses when orienting within the Hermes Agent CN Desktop codebase, locating source files, understanding the Tauri+React architecture, finding Rust commands or frontend modules, or…

    1.8k GitHub stars~4.2k tokensUpdated 18 days ago
    DevelopmentAuto-check: notes

More from octanejs/octane

All 19 skills in this repo

  • Performance Audit

    octanejs/octane

    Audit or defend Octane performance. An agent skill from octanejs/octane.

    1.5k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

  • Update Bindings

    octanejs/octane

    Audit one, several, or all existing Octane bindings; implement selected maintenance findings or remove redundant copied files with evidence matched to source ownership.

    1.5k GitHub stars~1.8k tokensUpdated today
    Auto-check passed

  • Concise Code

    octanejs/octane

    Keep a change small and in the existing idiom - size the plan and weigh smaller alternatives before writing it, reuse the mechanism that already owns the behavior instead of adding a parallel one…

    1.5k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

  • Handle Issue

    octanejs/octane

    Work a GitHub issue in the octane repo. An agent skill from octanejs/octane.

    1.5k GitHub stars~638 tokensUpdated today
    Auto-check passed

  • Migrate V8 To V9

    octanejs/octane

    Perform a complete @tanstack/react-table v8-to-v9 migration: hook and feature architecture, row-model slots, React state and subscriptions, rendering, composable tables, type helpers, and every…

    1.5k GitHub stars~4.7k tokensUpdated today
    Auto-check passed

  • Octane React Library Port

    octanejs/octane

    Implement and verify new React-library ports or copied/rewritten React surfaces in Octane bindings from npm names or npm/GitHub links/lists.

    1.5k GitHub stars~2.5k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Bug Hunter

What does Bug Hunter do?

Find and fix a bug in the octane monorepo. An agent skill from octanejs/octane. Bug Hunter is an agent skill from octanejs/octane. Find and fix a bug in the octane monorepo.

When should I use Bug Hunter?

Bug Hunter fits situations like: given a failing test; A report that behavior differs from expectation; including deciding whether a React mismatch is an intentional divergence.

How do I install Bug Hunter in Claude Code?

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

How do I install Bug Hunter in Codex?

Run `npx skills add octanejs/octane --skill bug-hunter -a codex`. Or copy the skill folder (.agents/skills/bug-hunter in octanejs/octane) into .agents/skills/bug-hunter in your project. Codex loads it when a task matches its description.

Can I use Bug Hunter 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 octanejs/octane --skill bug-hunter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bug-hunter, .gemini/skills/bug-hunter, .github/skills/bug-hunter and .opencode/skills/bug-hunter in your project.

What does Bug Hunter need to run?

Going by SKILL.md and its folder, Bug Hunter needs the command-line tools its instructions call (pnpm).

Does Bug Hunter 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 Bug Hunter 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 Bug Hunter use?

Bug Hunter 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 Bug Hunter use?

About 707 tokens (SKILL.md is roughly 2.8k 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 Bug Hunter?

Skills that share tags, products or a category with Bug Hunter: Fix CI (gronxb/hot-updater, 1.8k stars), Electron Multi-Process Architecture (iOfficeAI/AionUi, 33k stars), Nullable New Params (remotion-dev/remotion, 63k stars) and Pnpm Engine (teambit/bit, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bug Hunter?

octanejs (a GitHub organization) maintains it in octanejs/octane, which has 1,452 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 9, 2026.

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