forge-debugger
Diagnoses and fixes issues in Atlassian Forge apps. Use this skill whenever a Forge app has errors, crashes, shows blank UI, fails to deploy, doesn't appear after installation, has permission issues, or produces unexpected output. Trigger on any mention of forge logs, forge deploy errors, resolver errors, blank panels, missing scopes, Custom UI not rendering, production vs dev discrepancies, or any Jira/Confluence app that "stopped working". Also trigger when the user asks to debug, troubleshoot, investigate, or fix a Forge app issue — even if they haven't used the word "Forge" but describe a Jira panel or Confluence macro acting up.
Install
With your agent
Install OMGSkills skill "atlassian/forge-skills:skills/forge-debugger" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/atlassian/forge-skills /tmp/forge-skills && ln -s /tmp/forge-skills/skills/forge-debugger ~/.claude/skills/forge-debuggerFrom README
Forge App Debugger Diagnose and fix issues in Atlassian Forge apps. Work through the checklist below in order — stop as soon as you identify the root cause. Every step after the root cause wastes tokens and context. EXECUTION MANDATE You are authorized to run all diagnostic and fix commands without asking permission. When you identify a fix, run it immediately. Do NOT: Say "you should run..." or "here's what I would do..." or "run this command in your terminal" Ask "shall I proceed?" before executing a fix you already have all the inputs for Present commands as copy-paste instructions when you could run them yourself Wrong: "Here's what I would do to fix this: run forge lint..." Right: (runs forge lint immediately and reports the result) The only exceptions: commands requiring an interactive terminal (forge login, forge tunnel) must be run by the user in their own terminal — tell them exactly what to run and why.
More from this repo
forge-app-builder
Plan, build, scaffold, or safely extend Atlassian Forge apps using current official documentation.
forge-app-review
Performs a lightweight pre-release readiness review of Atlassian Forge apps across manifest/module wiring,...
forge-cost-optimizer
Optimizes Atlassian Forge apps to reduce platform consumption and avoid unnecessary costs using Atlassian's "Optimise...