local
GitHub定义本地终端资产（local asset）的配置规范，用于在用户本机启动交互式 Shell。说明其无命令执行能力，并列出 put_asset 所需的可选配置字段如 shell、cwd 等。
触发场景
安装
npx skills add opskat/opskat --skill local -g -y
SKILL.md
Frontmatter
{
"name": "local",
"description": "Local terminal assets — a shortcut that opens a shell on the user's own machine. Config fields for put_asset; no command surface — exec is not supported for this type."
}
Local terminal assets
A local asset is a shortcut that opens an interactive shell on the user's own machine,
not a remote server — it has no host/port/credentials to configure. There is no command
surface: exec is not supported for this type (unlike the local_bash / local_write / …
tool family, which is unrelated and always available regardless of asset type).
It still needs a help doc like every other asset type: put_asset must be able to create it,
and nothing else tells the model what a local asset's config object looks like.
Asset config (for put_asset)
There are no required fields — an empty config object is valid.
| field | type | required | notes |
|---|---|---|---|
shell |
string | no | Shell executable path/name; empty uses the OS default |
args |
string | no | Comma/semicolon/newline separated extra shell arguments |
cwd |
string | no | Initial working directory; empty uses the OS default |
password |
string | no | Reserved compatibility key; any non-empty value is rejected as inapplicable |
credential_id |
number | no | Reserved compatibility key; any non-zero value is rejected as inapplicable |
Local automation never creates or references managed credentials.
Example:
put_asset(name="my-shell", type="local", config={"shell":"/bin/zsh","cwd":"/Users/me/project"})
版本历史
-
b159e91
当前 2026-08-19 20:20
新增password和credential_id字段说明，明确其被拒绝的兼容性用途。
- aeb4bc3 2026-07-24 16:28
