raycast-extension-docs
Guidance for building, debugging, and publishing Raycast extensions using the Raycast documentation set. Use when Codex needs to create or modify Raycast extensions (React/TypeScript/Node), consult Raycast API reference or UI components, build AI extensions, handle manifest/lifecycle/preferences, troubleshoot issues, or prepare/publish extensions to the Raycast Store or Teams.
About this skill
This skill serves as a comprehensive guide for AI coding agents to navigate and leverage the official Raycast documentation set. It provides a structured approach for the AI to quickly locate and utilize relevant information across various sections, including basics, API reference, UI components, AI extension guidance, examples, manifest details, troubleshooting, and publishing procedures. An AI agent equipped with this skill can help developers create new Raycast extensions, modify existing ones, consult specific API references or UI components, understand manifest and lifecycle details, troubleshoot issues, and even prepare extensions for publication to the Raycast Store or private teams. It's particularly useful for quickly finding accurate, up-to-date information without manually sifting through extensive documentation. Developers would use this skill to empower their AI coding assistant to become a knowledgeable expert on Raycast extension development. It ensures the AI provides precise, documentation-backed guidance directly from the official sources, speeding up development, reducing errors, and making the AI a more effective partner in all stages of Raycast extension creation.
Best use case
The primary use case for this skill is to enable AI coding agents to act as expert guides for Raycast extension development. Developers benefit most by receiving precise, documentation-backed assistance on tasks ranging from initial setup and API usage to debugging and publishing, significantly streamlining their workflow and ensuring adherence to best practices for the Raycast platform.
Guidance for building, debugging, and publishing Raycast extensions using the Raycast documentation set. Use when Codex needs to create or modify Raycast extensions (React/TypeScript/Node), consult Raycast API reference or UI components, build AI extensions, handle manifest/lifecycle/preferences, troubleshoot issues, or prepare/publish extensions to the Raycast Store or Teams.
Users should expect precise, documentation-backed guidance or relevant code snippets for developing, debugging, and publishing Raycast extensions, efficiently resolving queries or assisting with implementation tasks.
Practical example
Example input
How do I create a new Raycast extension that uses the `List` component and fetches data from an external API?
Example output
To create a new Raycast extension, begin with `npx create-raycast-extension@latest`. For the `List` component, import it from `@raycast/api` and use it within your default function, often combined with `useState`/`useEffect` for data fetching. See `references/basics/create-extension.md` and `references/api-reference/user-interface/list.md` for detailed examples and API usage.
When to use this skill
- When creating or modifying Raycast extensions using React, TypeScript, or Node.js.
- When needing to consult Raycast API references, UI components, or AI extension guidelines.
- When troubleshooting issues with existing Raycast extensions.
- When preparing or publishing an extension to the Raycast Store or private teams.
When not to use this skill
- When working on development projects unrelated to Raycast extensions.
- When the required information is not expected to be found within the official Raycast documentation.
- When direct code implementation is needed without prior documentation consultation or conceptual guidance.
How raycast-extension-docs Compares
| Feature / Agent | raycast-extension-docs | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | easy | N/A |
Frequently Asked Questions
What does this skill do?
Guidance for building, debugging, and publishing Raycast extensions using the Raycast documentation set. Use when Codex needs to create or modify Raycast extensions (React/TypeScript/Node), consult Raycast API reference or UI components, build AI extensions, handle manifest/lifecycle/preferences, troubleshoot issues, or prepare/publish extensions to the Raycast Store or Teams.
How difficult is it to install?
The installation complexity is rated as easy. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
SKILL.md Source
# Raycast Extension Docs ## Overview Use the bundled Raycast documentation under `references/` as the source of truth for APIs, patterns, and policies. Route requests to the right section, load only the needed files, and apply the guidance to the user's task. ## Quick Routing - Start with `references/SUMMARY.md` to locate the right doc page. - Use `references/README.md` for the general introduction and platform overview. - Use `references/basics/` for step-by-step guides (getting started, create, debug, publish). - Use `references/api-reference/` for API details and component usage. - Use `references/api-reference/user-interface/` for UI components (List, Form, Detail, Action Panel, etc.). - Use `references/ai/` and `references/api-reference/ai.md` for AI extension guidance. - Use `references/examples/` for real-world extension patterns. - Use `references/information/` for terminology, manifest, lifecycle, file structure, best practices, tools, and security. - Use `references/utils-reference/` for utility helpers and patterns. - Use `references/teams/` for private/team extension workflows. - Use `references/migration/` and `references/changelog.md` for version changes and breaking updates. - Use `references/faq.md` for quick clarifications. ## Working Approach 1. Identify the user's goal and map it to the most relevant section in `references/SUMMARY.md`. 2. Open the specific doc file(s) and extract only the details needed to answer or implement. 3. Cross-check API usage against `references/api-reference/` and best practices in `references/information/best-practices.md`. 4. When building UI, verify component props and patterns in `references/api-reference/user-interface/`. 5. When shipping or collaborating, confirm publish/team steps in `references/basics/` or `references/teams/`. ## Notes - Keep answers aligned with the docs; call out when guidance is inferred or when the docs are silent. - If the user asks about behavior changes, consult `references/migration/` and `references/changelog.md`.
Related Skills
debug-nw
Debug a Nativewind v5 setup issue. Walks through common configuration problems with metro, babel, postcss, and dependencies.
Go Production Engineering
You are a Go production engineering expert. Follow this system for every Go project — from architecture decisions through production deployment. Apply phases sequentially for new projects; use individual phases as needed for existing codebases.
Database Engineering Mastery
> Complete database design, optimization, migration, and operations system. From schema design to production monitoring — covers PostgreSQL, MySQL, SQLite, and general SQL patterns.
afrexai-code-reviewer
Enterprise-grade code review agent. Reviews PRs, diffs, or code files for security vulnerabilities, performance issues, error handling gaps, architecture smells, and test coverage. Works with any language, any repo, no dependencies required.
API Documentation Generator
Generate production-ready API documentation from endpoint descriptions. Outputs OpenAPI 3.0, markdown reference docs, and SDK quickstart guides.
bili-rs
Development skill for bili-rs, a Rust CLI tool for Bilibili (B站). Use when implementing features, fixing bugs, or extending the bilibili-cli-rust codebase. Provides architecture conventions, API endpoints, coding patterns, and project-specific constraints. Triggers on tasks involving adding CLI commands, calling Bilibili APIs, handling authentication, implementing output formatting, or working with the layered cli/commands/client/payloads architecture.
Puppeteer
Automate Chrome and Chromium with Puppeteer for scraping, testing, screenshots, and browser workflows.
pharaoh
Codebase knowledge graph with 23 development workflow skills. Query architecture, dependencies, blast radius, dead code, and test coverage via MCP. Requires GitHub App installation (read-only repo access) and OAuth authentication. Connects to external MCP server at mcp.pharaoh.so.
git-commit-helper
Generate standardized git commit messages following Conventional Commits format. Use this skill when the user asks to commit code, write a commit message, or create a git commit. Enforces team conventions for type prefixes, scope naming, message length, and breaking change documentation.
ask-claude
Delegate a task to Claude Code CLI and immediately report the result back in chat. Supports persistent sessions with full context memory. Safe execution: no data exfiltration, no external calls, file operations confined to workspace. Use when the user asks to run Claude, delegate a coding task, continue a previous Claude session, or any task benefiting from Claude Code's tools (file editing, code analysis, bash, etc.).
bnbchain-mcp
Interact with the BNB Chain Model Context Protocol (MCP) server. Blocks, contracts, tokens, NFTs, wallet, Greenfield, and ERC-8004 agent tools. Use npx @bnb-chain/mcp@latest or read the official skill page.
helius-phantom
Build frontend Solana applications with Phantom Connect SDK and Helius infrastructure. Covers React, React Native, and browser SDK integration, transaction signing via Helius Sender, API key proxying, token gating, NFT minting, crypto payments, real-time updates, and secure frontend architecture.