An Agentic Skill for Raycast — helping your AI coding assistants with best practices and workflows for developing, modifying, and troubleshooting Raycast extensions (React/Node).
Equips AI agents with crucial patterns and preferences for developing within the Raycast ecosystem:
- 🏗️ Scaffolding & Setup — Best practices for duplicating or creating extensions, managing
package.json, and local dev. - 🎨 General UI & UX — Standards for form inputs, auto-closing on success with
popToRoot, and handling icon updates. - 💾 Data Fetching & State — Utilizing
@raycast/utilsanduseCachedPromisefor dynamic UI elements. - ⚙️ Automation & Local Execution — Executing AppleScript/Keyboard Maestro scripts via
child_process.execand managing the Clipboard natively. - 🔐 Preferences & Authentication — Managing required secrets and properly guiding users to configure API tokens.
- Raycast installed and running.
- Node.js and npm installed.
- Raycast API — initialized for extension development (
npx @raycast/api@latest). - An AI coding assistant that supports the Agent Skills standard (see platforms below).
This skill collection follows the Agent Skills open standard and works across all major AI coding platforms.
| Platform | Type | Installation Path | Invocation |
|---|---|---|---|
| Google Antigravity | IDE | .agent/skills/raycast/ |
Automatically invoked when relevant |
| Claude Code | CLI | ~/.claude/skills/raycast/ |
Use the Raycast skill... |
| Gemini CLI | CLI | ~/.gemini/skills/raycast/ |
Automatically invoked when relevant |
| OpenCode | IDE | ~/.config/opencode/skills/raycast/ |
skill({ name: "raycast" }) |
| Cursor IDE | IDE | .cursor/skills/raycast/ |
Mentioned in chat with @raycast |
| OpenAI Codex | CLI | ~/.codex/skills/raycast/ |
Automatically invoked when relevant |
# For Google Antigravity (project skills — place in your project's .agent folder)
git clone https://github.com/adriangrantdotorg/Raycast-Skill.git .agent/skills
# For Claude Code (global skills)
git clone https://github.com/adriangrantdotorg/Raycast-Skill.git ~/.claude/skills/raycast
# For Gemini CLI (global skills)
git clone https://github.com/adriangrantdotorg/Raycast-Skill.git ~/.gemini/skills/raycast- Download the latest release.
- Extract and copy the desired skill folder(s) to your platform's skills directory.
- Ensure each skill has a
SKILL.mdfile at its root. - If needed, restart your AI assistant or reload the workspace.
Once installed, your AI agent will automatically apply best practices when working with Raycast. Here’s an example prompt to try:
"Create a command that runs my specific Keyboard Maestro macro."
The agent will:
- Use Node's
child_process.execto runosascript. - Structure the script execution safely:
exec('osascript -e \'tell application "Keyboard Maestro Engine" to do script "MACRO_ID"\''). - Handle clipboard operations using the native
@raycast/apiClipboard utilities.
Contributions are welcome! Whether you're adding new skills, refining existing patterns, or improving documentation — your help makes this toolkit better for the whole Raycast community 🙌🏾
Quick Start for Contributors:
# Fork and clone the repository
git clone https://github.com/adriangrantdotorg/Raycast-Skill.git
cd Raycast-Skill
# Create a feature branch
git checkout -b feature/your-skill-or-fix
# Make your changes and test them with your AI agent
# Commit and push
git commit -m "Add: description of your changes"
git push origin feature/your-skill-or-fix
# Open a Pull Request on GitHub- Raycast API Docs — Official extension API reference
- Raycast Utils — Helper utilities for React hooks and more
- Agent Skills Specification — Open standard documentation
- Raycast Store — Discover what others have built
- Raycast Community — Community support and discussion
Encountered a problem or have a suggestion?
- Bug Reports: Open an issue
- Feature Requests: Request a feature