Skip to content

About

Visualize installed Skills and symlink status across AI agents

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

43 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,262 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skills Desktop

Visualize installed Skills and symlink status across AI agents

Test Build Lint E2E Fallow Security Socket Codecov OpenSSF Scorecard License: MIT Platform: macOS Ask DeepWiki

Skills Desktop

Skills Desktop provides a GUI to manage and monitor skills installed via npx skills add <owner/repo>. It displays the central skill repository (~/.agents/skills/) and shows symlink status for each supported AI agent.

Features

  • 75 AI Agents Supported - Auto-detects Claude Code, Cursor, Codex, Gemini CLI, and more
  • Symlink Status Visualization - Valid (✓), Broken (◐), Inaccessible (!), Missing (○) indicators
  • Customizable Dashboard - Widget-based home view with skill stats, symlink health, agent coverage, bookmarks, and quick actions — drag, resize, and arrange across multiple pages
  • 54 Themes - 34 OKLCH color themes (17 hues × light/dark) + 2 pure neutral + 18 tinted neutral
  • Background Opacity - In Settings → Appearance, choose Entire or Section and adjust backgrounds from 0–100% while text and icons stay solid. Reset restores 100%; each mode keeps its own values. See the opacity behavior and settings contract.
  • Background Gallery - In Settings → Appearance → Choose background, choose from four bundled photos, upload your own image, crop it, and apply Fill / Fit / Tile. Built-in photos and uploads work offline. Online Unsplash browsing requires provider configuration; see the verification record.
  • App Updates - Checks GitHub Releases automatically; click Download to fetch an update, then Restart Now to install it. Older automatic-download preferences do not bypass these actions. See the update flow.

Supported Agents

Agent Path
Claude Code ~/.claude/skills/
Cursor ~/.cursor/skills/
OpenAI Codex ~/.codex/skills/
Gemini CLI ~/.gemini/skills/
GitHub Copilot ~/.copilot/skills/
Cline ~/.cline/skills/
Roo Code ~/.roo/skills/
Junie ~/.junie/skills/
Devin Desktop ~/.codeium/windsurf/skills/
OpenCode ~/.config/opencode/skills/
Continue ~/.continue/skills/
...and 64 more

Installation

Download the latest release from GitHub Releases.

Architecture Download
Apple Silicon (M1/M2/M3) skills-desktop-x.x.x-arm64.dmg
Intel Mac skills-desktop-x.x.x-x64.dmg

Security

Please report vulnerabilities through the process described in SECURITY.md, not through public issues.

Skills Desktop keeps local filesystem access behind Electron preload IPC. The main and settings windows use sandboxed, context-isolated renderers with Node.js integration disabled. Main-process handlers validate IPC arguments, restrict file reads to known skills directories, restrict external links to http(s), and allow marketplace webviews only from the expected skills.sh origin.

macOS releases are built with Developer ID signing, notarization, and the hardened runtime enabled. The security posture tracked for issue #241 includes CodeQL, dependency review, production dependency audit, Socket dependency scanning, OpenSSF Scorecard, GitHub secret scanning, Dependabot security updates, SHA-pinned least-privilege Actions, and branch protection.

Browse installed skill files

Use List / Tree above Installed skills to choose cards or an expandable hierarchy. Tree opens skill folders on demand. Select a file to preview it on the right, or use arrow keys to navigate and Enter to open. Space selects an eligible skill for bulk actions; files and folders never become delete targets. Collapse all closes the hierarchy without reloading it. Search and agent/source filters work in either view, and the view choice survives restart.

Development

Prerequisites

  • macOS (the app and its E2E suite are macOS-only)
  • Node.js 26 (the exact version is pinned in .node-version)
  • pnpm, pinned by the packageManager field (corepack enable or pnpm/setup)

Setup

# Install every workspace package from the single root lockfile
pnpm install --frozen-lockfile

# Start development
pnpm dev

# Type check
pnpm typecheck

# Lint
pnpm lint

Testing

# Unit + browser tests (Vitest)
pnpm test

# Full fast gate, including Website and Electron bridge checks
pnpm validate

# E2E tests (Playwright Electron, macOS only)
# Run only after pnpm validate succeeds
pnpm test:e2e
Suite Command Runner
Unit pnpm test Vitest (Node + browser mode via *.browser.test.tsx)
E2E pnpm test:e2e Playwright Electron — boots the real app per spec, isolated HOME each test

E2E specs live in apps/desktop/e2e/spec/*.e2e.ts. The suite uses cp -al hardlink snapshots so each test starts from a fresh, populated ~/.agents/skills/ without re-running the skills CLI installer (~50 ms reset). CI runs on macos-latest (.github/workflows/e2e.yml); failures upload playwright-report/ and test-results/ as artifacts (traces + videos retained on failure).

⚠️ Hardlink caveat for spec authors. Hardlinked files share inodes across every working HOME, so in-place edits (writeFileSync over an existing SKILL.md, appendFileSync, etc.) corrupt the snapshot for every subsequent test. Safe ops only: unlink, rmdir, mkdir + writeFile of NEW paths. See apps/desktop/e2e/fixtures/isolated-home.ts:82-85 for the canonical safe-ops list.

Build

# Build for macOS (requires code signing)
APPLE_KEYCHAIN_PROFILE=skills-desktop pnpm build:mac

# Verify gallery assets, Sharp, upload ownership and CSP in both built packages
# (bundle paths are relative to apps/desktop, where electron-builder writes dist/)
pnpm test:packaged:backgrounds -- --arm64 'dist/mac-arm64/Skills Desktop.app' --x64 'dist/mac/Skills Desktop.app' --output /tmp/backgrounds.json

# Verify that the packaged window reaches the native compositor (requires Screen Recording)
pnpm test:release:macos-window

Tech Stack

Component Technology
Framework Electron 44
Frontend React 19 + TypeScript
State Redux Toolkit + @laststance/redux-storage-middleware
Styling Tailwind CSS + shadcn/ui
Build electron-vite

Project Structure

A pnpm workspace with one lockfile. Dependencies used by more than one package are declared once in the catalog: of pnpm-workspace.yaml, and sherif fails CI on version drift.

apps/
├── desktop/                 # Electron app (package name: skills-desktop)
│   ├── src/main/            #   Electron main process
│   ├── src/preload/         #   Context bridge (IPC)
│   ├── src/renderer/        #   React frontend
│   ├── src/shared/          #   Types and constants shared across processes
│   └── e2e/                 #   Playwright Electron suite
└── website/                 # Next.js site + Unsplash oRPC proxy (Vercel)
packages/
└── unsplash-contract/       # oRPC contract and limits shared by desktop and website

See ARCHITECTURE.md for how the pieces fit together.

Contributing

Contributions are welcome. Read CONTRIBUTING.md for setup, the quality gates and the pull request checklist, and follow the Code of Conduct. Report vulnerabilities privately as described in SECURITY.md.

Every pull request runs these workflows: Test, Build, TypeCheck, Lint, Format, Fallow, E2E, Security and Socket. Scorecard runs on main. Socket uses the SOCKET_SECURITY_API_TOKEN secret and skips pull requests from forks.

Related

License

MIT © Laststance.io

About

Visualize installed Skills and symlink status across AI agents

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

43 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages