Skip to content
Back to search

LLMSkillz

Desktop manager for editing, organizing, and syncing custom LLM skills across Antigravity, Claude, and Codex targets, built with Electron and React.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/projectgloria--llmskillz/badge.svg)](/listings/projectgloria--llmskillz)

HTML

<a href="/listings/projectgloria--llmskillz"><img src="/api/listings/projectgloria--llmskillz/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

Pre-built Windows Releases

Download the latest release from the [GitHub Releases](https://github.com/projectGloria/LLMSkillz/releases) page:

- **Installer:** `LLMSkillz-<version>-setup-x64.exe` (NSIS installer with custom install directory option) - **Portable:** `LLMSkillz-<version>-portable-x64.exe` (standalone executable, no installation required) - **Checksums:** Verify downloads against `SHA256SUMS.txt` included in each release.

Run or Build from Source

Requires **Node.js 22+** and **npm**.

git clone https://github.com/projectGloria/LLMSkillz.git
cd LLMSkillz
npm install

| Command | Description | | --- | --- | | `npm run dev` | Starts the Vite dev server on `http://localhost:5173` and launches Electron against it. | | `npm run build` | Type-checks with `tsc --noEmit` and builds the renderer bundle into `dist/`. | | `npm start` | Runs `npm run build` and launches Electron using the compiled `dist/` output. | | `npm run pack` | Builds an unpacked Windows directory into `release/` via `electron-builder --dir`. | | `npm run dist` | Builds Windows NSIS installer and portable `.exe` artifacts into `release/`. |

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.

README.md · README · 138 lines
  1. <div align="center">
  2. <img src="LLMSkillz.png" width="110" alt="LLMSkillz icon" />
  3. # LLMSkillz
  4. Desktop manager for authoring, organizing, and syncing custom LLM skills across Antigravity, Claude, and Codex.
  5. <img src="https://img.shields.io/badge/Electron-36%20%2B%20React%2019-3B7BFF?style=flat-square" alt="Electron 36 + React 19" />
  6. <img src="https://img.shields.io/badge/version-1.0.0-2b2d34?style=flat-square" alt="Version" />
  7. <img src="https://img.shields.io/badge/platform-Windows%20x64-2b2d34?style=flat-square" alt="Platform" />
  8. <img src="https://img.shields.io/github/last-commit/projectGloria/LLMSkillz?style=flat-square&color=3B7BFF" alt="Last commit" />
  9. <br /><br />
  10. <img src="docs/assets/banner.svg" alt="LLMSkillz banner" width="100%" />
  11. <br /><br />
  12. [Features](#features) • [Screenshots](#screenshots) • [How it works](#how-it-works) • [Installation](#installation) • [Usage](#usage) • [Configuration](#configuration) • [Troubleshooting](#troubleshooting)
  13. </div>
  14. ## About
  15. LLMSkillz is a local-first Electron + React + TypeScript desktop application that manages a folder-based library of custom LLM skills (`SKILL.md` plus supporting scripts and references) and synchronizes them to installed LLM client directories. All filesystem operations run in the Electron main process over context-isolated IPC (`contextIsolation: true`, `nodeIntegration: false`) with zero external network calls or cloud accounts required.
  16. ## Features
  17. - **Skill Library & Section Grouping** — Scans your source skills directory and loads each folder containing a `SKILL.md` (case-insensitive). Nested category folders automatically appear as collapsible sections in the sidebar with live text filtering across name, folder, section, and description.
  18. - **Markdown Authoring & Live Preview** — Edit `SKILL.md` and supporting files (e.g., `scripts/`, `references/`) in **Read**, **Split**, or **Edit** mode with sanitized GFM rendering (`marked` + `DOMPurify`), parsed YAML frontmatter display, unsaved-change indicators, and `Ctrl+S` saving.
  19. - **SHA-256 Drift Detection** — Computes a recursive SHA-256 digest of every file in each skill folder and compares it against each target directory to report `installed` (Synced), `outdated` (Modified locally), or `not-installed`.
  20. - **Per-Target & Batch Installation** — Install, update, or uninstall a skill for individual targets (Antigravity App/CLI, Claude App/CLI, Codex App/CLI, or custom targets), push a single skill to all enabled targets at once, or sync your entire library to a target from the **Targets & Sync** view.
  21. - **Untracked Skill Import** — Detects skill folders that exist inside a target directory but not yet in your library, allowing one-click import back into your source library.
  22. - **Custom Targets & Configurable Library Path** — Point LLMSkillz at any local skills folder, add arbitrary custom target paths, toggle targets on or off, open any folder directly in File Explorer, or reset target paths to defaults.
  23. ## Screenshots
  24. <p align="center">
  25. <img src="docs/assets/screenshot-main.png" alt="LLMSkillz workspace with split Markdown editor and target install strip" width="760" />
  26. <br />
  27. <em>Skill Workspace in Split mode showing YAML frontmatter preview, Markdown rendering, and per-target SHA-256 sync status.</em>
  28. </p>
  29. <p align="center">
  30. <img src="docs/assets/screenshot-targets.png" alt="LLMSkillz Targets and Sync view" width="760" />
  31. <br />
  32. <em>Targets &amp; Sync view for configuring Antigravity, Claude, and Codex directories, running bulk syncs, and importing untracked skills.</em>
  33. </p>
  34. ## How it works
  35. ```mermaid
  36. flowchart LR
  37. A["Source Skills Library (skills/)"] --> B["Main Process Scanner (electron/main.cjs)"]
  38. B --> C["Parse SKILL.md Frontmatter & SHA-256 Hash"]
  39. C --> D{"Compare Target Folder Hash"}
  40. D -- "Match" --> E["Status: Synced"]
  41. D -- "Mismatch" --> F["Status: Modified Locally"]
  42. D -- "Missing" --> G["Status: Not Installed"]
  43. E & F & G --> H["React UI via Context-Isolated IPC"]
  44. H -- "Install / Sync" --> I["Clean Copy to Target Skill Folder"]
  45. H -- "Import Untracked" --> A
  46. ```
  47. ## Installation
  48. ### Pre-built Windows Releases
  49. Download the latest release from the [GitHub Releases](https://github.com/projectGloria/LLMSkillz/releases) page:
  50. - **Installer:** `LLMSkillz-<version>-setup-x64.exe` (NSIS installer with custom install directory option)
  51. - **Portable:** `LLMSkillz-<version>-portable-x64.exe` (standalone executable, no installation required)
  52. - **Checksums:** Verify downloads against `SHA256SUMS.txt` included in each release.
  53. ### Run or Build from Source
  54. Requires **Node.js 22+** and **npm**.
  55. ```bash
  56. git clone https://github.com/projectGloria/LLMSkillz.git
  57. cd LLMSkillz
  58. npm install
  59. ```
  60. | Command | Description |
  61. | --- | --- |
  62. | `npm run dev` | Starts the Vite dev server on `http://localhost:5173` and launches Electron against it. |
  63. | `npm run build` | Type-checks with `tsc --noEmit` and builds the renderer bundle into `dist/`. |
  64. | `npm start` | Runs `npm run build` and launches Electron using the compiled `dist/` output. |
  65. | `npm run pack` | Builds an unpacked Windows directory into `release/` via `electron-builder --dir`. |
  66. | `npm run dist` | Builds Windows NSIS installer and portable `.exe` artifacts into `release/`. |
  67. ## Usage
  68. 1. **Create a skill:** Click **New Skill** in the sidebar, enter a name (the folder slug is auto-generated), an optional category section subfolder, and a description. LLMSkillz creates the folder with a pre-formatted `SKILL.md` frontmatter template.
  69. 2. **Edit & organize files:** Use the toolbar to switch between **Read**, **Split**, and **Edit** views, click **Add File** to create supporting files (such as `scripts/helper.py` or `references/guide.md`), and press `Ctrl+S` (or click **Save**) to write changes to disk.
  70. 3. **Install or update targets:** In the **Install to LLM Targets** strip at the top of the workspace, click **Install**, **Update**, or **X** (uninstall) per target, or click **Install to All** to push the skill to every enabled target.
  71. 4. **Bulk sync & import:** Open **Targets & Sync** from the bottom-left navigation to edit target paths, toggle targets, click **Sync All Skills** for a target, or click **Import** on any untracked folder found inside a target directory.
  72. ## Configuration
  73. Settings are persisted automatically to `llmskillz-config.json` inside Electron's `userData` directory (on Windows: `%APPDATA%\llmskillz\llmskillz-config.json`).
  74. ### Library Folder Layout
  75. By default, LLMSkillz uses the `skills/` directory next to the application. You can point it to any folder in **Settings → Source Skills Library**.
  76. ```text
  77. skills/
  78. ├── github-repo-readme/
  79. │ └── SKILL.md # Loaded under "General"
  80. └── devops/ # Category folder -> "devops" section in sidebar
  81. └── release-check/
  82. ├── SKILL.md
  83. └── scripts/
  84. └── verify.py
  85. ```
  86. ### Default Target Directories
  87. | Target | Provider | Type | Default Path (Windows) |
  88. | --- | --- | --- | --- |
  89. | Antigravity App | `antigravity` | `app` | `%USERPROFILE%\.gemini\antigravity\skills` |
  90. | Antigravity CLI | `antigravity` | `cli` | `%USERPROFILE%\.gemini\config\skills` |
  91. | Claude App | `claude` | `app` | `%APPDATA%\Claude\skills` |
  92. | Claude CLI | `claude` | `cli` | `%USERPROFILE%\.claude\skills` |
  93. | Codex App | `codex` | `app` | `%USERPROFILE%\.codex\skills` |
  94. | Codex CLI | `codex` | `cli` | `%USERPROFILE%\.agents\skills` |
  95. You can add additional custom targets or restore the defaults at any time from **Settings**.
  96. ## Troubleshooting
  97. - **Target shows "Will Create on Install":** The target's base directory does not exist on disk yet. Clicking **Install** or **Sync All Skills** automatically creates the directory tree before copying the skill folder.
  98. - **Skill stays installed after deleting from the library:** Deleting a skill from your library only removes the source folder inside your library path; installed copies inside LLM target folders are intentionally left untouched. Use the target's uninstall button (`X`) first if you want to remove deployed copies.
  99. - **Hidden files or directories are not synced:** Directories named `.git`, `node_modules`, `.DS_Store`, `__pycache__`, and `.vscode` (as well as dot-prefixed skill folders) are ignored during scanning, hashing, and copying.
  100. - **Changes made outside LLMSkillz do not appear immediately:** Click the refresh icon in the sidebar header to rescan the library and all configured target directories.

Ratings and comments

Sign in to rate this skill.

Sign in

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