{
  "markdown": "# Atlassian Forge Skills\n\nAtlassian 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.\n\n## What's included\n\n### Skills\n\nThe plugin ships multiple skills under `skills/`, each with a `SKILL.md` the host can load:\n\n**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.\n\n**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.\n\n**Forge Cost Optimizer** (`skills/forge-cost-optimizer/`) helps reduce Forge platform consumption across invocations, storage, logs, memory, triggers, API calls, and frontend/backend boundaries.\n\n**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.\n\n**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.\n\n**Forge Security Review** (`skills/forge-security-review/`) performs white-box Forge app security audits with rule-driven checks for authz, injection, tenant isolation, secrets handling, egress/remotes, web triggers, and optional static-analysis workflows.\n\n### Forge MCP Server\n\nGives 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.\n\n### ADS MCP Server\n\nProvides Atlassian Design System lookup for Custom UI apps: component discovery, token reference, and icon search via the `@atlaskit` library.\n\n| Component                       | What it adds                                              | Examples                                                               |\n| ------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------- |\n| **Forge App Builder skill**     | Scaffold, deploy, install, module choice, CLI workflows   | `forge create`, environments, cross-product scopes                     |\n| **Forge App Review skill**      | Pre-deploy review: security, cost, architecture, triggers | Audit before release, reduce invocations, find misconfigurations       |\n| **Forge Cost Optimizer skill**  | Reduce Forge platform consumption and avoid waste         | Invocations, storage writes, logs, memory, triggers                    |\n| **Forge Debugger skill**        | Diagnose deploy, runtime, UI, and permission issues       | Logs, blank panels, resolver errors, missing app in UI                 |\n| **Forge Connector skill**       | Ingest external data into Teamwork Graph / Rovo           | graph:connector, setObjects, Rovo Search, Rovo Chat                    |\n| **Forge Security Review skill** | White-box security audits and exploitability reporting    | AuthZ bypasses, injection, tenant isolation, static analysis workflows |\n| **Forge MCP Server**            | Live Forge documentation and tooling                      | Template lookup, manifest syntax, UI Kit guides, backend API reference |\n| **ADS MCP Server**              | Atlassian Design System lookup                            | Component discovery, token reference, icon lookup (Custom UI only)     |\n\n## Prerequisites\n\nBefore you install, make sure you have:\n\n- An [Atlassian account](https://id.atlassian.com)\n- **Node.js 22+** (`node -v`) — required for Forge CLI and app builds\n- **Python 3** available on your PATH (used by helper scripts)\n\n## Install\n\n### Claude Code\n\n```\n/plugin install forge-skills@atlassian-forge-skills\n```\n\n### Cursor\n\nThe Forge Skills plugin can be installed directly from the [Cursor Marketplace](https://cursor.com/marketplace/atlassian/forge-skills)\n\nOr by running the following command in chat with a Cursor agent:\n\n```\n/add-plugin forge-skills\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/atlassian/forge-skills\n```\n\n### GitHub Copilot CLI\n\n```bash\ncopilot plugin install atlassian/forge-skills\n```\n\n### OpenAI Codex\n\nInstall the Forge Skills marketplace:\n\n```bash\ncodex plugin marketplace add atlassian/forge-skills --ref main\n```\n\nThen install the plugin:\n\n```bash\ncodex plugin add forge-skills@atlassian-forge-skills\n```\n\nStart a new Codex thread after installing so the Forge skills and MCP servers are loaded.\n\nTo refresh the Codex marketplace after updates:\n\n```bash\ncodex plugin marketplace upgrade atlassian-forge-skills\ncodex plugin add forge-skills@atlassian-forge-skills\n```\n\n### Kiro and Agent Plugins clients\n\nThis repository follows the [Agent Plugins v1.0.0 specification](https://agent-plugins.org/). In Kiro, open the Powers panel, choose **Add Custom Power**, and import this repository from GitHub or from a local checkout.\n\nPortable clients discover:\n\n- `plugin.json` for plugin identity and metadata\n- `skills/*/SKILL.md` for Agent Skills\n- `mcp.json` for Forge and Atlassian Design System MCP servers\n\nThe separate `.mcp.json` and client-specific manifest directories remain in place for clients that use their own plugin formats.\n\n### Rovo Dev\n\nRovo Dev doesn't currently support plugin installations but you can install the skills and MCP servers separately.\n\nInstall the skills:\n\n```bash\nnpx skills add atlassian/forge-skills\n```\n\nThen run `acli rovodev mcp` to edit your MCP configuration in your default editor. Add the details from `.mcp.json`.\n\nRestart Rovo Dev for the skills and MCP to be available.\n\n## Verify the installation\n\nAfter install, try four quick checks.\n\n### 1. Verify the skill layer\n\nAsk:\n\n> Build me a Jira issue panel that shows customer support tickets.\n\nYou should get a structured Forge workflow: developer space discovery, template selection, `forge create`, code customization, and deployment -- not just generic code snippets.\n\nOptionally confirm the other skills are available:\n\n- **Review:** e.g. “Review my Forge app for security and unnecessary trigger invocations before I deploy.”\n- **Debug:** e.g. “My Forge issue panel is blank after deploy -- help me trace it.”\n- **Security:** e.g. “Run a white-box security review on this Forge app and include CVSS-scored findings.”\n\n### 2. Verify Forge MCP\n\nAsk:\n\n> What Forge templates are available for Confluence macros?\n\nYou should get a tool-backed response from the Forge documentation, not a hallucinated list.\n\n### 3. Verify ADS MCP (Custom UI only)\n\nAsk:\n\n> What Atlaskit components should I use for a data table?\n\nYou should get a response backed by the Atlassian Design System, with specific component names and import paths.\n\n### 4. Verify Forge Connector skill\n\nAsk:\n\n> I want to ingest data from an external project management tool into Rovo Search using a Forge connector app. Where do I start?\n\nYou should get a structured walkthrough covering `graph:connector` app setup, `setObjects` ingestion, required scopes, and how the data surfaces in Rovo Search and Rovo Chat -- not a generic Forge tutorial.\n\n## Prompts to try\n\nOnce the plugin is installed, try prompts like these:\n\n- `Create a Jira issue panel that shows related support tickets from an external API.`\n- `Build a Confluence macro that embeds an interactive chart with bar, line, and pie options.`\n- `Add a Jira dashboard gadget that summarizes open issues grouped by priority.`\n- `Create a Confluence macro that reads Jira issues assigned to me and displays them in a table.`\n- `My forge create keeps failing with \"Prompts can not be meaningfully rendered\" -- help!`\n- `Deploy my Forge app to my staging site.`\n- `What scopes do I need for a Confluence app that also reads Jira data?`\n- `Review my Forge app for cost and security before production.`\n- `Run a white-box security audit of this Forge app and focus on authz bypass and web trigger abuse.`\n- `forge deploy fails with [error] -- what should I check?`\n\n## What you get\n\n| Component                 | Default location                                                                               | Purpose                                                                        |\n| ------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |\n| **Forge App Builder**     | `skills/forge-app-builder/`                                                                    | Create, deploy, install; helper scripts and tests                              |\n| **Forge App Review**      | `skills/forge-app-review/`                                                                     | Pre-deploy review and audits (`SKILL.md`, README)                              |\n| **Forge Cost Optimizer**  | `skills/forge-cost-optimizer/`                                                                 | Reduce Forge platform consumption across invocations, storage, logs, and memory |\n| **Forge Connector**       | `skills/forge-connector/`                                                                      | Build graph:connector apps; ingest data into Teamwork Graph (SKILL.md, README) |\n| **Forge Debugger**        | `skills/forge-debugger/`                                                                       | Troubleshooting and diagnostics (`SKILL.md`, README)                           |\n| **Forge Security Review** | `skills/forge-security-review/`                                                                | White-box security audits with rule assets (`SKILL.md`, README, assets/)       |\n| **MCP config**            | `mcp.json`, `.mcp.json`                                                                        | Forge MCP Server and ADS MCP Server configuration                    |\n| **Plugin manifests**      | `plugin.json`, `.plugin/`, `.cursor-plugin/`, `.claude-plugin/`, `.codex-plugin/`, `gemini-extension.json` | Per-host plugin metadata and MCP wiring                 |\n\n## Authentication\n\nThe Forge CLI handles authentication:\n\n```bash\nforge login\n```\n\nYou will be prompted for your Atlassian email and an [API token](https://id.atlassian.com/manage/api-tokens). Enter credentials only in your terminal -- never paste tokens into chat.\n\nVerify you are logged in:\n\n```bash\nforge whoami\n```\n\n## Troubleshooting\n\n### The agent is not using Forge skills\n\n- Make sure the plugin installed successfully in your host\n- Confirm the `skills/` directory includes `forge-app-builder`, `forge-app-review`, `forge-debugger`, `forge-connector`, and `forge-security-review` (each with a `SKILL.md` where applicable)\n- Reload or restart your host so it re-indexes plugins and MCP configuration\n\n### MCP tools are not showing up\n\n- Check that the Forge MCP entries were added for your host\n- Restart MCP servers or reload the host after configuration changes\n- Verify Node.js is installed (`node -v`)\n\n### Forge commands fail with auth errors\n\n- Re-run `forge login`\n- Create a new API token at [id.atlassian.com/manage/api-tokens](https://id.atlassian.com/manage/api-tokens)\n- Make sure the correct developer space is selected\n\n### forge create fails\n\n- **\"Prompts can not be meaningfully rendered\"**: Run `forge create` in an interactive terminal\n- **\"No developer spaces found\"**: Create one at [developer.atlassian.com/console](https://developer.atlassian.com/console/)\n- **\"forge: command not found\"**: `npm install -g @forge/cli`\n\n## Learn more\n\n- [Forge documentation](https://developer.atlassian.com/platform/forge/)\n- [Forge CLI reference](https://developer.atlassian.com/platform/forge/cli-reference/)\n- [Atlassian Design System](https://atlassian.design/)\n- [Forge community](https://community.developer.atlassian.com/c/forge/)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\n[Apache 2.0](LICENSE)\n",
  "bytes": 12459,
  "sha": "c0cfc29f5f0bbad0a29b63a2538827112bcfdee45ae4137753c900533f3b3df4",
  "repo_slug": "atlassian/forge-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_atlassian_forge_skills_e6103839/readme"
}