A desktop app for managing AI agent skill files across projects and tools.
Works on Windows, macOS, and Linux.
You spent an hour writing the perfect code review skill. It lives somewhere in ~/projects/old-app/.claude/skills/. Your new project doesn't have it. Your Cursor setup has a different version. Your Codex project has none at all.
Every AI coding tool wants its own file in its own format in its own location. CLAUDE.md. AGENTS.md. .cursor/rules/*.mdc. .windsurfrules. They diverge the moment you copy them. You lose track of which version is canonical. You rebuild from scratch more than you should.
Skilldeck fixes this. One library. Every project. Every tool.
No cloud. No backend. No database. Everything lives on your local filesystem.
- Create, edit, and delete skill files with YAML frontmatter (name, description, tags)
- Full-text search across skill names and descriptions
- Semantic search — describe what you need in plain language, get ranked results
- Filter by tag or source tool
- Bulk selection and batch actions
- Automatic version snapshots on every save, with diff view and one-click rollback
- Scan your machine for existing skills from Claude Code, Codex, Kiro, Amp, Agent Protocol, Gemini, and more
- Source badges show where each skill originated
- Divergence detection when the same skill exists in multiple locations with different content
- Register any project and deploy skills to it
- 10 built-in target profiles — deploys to the right format and location for each tool automatically:
| Tool | Format | Deploys to |
|---|---|---|
| Claude Code | Skill directory | .claude/skills/ |
| Codex | Skill directory | .codex/skills/ |
| Kiro | Skill directory | .kiro/skills/ |
| Amp | Skill directory | .amp/skills/ |
| Agent Protocol | Skill directory | .agents/skills/ |
| Cursor | Rules directory | .cursor/rules/*.mdc |
| Windsurf | Instructions file | .windsurfrules |
| GitHub Copilot | Instructions file | .github/copilot-instructions.md |
| Aider | Instructions file | CONVENTIONS.md |
| OpenCode | Instructions file | AGENTS.md |
- Deployment state tracking — know at a glance which deployed skills are current and which are stale
- Symlink mode — deploy as symlinks instead of copies for zero-drift sync
- Instructions-file safety — preserves existing content when deploying to shared files like
.windsurfrules - Undeploy skills from any project with one click
- Bidirectional sync — edited a skill inside a project? Promote it back to the library and push the improvement everywhere
- Git sync — store your library in any Git repo and sync skills across machines without a cloud account
- Browse and install community skills from SkillsHub
- One-click install with automatic frontmatter generation
- Offline-aware with graceful fallback
Coming soon — the app is functional, screenshots will be added before v1.0.
Download the latest release from the Releases page. Available for Windows (.exe), macOS (.dmg), and Linux (.AppImage).
Prerequisites: Node.js 18+, npm, Git
git clone https://github.com/ali-erfan-dev/skilldeck.git
cd skilldeck
npm install
npm run electron:devThis starts the Vite dev server and launches the Electron app in development mode.
npm run buildCompiles TypeScript, builds the Vite frontend, and packages the Electron app.
Everything stays on your local filesystem:
| What | Where |
|---|---|
| Skill library | ~/.skilldeck/library/ |
| Configuration | ~/.skilldeck/config.json |
| Deployment records | ~/.skilldeck/deployments.json |
| Version history | ~/.skilldeck/versions/ |
Skills are Markdown files with optional YAML frontmatter:
---
name: scope-killer
description: "Prevents scope creep by enforcing task boundaries"
tags: [thinking, scoping]
---
# Scope Killer
When starting a new task:
1. Define the boundary before writing code
2. Flag any work that exceeds the stated scope
3. Suggest splitting oversized tasksSkills without frontmatter fall back to the first # Heading for the name and the first paragraph for the description.
When you deploy a skill to a project, Skilldeck:
- Writes the skill to the correct location and format for the project's target profile
- Records the deployment with the file hash and timestamp
- Tracks deployed version vs. library version — shows stale if they diverge
┌─────────────────────────────────┐
│ React Frontend (Vite + TS) │
│ State: Zustand │
│ Styling: Tailwind CSS │
├─────────────────────────────────┤
│ Electron Preload (contextBridge)│
├─────────────────────────────────┤
│ Electron Main Process │
│ IPC handlers per domain │
│ File I/O via Node.js fs │
└─────────────────────────────────┘
No backend. No cloud services. The renderer communicates with the main process exclusively through Electron's IPC bridge.
| Layer | Technology |
|---|---|
| Runtime | Electron 28+ |
| Frontend | React 18 + TypeScript |
| Build | Vite |
| State | Zustand |
| Styling | Tailwind CSS |
| File I/O | Node.js fs (via Electron main process) |
| IPC | Electron contextBridge |
| Semantic Search | @xenova/transformers |
| Frontmatter | gray-matter |
skilldeck/
├── electron/
│ ├── main.ts # Electron main process + IPC handlers
│ └── preload.ts # Context bridge (renderer ↔ main)
├── src/
│ ├── main.tsx # React entry
│ ├── App.tsx # Root component + view routing
│ ├── store/ # Zustand stores
│ │ ├── skillStore.ts # Skills, search, filtering, CRUD
│ │ ├── configStore.ts # App configuration
│ │ ├── deploymentStore.ts
│ │ └── syncStore.ts # Cross-tool sync
│ ├── hooks/
│ │ └── useRegistry.ts # Community registry state
│ ├── components/
│ │ ├── Sidebar.tsx
│ │ ├── SkillEditor.tsx
│ │ ├── SourceBadge.tsx
│ │ ├── RegistryCard.tsx
│ │ └── ConflictModal.tsx
│ ├── views/
│ │ ├── LibraryView.tsx
│ │ ├── ProjectsView.tsx
│ │ └── SettingsView.tsx
│ └── types/
│ └── index.ts
├── package.json
├── vite.config.ts
├── tailwind.config.js
└── tsconfig.json
npm install
npm run electron:dev # Start Vite + Electron
npm run build # TypeScript → Vite → Electron packageRefined dark utility — inspired by Linear, Raycast, and Zed. Dark background, precise typography, tight spacing, warm amber accent. Information density over whitespace.
- Skill Playground — test a skill against Claude Code or Codex without leaving the app
- A/B testing — run two skill versions against the same prompt, pick the winner
- Behavioral diff — see exactly what changed between deployed and library versions
Skilldeck was built entirely by AI agents (Claude Code) using a harness engineering methodology — a structured system of ground truth files, verification tests, regression gates, and feature intake protocols that kept the agents reliable across weeks of autonomous sessions.
The harness is documented in two articles:
- Instructions Are Not a Harness — the story: three failure modes, the regression problem, what actually broke
- The Six-Component Harness — the framework: a reusable template for building with AI agents
The harness files (feature_list.json, system-contract.json, init.sh, verify.spec.ts, check-invariants.js) are included in the repository.
MIT