# Raycast AI Command

> Use this skill when the user wants to create, improve, or troubleshoot a paste-ready prompt for a Raycast AI Command, especially one that uses Dynamic Placeholders such as {selection}, {argument}, {clipboard}, or {browser-tab}. Apply for vague requests like "make a Raycast command that..." and ask targeted questions when missing details would materially reduce prompt quality.

- Skill: `tdkn/raycast-ai-command` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tdkn/raycast-ai-command`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tdkn/raycast-ai-command/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tdkn (https://skillmd.com/u/tdkn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tdkn/raycast-ai-command

---


# Raycast AI Command

## Overview

Create concise, reliable prompts for Raycast AI Commands. The primary
deliverable is an English prompt that the user can paste into the **Prompt**
field of Raycast's Create AI Command form.

Keep the skill lightweight: use this file for the workflow and read
`references/ai-command.md` only when placeholder syntax,
Raycast settings, or examples are needed.

## Workflow

1. Clarify the command's job.
   - Identify the input source: selected text, clipboard, focused browser tab,
     runtime arguments, or AI Extension output.
   - Identify the transformation, audience, tone, language, and expected output
     shape.
   - Ask up to three focused questions when the request is too ambiguous to
     produce a durable command. If a reasonable default is obvious, proceed and
     state the assumption briefly.

2. Choose Raycast context deliberately.
   - Prefer `{selection}` for commands that operate on highlighted text.
   - Use `{argument name="..."}` for values the user should provide at runtime;
     keep to Raycast's maximum of three different arguments.
   - Use `{browser-tab}` only when the command should read the focused browser
     tab and the Browser Extension requirement is acceptable.
   - Read `references/ai-command.md` before using less common
     placeholders, modifiers, browser-tab selectors, or AI Extension patterns.

3. Draft the Raycast prompt in English.
   - Make it self-contained; it should still work weeks later without this
     conversation.
   - Name the input source explicitly before the placeholder.
   - Include only constraints that improve repeatable behavior: scope, tone,
     output format, preservation rules, and fallback behavior.
   - For in-place rewrite commands, usually request only the final replacement
     text so Raycast can paste or apply it cleanly.

4. Return a copy-friendly result.
   - Put the prompt first, in a plain text code block.
   - Add optional Raycast form suggestions only when useful: command name,
     placeholder choices, model/creativity notes, tags, or whether to enable
     Highlight Editing Changes.
   - Keep explanations outside the prompt short and in the conversation
     language; keep the prompt itself in English.

## Prompt Shape

Use this shape as a default, then trim unnecessary parts:

```text
You are [role].

Use the following [input source]:
{selection}

Task:
- [specific transformation]
- [important constraints]
- [output format]

If the input is empty or unusable, reply with one concise sentence explaining what input is needed.
```

Adapt the placeholder and labels to the user's command. Remove the role line
when it adds no useful behavior.

## Quality Checklist

- The generated Raycast prompt is in English.
- The prompt is paste-ready for the Raycast **Prompt** field.
- Dynamic Placeholders are valid for AI Commands and use exact Raycast syntax.
- The prompt avoids hidden assumptions about selected text, clipboard contents,
  browser access, or installed AI Extensions.
- Runtime arguments have clear names, defaults/options when helpful, and do not
  exceed three distinct arguments.
- The prompt asks for output that matches the command's real use: replacement
  text for edits, bullets for summaries, JSON only when the user needs JSON, and
  no extra commentary when the result will be pasted into another app.

## References

- `references/ai-command.md`: Raycast AI Command form facts,
  AI Command-safe Dynamic Placeholders, modifiers, and compact prompt examples.