SkillLauncher

A lightweight macOS launcher for Claude Code Skills. Press Option+Space to quickly search and execute your Skills with real-time streaming output.

Features

• Global Hotkey - Option+Space to summon from anywhere
• Smart Search - Filter Skills by name or description
• Streaming Output - See Claude’s response character by character
• Recent Skills - Frequently used Skills appear first
• Native macOS - Built with Swift & SwiftUI, minimal resource usage

Requirements

• macOS 14.0 (Sonoma) or later
• Claude Code CLI installed
• Skills configured in ~/.claude/skills/

Installation

Build from Source

git clone https://github.com/Ceeon/SkillLauncher.git
cd SkillLauncher
swift build -c release

The binary will be at .build/release/SkillLauncher.

Run

# Run directly
.build/release/SkillLauncher

# Or copy to Applications
cp .build/release/SkillLauncher /Applications/

The app runs in the menu bar (look for the command icon).

Usage

Example

1. Press Option+Space
2. Type gem to filter skills
3. Press Tab to autocomplete: /gemini-image
4. Add your prompt: /gemini-image a cat wearing sunglasses
5. Press Enter and watch the streaming response

How It Works

SkillLauncher scans ~/.claude/skills/ for directories containing SKILL.md files. It parses the YAML frontmatter to extract skill names and descriptions.

When you execute a command, it runs:

claude -p "your command" --output-format stream-json --verbose --include-partial-messages

The streaming JSON output is parsed in real-time to display Claude’s response as it generates.

Configuration

Skills are automatically discovered from ~/.claude/skills/. Each skill should have a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: A brief description of what this skill does
---

# Skill Instructions

Your skill prompt here...

Project Structure

SkillLauncher/
├── Package.swift                    # Swift Package Manager config
├── Sources/SkillLauncher/
│   └── App.swift                    # Main application (~500 lines)
└── README.md

Dependencies

• HotKey - Global keyboard shortcuts
• Yams - YAML parsing

Troubleshooting

Hotkey not working?

Grant accessibility permissions in System Settings > Privacy & Security > Accessibility.

Claude CLI not found?

Ensure Claude CLI is installed. SkillLauncher looks for it in: