raycast-extensions

What This Skill Does

The raycast-extensions skill equips OpenClaw with the capability to architect, develop, and maintain high-performance extensions for Raycast. Leveraging React, TypeScript, and the comprehensive Raycast API, this skill allows the agent to build sophisticated user interfaces ranging from searchable List and Grid views to interactive Form components and rich Detail markdown views. It acts as an expert-level co-pilot, ensuring adherence to documentation stored in the repo's references/api/ directory.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/xaif/raycast

Ensure that you have the Raycast development environment pre-configured on your system to allow the agent to interface with your local files effectively.

Use Cases

This skill is designed for developers and power users looking to automate workflows within their Raycast environment. Use cases include:

1. Building custom search tools for internal company documentation or local databases.
2. Creating data entry forms that sync directly with persistent LocalStorage or transient Cache layers.
3. Developing interactive dashboard extensions that display real-time information via Detail or Grid layouts.
4. Implementing AI-powered features using AI.ask and showToast feedback loops to improve user productivity.

Example Prompts

1. "Create a new Raycast List extension that fetches my recent GitHub notifications and displays them with a summary subtitle."
2. "Update my existing form extension to include a date picker and ensure the submitted values are saved to LocalStorage."
3. "Help me debug this Raycast extension; the Detail component isn't rendering the markdown correctly and it's throwing a toast error on mount."

Tips & Limitations

• Source of Truth: Always refer to the references/api/*.md files. If the agent isn't sure about an API parameter, force it to read the specific reference file first.
• Feedback First: Always prioritize showToast for user feedback. Only use showHUD for transient status updates.
• Environment Safety: Before invoking AI.ask or BrowserExtension methods, the agent must check environment.canAccess to prevent runtime crashes.
• Performance: Use Cache for transient data fetching to keep the UI snappy. The extension development lifecycle relies heavily on React component state, so keep your components modular to simplify maintenance.