docs/reference/sdk/core/interfaces/SKILL.md
--- title: "Interface: Skill" nav: Skill note: |- This file is autogenerated from TypeScript definitions. Make edits to the comments in the TypeScript file and then run "make docs" to regenerate this file. search: boost: 0.1 --- # Interface: Skill A prompt and set of tools that defines a specific skill this agent provides. ## Properties ### description > **description**: `string` Description of what this skill does. *** ### displayName > **displayName**: `string` Display name sho
npx skillsauth add coda/packs-sdk docs/reference/sdk/core/interfacesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A prompt and set of tools that defines a specific skill this agent provides.
description:
string
Description of what this skill does.
displayName:
string
Display name shown to users for this skill.
optionalmodels:SkillModelConfiguration[]
The LLM model(s) to use for this skill. Specify an array of SkillModelConfiguration objects.
If not specified, Superhuman Go will select a default model.
If multiple models are specified, Superhuman Go will select the best available model based on the user's workspace settings.
name:
string
Stable identifier for the skill.
prompt:
string
The prompt/instructions that define the skill's behavior.
tools:
Tool[]
List of tools that this skill can use.
When used in PackDefinitionBuilder.addSkill, this field is required.
When omitted from PackDefinitionBuilder.setChatSkill, the following defaults are applied at runtime:
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.