Raycast Script Creator - Claude Skill

A Claude Code skill that enables creating valid Raycast script-commands with proper metadata formatting and structure.

Overview

This skill helps create Raycast script-commands that integrate with the Raycast launcher, enabling quick access to custom workflows, system commands, and automation tasks on macOS.

What's Included

SKILL.md

Comprehensive instructions for creating Raycast scripts with:

• Core principles and metadata requirements
• Step-by-step creation workflow
• 6 common patterns with examples (silent, compact, fullOutput, inline modes)
• Decision tree for choosing the right configuration
• Best practices and constraints

Reference Documentation

references/raycast-metadata.md - Complete reference covering:

• All metadata fields (required and optional)
• Four output modes with detailed explanations
• Language-specific formatting examples
• Important constraints and validation rules

Template Files

assets/ - Ready-to-use templates for all supported languages:

• template.sh - Bash/Shell
• template.py - Python
• template.js - JavaScript/Node.js
• template.rb - Ruby
• template.swift - Swift
• template.applescript - AppleScript

Installation

1. Download or clone this repository
2. Copy the raycast-script-creator folder to your Claude Code skills directory:

   cp -r raycast-script-creator ~/.claude/skills/

3. Restart Claude Code or reload skills

Usage

Once installed, simply ask Claude to create a Raycast script:

• "Create a Raycast script to open my Downloads folder"
• "Make a Raycast command to launch my project in Cursor"
• "Build a script-command that shows CPU usage"
• "Add a Raycast shortcut to clear my trash"

Claude will automatically use this skill to ensure all scripts have:

• Proper metadata formatting
• Correct output mode selection
• Valid structure and syntax
• Best practices applied

Output Modes

The skill helps choose the right mode for your script:

• silent - Instant commands with minimal output
• compact - Long-running background tasks
• fullOutput - Scripts with substantial output to display
• inline - Auto-refreshing data displayed in search results

Features

• Templates for 6 programming languages
• Complete metadata reference documentation
• Common pattern examples
• Automatic validation of required fields
• Best practices enforcement
• Decision tree for configuration choices

Requirements

• Claude Code
• Raycast (for using the generated scripts)
• macOS

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Related Links

• Raycast Script Commands Repository
• Raycast Documentation