Skilldeck

Skilldeck is a powerful desktop application designed for managing AI agent skill files efficiently across multiple projects and tools. Compatible with Windows, macOS, and Linux, this application addresses the common issue of fragmented skill files that often exist in different locations, formats, and versions.

Key Features

Library Management

• Create, edit, and delete skill files with intuitive YAML frontmatter, including name, description, and tags.
• Full-text search for easy retrieval of skills based on names and descriptions.
• Semantic search functionality enables users to describe their needs in plain language, returning ranked results.
• Filter skills by tags or the source tool for organized management.
• Perform bulk selections and batch actions for efficiency.
• Automatic version snapshots on every save, with the ability to view diffs and initiate one-click rollbacks.

Skill Discovery

• Scan the local machine for existing skills from various tools including Claude Code, Codex, Kiro, and more.
• Source badges clearly indicate the origin of each skill.
• Divergence detection helps identify if the same skill exists in multiple locations with contrasting content.

Deployment Capabilities

• Register any project and deploy skills directly to it.
• Ten built-in target profiles allow deployment to the correct format and location for each tool automatically, including:

  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 provides visibility on which skills are current or stale.
• Symlink mode allows deployment as symlinks instead of copies, ensuring zero-drift sync.
• Instructions-file safety preserves existing content when updating shared files.
• A simple click to undeploy skills from any project.

Sync Functionality

• Bidirectional sync enables skills edited within a project to promote changes back to the library and distribute improvements to all instances.
• Git sync allows storage of the library in any Git repository to synchronize skills across multiple machines without requiring a cloud account.

Community Engagement

• Browse and install community-driven skills through SkillsHub.
• One-click installation comes with automatic frontmatter generation for ease of use.
• Offline support ensures functionality with graceful fallbacks.

How It Works

Skilldeck operates locally, ensuring that all data remains on the user's filesystem:

• Skills library stored in ~/.skilldeck/library/
• Configuration managed through ~/.skilldeck/config.json
• Deployment records and version histories are prominently maintained.

Technology Stack

Skilldeck is built on a robust tech stack:

• Runtime: Electron 28+
• Frontend: React 18 + TypeScript
• Build System: Vite
• State Management: Zustand
• Styling Framework: Tailwind CSS
• File I/O: Node.js fs via Electron main process

Development and Contribution

Developers keen on extending Skilldeck’s capabilities can dive into its well-structured project architecture and follow the included documentation for building, testing, and enhancing features.

Skilldeck streamlines the management of AI skills, making it easier to utilize and deploy tools across various projects without losing track of versions and formats.