{"slug":"code-overview-to-confluence","title":"code-overview-to-confluence","summary":"Produces a progressive-disclosure overview of unfamiliar code or a pull request's changes with code-overview and publishes the resulting overview to a user-specified Confluence location. Use when the user wants code or a PR explained, oriented, or made sense of AND the overview p","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-15T13:12:01.217182Z","repo":{"url":"https://github.com/testdouble/han","stars":303,"forks":24,"license":"MIT","updatedAt":"2026-10-14T20:22:28Z"},"bodyHtml":"<hr>\n<h2>name: code-overview-to-confluence\ndescription: &gt;\nProduces a progressive-disclosure overview of unfamiliar code or a pull request's changes with code-overview and\npublishes the resulting overview to a user-specified Confluence location. Use when the user wants code or a PR\nexplained, oriented, or made sense of AND the overview posted to a Confluence space or page. Requires a configured\nAtlassian MCP server. Does not produce the overview to a local file only — use code-overview. Does not publish an\narbitrary existing markdown file — use markdown-to-confluence. Does not document an already-understood feature to\nConfluence — use project-documentation-to-confluence. Does not root-cause a bug to Confluence — use\ninvestigate-to-confluence. Does not plan or specify a new feature to Confluence — use plan-a-feature-to-confluence.\nDoes not publish to Jira — use work-items-to-jira.\nargument-hint:\n\"[size: small | medium | large] [target: file, directory, symbol, or PR reference — defaults to the current branch's\nchanges] [confluence location: page URL or space + parent] [--mode draft|live (default draft)]\"\nallowed-tools:\nRead, Glob, Grep, Skill, Agent, Bash(find *), mcp__claude_ai_Atlassian__getAccessibleAtlassianResources,\nBash(bash \"$/scripts/han-config-dir.sh\")</h2>\n<h2>Project Context</h2>\n<ul>\n<li>personal config directory: !<code>bash \"${CLAUDE_PLUGIN_ROOT}/scripts/han-config-dir.sh\" 2&gt;/dev/null || echo \"$HOME/.claude\"</code></li>\n<li>project .han/config.md: !<code>cat .han/config.md 2&gt;/dev/null || echo \"\"</code></li>\n</ul>\n<p>As your first action, use the Read tool on <code>.han/config.md</code> inside the <code>personal config directory</code> path above. A read\nthat returns no file is no personal configuration: continue silently. When that file or the <code>project .han/config.md</code>\nprobe supplies content, apply it per <a href=\"../../references/config-rule.md\">config-rule.md</a>, which governs precedence\nbetween the two files, relative-path resolution, and what to do with a file that reads but cannot be used.</p>\n<h1>Code Overview to Confluence</h1>\n<p>This skill runs a progressive-disclosure code overview with the core <code>han-coding:code-overview</code> skill, lets the user\nreview the resulting overview, and then publishes it to a Confluence location that <strong>the user must specify</strong>. It is a\nthin orchestrator: the overview work belongs to <code>han-coding:code-overview</code>, and the publishing work belongs to\n<code>han-atlassian:markdown-to-confluence</code>. This skill only validates its inputs, runs the overview to a scratch file, gets\nthe user's review and publish choice, and hands the file to the publisher.</p>\n<p><code>han-coding:code-overview</code> produces a <strong>single</strong> scratch file (the overview: what the code does, how it flows, where to\nstart, and — in PR mode — what changed and what to watch when reviewing). It does not produce companion artifacts, so\nthis skill publishes that one file as a single Confluence page — the single-page sibling of\n<code>han-atlassian:investigate-to-confluence</code> and <code>han-atlassian:project-documentation-to-confluence</code>, not the\nparent-plus-children tree of <code>han-atlassian:plan-a-feature-to-confluence</code>.</p>\n<p>The five steps below are the whole skill. It does not resolve Confluence pages or call the Confluence MCP create/update\ntools itself; <code>han-atlassian:markdown-to-confluence</code> owns all of that.</p>\n<h2>Step 1: Validate Inputs</h2>\n<p>Confirm the skill has everything it needs before spending effort on an overview:</p>\n<ol>\n<li><strong>Atlassian MCP reachable (hard requirement).</strong> Call <code>mcp__claude_ai_Atlassian__getAccessibleAtlassianResources</code> to\nconfirm the server is connected and retrieve the cloud ID(s). If the tool is not available, the call errors, or it\nreturns no accessible resources (typically an authentication or configuration problem), <strong>stop immediately</strong>. Tell\nthe user this skill requires the Atlassian MCP server to be installed, configured, and authenticated, and that they\ncan re-run it once it is connected. Do not fall back to a local-only run; for a local-only overview, point them at\n<code>han-coding:code-overview</code>. This preflight runs first so a missing server fails before any overview work begins.</li>\n<li><strong>A target to overview (optional).</strong> The target may be a file, directory, symbol, or pull request reference, and an\noptional size (<code>small</code>, <code>medium</code>, or <code>large</code>). All of this — together with the relevant conversation context — is\nforwarded to <code>han-coding:code-overview</code> verbatim in Step 2. A target is not required: with none given,\n<code>han-coding:code-overview</code> defaults to the current branch's changes. Do not resolve or classify the target here; that\nis <code>han-coding:code-overview</code>'s job.</li>\n<li><strong>A Confluence destination.</strong> Confirm the request provides a target location: a <strong>Confluence page URL</strong> (to update\nthat page, or create a child under it), or a <strong>space</strong> (key or name) plus an optional <strong>parent page</strong>. If none was\nprovided, ask for one with <code>AskUserQuestion</code>, explaining plainly that the skill needs an exact destination because it\ndoes not search Confluence. Do not resolve the page tree here — only confirm a location was given. Carry it through\nto Step 5; <code>han-atlassian:markdown-to-confluence</code> resolves it.</li>\n</ol>\n<h2>Step 2: Produce the Overview to a Scratch File</h2>\n<p>Invoke the <code>han-coding:code-overview</code> skill with the <strong>Skill</strong> tool, <strong>forwarding all provided context</strong> verbatim: the\ntarget (file, directory, symbol, or PR reference, or none for the current branch's changes), any size the user gave, and\nthe relevant conversation context. Do not summarize, trim, or reinterpret the user's context; pass it through so\n<code>han-coding:code-overview</code> runs exactly as it would on its own (target resolution, mode and size selection, parallel\n<code>han-core:codebase-explorer</code> exploration, synthesis, and the readability-review pass).</p>\n<p><code>han-coding:code-overview</code> already writes its overview to a scratch file outside the repository and changes no code —\n<strong>except</strong> add one explicit instruction: it must write the overview to an explicit scratch path this skill names (for\nexample <code>${TMPDIR:-/tmp}/code-overview-&lt;slug&gt;.md</code>). Passing the path explicitly keeps the file where this skill expects\nit even when either <code>.han/config.md</code> configures an output directory, because explicit input outranks the config\n(see <a href=\"../../references/config-rule.md\">../../references/config-rule.md</a>). <strong>Capture the exact scratch-file path it\nwrote.</strong> That markdown file is the source content for Confluence. Proceed to Step 3 once it finishes.</p>\n<h2>Step 3: Show the File for Review</h2>\n<p>Tell the user the exact scratch-file path of the generated overview so they can open and review it before deciding\nwhether to publish. State plainly that the content has not been published anywhere yet, and that no code was changed.</p>\n<h2>Step 4: Confirm the Publish Choice</h2>\n<p>Publishing to Confluence puts the content where other people can see it, so require an explicit choice before posting.\nAsk with <code>AskUserQuestion</code>, restating the <strong>scratch-file path</strong> and the <strong>Confluence destination</strong> the user provided.\nOffer three options, listing the draft option first as the recommended default:</p>\n<ul>\n<li><strong>\"Yes, save it as a draft to edit later (recommended)\"</strong> — published as an unpublished Confluence draft for the user\nto review, edit, and publish themselves. This is the default. (Publish mode: <strong>draft</strong>.)</li>\n<li><strong>\"Yes, publish it live now\"</strong> — the page goes live immediately. (Publish mode: <strong>live</strong>.)</li>\n<li><strong>\"No, keep it local only\"</strong> — nothing is published.</li>\n</ul>\n<p>If the user keeps it local only, <strong>stop</strong>. Report the scratch-file path and state clearly that nothing was published to\nConfluence. Otherwise, record the chosen publish mode (draft or live) for Step 5.</p>\n<h2>Step 5: Publish with markdown-to-confluence</h2>\n<p>Invoke the <code>han-atlassian:markdown-to-confluence</code> skill with the <strong>Skill</strong> tool, forwarding:</p>\n<ul>\n<li>the <strong>scratch-file markdown path</strong> captured in Step 2,</li>\n<li>the <strong>Confluence destination</strong> the user provided in Step 1 (the page URL, or the space plus optional parent page),\npassed through verbatim, and</li>\n<li>the <strong>publish mode</strong> the user chose in Step 4 (<code>draft</code> or <code>live</code>), stated explicitly so\n<code>han-atlassian:markdown-to-confluence</code> does not re-ask.</li>\n</ul>\n<p><code>han-atlassian:markdown-to-confluence</code> resolves the location, reads the file, creates or updates the page in the chosen\nmode, handles Mermaid diagrams, and reports the resulting page URL. Relay its result to the user: the created or updated\npage's URL and whether it went live or was saved as a draft. If publishing fails, report the error and confirm the\nscratch-file markdown is unchanged and intact.</p>\n<h2>Verification</h2>\n<ol>\n<li><strong>Inputs validated:</strong> the Atlassian server was reachable and a Confluence location was provided — or the skill\nstopped before doing any work.</li>\n<li><strong>Overview produced to a scratch file:</strong> <code>han-coding:code-overview</code> ran with the full forwarded context, wrote the\noverview to a scratch file whose path was captured, and changed no code.</li>\n<li><strong>User reviewed:</strong> the scratch-file path was shown to the user before any publish.</li>\n<li><strong>Explicit choice obtained:</strong> the user chose draft, live, or local-only.</li>\n<li><strong>Publish delegated and reported:</strong> when the user chose to publish, <code>han-atlassian:markdown-to-confluence</code> created or\nupdated the page in the chosen mode and its URL was relayed; when the user declined, only the scratch file exists.</li>\n</ol>\n","files":[{"path":"SKILL.md","sizeBytes":9320,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-15T13:12:51.382191Z","sha256":"36955797FBDAF066D27A05CFA6C17EA6C303084E428A1BDE559F3308F20054B6","sizeBytes":3688},"review":null,"source":{"repositoryUrl":"https://github.com/testdouble/han","path":"han-atlassian/skills/code-overview-to-confluence","license":"MIT","commit":"abba73a773528905a8f3d15956029394746e5c7f","subtreeSha":"C67095CDDFBDAE0D8D37F48482755A4BDDFB71219F3B56EA36ABD6F34B8DE619","lastSyncedAt":"2026-10-15T13:11:53.672149Z"},"reviewedAt":"2026-10-15T13:14:22.498483Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/testdouble/han/tree/main/han-atlassian/skills/code-overview-to-confluence"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install testdouble-han@llmmart"},{"target":"git","command":"git clone https://github.com/testdouble/han.git"}]}