Skill Icons

Theme-aware tech stack icon grids for GitHub READMEs

Overview

Skill Icons is an automated GitHub Action that generates clean, modern, and theme-aware tech stack icon grids directly in your repository.

• Theme-Adaptive: Automatically switches colors and contrast to match the viewer's GitHub theme (light or dark mode).
• Self-Hosted & Reliable: Commits optimized, vectorized SVGs directly to your repo. No external server downtime, tracking, or rate limits.
• Simple Icons Catalog: Access to 3,000+ official brand icons out of the box.
• Fully Configurable: Easily tweak icon sizes, row layouts, output paths, and custom commit messages.

Usage

Installation

Copy and paste the following snippet into your .yml file.

- name: Skill Icons
  uses: emrocode/skill-icons@v1
  # Advanced configuration
  # You can customize the layout by adding specific options to the template configuration
  with:
    icon_size: # Default: 48
    per_row: # Default: 15
    out_path: # Default: assets/svgs
    tag: # Default: SKILL_ICONS
    filename: # Default: README.md
    commit_message: # Default: chore(si): update assets and docs

Permissions

permissions:
  contents: write

README

Copy and paste the markdown snippet below into your README.md file. Replace the technology names with your preferred stack.

Important

^{All technology names must match official simpleicons slugs}

### 🛠️ Tech Stack

<!-- SKILL_ICONS_START -->

css,javascript,typescript,react,nextdotjs,tailwindcss

<!-- SKILL_ICONS_END -->