Agent Skills › J-x-Z/cocoa-way › cocoa-way-onboarding

cocoa-way-onboarding

GitHub

指导新用户完成Cocoa-Way的首次设置，包括选择镜像源、配置Apple Container应用或SSH连接。提供分步操作指引、安全规范及故障排查建议。

skills/cocoa-way-onboarding/SKILL.md J-x-Z/cocoa-way

Trigger Scenarios

新用户首次运行设置配置Cocoa-Way应用或连接

Install

npx skills add J-x-Z/cocoa-way --skill cocoa-way-onboarding -g -y

More Options

Use without installing

npx skills use J-x-Z/cocoa-way@cocoa-way-onboarding

指定 Agent (Claude Code)

npx skills add J-x-Z/cocoa-way --skill cocoa-way-onboarding -a claude-code -g -y

安装 repo 全部 skill

npx skills add J-x-Z/cocoa-way --all -g -y

预览 repo 内 skill

npx skills add J-x-Z/cocoa-way --list

SKILL.md

Frontmatter

{
    "name": "cocoa-way-onboarding",
    "description": "Guide a new Cocoa-Way user through choosing an image source, creating an Apple Container application profile, or saving a classic SSH\/local Waypipe connection. Use for first-run setup and configuration questions."
}

Cocoa-Way Onboarding

Keep setup local, reviewable, and reversible.

Call cocoa_way_onboarding with the user's goal.
For Apple Container, confirm that Apple's separate container runtime is installed. If it is missing, direct the user to https://github.com/apple/container/releases/latest; if it is stopped, direct the user to Container > Apple Container > Start System.
Call cocoa_way_image_sources, then cocoa_way_application_template with the chosen image and command.
Explain that a base OCI image is not automatically GUI-ready. It needs Waypipe and the requested GUI command; clipboard and audio need the Cocoa-Way image helpers.
Ask the user to review the generated fields in Applications > New Application, run Check, and launch explicitly.
Use desktop for nested compositors such as niri or Hyprland. Use rootless for ordinary xdg-shell apps such as Foot or Firefox.
For SSH or an existing local Waypipe socket, call cocoa_way_connection_template. Save the reviewed fields through Connections > Connect to Machine or run the generated run_waypipe.sh command.
Create or select a managed Display before connecting when the default display is occupied.
If setup fails, switch to the cocoa-way-diagnose workflow and collect evidence before changing configuration.

Safety

Never choose an untrusted registry or tag on the user's behalf.
Never store passwords, registry credentials, or private keys in Cocoa-Way configuration.
MCP setup tools are read-only. Do not bypass explicit Check, Launch, Stop, or deletion controls.
Do not force software rendering to hide a guest-image or transport problem.