forge-app-builder

Automate Atlassian Forge app creation, deployment, and installation workflows.

20|10|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/atlassian/forge-skills --skill forge-app-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-app-builder
Source: https://github.com/atlassian/forge-skills/tree/main/skills/forge-app-builder
Command: npx skills add https://github.com/atlassian/forge-skills --skill forge-app-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

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.

Core Features & Use Cases

  • Automated workflow — Discovers dev spaces, creates apps with forge create, deploys and installs
  • Module selection — Guidance for Jira panels, Confluence macros, dashboard gadgets, Rovo agents, and more
  • Helper scripts — Python scripts for dev spaces, templates, and deployment
  • Reference docs — CLI workflow, module selector, project setup

Quick Start

Describe the end-to-end Forge app workflow and run the included scripts to create, deploy, and install a Forge app.

Frequently Asked Questions about forge-app-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Forge app creation and deployment with the CLI?

You can automate Forge app creation and deployment by running Python scripts that validate prerequisites, discover developer spaces, select templates, lint manifests, and execute cross-product installs. The automated workflow guides you end-to-end from scaffolding to deployment.

What Atlassian Forge modules can I choose when building a custom app?

When building a Forge app, you can select modules for Jira issue panels, dashboard gadgets, Confluence macros, global pages, and Rovo agents. The module selection process provides specific guidance for scaffolding these custom extensions.

Can I use this to troubleshoot Forge CLI errors like installation failures?

Yes, you can use this to troubleshoot Forge CLI errors such as installation failures and environment errors. It handles deployment issues by validating prerequisites, linting manifests, and requiring user site URLs during the installation step.

Do I need a site URL to install a Forge app across Jira and Confluence?

Yes, you need a user site URL to install a Forge app across products. The deployment workflow requires this URL to successfully handle cross-product installs for your Atlassian environment.

Does this workflow support learning Forge concepts like UI Kit and resolvers?

Yes, this workflow supports learning Forge concepts like UI Kit, resolvers, and manifest scopes. It applies to building custom extensions and provides reference documentation for the CLI workflow, module selectors, and project setup.

Why am I getting a manifest scopes error during Forge deployment?

Manifest scopes errors during Forge deployment often occur when prerequisites are unmet or the manifest requires linting. The automated workflow validates your environment and lints manifests before attempting deployment and installation.