wei / upgrade-simple-icons

Install for your project team

Run this command in your project directory to install the skill for your entire team:

mkdir -p .claude/skills/upgrade-simple-icons && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3791" && unzip -o skill.zip -d .claude/skills/upgrade-simple-icons && rm skill.zip

New-Item -Path ".claude/skills/upgrade-simple-icons" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/3791" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".claude/skills/upgrade-simple-icons" -Force; Remove-Item "skill.zip"

Project Skills

This skill will be saved in .claude/skills/upgrade-simple-icons/ and checked into git. All team members will have access to it automatically.

Important: Please verify the skill by reviewing its instructions before using it.

Install skill for Codex

Run one of these commands to install the skill depending on your needs:

Project Local ($CWD/.codex/skills)

mkdir -p .codex/skills/upgrade-simple-icons && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3791" && unzip -o skill.zip -d .codex/skills/upgrade-simple-icons && rm skill.zip

New-Item -Path ".codex/skills/upgrade-simple-icons" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/3791" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".codex/skills/upgrade-simple-icons" -Force; Remove-Item "skill.zip"

User Global (~/.codex/skills)

mkdir -p ~/.codex/skills/upgrade-simple-icons && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3791" && unzip -o skill.zip -d ~/.codex/skills/upgrade-simple-icons && rm skill.zip

New-Item -Path "$HOME/.codex/skills/upgrade-simple-icons" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/3791" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath "$HOME/.codex/skills/upgrade-simple-icons" -Force; Remove-Item "skill.zip"

Scope	Location	Suggested Use
REPO	`$CWD/.codex/skills`	Project directory. Teams can check in skills most relevant to a working folder here.
REPO	`$CWD/../.codex/skills`	A folder above CWD. Organizations can check in skills relevant to a shared area.
REPO	`$REPO_ROOT/.codex/skills`	Top-most root folder. Relevant to everyone using the repository.
USER	`$CODEX_HOME/skills`	Personal folder (`~/.codex/skills`). Curate skills that apply to any repository.

Install skill for GitHub Copilot

Run one of these commands to install the skill depending on your needs:

Project (.github/skills)

mkdir -p .github/skills/upgrade-simple-icons && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3791" && unzip -o skill.zip -d .github/skills/upgrade-simple-icons && rm skill.zip

New-Item -Path ".github/skills/upgrade-simple-icons" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/3791" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".github/skills/upgrade-simple-icons" -Force; Remove-Item "skill.zip"

Personal (~/.copilot/skills)

mkdir -p ~/.copilot/skills/upgrade-simple-icons && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3791" && unzip -o skill.zip -d ~/.copilot/skills/upgrade-simple-icons && rm skill.zip

New-Item -Path "$HOME/.copilot/skills/upgrade-simple-icons" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/3791" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath "$HOME/.copilot/skills/upgrade-simple-icons" -Force; Remove-Item "skill.zip"

Scope	Location	Suggested Use
Project	`.github/skills/`	Repository-specific skills. Checked into git for the whole team.
Personal	`~/.copilot/skills/`	Personal skills available across all your projects.

Install skill for Google Antigravity

Run one of these commands to install the skill depending on your needs:

Workspace (.agent/skills)

mkdir -p .agent/skills/upgrade-simple-icons && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3791" && unzip -o skill.zip -d .agent/skills/upgrade-simple-icons && rm skill.zip

New-Item -Path ".agent/skills/upgrade-simple-icons" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/3791" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".agent/skills/upgrade-simple-icons" -Force; Remove-Item "skill.zip"

Global (~/.gemini/antigravity/skills)

mkdir -p ~/.gemini/antigravity/skills/upgrade-simple-icons && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3791" && unzip -o skill.zip -d ~/.gemini/antigravity/skills/upgrade-simple-icons && rm skill.zip

New-Item -Path "$HOME/.gemini/antigravity/skills/upgrade-simple-icons" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/3791" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath "$HOME/.gemini/antigravity/skills/upgrade-simple-icons" -Force; Remove-Item "skill.zip"

Scope	Location	Suggested Use
Workspace	`.agent/skills/`	Workspace-specific skills for project workflows and conventions.
Global	`~/.gemini/antigravity/skills/`	Personal skills available across all workspaces.

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.

Coding Design

0 views

0 installs

Source: https://github.com/wei/socialify/tree/master/.github/skills/upgrade-simple-icons

Skill Content

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

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.

wei / upgrade-simple-icons

Install for your project team

Download skill

Enable skills in Claude

Upload to Claude

Install skill for Codex

Install skill for GitHub Copilot

Install skill for Google Antigravity

Skill Content