Agent Skills › ryantsai/KKTerm › sftp-transfer-helper

sftp-transfer-helper

GitHub

辅助处理KKTerm SFTP会话中的文件浏览、上传下载规划、冲突解决、权限管理及路径导航。区分SSH与SFTP状态，谨慎处理远程路径与删除操作，确保传输安全并避免敏感信息泄露。

assistant-skills/sftp-transfer-helper/SKILL.md ryantsai/KKTerm

Trigger Scenarios

用户询问SFTP文件浏览或目录导航需要规划或执行SFTP上传和下载任务遇到文件覆盖冲突或权限错误确认远程路径格式或解析路径错误

Install

npx skills add ryantsai/KKTerm --skill sftp-transfer-helper -g -y

More Options

Non-standard path

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

Use without installing

npx skills use ryantsai/KKTerm@sftp-transfer-helper

指定 Agent (Claude Code)

npx skills add ryantsai/KKTerm --skill sftp-transfer-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": "sftp-transfer-helper",
    "description": "Help with KKTerm SFTP file browsing, upload and download planning, overwrite conflicts, remote path mistakes, permissions, directory navigation, and SFTP Sessions opened from SSH Connections."
}

SFTP Transfer Helper

Use this skill when the user asks about SFTP browsing, uploads, downloads, file conflicts, permissions, paths, or transfer failures.

Workflow

Confirm whether the user is working in an SFTP Session, an SSH terminal, or a stored SSH Connection.
Treat remote paths carefully. Distinguish root, home-relative, absolute, and sibling paths.
Prefer listing and inspecting before upload, overwrite, rename, chmod, or delete.
For transfers, clarify direction: local to remote upload, remote to local download, or remote-side rename/move.
For conflicts, explain the consequence of fail, overwrite, resume, rename, or skip choices.
For permission errors, separate ownership, mode bits, parent directory permissions, and server policy.
Avoid suggesting terminal-side file operations when the SFTP browser can perform the operation more safely.
Do not ask the user to paste passwords or private keys into chat.

KKTerm Boundaries

SFTP opens from an SSH Connection.
SFTP browser state is a live Session, not durable Connection data.
File deletes are destructive and should be confirmed through app-owned approval flows when tools are available.
Windows local paths and POSIX remote paths need separate quoting and separator rules.