---
name: jetbrains-jewel
description: "Jewel UI: build, audit, Markdown, Swing interop, PRs and releases."
license: "NOASSERTION"
metadata:
  decimalai-skill-id: "053eac3b-6962-4d37-8400-0f51b4e0f650"
  decimalai-version-id: "1525ed1e-0715-4987-9f04-a179a3194d61"
  decimalai-version: "2"
  decimalai-body-sha256: "1cd2d9e3069ee20cf745a9067e05393d08c4e4ff5f94a79d87d9a4c9b1ee2bbb"
  decimalai-name: "jetbrains/jewel"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "frontend"
  decimalai-source: "https://app.decimal.ai/s/jetbrains-jewel@2/SKILL.md"
---
<!-- Generated by community/.ai/render-guides.mjs; edit community/.agents/skills/jewel/SKILL.md -->

# Jewel

Each part of this skill is a guide. Open the guide that matches the task:

- Build UI with Jewel components and themes: [ui](ui/GUIDE.md).
- Audit Jewel UI theming and idioms: [ui-audit](ui-audit/GUIDE.md).
- Embed Jewel Compose UI in Swing: [swing-interop](swing-interop/GUIDE.md).
- Build or debug Jewel Markdown parsing, rendering, and styling: [markdown](markdown/GUIDE.md).
- Prepare a Jewel PR or a release: the section below.

## PR and release preparation

Both workflows are interactive checklists. Work through one step at a time, report the result of each step, and stop
to ask the user before you move on when a check fails.

Check the [`platform/jewel/docs`](../../../platform/jewel/docs) folder for the process guides:
- [`pr-guide.md`](../../../platform/jewel/docs/pr-guide.md) — PR conventions, commit message format, release notes template
- [`releasing-guide.md`](../../../platform/jewel/docs/releasing-guide.md) — full release process, cherry-pick workflow, publishing validation
- [`api-compatibility.md`](../../../platform/jewel/docs/api-compatibility.md) — Metalava API dump validation and update workflow

- **Prepare a pull request:** follow [pull-request.md](release/references/pull-request.md). It validates the commit, runs the
  local CI checks, drafts the release notes entry, and creates the PR with `release/scripts/validate_pr_body.py` and
  `release/scripts/suggest_reviewers.py`.
- **Prepare a release:** follow [release.md](release/references/release.md). It covers the version bumps, the checks, the
  release notes, the cherry-picks to the release branches, the artifact validation, and the tagging.