Agent Skills › ryantsai/KKTerm › remote-desktop-helper

remote-desktop-helper

GitHub

指导 KKTerm 的 RDP 和 VNC 远程桌面会话管理，涵盖连接配置、键鼠交互、截图获取、显示调整及故障排查。强调优先使用只读状态，避免盲操作，并严格禁止在聊天中处理密码输入。

assistant-skills/remote-desktop-helper/SKILL.md ryantsai/KKTerm

Trigger Scenarios

用户询问 RDP 或 VNC 连接问题需要远程控制鼠标键盘远程桌面截图需求远程桌面显示尺寸调整连接失败或凭证提示故障排查

Install

npx skills add ryantsai/KKTerm --skill remote-desktop-helper -g -y

More Options

Non-standard path

npx skills add https://github.com/ryantsai/KKTerm/tree/main/assistant-skills/remote-desktop-helper -g -y

Use without installing

npx skills use ryantsai/KKTerm@remote-desktop-helper

指定 Agent (Claude Code)

npx skills add ryantsai/KKTerm --skill remote-desktop-helper -a claude-code -g -y

安装 repo 全部 skill

npx skills add ryantsai/KKTerm --all -g -y

预览 repo 内 skill

npx skills add ryantsai/KKTerm --list

SKILL.md

Frontmatter

{
    "name": "remote-desktop-helper",
    "description": "Guide KKTerm RDP and VNC remote desktop Sessions, connection setup, keyboard and mouse interaction, screenshots, focus problems, display sizing, credentials, and troubleshooting."
}

Remote Desktop Helper

Use this skill when the user asks about RDP, VNC, remote desktop input, screenshots, display sizing, connection failures, or credential prompts.

Workflow

Determine whether the target is RDP or VNC and whether it is a stored Connection, Quick Connect draft, or live Session.
For live interaction, inspect available Session context before sending keys, text, mouse clicks, or screenshots.
Prefer screenshots and read-only state before mutating remote input.
For keyboard input, use named keypresses for special keys and text send for plain text.
For mouse input, reason in remote surface coordinates and avoid blind clicks when the visible state is unknown.
For connection failures, separate network reachability, port/protocol, credentials, server policy, display size, and TLS/security settings.
Do not ask users to paste passwords into chat.
If an app overlay crosses an RDP surface, remember that RDP uses native HWND-backed rendering and may need special handling.

KKTerm Boundaries

RDP and VNC are live Sessions; saved settings live on the Connection.
RDP uses ActiveX on Windows and has special overlay parking behavior.
WebView2, terminal, SFTP, and VNC should not inherit RDP overlay workarounds.
Remote desktop tools that mutate input may require approval depending on Assistant tool permission mode.