🔍✨ Raycast AI Skill

A free skill that teaches your AI coding assistant to build Raycast commands and extensions the right way, the first time.

---

⬇️ Why Install?

• ⏱️ Less time per command — it gets things right on the first try
• 💸 $0 added cost — it rides on the AI you already pay for
• 📅 Current with Raycast API 2.8.2 — not the AI's year-old memory

	😩 Without this Skill	😌 With this Skill
🔁 Tries until it works	🧪 3–5	1
📄 Code for a simple hotkey	🧪 ~200 lines	~10 lines
🛠️ Build steps	npm install + build	none
🪙 AI usage burned on retries	🧪 ~4×	1×

_{🧪 estimate}

---

✨ Features

Before writing code, the AI picks the lightest option that works: a built-in Quicklink or Snippet, a one-file Script Command, or a full Extension.

• 📜 Script Commands that don't hang — every @raycast.* setting right, including traps like a hidden SSH password prompt
• 🎨 Extensions that feel native — keyboard-driven lists, self-closing forms, menu bar items, background refresh
• ⚡ Instant, flicker-free data — the right @raycast/utils hook for each job
• 🔐 Secure tokens and sign-in — encrypted preferences and built-in OAuth for GitHub, Linear and Slack
• 🤖 Raycast AI tools — tools Raycast AI can call for you, with evals
• 🩺 Debugging that finds the real error — reads Raycast's own logs, like dev extensions dropped after the v2 upgrade
• 🔄 Stays current on its own — checks Raycast's npm releases, docs and manual when it loads

---

🚀 Installation

Needs Raycast and an AI assistant that supports Agent Skills. Full Extensions also need Node.js 22.22.2+; the freshness check uses Python 3.

git clone https://github.com/adriangrantdotorg/Raycast-AI-Skill.git /tmp/Raycast-AI-Skill
cp -R /tmp/Raycast-AI-Skill/skills/raycast ~/.claude/skills/raycast   # Claude Code
cp -R /tmp/Raycast-AI-Skill/skills/raycast ~/.cursor/skills/raycast   # Cursor
cp -R /tmp/Raycast-AI-Skill/skills/raycast ~/.agents/skills/raycast   # ChatGPT & Codex

Platform	Skills folder
Claude Code	~/.claude/skills/
Cursor	~/.cursor/skills/
ChatGPT & Codex	~/.agents/skills/

Keep the folder named raycast; tools skip a skill whose folder name doesn't match its name.

---

💡 Usage

Describe what you want; the skill kicks in on its own.

You say	The skill makes
"Make a Raycast command that wakes my Mac Mini over the network."	A Script Command in silent mode that shows a clear error toast if it fails
"Build a Raycast extension that adds a task to my Notion database, with a tag picker."	An Extension with the token stored securely, cached tags, and a form that closes when saved
"My extensions disappeared after updating to Raycast 2."	A fix that finds the dropped ones in Raycast's logs and re-imports each

---

_{Built with ❤️ for the Raycast community & everyone who'd rather press a hotkey than click ✌🏾}