Local inventory for agent skills · Open source

Your agent skills, finally in one clear place.

They’re scattered across global folders, projects, packages, and plugin caches. Tell Skillglass where it can look. It shows what every skill does, where it came from, and which copy takes effect when two share a name.

Everything stays on your machine. No account, no cloud, no telemetry. Skillglass reads by default and shows you every change before it writes.

macOS · Windows · Linux — Omarchy package candidate

Skillglass inventory showing installations, evidence and the inspector

How it works

From scattered folders to a clear inventory in three steps.

  1. 1

    Choose where to look

    Skillglass proposes roots for the runtimes it finds and labels each one writable, managed, read-only, or missing. You decide what gets scanned.

  2. 2

    Scan without changing a thing

    The scan only reads. You get the name, description, canonical path, scope, provenance, and validity of every installation it finds.

  3. 3

    Inspect first. Change when ready.

    Open any skill and see how it works. If you edit or create one, Skillglass shows the plan and exact diff before writing, then keeps a snapshot you can undo.

Capabilities

The complete picture, without the guesswork.

Find any skill fast

Search by name, description, path, or metadata. Filter by runtime, validity, provenance, source, or update state. Group only when real data supports it.

See what actually takes effect

When two skills share a name, Skillglass points to the exact file that wins in each scope and the installations left shadowed.

Catch broken structure

Check SKILL.md and its local resources statically. Imported content is never executed.

Install without surprises

Install from a folder or ZIP into an approved root. See the plan first; then Skillglass writes atomically and keeps a recoverable snapshot.

Edit with the diff in front of you

Preview, Code, and Changes work from the same observed installation. You see exactly what will change before applying it.

Undo—even after a restart

The persistent journal recovers interrupted operations and keeps undo available between sessions.

The interface

No mystery scores. Just the evidence.

Validity, provenance, and update status mean different things, so Skillglass keeps them separate. If the data is not there, it says “No data.”

Safety boundaries

Your files stay yours.

Skillglass is conservative on purpose. These are product boundaries, not features waiting to happen.

  • No activating, deactivating, or uninstalling skills. Your harness stays in charge.
  • No administrator, root, or operating-system elevation.
  • Writes happen only inside approved roots your user can modify. Everything else stays read-only.
  • Imported content is never executed. Skillglass treats it as untrusted during inspection and installation.
  • No usage telemetry and no claims it cannot prove. If it cannot be observed, it is not invented.
  • No cloud, accounts, teams, or sync. The index and recovery material stay in local application data.

Download

Build it today. Download official builds when available.

Download the source, inspect exactly what you will run, and generate the native installer for your system using the versions pinned by the project.

Official binaries, when available, will live only on GitHub Releases and include SHA256SUMS.txt and build-metadata.json.

Platforms and requirements

macOS, Windows, and Linux. Omarchy under validation.

Systems
The native matrix validates macOS, Windows, and Linux. The x86-64 Pacman package is built, inspected, and installed in a clean Arch environment; it still needs the final interface check on Omarchy with Hyprland and Wayland.
Runtimes
Codex and Agent Skills-compatible folders with a required SKILL.md. Every runtime comes in through its own adapter.
Build
Git, Node.js 24.19.x, and pnpm 11.5.x. The installer is generated natively for the system you build on.
Accessibility
The whole flow is keyboard-navigable. Display scaling, high contrast and reduced motion are supported.

Questions

Fair questions. Straight answers.

Will Skillglass change my files on its own?

No. Reading changes nothing. Every write starts with a plan you accept and ends with a recoverable snapshot and journal entry.

Does undo uninstall a skill?

No. Rollback works only for the exact, unchanged tree created by a recorded operation. It is not a general uninstaller.

Can I install from the internet?

Not yet. The MVP has no remote registry or arbitrary URLs. You install from a folder or ZIP into an approved root.

Does it generate skills with AI?

Not in this version. Agent analysis and rewriting, if they arrive, need a different product contract. Today you get a clear editor and the exact diff.

What does it store on my machine?

A SQLite index and recovery material inside your per-user application-data directory. On POSIX, the directory uses 0700 and the database 0600. Nothing is uploaded.

How much history does it keep?

The latest 30 snapshots per installation, or every snapshot from the last 90 days—whichever preserves more recoverable history. The current snapshot is never pruned.

Open source, Apache 2.0, and built in public.

Skillglass is under active development and the code is open. To propose a change, start with CONTRIBUTING. To report a vulnerability, go to SECURITY.