raycast-extensions
Build Raycast extensions — commands, List/Form/Grid views, hooks like useFetch, AI integration, manifest. Use when the user says 'raycast extension', 'add a raycast command', or is working in a project with @raycast/api and a Raycast manifest.
How do I install this agent skill?
npx skills add https://github.com/nweii/agent-stuff --skill raycast-extensionsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides comprehensive documentation and code examples for developing Raycast extensions using React and TypeScript. It covers official UI components, API hooks, and AI integration patterns without any malicious behavior.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
- Runlayerpass
13 files scanned · No issues
What does this agent skill do?
Raycast Extension Development
Build Raycast extensions using React, TypeScript, and Node.js.
Quick Start
- Create extension: Run "Create Extension" command in Raycast
- Install & develop:
npm install && npm run dev - Edit: Modify
src/index.tsx, changes hot-reload automatically - Test: Extension appears at top of Raycast root search
Choosing a UI Primitive
| Need | Component |
|---|---|
| Searchable list of items | List |
| Image gallery/grid | Grid |
| User input collection | Form |
| Rich content display | Detail |
| Status bar presence | MenuBarExtra |
Decision Tree
-
Displaying items the user searches/filters?
- Text-focused →
List - Image-focused →
Grid
- Text-focused →
-
Collecting user input? →
Form -
Showing detailed content? →
Detail(supports markdown + metadata) -
Always-visible status bar? →
MenuBarExtra
Core Patterns
List with ActionPanel
import { ActionPanel, Action, List } from "@raycast/api";
export default function Command() {
return (
<List>
<List.Item
title="Item"
actions={
<ActionPanel>
<Action.CopyToClipboard content="Copied!" />
<Action.OpenInBrowser url="https://raycast.com" />
</ActionPanel>
}
/>
</List>
);
}
Data Fetching
import { List } from "@raycast/api";
import { useFetch } from "@raycast/utils";
export default function Command() {
const { data, isLoading } = useFetch<Item[]>("https://api.example.com/items");
return (
<List isLoading={isLoading}>
{data?.map((item) => <List.Item key={item.id} title={item.name} />)}
</List>
);
}
AI Integration
import { AI, Clipboard } from "@raycast/api";
export default async function Command() {
const answer = await AI.ask("Summarize this text");
await Clipboard.copy(answer);
}
[!NOTE] AI requires Raycast Pro. Check access with
environment.canAccess(AI).
References
For detailed documentation, see:
- UI Components: references/ui-components.md - List, Detail, Form, Grid, ActionPanel, MenuBarExtra
- Hooks & Utilities: references/hooks-utilities.md - useFetch, LocalStorage, Clipboard, OAuth, runAppleScript
- AI API: references/ai-api.md - AI.ask, useAI, model selection, streaming
- Package Structure: references/package-structure.md - manifest, commands, preferences
Examples
Runnable examples in examples/:
| File | Pattern |
|---|---|
list-with-actions.tsx | List + ActionPanel basics |
list-with-detail.tsx | List with detail panel |
form-with-validation.tsx | Form + useForm validation |
detail-with-metadata.tsx | Detail markdown + metadata |
grid-with-images.tsx | Grid layout |
data-fetching.tsx | useFetch patterns |
ai-integration.tsx | AI.ask with streaming |
menubar-extra.tsx | MenuBarExtra interactions |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/nweii/agent-stuff/raycast-extensions">View raycast-extensions on skillZs</a>