Agent skill

Ssh Tui UX

by yqlay in yqlay/flclash-tui

A skill your agent uses when changing Linux TUI/CLI SSH Capture copy, empty states, picker labels, SSH dashboard hints, or the Connect vs Capture vs ssh -D vs ssh -R user flow.

GPL-3.0Auto-check passedFrontend & Design

Install Ssh Tui UX

skills CLI
$ npx skills add yqlay/flclash-tui --skill ssh-tui-ux -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yqlay/flclash-tui ssh-tui-ux --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yqlay/flclash-tui.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ssh-tui-ux .claude/skills/ssh-tui-ux && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ssh-tui-ux
GitHub stars
119
Token cost
~815 tokens
SKILL.md length
430 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
GPL-3.0

At a glance

A skill your agent uses when changing Linux TUI/CLI SSH Capture copy, empty states, picker labels, SSH dashboard hints, or the Connect vs Capture vs ssh -D vs ssh -R user flow.

  • Works in 8 steps: Say this machine when Capture scans.… → Every candidate line must say where… → Capture row: one action clause. Example:… → …
  • Changing Linux TUI/CLI SSH Capture copy
  • SKILL.md covers What each action does, Display rules, When editing and Do not
  • Calls ssh and go

What it does

Ssh Tui UX is an agent skill from yqlay/flclash-tui. Use when changing Linux TUI/CLI SSH Capture copy, empty states, picker labels, SSH dashboard hints, or the Connect vs Capture vs ssh -D vs ssh -R user flow.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering UX design. It works with Linux. The repository describes itself as: Linux/SSH/headless Mihomo TUI. Default silent: only flc COMMAND uses the proxy. The licence is GPL-3.0.

When your agent uses it

  • Changing Linux TUI/CLI SSH Capture copy
  • SSH dashboard hints
  • The Connect vs Capture vs ssh -D vs ssh -R user flow

Example prompts

  • “/ssh-tui-ux”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Say this machine when Capture scans. Never imply it can see the other host's ssh.
  2. Every candidate line must say where traffic exits, then the local SOCKS port.
  3. Capture row: one action clause. Example: Capture live SSH Enter · SOCKS on THIS machine.
  4. Capture dashboard (row selected): at most three short lines — when it scans, what can appear, what to do if empty.
  5. Empty states: next command first, reason second. Rank
  6. Picker overlay: Enter attaches · no new login · Esc cancel. Loading: Looking for SOCKS on this machine….
  7. Status while highlighting Capture: attach language, not “connect” or “probe ControlMaster” alone.
  8. Keep TUI English. Do not add a new page, shortcut, or flag for this copy.

What it can do on your machine

Read from SKILL.md and the folder at commit b352c39. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • ssh
    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use ssh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ssh Tui UX loads about 815 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 430 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~815

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yqlay/flclash-tui at commit b352c39, republished under its GPL-3.0 licence (© yqlay). 430 words, ~815 tokens.

Download SKILL.mdSave it as .claude/skills/ssh-tui-ux/SKILL.md (or your agent's skills folder).
name
ssh-tui-ux
description
Use when changing Linux TUI/CLI SSH Capture copy, empty states, picker labels, SSH dashboard hints, or the Connect vs Capture vs ssh -D vs ssh -R user flow.

SSH TUI/CLI UX

Linux CLI/TUI only (core/cli_tui_*.go, core/cli_ssh*.go, CLI_LINUX.md). Do not change Flutter GUI, shortcuts, flags, or version unless the user asked.

Change the TUI widgets, list rows, overlay, and key flow. Do not add help paragraphs, tutorials, or copy-paste SSH commands into the dashboard. If the user cannot tell Capture from Connect, fix layout, status, and what Enter does — not a longer caption.

What each action does

User actionWhat happensTraffic exits via
Capture (Enter/a on Capture row, ssh attach)Attach a SOCKS already listening on this FlClash machine. No new login.-D / ControlMaster: the SSH server. -R: the SSH client.
Enter on a saved profile / ssh connectStart or reuse a tunnel to that saved host.That host.
Idle refresh / ssh listMust not scan /proc or Windows ssh.exe.—

ssh -D SOCKS lives on the client. Capture it on the client. ssh -R / RemoteForward <port> SOCKS lives on the server. Capture it on the server. A session on another machine, or plain ssh without -D/-R/ControlMaster, will not appear. Do not open with that limitation; put the next step first.

Display rules

  1. Say this machine when Capture scans. Never imply it can see the other host's ssh.
  2. Every candidate line must say where traffic exits, then the local SOCKS port.
    • Local -D / ControlMaster: exit via <ssh-host> · SOCKS 127.0.0.1:<port>
    • Inbound -R: exit via client · SOCKS ←R 127.0.0.1:<port>
  3. Capture row: one action clause. Example: Capture live SSH Enter · SOCKS on THIS machine.
  4. Capture dashboard (row selected): at most three short lines — when it scans, what can appear, what to do if empty.
  5. Empty states: next command first, reason second. Rank:
    1. Incoming sshd but no -R SOCKS → On the SSH client: ssh -R 10808 USER@THISHOST — then Capture again.
    2. Local VS Code/ssh.exe without a reachable -D
    3. Saved profiles exist → use the profile list + Enter to connect
    4. Generic: nothing listening here
  6. Picker overlay: Enter attaches · no new login · Esc cancel. Loading: Looking for SOCKS on this machine….
  7. Status while highlighting Capture: attach language, not “connect” or “probe ControlMaster” alone.
  8. Keep TUI English. Do not add a new page, shortcut, or flag for this copy.
Show full SKILL.md (67 more words)Show less

When editing

  • core/cli_tui_profiles_page.go — Capture row + dashboard
  • core/cli_tui_view.go / core/cli_tui_keys.go / core/cli_tui_ssh_page.go — overlay, status, checking line
  • core/cli_ssh_discover.go — formatCLICaptureCandidate, formatCLICaptureEmptyHint
  • core/cli_ssh.go — attach/connect one-liners
  • Update tests that assert those strings
  • CGO_ENABLED=0 GOOS=linux go test -tags cli -count=1 ./... from core/

Do not

  • Teach users to hijack plain ssh or to Capture A’s -D from B
  • Change ControlMaster in the user’s ssh config
  • Scan on idle TUI refresh
  • Treat mihomo/Clash mixed-port as SSH SOCKS

© yqlay, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/ssh-tui-ux of yqlay/flclash-tui.

Open the folder on GitHubat commit b352c39

Compare with similar skills

Ssh Tui UX next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ssh Tui UX compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ssh Tui UX this skillyqlay/flclash-tui119—~815Automated safety check: PassGPL-3.0
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Interface Design for Dashboards and Appsholaboss-ai/holaOS11k3 repos~6kAutomated safety check: PassMIT
Animategrowupanand/ConvoForm1026 repos~1.9kAutomated safety check: PassApache-2.0
Migrate Content Iadocker/docs4.7k—~5.1kAutomated safety check: PassApache-2.0
UX WalkthroughXiaoMi/hiui878—~1.3kAutomated safety check: PassMIT

Similar skills

  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Pushes an agent past generic defaults when designing dashboards, admin panels, SaaS apps and tools, with attention to structure, type, navigation and how data is shown.

    11k GitHub starsUsed in 3 repos~6k tokens
    Frontend & DesignAuto-check passed
  • Animate

    growupanand/ConvoForm

    Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight.

    102 GitHub starsUsed in 6 repos~1.9k tokens
    Frontend & DesignAuto-check passed
  • Official

    Handle Hugo docs information-architecture moves: discover old vs new URLs, add front matter aliases (Phase 1), update in-repo links (Phase 2), interactive List 2 resolution and fragment validation…

    4.7k GitHub stars~5.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • UX Walkthrough

    XiaoMi/hiui

    体验走查 skill。适用于代码库、URL、截图三种输入,输出结构化体验问题报告,并同步生成本地 docx 报告。触发词:体验走查、UX review、交互走查、界面审查、体验问题。

    878 GitHub stars~1.3k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    737 GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed

More from yqlay/flclash-tui

  • Localization

    yqlay/flclash-tui

    A skill your agent uses when changing FlClash UI text, scanning for hardcoded Chinese strings, updating ARB localization, or fixing generated locale output in this repository.

    119 GitHub stars~440 tokensUpdated yesterday
    Auto-check passed
  • Provider Tests

    yqlay/flclash-tui

    A skill your agent uses when adding or updating FlClash Riverpod provider tests, notifier tests, or state-management tests in this repository.

    119 GitHub stars~363 tokensUpdated yesterday
    Auto-check passed
  • UI Work

    yqlay/flclash-tui

    A skill your agent uses when changing FlClash Flutter UI, widgets, screens, Material You styling, navigation surfaces, or user-facing interactions.

    119 GitHub stars~302 tokensUpdated yesterday
    Auto-check passed
  • Core Platform

    yqlay/flclash-tui

    A skill your agent uses when changing FlClash core integration, platform managers, Go core communication, desktop/mobile platform behavior, or Windows helper flow.

    119 GitHub stars~376 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Ssh Tui UX

What does Ssh Tui UX do?

A skill your agent uses when changing Linux TUI/CLI SSH Capture copy, empty states, picker labels, SSH dashboard hints, or the Connect vs Capture vs ssh -D vs ssh -R user flow. Ssh Tui UX is an agent skill from yqlay/flclash-tui. Use when changing Linux TUI/CLI SSH Capture copy, empty states, picker labels, SSH dashboard hints, or the Connect vs Capture vs ssh -D vs ssh -R user flow.

When should I use Ssh Tui UX?

Ssh Tui UX fits situations like: changing Linux TUI/CLI SSH Capture copy; SSH dashboard hints; the Connect vs Capture vs ssh -D vs ssh -R user flow.

How do I install Ssh Tui UX in Claude Code?

Run `npx skills add yqlay/flclash-tui --skill ssh-tui-ux -a claude-code`. Or copy the skill folder (.agents/skills/ssh-tui-ux in yqlay/flclash-tui) into .claude/skills/ssh-tui-ux in your project. Claude Code loads it when a task matches its description.

How do I install Ssh Tui UX in Codex?

Run `npx skills add yqlay/flclash-tui --skill ssh-tui-ux -a codex`. Or copy the skill folder (.agents/skills/ssh-tui-ux in yqlay/flclash-tui) into .agents/skills/ssh-tui-ux in your project. Codex loads it when a task matches its description.

Can I use Ssh Tui UX in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yqlay/flclash-tui --skill ssh-tui-ux -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ssh-tui-ux, .gemini/skills/ssh-tui-ux, .github/skills/ssh-tui-ux and .opencode/skills/ssh-tui-ux in your project.

What does Ssh Tui UX need to run?

Going by SKILL.md and its folder, Ssh Tui UX needs the command-line tools its instructions call (ssh and go).

Does Ssh Tui UX access the network?

SKILL.md contains no URLs. Its commands use ssh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ssh Tui UX safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ssh Tui UX use?

Ssh Tui UX is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ssh Tui UX use?

About 815 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ssh Tui UX?

Skills that share tags, products or a category with Ssh Tui UX: Impeccable (bestofjs/bestofjs, 3.1k stars), Interface Design for Dashboards and Apps (holaboss-ai/holaOS, 11k stars), Animate (growupanand/ConvoForm, 102 stars) and Migrate Content Ia (docker/docs, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ssh Tui UX?

yqlay (a GitHub user) maintains it in yqlay/flclash-tui, which has 119 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 8, 2026.

Source: yqlay/flclash-tui on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.