Agent skill

Investigate To Confluence

by testdouble in testdouble/han

Runs an evidence-based investigation of a bug, failure, or unexpected behavior with investigate and publishes the resulting investigation report to a user-specified Confluence location.

MITAuto-check passedAgent Workflows

Install Investigate To Confluence

skills CLI
$ npx skills add testdouble/han --skill investigate-to-confluence -a claude-code

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

GitHub CLI
$ gh skill install testdouble/han investigate-to-confluence --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/testdouble/han.git skills-src && mkdir -p .claude/skills && cp -r skills-src/han-atlassian/skills/investigate-to-confluence .claude/skills/investigate-to-confluence && 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-to-confluence
GitHub stars
281
Token cost
~2.3k tokens
SKILL.md length
1,153 words
Files
1
Skills in repo
54
Repo updated
First seen
Licence
MIT

At a glance

Runs an evidence-based investigation of a bug, failure, or unexpected behavior with investigate and publishes the resulting investigation report to a user-specified Confluence location.

  • Works in 5 steps: Validate Inputs → Produce the Investigation Report to a… → Show the File for Review → …
  • The user wants something debugged
  • SKILL.md covers Project Context, Step 1: Validate Inputs, Step 2: Produce the… and Step 3: Show the File for Review, plus 3 more sections
  • Calls bash

What it does

Investigate To Confluence is an agent skill from testdouble/han. Runs an evidence-based investigation of a bug, failure, or unexpected behavior with investigate and publishes the resulting investigation report to a user-specified Confluence location. Use when the user wants something debugged, diagnosed, or root-caused AND the findings posted to a Confluence space or page. Requires a configured Atlassian MCP server. Does not investigate to a local file only — use investigate. Does not publish an arbitrary existing markdown file — use markdown-to-confluence. Does not document…

Its SKILL.md is about 2.3k 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 Agent Workflows, covering Markdown. It works with Confluence, Model Context Protocol and Jira. The repository describes itself as: Han: AI skills and agents for "Solo" product engineers and small teams. The licence is MIT.

When your agent uses it

  • The user wants something debugged
  • Root-caused AND the findings posted to a Confluence space

Example prompts

  • “/investigate-to-confluence”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Skill, Agent, Bash(find *), mcp__claude_ai_Atlassian__getAccessibleAtlassianResources, Bash(bash "${CLAUDE_PLUGIN_ROOT}/scripts/han-config-dir.sh")

Workflow steps

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

  1. Validate Inputs
  2. Produce the Investigation Report to a Temporary File
  3. Show the File for Review
  4. Confirm the Publish Choice
  5. Publish with markdown-to-confluence

What it can do on your machine

Read from SKILL.md and the folder at commit abba73a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • Skill
    • Agent
    • Bash(find *)
    • mcp__claude_ai_Atlassian__getAccessibleAtlassianResources
    • Bash(bash "${CLAUDE_PLUGIN_ROOT}/scripts/han-config-dir.sh")

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    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 To Confluence loads about 2.3k tokens when it runs. Until then it costs about 192 tokens; SKILL.md has 1,153 words of instructions outside code blocks.

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

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 testdouble/han at commit abba73a, republished under its MIT licence (© testdouble). 1,153 words, ~2,339 tokens.

Download SKILL.mdSave it as .claude/skills/investigate-to-confluence/SKILL.md (or your agent's skills folder).
name
investigate-to-confluence
description
Runs an evidence-based investigation of a bug, failure, or unexpected behavior with investigate and publishes the resulting investigation report to a user-specified Confluence location. Use when the user wants something debugged, diagnosed, or root-caused AND the findings posted to a Confluence space or page. Requires a configured Atlassian MCP server. Does not investigate to a local file only — use investigate. Does not publish an arbitrary existing markdown file — use markdown-to-confluence. Does not document an already-understood feature to Confluence — use project-documentation-to-confluence. Does not plan or specify a new feature to Confluence — use plan-a-feature-to-confluence. Does not publish to Jira — use work-items-to-jira.
allowed-tools
Read, Glob, Grep, Skill, Agent, Bash(find *), mcp__claude_ai_Atlassian__getAccessibleAtlassianResources, Bash(bash "${CLAUDE_PLUGIN_ROOT}/scripts/han-config-dir.sh")
argument-hint
[symptom or question to investigate] [confluence location: page URL or space + parent] [--mode draft|live (default draft)]

Project Context

  • personal config directory: !bash "${CLAUDE_PLUGIN_ROOT}/scripts/han-config-dir.sh" 2>/dev/null || echo "$HOME/.claude"
  • project .han/config.md: !cat .han/config.md 2>/dev/null || echo ""

As your first action, use the Read tool on .han/config.md inside the personal config directory path above. A read that returns no file is no personal configuration: continue silently. When that file or the project .han/config.md probe supplies content, apply it per config-rule.md, which governs precedence between the two files, relative-path resolution, and what to do with a file that reads but cannot be used.

Investigate to Confluence

This skill runs an evidence-based investigation with the core han-coding:investigate skill, lets the user review the resulting report, and then publishes it to a Confluence location that the user must specify. It is a thin orchestrator: the investigation work belongs to han-coding:investigate, and the publishing work belongs to han-atlassian:markdown-to-confluence. This skill only validates its inputs, runs the investigation to a temporary file, gets the user's review and publish choice, and hands the file to the publisher.

han-coding:investigate produces a single report file (the investigation plan: problem statement, evidence summary, root cause analysis, planned fix, validation results, and summary). It does not produce companion artifacts, so this skill publishes that one file as a single Confluence page — the single-page sibling of han-atlassian:project-documentation-to-confluence, not the parent-plus-children tree of han-atlassian:plan-a-feature-to-confluence.

The five steps below are the whole skill. It does not resolve Confluence pages or call the Confluence MCP create/update tools itself; han-atlassian:markdown-to-confluence owns all of that.

Step 1: Validate Inputs

Confirm the skill has everything it needs before spending effort on an investigation:

  1. Atlassian MCP reachable (hard requirement). Call mcp__claude_ai_Atlassian__getAccessibleAtlassianResources to confirm the server is connected and retrieve the cloud ID(s). If the tool is not available, the call errors, or it returns no accessible resources (typically an authentication or configuration problem), stop immediately. Tell the user this skill requires the Atlassian MCP server to be installed, configured, and authenticated, and that they can re-run it once it is connected. Do not fall back to a local-only run; for a local-only investigation, point them at han-coding:investigate. This preflight runs first so a missing server fails before any investigation work begins.
  2. A symptom or question to investigate. Confirm the request names a bug, failure, error, integration, or unexpected behavior to investigate. This — together with any relevant conversation context — is forwarded to han-coding:investigate verbatim in Step 2. If the request is too thin to start, let han-coding:investigate run its own investigation rather than pre-empting it here.
  3. A Confluence destination. Confirm the request provides a target location: a Confluence page URL (to update that page, or create a child under it), or a space (key or name) plus an optional parent page. If none was provided, ask for one with AskUserQuestion, explaining plainly that the skill needs an exact destination because it does not search Confluence. Do not resolve the page tree here — only confirm a location was given. Carry it through to Step 5; han-atlassian:markdown-to-confluence resolves it.

Step 2: Produce the Investigation Report to a Temporary File

Invoke the han-coding:investigate skill with the Skill tool, forwarding all provided context verbatim: the symptom or question, any known reproduction steps or error messages, any suspected entry points, and the relevant conversation context. Do not summarize, trim, or reinterpret the user's context; pass it through so han-coding:investigate runs exactly as it would on its own (parallel investigators, conditional specialist analysts, adversarial validation, and the final report) — except add two explicit instructions:

  • It must write the resulting investigation report to a file under /tmp/ (for example /tmp/<symptom-slug>.md) rather than into the project's docs or plans directory. This keeps the working report out of the repo until the user decides to publish it, and because the path is explicit input it outranks any output-directory the project or personal .han/config.md supplies (see ../../references/config-rule.md).
  • It must stop after producing the report. han-coding:investigate normally ends by presenting the plan for approval and can trigger the fix's implementation on approval; this skill wants the report only, so instruct it not to implement the fix or change any code — this skill publishes findings, it does not ship them.

Let han-coding:investigate complete its full investigation process. Capture the exact /tmp/ file path it wrote. That markdown file is the source content for Confluence. Proceed to Step 3 once it finishes.

Show full SKILL.md (441 more words)Show less

Step 3: Show the File for Review

Tell the user the exact /tmp/ path of the generated investigation report so they can open and review it before deciding whether to publish. State plainly that the content has not been published anywhere yet, and that no code was changed.

Step 4: Confirm the Publish Choice

Publishing to Confluence puts the content where other people can see it, so require an explicit choice before posting. Ask with AskUserQuestion, restating the /tmp/ file path and the Confluence destination the user provided. Offer three options, listing the draft option first as the recommended default:

  • "Yes, save it as a draft to edit later (recommended)" — published as an unpublished Confluence draft for the user to review, edit, and publish themselves. This is the default. (Publish mode: draft.)
  • "Yes, publish it live now" — the page goes live immediately. (Publish mode: live.)
  • "No, keep it local only" — nothing is published.

If the user keeps it local only, stop. Report the /tmp/ report path and state clearly that nothing was published to Confluence. Otherwise, record the chosen publish mode (draft or live) for Step 5.

Step 5: Publish with markdown-to-confluence

Invoke the han-atlassian:markdown-to-confluence skill with the Skill tool, forwarding:

  • the /tmp/ markdown file path captured in Step 2,
  • the Confluence destination the user provided in Step 1 (the page URL, or the space plus optional parent page), passed through verbatim, and
  • the publish mode the user chose in Step 4 (draft or live), stated explicitly so han-atlassian:markdown-to-confluence does not re-ask.

han-atlassian:markdown-to-confluence resolves the location, reads the file, creates or updates the page in the chosen mode, handles Mermaid diagrams, and reports the resulting page URL. Relay its result to the user: the created or updated page's URL and whether it went live or was saved as a draft. If publishing fails, report the error and confirm the /tmp/ markdown file is unchanged and intact.

Verification

  1. Inputs validated: the Atlassian server was reachable, a symptom or question to investigate was present, and a Confluence location was provided — or the skill stopped before doing any work.
  2. Report produced to /tmp: han-coding:investigate ran with the full forwarded context, wrote the investigation report to a /tmp/ file whose path was captured, and did not implement the fix or change any code.
  3. User reviewed: the /tmp/ path was shown to the user before any publish.
  4. Explicit choice obtained: the user chose draft, live, or local-only.
  5. Publish delegated and reported: when the user chose to publish, han-atlassian:markdown-to-confluence created or updated the page in the chosen mode and its URL was relayed; when the user declined, only the /tmp/ report exists.

© testdouble, 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 han-atlassian/skills/investigate-to-confluence of testdouble/han.

Open the folder on GitHubat commit abba73a

Compare with similar skills

Investigate To Confluence 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 To Confluence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Investigate To Confluence this skilltestdouble/han281—~2.3kAutomated safety check: PassMIT
Akb Ingestdnotitia/akb162—~2kAutomated safety check: PassCustom licence
Jira Assistanttech-leads-club/agent-skills7k—~2.3kAutomated safety check: PassCustom licence
Atlassian Setupdavekilleen/Dex494—~2.7kAutomated safety check: PassMIT
MCP Atlassiansundial-org/awesome-openclaw-skills663—~433Automated safety check: PassNone
Confluence To Markdowniurykrieger/claude-bedrock1051 repos~2.8kAutomated safety check: NotesMIT

Similar skills

  • Akb Ingest

    dnotitia/akb

    Ingest whatever you point at into an AKB vault — a local file, a web URL, a GitHub PR/release/commit, a Confluence page, or a Jira issue.

    162 GitHub stars~2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Jira Assistant

    tech-leads-club/agent-skills

    Manage Jira issues via Atlassian MCP — search, create, update, transition status, and handle sprint tasks.

    7k GitHub stars~2.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Atlassian Setup

    davekilleen/Dex

    Connect Jira and Confluence for project tracking and knowledge search.

    494 GitHub stars~2.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • MCP Atlassian

    sundial-org/awesome-openclaw-skills

    Run the Model Context Protocol (MCP) Atlassian server in Docker, enabling integration with Jira, Confluence, and other Atlassian products.

    663 GitHub stars~433 tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed
  • Confluence To Markdown

    iurykrieger/claude-bedrock

    Internal fetcher module for Confluence pages. An agent skill from iurykrieger/claude-bedrock.

    105 GitHub starsUsed in 1 repo~2.8k tokens
    Knowledge ManagementAuto-check: notes
  • Atlassian MCP Expert

    Jeffallan/claude-skills

    Queries and edits Jira issues and Confluence pages through an MCP server, covering JQL and CQL queries, server setup, authentication and sprint or backlog workflows.

    12k GitHub stars~1.3k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed

More from testdouble/han

All 54 skills in this repo
  • HTML Summary

    testdouble/han

    Convert a stakeholder summary markdown file into a single self-contained HTML executive report — bottom line and decision asks up front, supporting detail later — styled with a Test Double-derived…

    281 GitHub stars~2.9k tokensUpdated 9 days ago
    Auto-check passed
  • Update Han plugin documentation so every skill, agent, guidance doc, index, and cross-reference is current and accurate.

    281 GitHub stars~3.4k tokensUpdated 9 days ago
    Auto-check passed
  • Guidance

    testdouble/han

    Authoritative guidance for building Claude Code skills, agents, and plugins, plus init and update steps that install and refresh the plugin-building skills in the current repository.

    281 GitHub stars~1.8k tokensUpdated 9 days ago
    Auto-check passed
  • Han Release

    testdouble/han

    Cut a Han release: update CHANGELOG.md with the changes since the last release, bump and tag every plugin that changed as {plugin-name}--v{version} so a version-constrained dependency can resolve…

    281 GitHub stars~8.6k tokensUpdated 9 days ago
    Auto-check passed
  • Plan Implementation

    testdouble/han

    Builds a feature implementation plan from an existing feature specification (or equivalent context) through a facilitated team conversation.

    281 GitHub stars~9.5k tokensUpdated 9 days ago
    Auto-check passed
  • Refactor

    testdouble/han

    Restructure existing code without changing its behavior, through a test-gated refactoring loop: a named target, a green suite over that target before any edit, a planned sequence of small named…

    281 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed

Questions about Investigate To Confluence

What does Investigate To Confluence do?

Runs an evidence-based investigation of a bug, failure, or unexpected behavior with investigate and publishes the resulting investigation report to a user-specified Confluence location. Investigate To Confluence is an agent skill from testdouble/han. Runs an evidence-based investigation of a bug, failure, or unexpected behavior with investigate and publishes the resulting investigation report to a user-specified Confluence location.

When should I use Investigate To Confluence?

Investigate To Confluence fits situations like: the user wants something debugged; root-caused AND the findings posted to a Confluence space.

How do I install Investigate To Confluence in Claude Code?

Run `npx skills add testdouble/han --skill investigate-to-confluence -a claude-code`. Or copy the skill folder (han-atlassian/skills/investigate-to-confluence in testdouble/han) into .claude/skills/investigate-to-confluence in your project. Claude Code loads it when a task matches its description.

How do I install Investigate To Confluence in Codex?

Run `npx skills add testdouble/han --skill investigate-to-confluence -a codex`. Or copy the skill folder (han-atlassian/skills/investigate-to-confluence in testdouble/han) into .agents/skills/investigate-to-confluence in your project. Codex loads it when a task matches its description.

Can I use Investigate To Confluence 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 testdouble/han --skill investigate-to-confluence -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-to-confluence, .gemini/skills/investigate-to-confluence, .github/skills/investigate-to-confluence and .opencode/skills/investigate-to-confluence in your project.

What does Investigate To Confluence need to run?

Going by SKILL.md and its folder, Investigate To Confluence needs the command-line tools its instructions call (bash). Its frontmatter pre-approves these tools: Read, Glob, Grep, Skill, Agent, Bash(find *), mcp__claude_ai_Atlassian__getAccessibleAtlassianResources, Bash(bash "${CLAUDE_PLUGIN_ROOT}/scripts/han-config-dir.sh").

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

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

About 2.3k tokens (SKILL.md is roughly 9.4k 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 To Confluence?

Skills that share tags, products or a category with Investigate To Confluence: Akb Ingest (dnotitia/akb, 162 stars), Jira Assistant (tech-leads-club/agent-skills, 7k stars), Atlassian Setup (davekilleen/Dex, 494 stars) and MCP Atlassian (sundial-org/awesome-openclaw-skills, 663 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Investigate To Confluence?

testdouble (a GitHub organization) maintains it in testdouble/han, which has 281 GitHub stars. The repository holds 54 skills in this directory. The repository was last updated on October 1, 2026.

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