Adoption

Agent Skills are supported by leading AI development tools.

VS Code Gemini CLI GitHub Goose Amp Cursor Claude Code Letta OpenCode Claude OpenAI Codex Factory VS Code Gemini CLI GitHub Goose Amp Cursor Claude Code Letta OpenCode Claude OpenAI Codex Factory

kangarko/chat-formatting

Name: chat-formatting
Author: kangarko

projects/chatcontrol/skills/chat-formatting/SKILL.md

npx skillsauth add kangarko/ai-support chat-formatting

Clean

TrivyContainer and dependency vulnerability scanner

Clean

SemgrepStatic code analysis for vulnerabilities

Clean

mcp-scan (Snyk)Model Context Protocol security validation

Skipped

Snyk (dep)Open source security scanning

Skipped

Socket.devSupply chain security analysis

Skipped

VirusTotalMulti-engine malware detection

Skipped

CrowdStrikeAdvanced threat intelligence

Skipped

OSV-ScannerOpen Source Vulnerability database check

Skipped

OWASP Dep-Check

Chat Formatting Troubleshooting

Common Mistakes

Gradients are "unsafe" — MiniMessage tags inside Message break gradient rendering. Use gradients only on plain text without inner color/format tags
Only ONE Run_Command per format part — Minecraft protocol limitation. Split into separate Parts if multiple click commands are needed
Hover max 21 chars pre-1.13 — older versions truncate hover text. Use shorter text for compatibility
{player_prefix+} vs {player_prefix} — the + variant includes a trailing space. Without +, there's no separator between prefix and name
Message: does NOT execute commands — it only displays text. Users sometimes put /chc a image ... inside a Message: value expecting it to render images — it will print the command text literally. To show images in format parts, use the dedicated image keys below

Images in Format Parts

Format parts support showing images alongside text using these keys:

| Key | Purpose | Example | |-----|---------|--------| | Image_File | Image from the images/ folder | creeper-head.png | | Image_Head | Player head from avatar API | "{player}" or "Herobrine" | | Image_Url | Image from a remote URL | "https://example.com/logo.png" | | Image_Height | Height in chat lines (default: 8, min: 2) | 10 | | Image_Type | Filler character style | BLOCK, DARK_SHADE, MEDIUM_SHADE, LIGHT_SHADE |

Only one image source allowed per part — you cannot combine Image_File, Image_Head, and Image_Url in the same part.

Example — player head image in a MOTD format:

Parts:
  Welcome:
    Message:
    - " Welcome back to MyServer {player}"
    - " Your return is appreciated!"
    Image_Head: "{player_name}"
    Image_Height: 10

Example — static image from file:

Parts:
  Logo:
    Message: "Welcome to our server!"
    Image_File: "creeper-head.png"
    Image_Height: 8

The /chc a image <file> <height> <message> command is for one-time broadcast announcements only — it cannot be used inside format files.

Inline Player Heads and Sprites via MiniMessage (`<head:>` / `<sprite:>`)

Foundation ships Adventure 5.0.0, which adds two standard MiniMessage tags that work anywhere a format Message (or rule rewrite) is parsed: <head:name|uuid|texture[:outer_layer]> and <sprite:[atlas:]sprite>. They render as native vanilla "object" chat components, so they need a client on MC 1.21.9+. On older clients they fall back to plain text.

These are NOT custom Foundation/ChatControl resolvers, they come from TagResolver.standard(). So:

<head:Notch> inline in a chat format Message renders Notch's head next to the text on supported clients. Different rendering from Image_Head (the format-part key), which draws an 8-line ASCII block from the skin texture and only sits beside text, not inside it.
Players need chatcontrol.tag.action.head to use <head:> themselves (see Colors.hasPermissionForTag). Same pattern applies to <sprite>, <click>, <hover>, etc.
Because these are real standard tags, an unknown-tag rule rewrite like [head:player] -> <head:player> works — the previously raised concern that <head> "gets dropped silently by MiniMessage" is wrong on Adventure 4.25.0+.

When asked whether a MiniMessage tag exists, do not assume from memory. Check the current Adventure standard tag list (https://docs.papermc.io/adventure/minimessage/format/) — the standard set grew in 2025 (pride, sprite, head, shadow).

kangarko/chat-formatting

projects/chatcontrol/skills/chat-formatting/SKILL.md

Troubleshooting format display, hover/click events, gradients, images in formats, and color permissions

tools

Updated May 13, 2026

$ install --global

skillsauth

npx skillsauth add kangarko/ai-support chat-formatting

Install this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.

Security Scan Results

3 of 9 scanners reported clean

Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.

Scanners Passed

Scanners in report

Clean

TrivyContainer and dependency vulnerability scanner

95%

Clean

SemgrepStatic code analysis for vulnerabilities

95%

Clean

mcp-scan (Snyk)Model Context Protocol security validation

95%

Skipped

Snyk (dep)Open source security scanning

50%

Skipped

Socket.devSupply chain security analysis

50%

Skipped

VirusTotalMulti-engine malware detection

50%

Skipped

CrowdStrikeAdvanced threat intelligence

50%

Skipped

OSV-ScannerOpen Source Vulnerability database check

50%

Skipped

OWASP Dep-Check

50%

Last scanned: May 13, 2026, 7:17 AM243.8s1 file scanned

SKILL.md

name:: chat-formatting
description:: Troubleshooting format display, hover/click events, gradients, images in formats, and color permissions

Chat Formatting Troubleshooting

Common Mistakes

Gradients are "unsafe" — MiniMessage tags inside Message break gradient rendering. Use gradients only on plain text without inner color/format tags
Only ONE Run_Command per format part — Minecraft protocol limitation. Split into separate Parts if multiple click commands are needed
Hover max 21 chars pre-1.13 — older versions truncate hover text. Use shorter text for compatibility
{player_prefix+} vs {player_prefix} — the + variant includes a trailing space. Without +, there's no separator between prefix and name
Message: does NOT execute commands — it only displays text. Users sometimes put /chc a image ... inside a Message: value expecting it to render images — it will print the command text literally. To show images in format parts, use the dedicated image keys below

Images in Format Parts

Format parts support showing images alongside text using these keys:

Only one image source allowed per part — you cannot combine Image_File, Image_Head, and Image_Url in the same part.

Example — player head image in a MOTD format:

Parts:
  Welcome:
    Message:
    - " Welcome back to MyServer {player}"
    - " Your return is appreciated!"
    Image_Head: "{player_name}"
    Image_Height: 10

Example — static image from file:

Parts:
  Logo:
    Message: "Welcome to our server!"
    Image_File: "creeper-head.png"
    Image_Height: 8

The /chc a image <file> <height> <message> command is for one-time broadcast announcements only — it cannot be used inside format files.

Inline Player Heads and Sprites via MiniMessage (`<head:>` / `<sprite:>`)

These are NOT custom Foundation/ChatControl resolvers, they come from TagResolver.standard(). So:

<head:Notch> inline in a chat format Message renders Notch's head next to the text on supported clients. Different rendering from Image_Head (the format-part key), which draws an 8-line ASCII block from the skin texture and only sits beside text, not inside it.
Players need chatcontrol.tag.action.head to use <head:> themselves (see Colors.hasPermissionForTag). Same pattern applies to <sprite>, <click>, <hover>, etc.
Because these are real standard tags, an unknown-tag rule rewrite like [head:player] -> <head:player> works — the previously raised concern that <head> "gets dropped silently by MiniMessage" is wrong on Adventure 4.25.0+.

Related Skills

kangarko/snowmen

development

VerifiedTrustedCommunity

Troubleshooting snowman protection, Psycho hostile snowmen, and mob transformation

SKILL.mdUpdated Apr 18, 2026

kangarko/snow-weather

data-ai

VerifiedTrustedCommunity

Troubleshooting snow particles, terrain generation, weather control, and performance issues

SKILL.mdUpdated Apr 18, 2026

kangarko/snow-weather

kangarko/commands

tools

VerifiedTrustedCommunity

Troubleshooting Winter commands and platform compatibility

SKILL.mdUpdated Apr 18, 2026

kangarko/chests

content-media

VerifiedTrustedCommunity

Troubleshooting Gift, Dated, and Timed chest issues

SKILL.mdUpdated Apr 18, 2026

Download

For Claude Desktop. Download once, then upload the file in the app — no terminal needed.

Need help? View full Cowork setup guide →

Install manually

Choose your platform

# Clone the repo
git clone https://github.com/kangarko/ai-support.git

# Copy into Claude Code skills folder (global)
cp -r ai-support/projects/chatcontrol/skills/chat-formatting ~/.claude/skills/

Claude Code Skills — official skills path docs.

Repository

kangarko/ai-support

Compatible with

Claude Code

OpenAI Codex CLI

ChatGPT

Adoption

kangarko/chat-formatting

$ install --global

Security Scan Results

SKILL.md

Chat Formatting Troubleshooting

Common Mistakes

Images in Format Parts

Inline Player Heads and Sprites via MiniMessage (<head:> / <sprite:>)

Related Skills

kangarko/snowmen

kangarko/snow-weather

kangarko/commands

kangarko/chests

kangarko/chat-formatting

$ install --global

Security Scan Results

SKILL.md

Chat Formatting Troubleshooting

Common Mistakes

Images in Format Parts

Inline Player Heads and Sprites via MiniMessage (<head:> / <sprite:>)

Related Skills

kangarko/snowmen

kangarko/snow-weather

kangarko/commands

kangarko/chests

Inline Player Heads and Sprites via MiniMessage (`<head:>` / `<sprite:>`)

Inline Player Heads and Sprites via MiniMessage (`<head:>` / `<sprite:>`)