Skip to content
Back to search

gentleface

MarketplaceWorks with Claude CodeGitHub

Gentleface icons for coding agents: free, pixel-aligned icons by meaning, as code for any stack.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/andaja/gentleface-icons with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/andaja/gentleface-icons'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/andaja--gentleface-icons/badge.svg)](/listings/andaja--gentleface-icons)

HTML

<a href="/listings/andaja--gentleface-icons"><img src="/api/listings/andaja--gentleface-icons/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

| | | |---|---| | SVG, 16 px | `npm i @gentleface/icons` | | SVG, 20 / 24 px | `npm i @gentleface/icons-20`, `@gentleface/icons-24` (`-24-light`, `-24-bold`) | | React | `npm i @gentleface/react` (`@gentleface/react-20`, `@gentleface/react-24`) | | Animated | `npm i @gentleface/animated` | | CDN | `https://cdn.jsdelivr.net/npm/@gentleface/icons@0.7/svg/line-round/16/bell.svg` | | Iconify | `@gentleface/icons/iconify.json`, prefix `gentleface` | | Claude Code | `/plugin marketplace add andaja/gentleface-icons`, then `/plugin install gentleface@gentleface` |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 28 lines
  1. {
  2. "name": "gentleface",
  3. "owner": {
  4. "name": "Alexander Kiselev",
  5. "url": "https://andaja.com"
  6. },
  7. "description": "Gentleface icons for coding agents: free, pixel-aligned icons by meaning, as code for any stack.",
  8. "plugins": [
  9. {
  10. "name": "gentleface",
  11. "source": "./plugins/gentleface",
  12. "description": "Gentleface icons for coding agents: the MCP server and the icon-picking skill.",
  13. "version": "0.1.0",
  14. "homepage": "https://gentleface.com/agents",
  15. "license": "MIT",
  16. "category": "design",
  17. "keywords": [
  18. "icons",
  19. "svg",
  20. "react",
  21. "swiftui",
  22. "compose",
  23. "mcp",
  24. "design"
  25. ]
  26. }
  27. ]
  28. }
README.md · README · 74 lines
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset=".github/preview-dark.png">
  4. <img src=".github/preview.png" alt="Gentleface icons in six styles" width="100%">
  5. </picture>
  6. </p>
  7. # Gentleface icons
  8. Free, pixel-aligned icons drawn on the 16 px grid, with separate 20 and 24 px masters. MIT.
  9. [![npm](https://img.shields.io/npm/v/@gentleface/icons?label=%40gentleface%2Ficons)](https://www.npmjs.com/package/@gentleface/icons)
  10. [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
  11. - 4,035 icons at 16 px in 6 styles: line or solid, with round, soft or sharp corners
  12. - 4,031 of them also drawn at 20 px and at 24 px in light, regular and bold
  13. - 120,954 SVGs in all, plus 1,000 animated ones
  14. - every icon documents what it means and what to use instead
  15. Browse, search and copy them at [gentleface.com](https://gentleface.com).
  16. ## Install
  17. | | |
  18. |---|---|
  19. | SVG, 16 px | `npm i @gentleface/icons` |
  20. | SVG, 20 / 24 px | `npm i @gentleface/icons-20`, `@gentleface/icons-24` (`-24-light`, `-24-bold`) |
  21. | React | `npm i @gentleface/react` (`@gentleface/react-20`, `@gentleface/react-24`) |
  22. | Animated | `npm i @gentleface/animated` |
  23. | CDN | `https://cdn.jsdelivr.net/npm/@gentleface/icons@0.7/svg/line-round/16/bell.svg` |
  24. | Iconify | `@gentleface/icons/iconify.json`, prefix `gentleface` |
  25. | Claude Code | `/plugin marketplace add andaja/gentleface-icons`, then `/plugin install gentleface@gentleface` |
  26. ## Usage
  27. ```tsx
  28. import { BellIcon } from '@gentleface/react';
  29. <BellIcon /> // 16 px, line-round
  30. <BellIcon variant="solid-sharp" size={32} />
  31. <BellIcon title="Notifications" /> // with an accessible name
  32. ```
  33. ```html
  34. <img src="https://cdn.jsdelivr.net/npm/@gentleface/icons@0.7/svg/line-round/16/bell.svg" width="16" height="16" alt="">
  35. ```
  36. The SVGs use `currentColor`. Keep each icon at its own size or an exact multiple (16, 32, 48) on whole pixels; a fractional size or position blurs it. For a 20 or 24 px UI, use the icons drawn for that grid instead of scaling the 16 px ones.
  37. ## In this repository
  38. | Path | Contents |
  39. |---|---|
  40. | `svg/16/<style>/` | 16 px icons, 4,035 per style |
  41. | `svg/20/<style>/` | 20 px masters, 4,031 per style |
  42. | `svg/24/<style>/` | 24 px masters, regular weight (1.5 px line) |
  43. | `svg/24-light/<style>/`, `svg/24-bold/<style>/` | 24 px masters, light (1 px) and bold (2 px) |
  44. | `animated/` | 1,000 animated 16 px line-round SVGs and their timings (`motions.json`) |
  45. | `icons.json` | names, categories, meanings and tags |
  46. | `plugins/gentleface/` | the Claude Code plugin: MCP server and icon-picking skill |
  47. Styles: `line-round`, `line-soft`, `line-sharp`, `solid-round`, `solid-soft`, `solid-sharp`.
  48. ## For coding agents
  49. The Claude Code plugin adds the Gentleface MCP server (search icons by meaning, get them as React, SwiftUI, Compose or SVG code) and a skill that keeps one meaning per icon across a project. Other agents: [gentleface.com/agents](https://gentleface.com/agents).
  50. ## Feedback
  51. Missing icon or a wrong meaning: [gentleface.com/feedback](https://gentleface.com/feedback). Problems with this repository or the packages: open an issue. See [CONTRIBUTING.md](CONTRIBUTING.md).
  52. ## License
  53. [MIT](LICENSE). Drawn with Claude Code; art direction by Alex Kiselev, who reviewed every icon.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.