name: raycast-script
description: Use this skill whenever the user asks to create a Raycast script command, add a script to Raycast, or make something runnable from Raycast. Trigger even if the user just says "make a Raycast script for X" or "add this to Raycast" — any time a script needs to work as a Raycast command, this skill applies.

Raycast Script Commands

Template

Every Raycast script starts with this header. Use it exactly — required fields first, then optional, then documentation.

Bash:

#!/bin/bash

# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title <Title Here>
# @raycast.mode silent

# Optional parameters:

# Documentation:
# @raycast.description <short description>
# @raycast.author a_l_i_r
# @raycast.authorURL https://raycast.com/a_l_i_r

Python:

#!/usr/bin/env python3

# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title <Title Here>
# @raycast.mode silent

# Optional parameters:

# Documentation:
# @raycast.description <short description>
# @raycast.author a_l_i_r
# @raycast.authorURL https://raycast.com/a_l_i_r

Key rules

• Scripts go in ~/code/scripts/ — always save there, never elsewhere
• Icon: omit the @raycast.icon line entirely unless the user explicitly asks for one. Don't leave a blank @raycast.icon line.
• Always chmod +x the script after creating it
• author/authorURL: always a_l_i_r / https://raycast.com/a_l_i_r

Choosing @raycast.mode

• silent — runs in background, shows a brief HUD toast on completion. Best for scripts that just do something (write a file, send a request, etc.)
• compact — shows output inline in the Raycast bar. Good for short status messages.
• fullOutput — opens a full output window. Use when there's meaningful text to read.

When in doubt, use silent.

Arguments

If the script needs user input from Raycast (typed directly into the Raycast bar), add argument fields after @raycast.mode:

# @raycast.argument1 {"type": "text", "placeholder": "Your input here"}

However, if the workflow is "copy something, then trigger the script", read from clipboard with pbpaste instead — this is often more fluid and matches Ali's preferred pattern.