forge-debugger

forge-debugger is a skill for Claude Code, Codex from atlassian/forge-skills. It costs 136 tokens per session (3,837 once invoked), scanned B, original, Apache-2.0.

A troubleshooting and repair guide for Atlassian Forge apps. Forge is Atlassian’s platform for building extensions to products such as Jira and Confluence.

In plain words
What is it for?
Use it for deployment failures, crashes, blank screens, missing installations, permission problems, resolver errors, and Forge log investigation.
Why use it?
It helps identify the root cause of errors before applying a fix, reducing time spent checking unrelated possibilities.

Skill for Claude CodeCodex

Part of the forge-skills plugin — 6 skills, 2 MCP servers shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/atlassian/forge-skills/forge-debugger
Any agent
npx skills add atlassian/forge-skills --skill forge-debugger
Clone the repo
git clone --depth 1 https://github.com/atlassian/forge-skills

Made for: Claude Code, Codex.

Or install forge-skills, the plugin that ships this one along with the rest of its 6 skills, 2 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for forge-debugger

README.md
[![agentmods](https://agentmods.dev/badge/skills/atlassian/forge-skills/forge-debugger.svg)](https://agentmods.dev/skills/atlassian/forge-skills/forge-debugger)
Your own site
<a href="https://agentmods.dev/skills/atlassian/forge-skills/forge-debugger"><img src="https://agentmods.dev/badge/skills/atlassian/forge-skills/forge-debugger.svg" alt="Measured on agentmods" height="20"></a>
Per session 136 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,837 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00136 $0.03837
Opus 5 $0.00068 $0.01919
Sonnet 5 $0.00027 $0.00767
Haiku 4.5 $0.00014 $0.00384

Measured 3d ago against content hash b5b05d11d3a5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

forge-debugger scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

| `npm install -g` permission error / cannot install forge globally | No sudo or write access to global npm directory | Use `npx @forge/cli` as a drop-in replacement for all `forge` commands (lint, deploy, logs, install)
skills/forge-debugger/SKILL.md · 282 lines

How it starts

The opening of the file, as written. The whole thing — 282 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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.

Attribution: prefix every forge command you run yourself with ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-debugger (e.g. ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-debugger forge lint; with the npx fallback, ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-debugger npx @forge/cli lint). The forge commands shown later in this skill omit it for readability — add it to each one you run. Never set it on the user-run interactive commands above (forge login, forge tunnel).

Diagnostic Principles

  • Cheap first: lint and version checks cost nothing. Run them before reading source code or logs.
  • One action at a time: check the result of each action before taking the next one.
  • Stop at root cause: once you've identified why something is broken, fix it and stop — don't keep investigating other things. Exception: if the app has multiple independent bugs (e.g. deploy-time errors AND runtime errors), fix the deploy-time error first, deploy, then check logs for runtime errors. Don't declare "fixed" after only resolving the first layer.
  • Own the fixes: run the fix commands yourself, don't hand them to the user.
  • Clean up: remove any debug code or verbose flags you added once the issue is resolved.
  • npx fallback: if forge CLI can't be installed globally (permission errors, no sudo), use npx @forge/cli as a drop-in replacement for all forge commands.

Read the full file on GitHub · 282 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 282 lines · 136 tokens per session scan B b5b05d11d3a5

Subscribe to this mod's changes

forge-debugger is a skill published in the GitHub repository atlassian/forge-skills (20 stars, last pushed 4d ago), licensed Apache-2.0. It adds 136 tokens to every session and 3,837 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

motherduck-build-cfa-app

Design a MotherDuck-backed customer-facing analytics app. Use for embedded analytics, multi-tenant SaaS reporting, or product analytics for external users -- whenever the decision depends on per-customer isolation, backend routing, service-account boundaries, read scaling, or Hypertenancy-style patterns.

motherduckdb/agent-skills · 63 tokens

motherduck-build-dashboard

Build a live MotherDuck dashboard as a Dive. Use when composing one shareable KPI, trend, and breakdown story over existing MotherDuck data, especially when the result should stay a saved workspace artifact rather than a full application.

motherduckdb/agent-skills · 50 tokens

motherduck-build-data-pipeline

Design an end-to-end MotherDuck data pipeline. Use for ETL/ELT workflows -- choosing raw, staging, and analytics boundaries, bulk ingestion paths, transformation sequencing, dlt/dbt integration, publication targets, or whether DuckLake is actually required.

motherduckdb/agent-skills · 59 tokens

motherduck-connect

Connect to MotherDuck from any application. Use when setting up database connectivity via the Postgres endpoint (recommended), pgduckdb, native DuckDB API, or JDBC. Covers connection strings, authentication, SSL, and environment variable configuration.

motherduckdb/agent-skills · 52 tokens

motherduck-create-dive

Create, edit, manage, share, or embed MotherDuck Dives — live React + SQL dashboards, charts, and data apps saved in the workspace. Use for any dashboard, chart, KPI display, or data visualization over MotherDuck data, and for Dive authoring mechanics such as getdiveguide, useSQLQuery, local preview, version history…

motherduckdb/agent-skills · 95 tokens

motherduck-create-flight

Create, schedule, run, and debug MotherDuck Flights — Python jobs that run on MotherDuck compute. Use whenever someone wants to create a flight, schedule a Python script or recurring job on MotherDuck, set up scheduled ingestion from Postgres, dlt sources, S3, BigQuery, Snowflake, or APIs, refresh aggregates or…

motherduckdb/agent-skills · 106 tokens