OpenParable
Skip to content
← Back to skills

Upgrade Simple Icons

Development
upgrade-simple-icons

Upgrade 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  1. Record the current simple-icons version from package.json and pnpm-lock.yaml.
  2. Install the latest package: pnpm add simple-icons@latest.
  3. Reconcile icon imports:
    • Review common/icons/languageMapping.ts for imports from simple-icons.
    • Run pnpm lint or pnpm verify to surface missing icon exports.
  4. 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 the si* export or icons/<slug>.json in the package.
    • Add a custom<IconName> entry to common/icons/customIcons.ts with the extracted data.
    • Update common/icons/languageMapping.ts to import and reference the custom icon.
    • Run pnpm lint:fix to fix import ordering issues if any.
    • Remove any temporary dependency or scratch folder after the data is captured.
  5. Update relevant documentation if icon mappings or customization behavior changes.
  6. Run pnpm verify before committing, and add a changeset for the upgrade.