forge-skills

Atlassian Forge Skills

Atlassian Forge lets you build and deploy apps directly on the Atlassian platform - issue panels, Confluence macros, dashboard gadgets, and more. The Forge Skills Plugin bundles several Forge-focused skills plus MCP-backed tooling so your agent can scaffold apps, review them before deploy, debug production issues, and stay current on Forge APIs and the Atlassian Design System.

What's included

Skills

The plugin ships multiple skills under skills/, each with a SKILL.md the host can load:

Forge App Builder (skills/forge-app-builder/) guides scaffolding through production: forge create, dev spaces and templates, deploy and install, module selection, cross-product scopes, and common CLI or permission issues.

Forge App Review (skills/forge-app-review/) supports pre-deploy review and audits: security, architecture, cost and invocation efficiency, performance, and trigger or scheduling waste.

Forge Debugger (skills/forge-debugger/) supports systematic troubleshooting when something breaks: forge / deploy errors, resolver failures, blank or missing UI, scopes and permissions, and apps that “stopped working” in Jira or Confluence.

Forge Connector (skills/forge-connector/) guides building graph:connector apps that ingest external data into Atlassian's Teamwork Graph, making it searchable in Rovo Search and surfaced in Rovo Chat.

Forge MCP Server

Gives your agent access to up-to-date Forge documentation, template registries, module configuration, manifest syntax, and UI Kit/backend API guides -- so its knowledge stays current rather than relying on training data.

ADS MCP Server

Provides Atlassian Design System lookup for Custom UI apps: component discovery, token reference, and icon search via the @atlaskit library.

Component	What it adds	Examples
Forge App Builder skill	Scaffold, deploy, install, module choice, CLI workflows	forge create, environments, cross-product scopes
Forge App Review skill	Pre-deploy review: security, cost, architecture, triggers	Audit before release, reduce invocations, find misconfigurations
Forge Debugger skill	Diagnose deploy, runtime, UI, and permission issues	Logs, blank panels, resolver errors, missing app in UI
Forge Connector skill	Ingest external data into Teamwork Graph / Rovo	graph:connector, setObjects, Rovo Search, Rovo Chat
Forge MCP Server	Live Forge documentation and tooling	Template lookup, manifest syntax, UI Kit guides, backend API reference
ADS MCP Server	Atlassian Design System lookup	Component discovery, token reference, icon lookup (Custom UI only)

Prerequisites

Before you install, make sure you have:

• An Atlassian account
• Node.js 22+ (node -v) — required for Forge CLI and app builds
• Python 3 available on your PATH (used by helper scripts)

Install

Claude Code

/plugin install forge-skills@atlassian-forge-skills

Cursor

The Forge Skills plugin can be installed directly from the Cursor Marketplace

Or by running the following command in chat with a Cursor agent:

/add-plugin forge-skills

Gemini CLI

gemini extensions install https://github.com/atlassian/forge-skills

GitHub Copilot CLI

copilot plugin install atlassian/forge-skills

OpenAI Codex

Coming soon

Rovo Dev

Rovo Dev doesn't currently support plugin installations but you can install the skills and MCP servers separately.

Install the skills:

npx skills add atlassian/forge-skills

Then run acli rovodev mcp to edit your MCP configuration in your default editor. Add the details from .mcp.json.

Restart Rovo Dev for the skills and MCP to be available.

Verify the installation

After install, try three quick checks.

1. Verify the skill layer

Ask:

Build me a Jira issue panel that shows customer support tickets.

You should get a structured Forge workflow: developer space discovery, template selection, forge create, code customization, and deployment -- not just generic code snippets.

Optionally confirm the other skills are available:

• Review: e.g. “Review my Forge app for security and unnecessary trigger invocations before I deploy.”
• Debug: e.g. “My Forge issue panel is blank after deploy -- help me trace it.”

2. Verify Forge MCP

Ask: