RonanCodes/skills/confluence
skills/confluence/SKILL.md
--- name: confluence description: Create, update, read, and Smart-Link Confluence pages via the Atlassian Remote MCP server. Defaults to the dataforce space on the Simplicity Labs site. Use when user wants to draft a research doc, post meeting notes, or link a Confluence page to a Jira ticket. Pairs with /ro:jira and /ro:confluence-to-wiki. category: project-management argument-hint: [create "title" [--parent <page-id>] [--body-file <path>] | update <page-id> [--body-file <path>] | show <page-id
tools
Updated May 22, 2026
$ install --global
skillsauthnpx skillsauth add RonanCodes/ronan-skills skills/confluenceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 22, 2026, 2:16 AM251.0s1 file scanned
SKILL.md
- name:
- confluence
- description:
- Create, update, read, and Smart-Link Confluence pages via the Atlassian Remote MCP server. Defaults to the dataforce space on the Simplicity Labs site. Use when user wants to draft a research doc, post meeting notes, or link a Confluence page to a Jira ticket. Pairs with /ro:jira and /ro:confluence-to-wiki.
- category:
- project-management
- argument-hint:
- [create "title" [--parent <page-id>] [--body-file <path>] | update <page-id> [--body-file <path>] | show <page-id> | link <page-id> <JIRA-KEY> | list [--parent <page-id>]] [--space <key>] [--site <host>]
- allowed-tools:
- Bash(claude mcp *) Bash(grep *) Read Write
Confluence
Opinionated wrapper around the Atlassian Remote MCP server's Confluence tools. Reads defaults from ~/.claude/.env. Common case is the dataforce space on simplicitylabs.atlassian.net.
Usage
/ro:confluence create "Inventory sync algorithm v2" --body-file ./notes.md
/ro:confluence create "Taskforce x Simplicity weekly — 2026-05-22" --parent <weekly-notes-page-id>
/ro:confluence update <page-id> --body-file ./revised.md
/ro:confluence show <page-id>
/ro:confluence link <page-id> DAFO-42 # Smart Link: append the Jira issue panel
/ro:confluence list --parent <page-id> # children under a parent
Override defaults: --space <key> --site <host>.
Prerequisites
Same as /ro:jira:
claude mcp add --transport http --scope user atlassian https://mcp.atlassian.com/v1/mcp/authv2/mcp→ OAuth theatlassianserver in browser- Defaults in
~/.claude/.env:ATLASSIAN_SITE=simplicitylabs.atlassian.net ATLASSIAN_CONFLUENCE_SPACE_DEFAULT=dataforce
How to run each verb
Use the live mcp__atlassian__* tools at runtime. Typical mapping:
| Verb | What to do | Atlassian MCP tool (typical name) |
|---|---|---|
| create | Convert body to Atlassian storage format (the MCP usually accepts markdown and converts), set space + optional parent, post | createConfluencePage |
| update | Fetch current version, increment, post new body | updateConfluencePage |
| show | Fetch page, render title + URL + body as markdown | getConfluencePage |
| link | Append an inline-card / Smart Link macro for the Jira issue URL to the page body, then update. Alternatively, comment on the Jira ticket with the Confluence URL — do both for two-way visibility | updateConfluencePage + addJiraIssueComment |
| list | List children of a parent page | getConfluenceChildren / searchConfluenceUsingCql |
Body input
- Prefer
--body-file <path>over inline--body. Confluence pages are long; quoting markdown on the command line is painful. - Markdown is the input format; the MCP handles conversion to storage format. If the conversion mangles tables/code blocks, fall back to writing storage-format XHTML directly and pass
--raw.
Smart Linking to Jira
When linking a Confluence page to a DAFO ticket:
- Append a short context line to the Confluence page body:
> Related Jira: <ticket URL> - The Atlassian renderer turns that into a Jira issue panel automatically (Smart Links). No special macro needed in most cases.
- Mirror back: comment on the Jira ticket with the Confluence page URL.
This gives partners a clickable trail in both directions.
What to return after each action
create/update: page title + URL + parent path (if any)show: title + URL above, body as markdown belowlink: confirmation that both sides were updated + both URLslist: markdown table of children (title, id, last updated)
When to use vs /ingest
- Use
/ro:confluence createwhen authoring partner-facing content the Taskforce people need to see in Confluence (meeting notes, agreements, research summaries, RFCs for partner review). - Use
/ingestintollm-wiki-simplicity-taskforce-partnershipwhen capturing private notes, thinking, or research that doesn't need to round-trip with partners. Then/promoteselected pages intollm-wiki-researchif they're reusable knowledge. - Use
/ro:confluence-to-wikito pull an existing Confluence page into the wiki as a source-note (one-way mirror, doesn't sync back).
Failure modes
| Symptom | Cause | Fix |
|---|---|---|
| "No atlassian MCP tools" | OAuth not done | /mcp then browser auth |
| Body renders broken (tables, code) | Markdown → storage conversion edge case | Pass --raw and supply storage-format XHTML directly |
| "Space not found" | Default not loaded or space key wrong | Verify ATLASSIAN_CONFLUENCE_SPACE_DEFAULT=dataforce in env; pass --space |
| Update fails with version conflict | Page edited elsewhere between fetch and post | Re-fetch, re-apply, retry |
Related
- DAFO board: https://simplicitylabs.atlassian.net/jira/software/projects/DAFO/boards/34
- Dataforce Confluence space: https://simplicitylabs.atlassian.net/wiki/spaces/dataforce/overview
/ro:jirafor ticket ops/ro:confluence-to-wikifor pulling pages into the llm-wiki vault
Related Skills
RonanCodes/skills/worktree
development
VerifiedTrustedCommunity
--- name: worktree description: Coordinate multiple agents on one repo via a worktree-lock pool, so two agents never clobber each other's working tree. Acquire the first free slot (main, then beta/gamma… worktrees, created on demand), work there on your own branch, release when you've pushed. Use before modifying any repo that might be in use by another agent (factory, dataforce, etc.), or whenever you're told a repo is being worked on. Backed by `ro worktree`. category: development argument-hin
SKILL.mdUpdated May 25, 2026
RonanCodes/skills/ship
testing
VerifiedTrustedCommunity
--- name: ship description: Ship a feature branch the local-CI-first way — run the full local gate, push, open a PR, squash-merge, then deploy, without waiting on GitHub Actions. Use when a branch is ready for main and you want it merged and deployed now. Reads CI policy from `ro ci` (default skips remote CI because GitHub Actions billing keeps hitting limits). Sibling to /ro:gh-ship (waits on GitHub checks) and /ro:cf-ship (the deploy half). Triggers on "ship it", "ship this", "merge and deploy
SKILL.mdUpdated May 25, 2026
RonanCodes/skills/setup-logging
testing
VerifiedTrustedCommunity
--- name: setup-logging description: Set up (or audit) the observability stack in a TanStack Start + Cloudflare Workers app so it is "diagnosable by default" — structured logging (logtape) with a request context carrying trace_id + userId + tenant/orgId, a trace_id propagated FE→BE→logs→Sentry→PostHog, Cloudflare Workers observability enabled, and Sentry + PostHog wired. Two modes: `setup` (wire it into an app) and `audit` (check an existing app + report gaps). Use when scaffolding a new app, wh
SKILL.mdUpdated May 24, 2026
RonanCodes/env
development
VerifiedTrustedCommunity
Manage credentials INSIDE the active ~/.claude/.env file — read which token/account to use for a given app (Simplicity vs Dataforce vs Ronan-personal), add or update a secret WITHOUT it passing through the chat (an interactive Terminal window prompts for it), and track secrets that were exposed in a transcript so they get rotated. Sibling to /ro:context (which switches WHICH env file is active). Use when the user wants to add an API key/token/secret, asks "which credential do I use for X", needs the env organized/labelled, or a secret was pasted into the chat and should be rotated.
SKILL.mdUpdated May 24, 2026