ClaudeSuperPower

forge-app-builder

Skill

Guides building, deploying, troubleshooting, and installing Atlassian Forge apps — custom extensions built with the Forge CLI (forge create, forge deploy, forge install). Use when the user wants to create a Forge app (issue panels, dashboard gadgets, Confluence macros, global pages), is encountering

Install

git clone https://github.com/atlassian/forge-skills.git ~/.claude/skills/forge-app-builder

What is forge-app-builder?

Guides building, deploying, troubleshooting, and installing Atlassian Forge apps — custom extensions built with the Forge CLI (forge create, forge deploy, forge install). Use when the user wants to create a Forge app (issue panels, dashboard gadgets, Confluence macros, global pages), is encountering Forge CLI errors or deployment issues (e.g. forge install failures, environment errors), or needs help with Forge-specific concepts like resolvers, UI Kit, manifest scopes, or developer spaces. Do not use for general Jira configuration, automation rules, JQL queries, or Atlassian REST API usage outside of a Forge app context.

What this can do

Capabilities declared in this component's own frontmatter — not inferred.

Inherit all session tools

Declares no tool restrictions — inherits every session tool

~157 tokens of context used while enabled, before you invoke anything

Documentation

README · ~8 min read

Forge App Builder

When building a Forge app, the agent MUST complete this workflow in order. Do not skip steps. Do not substitute manual instructions for running the scripts below.

Critical Rules

  1. Always use forge create to scaffold apps — it registers the app and generates a valid app ID
  2. Never manually scaffold — apps without valid app IDs cannot be deployed
  3. If forge create fails, STOP — inform the user and provide the manual command
  4. Never ask for API tokens in chat — direct users to run forge login in their terminal and enter credentials there
  5. Always ask the user to choose when multiple options exist (developer spaces, sites) — never pick on their behalf
  6. Always ask the user for their Atlassian site URL during installation — never try to discover it from other apps, environment variables, or any other source
  7. Always run the deploy script for deploy and install — do not give the user only manual forge deploy / forge install commands as the primary outcome; run scripts.deploy_forge_app.py yourself

Reviews

Log in to leave a review.

No reviews yet — be the first.

Explore related

Other things in this space — across every part of the ecosystem, not just skills.