SKILL.md
readonlyread-only
name
upgrade-simple-icons
description
Upgrade simple-icons to the latest version and preserve any removed icons by sourcing them from the previous version into common/icons/customIcons.ts and updating icon mappings. Use whenever bumping or upgrading simple-icons in this repo.
Upgrade simple-icons
Workflow
- Record the current simple-icons version from
package.jsonandpnpm-lock.yaml. - Install the latest package:
pnpm add simple-icons@latest. - Reconcile icon imports:
- Review
common/icons/languageMapping.tsfor imports fromsimple-icons. - Run
pnpm lintorpnpm verifyto surface missing icon exports.
- Review
- If any previously used icon is missing after the upgrade:
- Download the previous simple-icons version (recorded in step 1) to a temporary location or install it briefly.
- Extract the icon data (
title,slug,hex,path). In simple-icons, this is available from thesi*export oricons/<slug>.jsonin the package. - Add a
custom<IconName>entry tocommon/icons/customIcons.tswith the extracted data. - Update
common/icons/languageMapping.tsto import and reference the custom icon. - Run
pnpm lint:fixto fix import ordering issues if any. - Remove any temporary dependency or scratch folder after the data is captured.
- Update relevant documentation if icon mappings or customization behavior changes.
- Run
pnpm verifybefore committing, and add a changeset for the upgrade.
You Might Also Like
Related Skills

verify
243K
Use when you want to validate changes before committing, or when you need to check all React contribution requirements.
facebook
test
243K
Use when you need to run tests for React core. Supports source, www, stable, and experimental channels.
facebook
feature-flags
243K
Use when feature flag tests fail, flags need updating, understanding @gate pragmas, debugging channel-specific test failures, or adding new flags to React.
facebook
extract-errors
243K
Use when adding new error messages to React, or seeing "unknown error code" warnings.
facebook