Community코딩 & 개발github.com

steipete/create-cli

CLI UX/사양: 인수, 플래그, 도움말, 출력, 오류, 구성, dry-run.

create-cli란 무엇인가요?

이 스킬은 인간 사용자와 스크립트 모두를 고려한 CLI(명령줄 인터페이스) 디자인을 위한 포괄적인 가이드입니다. 주어진 CLI 가이드라인(clig.dev)을 기본 평가 기준으로 삼아, 명령어 이름, 목적, 입력 소스(인수 vs stdin), 출력 계약(인간용 텍스트, --json, --plain), 상호작용성, 구성 모델(플래그/환경 변수/설정 파일), 플랫폼 제약 조건 등을 명확히 하는 데 중점을 둡니다. 이 스킬은 사용자에게 최소한의 명확화 질문을 던진 후, 구체적인 CLI 사양을 명령어 트리, 인수/플래그 표, 서브커맨드 의미론, 출력 규칙, 오류 및 종료 코드 맵, 안전 규칙(--dry-run, 확인, --force, --no-input), 구성/환경 변수 우선순위, 셸 완성, 예제 호출 형태로 제공합니다. 기본 규칙으로 --help와 --version 지원, stdout/ stderr 분리, --json/--plain 출력, --no-input 및 --no-color 존중, Ctrl-C 처리 등을 포함하며, 언어에 구애받지 않아 모든 프로그래밍 언어에 적용 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/create-cli

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Create CLI

CLI 인터페이스 영역(구문 + 동작)을 인간 중심으로, 스크립트에도 친화적으로 설계합니다.

먼저 할 일

명확히 하기 (빠르게)

질문한 후, 사용자가 확신하지 못하면 최선의 기본값으로 진행하세요:

  • 명령어 이름 + 한 문장 목적.
  • 주요 사용자: 사람, 스크립트, 또는 둘 다.
  • 입력 소스: 인수 vs stdin; 파일 vs URL; 비밀(절대 플래그로 전달 금지).
  • 출력 계약: 사람용 텍스트, --json, --plain, 종료 코드.
  • 상호작용성: 프롬프트 허용? --no-input 필요? 파괴적 작업에 확인?
  • 구성 모델: 플래그/환경 변수/설정 파일; 우선순위; XDG vs 저장소 로컬.
  • 플랫폼/런타임 제약: macOS/Linux/Windows; 단일 바이너리 vs 런타임.

결과물 (출력할 내용)

CLI를 설계할 때 사용자가 구현할 수 있는 간결한 사양을 생성하세요:

  • 명령어 트리 + USAGE 개요.
  • 인수/플래그 표 (타입, 기본값, 필수/선택, 예시).
  • 서브커맨드 의미론 (각각의 기능; 멱등성; 상태 변경).
  • 출력 규칙: stdout vs stderr; TTY 감지; --json/--plain; --quiet/--verbose.
  • 오류 + 종료 코드 맵 (주요 실패 모드).
  • 안전 규칙: --dry-run, 확인, --force, --no-input.
  • 구성/환경 변수 규칙 + 우선순위 (플래그 > 환경 변수 > 프로젝트 설정 > 사용자 설정 > 시스템).
  • 셸 완성 (해당되는 경우): 설치/검색 가능성; 생성 명령어 또는 번들 스크립트.
  • 예제 호출 5~10개 (일반적인 흐름; 파이프/stdin 예제 포함).

기본 규칙 (사용자가 달리 명시하지 않는 한)

  • -h/--help는 항상 도움말을 표시하고 다른 인수를 무시합니다.
  • --version은 버전을 stdout에 출력합니다.
  • 주요 데이터는 stdout으로; 진단/오류는 stderr로.
  • 기계 출력을 위해 --json을 추가하고, 안정적인 줄 기반 텍스트를 위해 --plain을 고려하세요.
  • 프롬프트는 stdin이 TTY인 경우에만; --no-input은 프롬프트를 비활성화합니다.
  • 파괴적 작업: 대화형 확인 + 비대화형에서는 --force 또는 명시적 --confirm=... 필요.
  • NO_COLOR, TERM=dumb를 존중하고 --no-color를 제공하세요.
  • Ctrl-C 처리: 빠르게 종료; 제한된 정리; 가능하면 crash-only로 처리.

템플릿 (답변에 복사하여 사용)

CLI 사양 뼈대

다음 섹션을 채우고 관련 없는 부분은 제거하세요:

  1. 이름: mycmd
  2. 한 줄 설명: ...
  3. USAGE:
    • mycmd [global flags] <subcommand> [args]
  4. 서브커맨드:
    • mycmd init ...
    • mycmd run ...
  5. 글로벌 플래그:
    • -h, --help
    • --version
    • -q, --quiet / -v, --verbose (정확히 정의)
    • --json / --plain (해당되는 경우)
  6. I/O 계약:
    • stdout:
    • stderr:
  7. 종료 코드:
    • 0 성공
    • 1 일반 실패
    • 2 잘못된 사용 (파싱/검증)
    • (실제로 유용할 때만 명령어별 코드 추가)
  8. 환경 변수/설정:
    • 환경 변수:
    • 설정 파일 경로 + 우선순위:
  9. 예제:
    • …

참고

  • 언어별 파싱 라이브러리는 요청 시에만 추천하며, 그렇지 않으면 이 스킬을 언어에 구애받지 않게 유지하세요.
  • 요청이 "설계 매개변수"인 경우 구현 세부 사항으로 빠지지 마세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

관련 스킬