Custom Actions

Use this skill when the user wants Actions Menu commands (Cmd+K), script-local actions via setActions(), or shared scriptlet actions via <bundle>.actions.md.

Write Here

For scripts: ~/.scriptkit/kit/main/scripts/<name>.ts

For scriptlet bundles: ~/.scriptkit/kit/main/scriptlets/<bundle>.md ~/.scriptkit/kit/main/scriptlets/<bundle>.actions.md

Script Example

import "@scriptkit/sdk";

await setActions([
  {
    name: "Copy Input",
    shortcut: "cmd+c",
    onAction: async (input) => {
      await copy(input);
      await hud("Copied");
    },
  },
  {
    name: "Clear Input",
    shortcut: "cmd+backspace",
    onAction: async () => {
      await setInput("");
      await hud("Cleared");
    },
  },
]);

await arg("Type something");

Scriptlet Companion File

Parent bundle:

## Script Kit

~~~metadata
description: Open the Script Kit homepage
~~~

~~~open
https://www.scriptkit.com
~~~

Companion actions file:

### Copy URL

~~~bash
echo -n "{{content}}" | pbcopy
~~~

### Open in Safari

~~~bash
open -a Safari "{{content}}"
~~~

Common Pitfalls

• •Discovery belongs in the Actions Menu. Do not add persistent chrome to solve discoverability.
• •The companion file must share the same basename: main.md + main.actions.md.
• •Use {{content}} inside companion actions to read the selected parent command content.

Related Examples

• •Canonical: ~/.scriptkit/kit/examples/scriptlets/custom-actions/main.md — parent bundle entries that receive shared actions
• •Canonical: ~/.scriptkit/kit/examples/scriptlets/custom-actions/main.actions.md — companion Actions Menu definitions using {{content}}
• •Flat mirror: ~/.scriptkit/kit/examples/scriptlets/custom-actions.md
• •Flat mirror: ~/.scriptkit/kit/examples/scriptlets/custom-actions.actions.md

Related Skills

• •scriptlets — bundle and companion-file structure
• •acp-chat — ACP-oriented actions
• •notes — note-focused actions and handoffs