Agent skill

Investigate

by greenfield-inc in greenfield-inc/Pane

Investigate a bug or broken behavior through hypothesis-driven root cause analysis and report what is wrong without jumping straight to a fix.

Custom licenceAuto-check passedDevelopment

Install Investigate

skills CLI
$ npx skills add greenfield-inc/Pane --skill investigate -a claude-code

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

GitHub CLI
$ gh skill install greenfield-inc/Pane investigate --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/greenfield-inc/Pane.git skills-src && mkdir -p .claude/skills && cp -r skills-src/main/src/services/paneChatBundle/skills/investigate .claude/skills/investigate && 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
investigate
GitHub stars
527
Token cost
~297 tokens
SKILL.md length
141 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
Custom licence

At a glance

Investigate a bug or broken behavior through hypothesis-driven root cause analysis and report what is wrong without jumping straight to a fix.

  • Works in 7 steps: Clarify expected behavior, observed… → Classify the bug type early: compile,… → Write 3-5 ranked hypotheses before… → …
  • Something is failing
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Behaving unexpectedly

What it does

Investigate is an agent skill from greenfield-inc/Pane. Investigate a bug or broken behavior through hypothesis-driven root cause analysis and report what is wrong without jumping straight to a fix. Use when something is failing or behaving unexpectedly.

Its SKILL.md is about 300 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 Root cause analysis. The repository describes itself as: Terminal-first, open-source AI agent manager for any CLI agent (agent agnostic), any OS (mac, windows, linux). The Open-Source Agentic Development Environment for running…

When your agent uses it

  • Something is failing
  • Behaving unexpectedly

Example prompts

  • “/investigate”

Workflow steps

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

  1. Clarify expected behavior, observed behavior, and reproduction steps if missing.
  2. Classify the bug type early: compile, logic, race, state, integration, environment, or UI.
  3. Write 3-5 ranked hypotheses before reading deeply.
  4. Test those hypotheses by tracing the relevant code and recent history.
  5. Compare broken and working paths when possible.
  6. If the cause is still unclear, propose targeted logging and explain exactly why.
  7. Report the root cause, confidence level, affected files, likely introduction point, and what needs to change.

What it can do on your machine

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

Investigate loads about 297 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 141 words of instructions outside code blocks.

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

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 141 words (~297 tokens).

“Find the root cause before proposing a fix.”

— opening of SKILL.md by greenfield-inc, Custom licence
name
investigate

Read the full SKILL.md on GitHub

Files

Just SKILL.md in main/src/services/paneChatBundle/skills/investigate of greenfield-inc/Pane.

Open the folder on GitHubat commit 0c471a3

Compare with similar skills

Investigate 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.

Investigate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Investigate this skillgreenfield-inc/Pane527—~297Automated safety check: PassCustom licence
OpenLogi macOS Permissions TriageAprilNEA/OpenLogi23k—~2.5kAutomated safety check: NotesApache-2.0
Bug Finder for daisyUIsaadeghi/daisyui43k—~2.3kAutomated safety check: PassMIT
Root Cause Debugginggarrytan/gstack136k—~1.4kAutomated safety check: PassMIT
Review PRapache/shardingsphere21k—~6.5kAutomated safety check: PassApache-2.0
Graph-Based Bug Tracingtirth8205/code-review-graph32k1 repos~287Automated safety check: PassMIT

Similar skills

  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check: notes
  • Bug Finder for daisyUI

    saadeghi/daisyui

    Investigates suspected bugs in the daisyUI monorepo through read-only analysis, then writes a decision-ready fix plan in tmp/bugs without changing any product code.

    43k GitHub stars~2.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Root Cause Debugging

    garrytan/gstack

    Investigates bugs, errors and stack traces in phases and requires a root-cause hypothesis to be confirmed before any fix is written.

    136k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Review PR

    apache/shardingsphere

    Review Apache ShardingSphere or user-authorized downstream pull requests and PR discussions from public or authorized repository evidence.

    21k GitHub stars~6.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Graph-Based Bug Tracing

    tirth8205/code-review-graph

    Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.

    32k GitHub starsUsed in 1 repo~287 tokens
    DevelopmentAuto-check passed
  • Om Auto Fix Issue

    go-musicfox/go-musicfox

    Fix or implement a tracker issue end to end from a single command — takes an issue id or a plain problem description (filed first via om-prepare-issue), classifies, then drives the bug autofix chain…

    2.6k GitHub starsUsed in 1 repo~5k tokens
    DevelopmentAuto-check: notes

More from greenfield-inc/Pane

All 35 skills in this repo
  • Page

    greenfield-inc/Pane

    House standard for any HTML page written for a person. An agent skill from greenfield-inc/Pane.

    529 GitHub stars~759 tokensUpdated today
    Auto-check passed
  • Session Trace

    greenfield-inc/Pane

    Publish an agent session as a readable trace page in Grain, with the story, key moments, every request and step on a timeline, subagents, and the pull requests it opened.

    529 GitHub stars~836 tokensUpdated today
    Auto-check passed
  • Discussion

    greenfield-inc/Pane

    Have an interactive discussion about a topic, approach, feature, or bug without making code changes.

    529 GitHub stars~666 tokensUpdated today
    Auto-check passed
  • Excalidraw PR Diagrams

    greenfield-inc/Pane

    Create Excalidraw diagram JSON files and PR visual overviews that make visual arguments.

    529 GitHub stars~9.4k tokensUpdated today
    Auto-check passed
  • HTML Explainer

    greenfield-inc/Pane

    The house standard for any skill that renders an HTML page for a person to read, covering design tokens, typography, components, diagrams, and quality gates so every generated page shares one calm…

    529 GitHub stars~1.6k tokensUpdated today
    Auto-check: notes
  • Pane Work

    greenfield-inc/Pane

    Answer questions about the user's own work in Pane, read-only.

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

Categories

Questions about Investigate

What does Investigate do?

Investigate a bug or broken behavior through hypothesis-driven root cause analysis and report what is wrong without jumping straight to a fix. Investigate is an agent skill from greenfield-inc/Pane. Investigate a bug or broken behavior through hypothesis-driven root cause analysis and report what is wrong without jumping straight to a fix.

When should I use Investigate?

Investigate fits situations like: something is failing; behaving unexpectedly.

How do I install Investigate in Claude Code?

Run `npx skills add greenfield-inc/Pane --skill investigate -a claude-code`. Or copy the skill folder (main/src/services/paneChatBundle/skills/investigate in greenfield-inc/Pane) into .claude/skills/investigate in your project. Claude Code loads it when a task matches its description.

How do I install Investigate in Codex?

Run `npx skills add greenfield-inc/Pane --skill investigate -a codex`. Or copy the skill folder (main/src/services/paneChatBundle/skills/investigate in greenfield-inc/Pane) into .agents/skills/investigate in your project. Codex loads it when a task matches its description.

Can I use Investigate 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 greenfield-inc/Pane --skill investigate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/investigate, .gemini/skills/investigate, .github/skills/investigate and .opencode/skills/investigate in your project.

What does Investigate need to run?

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

Does Investigate 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 Investigate 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 Investigate use?

Investigate 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 Investigate use?

About 297 tokens (SKILL.md is roughly 1.2k 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 Investigate?

Skills that share tags, products or a category with Investigate: OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), Bug Finder for daisyUI (saadeghi/daisyui, 43k stars), Root Cause Debugging (garrytan/gstack, 136k stars) and Review PR (apache/shardingsphere, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Investigate?

greenfield-inc (a GitHub organization) maintains it in greenfield-inc/Pane, which has 527 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 10, 2026.

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