Agent skill

UX Linter

CLI 도구의 사용자 경험을 검증하는 체크리스트와 모범 사례. An agent skill from revfactory/harness-100.

Apache-2.0Auto-check passedDevelopment

Install UX Linter

skills CLI

$ npx skills add revfactory/harness-100 --skill ux-linter -a claude-code

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

GitHub CLI

$ gh skill install revfactory/harness-100 ux-linter --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/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ko/40-cli-tool-builder/.claude/skills/ux-linter .claude/skills/ux-linter && 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/

Paste into Claude Code

Install the "ux-linter" agent skill from https://github.com/revfactory/harness-100/tree/main/ko/40-cli-tool-builder/.claude/skills/ux-linter into .claude/skills/ux-linter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-linter", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/revfactory/harness-100/tree/main/ko/40-cli-tool-builder/.claude/skills/ux-linter

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add revfactory/harness-100 --skill ux-linter -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 ux-linter --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .agents/skills && cp -r skills-src/ko/40-cli-tool-builder/.claude/skills/ux-linter .agents/skills/ux-linter && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "ux-linter" agent skill from https://github.com/revfactory/harness-100/tree/main/ko/40-cli-tool-builder/.claude/skills/ux-linter into .agents/skills/ux-linter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-linter", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add revfactory/harness-100 --skill ux-linter -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 ux-linter --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/ko/40-cli-tool-builder/.claude/skills/ux-linter .cursor/skills/ux-linter && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "ux-linter" agent skill from https://github.com/revfactory/harness-100/tree/main/ko/40-cli-tool-builder/.claude/skills/ux-linter into .cursor/skills/ux-linter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-linter", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/revfactory/harness-100.git --path ko/40-cli-tool-builder/.claude/skills/ux-linter

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add revfactory/harness-100 --skill ux-linter -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 ux-linter --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/ko/40-cli-tool-builder/.claude/skills/ux-linter .gemini/skills/ux-linter && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "ux-linter" agent skill from https://github.com/revfactory/harness-100/tree/main/ko/40-cli-tool-builder/.claude/skills/ux-linter into .gemini/skills/ux-linter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-linter", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install revfactory/harness-100 ux-linter

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add revfactory/harness-100 --skill ux-linter -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .github/skills && cp -r skills-src/ko/40-cli-tool-builder/.claude/skills/ux-linter .github/skills/ux-linter && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "ux-linter" agent skill from https://github.com/revfactory/harness-100/tree/main/ko/40-cli-tool-builder/.claude/skills/ux-linter into .github/skills/ux-linter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-linter", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add revfactory/harness-100 --skill ux-linter -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 ux-linter --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/ko/40-cli-tool-builder/.claude/skills/ux-linter .opencode/skills/ux-linter && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "ux-linter" agent skill from https://github.com/revfactory/harness-100/tree/main/ko/40-cli-tool-builder/.claude/skills/ux-linter into .opencode/skills/ux-linter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-linter", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: ux-linter
GitHub stars: 1.3k
Token cost: ~727 tokens
SKILL.md length: 106 words
Files: 1
Skills in repo: 464
Repo updated: Mar 22, 2026
First seen: Oct 9, 2026
Licence: Apache-2.0

At a glance

CLI 도구의 사용자 경험을 검증하는 체크리스트와 모범 사례. An agent skill from revfactory/harness-100.

Works in 5 steps: 발견 가능성 (Discoverability) → 피드백 (Feedback) → 에러 처리 (Error Handling) → …
Tasks that involve Linting and formatting
SKILL.md covers 대상 에이전트, CLI UX 12원칙 체크리스트, 에러 메시지 포맷 표준 and 출력 포맷 가이드, plus 3 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

UX Linter is an agent skill from revfactory/harness-100. CLI 도구의 사용자 경험을 검증하는 체크리스트와 모범 사례. 'CLI UX 검증', '사용성 체크', '출력 형식 검증', '에러 메시지 검토', '인터랙션 패턴 검사' 등 CLI UX 품질 확인 시 사용한다. 단, GUI 사용성 테스트, 접근성 인증은 이 스킬의 범위가 아니다.

Its SKILL.md is about 730 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 Development, covering Linting and formatting. The licence is Apache-2.0.

When your agent uses it

Tasks that involve Linting and formatting

Example prompts

“CLI UX 검증”
“/ux-linter”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

발견 가능성 (Discoverability)
피드백 (Feedback)
에러 처리 (Error Handling)
파이프 친화 (Pipe-friendly)
설정 (Configuration)

What it can do on your machine

Read from SKILL.md and the folder at commit 8e8d35c. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are json and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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

UX Linter loads about 727 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 106 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: ~727

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 revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 106 words, ~727 tokens.

Download SKILL.mdSave it as .claude/skills/ux-linter/SKILL.md (or your agent's skills folder).

name: ux-linter
description: CLI 도구의 사용자 경험을 검증하는 체크리스트와 모범 사례. 'CLI UX 검증', '사용성 체크', '출력 형식 검증', '에러 메시지 검토', '인터랙션 패턴 검사' 등 CLI UX 품질 확인 시 사용한다. 단, GUI 사용성 테스트, 접근성 인증은 이 스킬의 범위가 아니다.

UX Linter — CLI 사용자 경험 검증 체크리스트

test-engineer와 docs-writer의 UX 품질 검증을 강화하는 스킬.

대상 에이전트

test-engineer — CLI 사용성 테스트를 체계적으로 수행한다
docs-writer — 사용자 관점의 문서를 작성한다

CLI UX 12원칙 체크리스트

1. 발견 가능성 (Discoverability)

[ ] --help가 유용한 정보를 제공하는가?
[ ] 서브커맨드 목록이 설명과 함께 표시되는가?
[ ] 잘못된 명령 시 "Did you mean...?" 제안이 있는가?
[ ] 예시(Examples) 섹션이 있는가?

2. 피드백 (Feedback)

[ ] 작업 진행 중 프로그레스 표시가 있는가? (bar/spinner)
[ ] 성공/실패가 명확히 구분되는가?
[ ] 장시간 작업에 예상 시간이 표시되는가?
[ ] 결과 요약이 제공되는가?

3. 에러 처리 (Error Handling)

[ ] 에러 메시지가 구체적인가? (무엇이 잘못됐고 어떻게 고치는지)
[ ] 에러와 경고가 구분되는가?
[ ] stderr로 에러가 출력되는가? (stdout 오염 방지)
[ ] 종료 코드가 적절한가? (0: 성공, 비0: 실패)

4. 파이프 친화 (Pipe-friendly)

[ ] stdout이 구조화된 데이터를 출력하는가?
[ ] 인간용/기계용 출력 전환이 가능한가? (--json, --quiet)
[ ] stdin에서 입력을 읽을 수 있는가? (파이프)
[ ] 색상이 파이프 시 자동 비활성화되는가? (isatty 체크)

5. 설정 (Configuration)

[ ] 설정 파일 경로를 표시하는가?
[ ] 환경변수 + 설정파일 + CLI 옵션 우선순위가 명확한가?
[ ] 기본값이 합리적인가?
[ ] 현재 설정을 확인하는 명령이 있는가?

에러 메시지 포맷 표준

BAD (피해야 할 패턴)

Error: invalid input
Error: operation failed
Exception: NullPointerException at line 42

GOOD (권장 패턴)

Error: 입력 파일을 찾을 수 없습니다: data.json
  경로를 확인하거나 --input 옵션으로 지정하세요.
  예: mytool convert --input /path/to/data.json

Error: JSON 파싱 실패 (line 15, column 8)
  닫히지 않은 중괄호가 있습니다.
  힌트: jsonlint data.json 으로 문법을 확인해보세요.

에러 메시지 구성 요소

1. [무엇이 일어났는가] — 문제 설명
2. [왜 일어났는가] — 원인 (가능한 경우)
3. [어떻게 해결하는가] — 해결 방법
4. [추가 정보] — 문서 링크, 관련 명령어

출력 포맷 가이드

테이블 출력

NAME        STATUS    SIZE     MODIFIED
config.yml  active    2.4 KB   2025-01-15
data.json   pending   156 KB   2025-01-14

JSON 출력 (--json)

json

[
  {"name": "config.yml", "status": "active", "size": 2400},
  {"name": "data.json", "status": "pending", "size": 156000}
]

진행 상태 표시

TTY (터미널):
  Processing... [████████░░░░░░░░] 50% (15/30 files)

Non-TTY (파이프/리다이렉트):
  Processing 15/30 files...
  Processing 30/30 files... done.

색상 사용 가이드

의미	색상	ANSI
성공	초록	`\033[32m`
경고	노랑	`\033[33m`
오류	빨강	`\033[31m`
정보	파랑	`\033[34m`
강조	굵게	`\033[1m`
보조	회색	`\033[90m`

규칙:
1. NO_COLOR 환경변수 존재 시 색상 비활성화
2. 파이프/리다이렉트 시 자동 비활성화
3. --no-color 옵션 제공
4. 색상 없이도 의미 전달 가능해야 함

인터랙티브 패턴

확인 프롬프트 (위험 작업):
  정말 삭제하시겠습니까? [y/N]: _
  → 대문자가 기본값 (N = 기본 No)
  → --force / --yes 로 건너뛰기

선택 프롬프트:
  출력 형식을 선택하세요:
  > json
    yaml
    toml
  → 화살표 키로 선택 (TTY 전용)

드라이런:
  --dry-run 옵션으로 실제 변경 없이 미리보기

UX 검증 보고서 템플릿

markdown

## CLI UX 검증 보고서

### 12원칙 통과 현황
| 원칙 | 상태 | 비고 |
|------|------|------|

### 에러 메시지 품질
| 시나리오 | 현재 메시지 | 개선안 |

### 출력 형식 검증
| 명령 | 터미널 출력 | 파이프 출력 | JSON |

Files

Just SKILL.md in ko/40-cli-tool-builder/.claude/skills/ux-linter of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

UX Linter 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.

UX Linter compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
UX Linter this skillrevfactory/harness-100	1.3k	—	~727	Automated safety check: Pass	Apache-2.0	6 mo ago
Minimizing Ty Ecosystem Changesastral-sh/ruff	50k	—	~4.6k	Automated safety check: Pass	MIT	today
Install Anti-Slop Oxlint Rulesdmmulroy/anti-slop	5.3k	—	~2.2k	Automated safety check: Pass	MIT	29 days ago
Babysit PR To Pass CIsgl-project/sglang	37k	2 repos	~3k	Automated safety check: Pass	Apache-2.0	today
Rust Best Practicesfarm-fe/farm	5.6k	3 repos	~1.1k	Automated safety check: Pass	MIT	17 days ago
Summarise Ecosystem Resultsastral-sh/ruff	50k	—	~2.2k	Automated safety check: Pass	MIT	today

Similar skills

Minimizing Ty Ecosystem Changes
astral-sh/ruff
Official
A skill your agent uses when a user says "minimize this ty ecosystem change", "reproduce this ecosystem result", "investigate a primer difference", "investigate a mypyprimer difference"…
50k GitHub stars~4.6k tokensUpdated today
DevelopmentAuto-check passed
Install Anti-Slop Oxlint Rules
dmmulroy/anti-slop
Installs, updates or migrates the vendored anti-slop Oxlint plugin in a repository, keeping local rule changes and the plugin's license and provenance files.
5.3k GitHub stars~2.2k tokensUpdated 29 days ago
DevelopmentAuto-check passed
Babysit PR To Pass CI
sgl-project/sglang
Start and persistently pursue a goal to babysit an SGLang pull request until selected GitHub Actions workflows pass on the latest PR head.
37k GitHub starsUsed in 2 repos~3k tokens
DevelopmentAuto-check passed
Rust Best Practices
farm-fe/farm
Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.
5.6k GitHub starsUsed in 3 repos~1.1k tokens
DevelopmentAuto-check passed
Summarise Ecosystem Results
astral-sh/ruff
Official
A skill your agent uses when a user says "summarise ecosystem results", "summarize this ty ecosystem report", "what changed in this ecosystem run?", or asks to summarise or summarize ty ecosystem…
50k GitHub stars~2.2k tokensUpdated today
DevelopmentAuto-check passed
Go Pedantry
chromedp/chromedp
This skill should be used when the user is writing Go code and needs guidance on Go-specific pedantry: error wrapping with fmt.Errorf and %w, interface design (accept interfaces return structs)…
13k GitHub stars~3.7k tokensUpdated 4 days ago
DevelopmentAuto-check passed

Questions about UX Linter

What does UX Linter do?

CLI 도구의 사용자 경험을 검증하는 체크리스트와 모범 사례. An agent skill from revfactory/harness-100. UX Linter is an agent skill from revfactory/harness-100. CLI 도구의 사용자 경험을 검증하는 체크리스트와 모범 사례.

When should I use UX Linter?

UX Linter fits situations like: tasks that involve Linting and formatting.

How do I install UX Linter in Claude Code?

Run `npx skills add revfactory/harness-100 --skill ux-linter -a claude-code`. Or copy the skill folder (ko/40-cli-tool-builder/.claude/skills/ux-linter in revfactory/harness-100) into .claude/skills/ux-linter in your project. Claude Code loads it when a task matches its description.

How do I install UX Linter in Codex?

Run `npx skills add revfactory/harness-100 --skill ux-linter -a codex`. Or copy the skill folder (ko/40-cli-tool-builder/.claude/skills/ux-linter in revfactory/harness-100) into .agents/skills/ux-linter in your project. Codex loads it when a task matches its description.

Can I use UX Linter 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 revfactory/harness-100 --skill ux-linter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ux-linter, .gemini/skills/ux-linter, .github/skills/ux-linter and .opencode/skills/ux-linter in your project.

What does UX Linter need to run?

SKILL.md names no scripts, command-line tools or credentials: UX Linter is instructions for the agent only.

Does UX Linter access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is UX Linter 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 UX Linter use?

UX Linter is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does UX Linter use?

About 727 tokens (SKILL.md is roughly 2.9k 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 UX Linter?

Skills that share tags, products or a category with UX Linter: Minimizing Ty Ecosystem Changes (astral-sh/ruff, 50k stars), Install Anti-Slop Oxlint Rules (dmmulroy/anti-slop, 5.3k stars), Babysit PR To Pass CI (sgl-project/sglang, 37k stars) and Rust Best Practices (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains UX Linter?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,295 GitHub stars. The repository holds 464 skills in this directory. The repository was last updated on March 22, 2026.

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

Install UX Linter

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

UX Linter — CLI 사용자 경험 검증 체크리스트

대상 에이전트

CLI UX 12원칙 체크리스트

1. 발견 가능성 (Discoverability)

2. 피드백 (Feedback)

3. 에러 처리 (Error Handling)

4. 파이프 친화 (Pipe-friendly)

5. 설정 (Configuration)

에러 메시지 포맷 표준

BAD (피해야 할 패턴)

GOOD (권장 패턴)

에러 메시지 구성 요소

출력 포맷 가이드

테이블 출력

JSON 출력 (--json)

진행 상태 표시

색상 사용 가이드

인터랙티브 패턴

UX 검증 보고서 템플릿

Files

Compare with similar skills

Similar skills

More from revfactory/harness-100

Related

Questions about UX Linter