chore: Update agent skills

[LinKCoding]

Overview

Improves the Gamut agent-tools skills (the SKILL.md guides that drive AI-assisted code review and development against the Gamut design system) — adding new skills, fixing stale documentation, and closing gaps found while eval-testing the existing skills against real PR feedback.

• Adds Check 3d (styled(GamutComponent) bypassing system props) to gamut-review, including Step 4 (detects padding/margin/etc. used instead of their scale-aware alias like p/m inside css(), which silently skips token/rem conversion) and Step 5 (<Box display="flex">/<Box display="grid"> → recommends FlexBox/GridBox instead)
• Adds Check 6 (bespoke component duplication) to gamut-review — a heuristic, always-⚠ check for hand-rolled widgets that duplicate an existing Gamut component
• Adds gamut-component-first/SKILL.md (new) — a decision table and signals for checking existing Gamut components before building bespoke ones
• Adds gamut-modal/SKILL.md (new) — Modal vs Dialog composition guidance, dismiss/focus-trap patterns, and stacking order
• Adds gamut-z-index/SKILL.md (new) — z-index token scale and a stacking-component reference, cross-referenced with gamut-modal
• Updates gamut-system-props/SKILL.md and gamut-style-utilities/SKILL.md with the styled()-wrapper anti-pattern, correct background gradient-prop usage, semantic vs. fixed color-token guidance, and a scale-verification table
• Adds a Radio/RadioGroup section to gamut-forms/SKILL.md
• Fixes stale "light mode only" claims in DESIGN.LXStudio.md and DESIGN.Percipio.md — both themes actually inherit dark mode unmodified from Core since their theme definitions only override light
• Adds cross-references to the new gamut-modal/gamut-z-index skills from gamut-accessibility, gamut-datalist, gamut-datatable, and gamut-menu
• Adds evals/evals.json test cases for gamut-review, gamut-system-props, gamut-style-utilities, and gamut-component-first used to benchmark these skills

PR Checklist

• Related to designs:
• Related to JIRA ticket: GMT-1676
• Version plan added/updated (or not needed)
• I have run this code to verify it works
• This PR includes unit tests for the code change
• This PR includes testing instructions tests for the code change
• The alpha package of this PR is passing end-to-end tests in all relevant Codecademy repositories

Testing Instructions

Don't make me tap the sign.

1. Check over the JIRA ticket
2. See that the skills have been updated to address the gaps
3. Check over skill changes in general and see that they make sense
4. (Optionally) check against the latest iterations and evaluations to see how these skills perform
5. ...
6. Finish and do a celebratory dance

PR Links and Envs

N/A

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 8e65af5

---

☁️ Nx Cloud last updated this comment at 2026-08-05 14:26:08 UTC

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.45%. Comparing base (093ba39) to head (8e65af5).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3400      +/-   ##
==========================================
- Coverage   90.86%   90.45%   -0.41%     
==========================================
  Files         403      275     -128     
  Lines        6681     5765     -916     
  Branches     2173     1915     -258     
==========================================
- Hits         6071     5215     -856     
+ Misses        601      541      -60     
  Partials        9        9              

Flag	Coverage Δ
main	?
pull-request	90.45% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[LinKCoding]

If this is too broad, and we'd rather add ignore comments for the examples created, I can do that instead.

[dreamwasp]

looks awesome minus the tiniest nit, wanna talk more about iteration tracking but we'll do that not on GH 🔥

[dreamwasp]

this could be list or datalist, bulk comparison i'd say DataTable and DataList

[dreamwasp]

this looks good to me - would be nice to have a README in skills to explain how to run the evals + other information like that but i'm fine with that coming in follow up PR

[github-actions]

🚀 Styleguide deploy preview ready!

Preview URL: https://6a7348b41660651b66158941--gamut-preview.netlify.app
Deploy Logs: https://app.netlify.com/projects/gamut-preview/deploys/6a7348b41660651b66158941

[codecademydev]

📬 Published Alpha Packages:

Package	Version	npm	Diff
@codecademy/gamut	72.5.1-alpha.16660a.0	npm	diff
@codecademy/gamut-icons	9.57.12-alpha.16660a.0	npm	diff
@codecademy/gamut-illustrations	0.58.17-alpha.16660a.0	npm	diff
@codecademy/gamut-kit	3.0.14-alpha.16660a.0	npm	diff
@codecademy/gamut-patterns	0.10.36-alpha.16660a.0	npm	diff
@codecademy/gamut-styles	20.1.1-alpha.16660a.0	npm	diff
@codecademy/gamut-tests	6.0.7-alpha.16660a.0	npm	diff
@codecademy/variance	0.26.2-alpha.16660a.0	npm	diff
eslint-plugin-gamut	2.4.4-alpha.16660a.0	npm	diff