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

remote-desktop-helper

GitHub

指导 KKTerm RDP/VNC 远程桌面会话的连接、交互、截图及故障排查。涵盖输入处理、显示设置、凭据安全及特定平台渲染边界，确保操作前检查上下文并避免盲点点击。

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

触发场景

RDP或VNC连接失败远程桌面键盘鼠标交互问题远程屏幕截图或分辨率调整远程桌面凭据提示

安装

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

更多选项

非标准路径

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

不安装直接使用

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.