Agent skill

Debug Addon

by Mojang in Mojang/minecraft-creator-tools

Find and fix problems in a Minecraft Bedrock Edition add-on (behavior packs and resource packs) using Minecraft Creator Tools validation.

Custom licenceAuto-check passed

Install Debug Addon

skills CLI
$ npx skills add Mojang/minecraft-creator-tools --skill debug-addon -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Mojang/minecraft-creator-tools debug-addon --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Mojang/minecraft-creator-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/minecraft/skills/debug-addon .claude/skills/debug-addon && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debug-addon
GitHub stars
161
Token cost
~1.8k tokens
SKILL.md length
882 words
Files
10 (incl. scripts, references, assets)
Skills in repo
6
Repo updated
First seen
Licence
Custom licence

At a glance

Find and fix problems in a Minecraft Bedrock Edition add-on (behavior packs and resource packs) using Minecraft Creator Tools validation.

  • Works in 5 steps: Find the project folder → Run validation → Fix, in this order → …
  • SKILL.md covers 1. Find the project folder, 2. Run validation, 3. Fix, in this order and 4. Re-run until there are no…, plus 4 more sections
  • Runs JavaScript scripts from its folder; calls npx and node

What it does

Debug Addon is an agent skill from Mojang/minecraft-creator-tools. Find and fix problems in a Minecraft Bedrock Edition add-on (behavior packs and resource packs) using Minecraft Creator Tools validation. Use this whenever someone asks why their add-on, pack, mob, item, block, or texture isn't working, won't load, is invisible, shows a missing texture or raw name like item.foo:bar, has Content Log errors, fails validation, needs upgrading to current Minecraft versions, or needs checking and packaging as a .mcaddon for release. Also use it right after creating or changing add-on…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `references/content-log.md` and `references/runtime-symptoms.md`).

It works with Java and Home Assistant. The repository describes itself as: A set of tools for creating content and add-ons for Minecraft Bedrock Edition.

Example prompts

  • “t working, won”
  • “/debug-addon”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Find the project folder
  2. Run validation
  3. Fix, in this order
  4. Re-run until there are no errors
  5. If it still doesn't work in game

What it can do on your machine

Read from SKILL.md and the folder at commit a8f2cd2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npx
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debug Addon loads about 1.8k tokens when it runs, and up to ~4.8k if it reads all its reference files. Until then it costs about 172 tokens; SKILL.md has 882 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~172
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 882 words (~1,755 tokens).

“Validation catches most packaging and reference mistakes, so start there, then fall back to the runtime checklist for problems validation can't see. Keep going until validation reports zero errors, then tell the user what you changed.”

— opening of SKILL.md by Mojang, Custom licence
name
debug-addon

Read the full SKILL.md on GitHub

Files

SKILL.md and 9 other files (scripts, references, assets) in plugins/minecraft/skills/debug-addon of Mojang/minecraft-creator-tools.

  • SKILL.md
  • agents/openai.yaml
  • assets/icon-small.png
  • assets/icon.png
  • references/content-log.md
  • references/runtime-symptoms.md
  • references/validation-issues.md
  • scripts/add-missing-names.mjs
  • scripts/make-pack-icon.mjs
  • scripts/validate-summary.mjs

Open the folder on GitHubat commit a8f2cd2

Compare with similar skills

Debug Addon next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debug Addon compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug Addon this skillMojang/minecraft-creator-tools161—~1.8kAutomated safety check: PassCustom licence
Brainstormingxpinjection/test-driven-spring-boot11254 repos~2.6kAutomated safety check: PassMIT
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
PPTXrvdbreemen/OTGW-firmware20734 repos~2.3kAutomated safety check: PassProprietary
XLSXrvdbreemen/OTGW-firmware20735 repos~2.9kAutomated safety check: PassProprietary
Android API Diffgkd-kit/gkd43k—~796Automated safety check: PassGPL-3.0

Similar skills

  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 54 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • PPTX

    rvdbreemen/OTGW-firmware

    Use this skill any time a .pptx file is involved in any way — as input, output, or both.

    207 GitHub starsUsed in 34 repos~2.3k tokens
    Documents & OfficeAuto-check passed
  • XLSX

    rvdbreemen/OTGW-firmware

    Use this skill any time a spreadsheet file is the primary input or output.

    207 GitHub starsUsed in 35 repos~2.9k tokens
    Documents & OfficeAuto-check passed
  • Android API Diff

    gkd-kit/gkd

    Looks up Android framework Java and AIDL APIs across versions with the android-api-diff CLI: signatures, availability, source files and hidden-API access code.

    43k GitHub stars~796 tokensUpdated yesterday
    MobileAuto-check passed
  • Video Cover Image

    itwanger/toBeBetterJavaer

    Generate matched 3:4, 16:9, and 4:3 short-video cover images from toBeBetterJavaer video scripts or AI/Java technical topics.

    18k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed

More from Mojang/minecraft-creator-tools

  • Create Block

    Mojang/minecraft-creator-tools

    Create a new placeable block for a Minecraft Bedrock Edition add-on from a plain description, or change an existing one, such as a decorative, glowing, ore, crate, slab, stairs, or light-source…

    161 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Create Item

    Mojang/minecraft-creator-tools

    Create a new item for a Minecraft Bedrock Edition add-on from a plain description, or change an existing one, such as a weapon, tool, food, armor piece, throwable, or collectible, including its icon…

    161 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Create Mob

    Mojang/minecraft-creator-tools

    Create a new mob (custom entity) for a Minecraft Bedrock Edition add-on from a plain description, or change an existing one, including its health, attacks, AI behavior, taming, riding, drops, and…

    161 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Creator Tools CLI

    Mojang/minecraft-creator-tools

    Run the Minecraft Creator Tools command line (mct, the @minecraft/creator-tools npm package) for Minecraft Bedrock Edition add-ons.

    161 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Design Model

    Mojang/minecraft-creator-tools

    Design or change how things look in a Minecraft Bedrock Edition add-on - 3D models and textures for mobs, and pixel-art icons for items and textures for blocks.

    161 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

Questions about Debug Addon

What does Debug Addon do?

Find and fix problems in a Minecraft Bedrock Edition add-on (behavior packs and resource packs) using Minecraft Creator Tools validation. Debug Addon is an agent skill from Mojang/minecraft-creator-tools. Find and fix problems in a Minecraft Bedrock Edition add-on (behavior packs and resource packs) using Minecraft Creator Tools validation.

How do I install Debug Addon in Claude Code?

Run `npx skills add Mojang/minecraft-creator-tools --skill debug-addon -a claude-code`. Or copy the skill folder (plugins/minecraft/skills/debug-addon in Mojang/minecraft-creator-tools) into .claude/skills/debug-addon in your project. Claude Code loads it when a task matches its description.

How do I install Debug Addon in Codex?

Run `npx skills add Mojang/minecraft-creator-tools --skill debug-addon -a codex`. Or copy the skill folder (plugins/minecraft/skills/debug-addon in Mojang/minecraft-creator-tools) into .agents/skills/debug-addon in your project. Codex loads it when a task matches its description.

Can I use Debug Addon in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Mojang/minecraft-creator-tools --skill debug-addon -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debug-addon, .gemini/skills/debug-addon, .github/skills/debug-addon and .opencode/skills/debug-addon in your project.

What does Debug Addon need to run?

Going by SKILL.md and its folder, Debug Addon needs JavaScript for the scripts in its folder and the command-line tools its instructions call (npx and node). Our summary lists: Node.js.

Does Debug Addon access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Debug Addon safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Debug Addon use?

Debug Addon has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Debug Addon use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.1k tokens, read only when the agent opens those files.

What are the alternatives to Debug Addon?

Skills that share tags, products or a category with Debug Addon: Brainstorming (xpinjection/test-driven-spring-boot, 112 stars), DOCX (rvdbreemen/OTGW-firmware, 207 stars), PPTX (rvdbreemen/OTGW-firmware, 207 stars) and XLSX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug Addon?

Mojang (a GitHub organization) maintains it in Mojang/minecraft-creator-tools, which has 161 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 6, 2026.

Source: Mojang/minecraft-creator-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.