Upgrade Simple Icons
Developmentupgrade-simple-iconsUpgrade Simple Icons is an Agent Skill for development published in the wei/socialify repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/wei/socialify/blob/HEAD/.github/skills/upgrade-simple-icons/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/upgrade-simple-icons, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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.