script-kit-scripting

Define script metadata and scriptlet bundle structures for Script Kit.

28|6|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/johnlindquist/script-kit-next --skill script-kit-scripting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: script-kit-scripting
Source: https://github.com/johnlindquist/script-kit-next/tree/main/.claude/skills/script-kit-scripting
Command: npx skills add https://github.com/johnlindquist/script-kit-next --skill script-kit-scripting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides clear patterns and best practices for defining metadata and structuring scripts and scriptlet bundles within the Script Kit ecosystem, ensuring discoverability and maintainability.

Core Features & Use Cases

  • Metadata Definition: Supports global TypeScript exports, legacy comment-based metadata, and YAML frontmatter for script bundles.
  • SDK Import Guidance: Demonstrates correct import paths for SDK components in both production scripts and test files.
  • Scriptlet Bundle Structure: Defines the optional YAML frontmatter for organizing collections of scripts.

Quick Start

Use the script-kit-scripting skill to understand how to define metadata for your scripts.

Frequently Asked Questions about script-kit-scripting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define metadata for Script Kit scripts in TypeScript?

Script Kit script metadata can be defined using global TypeScript exports. This pattern ensures scripts are discoverable and maintainable within the Script Kit ecosystem by leveraging standard export structures.

What is the best way to structure scriptlet bundles in Script Kit?

Scriptlet bundles in Script Kit are structured using optional YAML frontmatter. This format allows you to organize collections of scripts effectively, ensuring both discoverability and maintainability for your workflow.

Does Script Kit still support legacy comment-based metadata?

Yes, Script Kit supports legacy comment-based metadata for script definition. However, transitioning to global TypeScript exports is recommended for improved maintainability and modern integration.

How do SDK import paths work for Script Kit production scripts and tests?

SDK import paths in Script Kit differ between production scripts and test files. Following the correct import guidance ensures your script components load properly in both environments without runtime errors.

Can I use YAML frontmatter for individual Script Kit scripts or only for bundles?

YAML frontmatter in Script Kit is specifically defined for organizing scriptlet bundles. Individual scripts typically rely on global TypeScript exports or legacy comment-based metadata for their definitions.