Translate Hugging Face blog post: Designing the hf CLI as an agent-optimized way to work with the Hub

[Jwaminju]

Source: https://huggingface.co/blog/hf-cli-for-agents

This PR adds a Korean translation draft for hf-cli-for-agents.

Downstream handoff:

• SEO review should use the translation-flow manifest.
• Quality review should use the translation-flow manifest.

[github-actions]

HF Agent Review

Gate	Result
Quality	❌ Fail
SEO	✅ Pass

Head SHA: c1d8332195ea24f570facf3ddec903edffed6fe0

Quality report — ❌ Fail

Quality Report

• Status: reject
• Quality Score: 0.0
• Hard failures: 1
• Issues: 90
• Source available: True
• Source changed: False
• Source segments: 61
• Target segments: 61

Scorecard

Dimension	Score
adequacy	0.0
technical_accuracy	0.0
completeness	0.0
terminology	0.0
fluency	0.0
publishing_integrity	80.0
style_locale	60.0

Metrics

• qe_metric: heuristic
• qe_average: 0.9448
• qe_min: 0.6042
• embedding_similarity_average: 0.8245
• embedding_similarity_min: 0.3238
• cache_hits: 0
• cache_misses: 122

MQM Judge

• Enabled: True
• Provider: openai
• Model: gpt-5.6-luna
• Reasoning effort: none
• Prompt: /home/runner/work/hugging-face-krew.github.io/hugging-face-krew.github.io/workflow/skills/quality/judges/mqm_prompt.md
• Prompt hash: 887d2931aa289213f0bdce4a917a0ac8364dad8e470011069b8f8bf758d69a90
• Style guide hash: 937d8cd893578d30e716a3eb513cdf5f10d6fd3ad8f5e77068b57f96e160de12
• Requested segments: 61
• Evaluated segments: 60
• MQM errors: 69
• Cache hits: 0
• Cache misses: 61
• Severity counts: {'major': 13, 'minor': 56}
• adequacy_average: 0.9022
• technical_average: 0.9602
• fluency_average: 0.8533
• warning: Skipped MQM error for segment p_005: target_span is not verbatim target text.
• warning: Skipped MQM result for segment p_005: at least one error was invalid.
• warning: MQM segment coverage is invalid: expected exactly one result for every aligned target segment.

Style Guide

• Enabled: True
• Guide: /home/runner/work/hugging-face-krew.github.io/hugging-face-krew.github.io/workflow/skills/quality/style/hf-blog-ko-translation-guide.md
• Policy: /home/runner/work/hugging-face-krew.github.io/hugging-face-krew.github.io/workflow/skills/quality/configs/style_policy.yml
• Style score: 60.0
• Rule hits: {'link_text_translation': 4, 'list_consistency': 1, 'modal_strength': 4}

Style Guide Findings

Rule	Severity	Segment	Current	Suggested
list_consistency	minor		phrase, sentence, sentence, sentence	Use either sentence-style endings or phrase-style endings consistently within one list.
modal_strength	major	p_015	CLI 명령은 드물게 독립적으로 실행됩니다: 한 단계가 보통 다음 단계(git add가 먼저, 그다음 git commit)를 시사합니다. 많은 hf 명령은 이제 끝에 힌트를 포함합니다: 방금 사용한 ID로 미리 채워진 정확한 다음 명령으로, 사용자나 에이전트가 처음부터 생각하지 않고도 바로 다음 단계로 연결할 수 있게 합니다. 백그라운드에서 작업을 시작하면 로그로 안내하고, Space를 만들면 부트 상태로 안내합니다:	Preserve the strength of can using: 수 있습니다.
modal_strength	major	p_019	hf은 에이전트가 누를 수 없는 키를 기다리며 대화형 프롬프트에 머무르지 않습니다. 파괴적 명령은 여전히 인간의 확인을 요구하지만, 에이전트 모드에서는 메시지에 수정이 포함된 상태로 빠르게 실패합니다(Use --yes to skip confirmation.), 그리고 -y/--yes는 이를 건너뜁니다. 그리고 에이전트는 시간 초과와 맥락 손실에 대해 재시도하므로, 작업은 재실행하기 쉽게 안전하게 설계되어 있습니다: hf repos create --exist-ok는 저장소가 이미 존재하면 무효(무시)이며, 업로드를 다시 실행하면 깔끔하게 재커밋됩니다. 또한 데이터를 실제로 옮기는 명령은 실행 전에 정확히 무엇을 전송할지 보여주는 --dry-run를 취합니다. 이는 사람과 에이전트 모두에게 편리합니다. 긴 다운로드나 무작정 동기화를 피할 수 있기 때문입니다:	Preserve the strength of can using: 수 있습니다.
modal_strength	major	p_040	CLI가 없으면 curl과 SDK는 열 점 차로 뒤처집니다. Sonnet의 경우 작업의 일부를 끝내지 못하기 때문인데, 주로 쓰기 작업이 그렇고, hf CLI가 이를 해결합니다.	Preserve the strength of can using: 수 있습니다.
modal_strength	major	l_046	더 강력한 모델에서 curl과 SDK는 작동하지만 낭비는 여전합니다. Sonnet에서는 작업의 일부를 끝내지 못하고(주로 쓰기), GPT-5.5에서는 대부분 성공적으로 REST 호출을 수동으로 구성하거나 SDK를 사용하지만 여전히 CLI의 토큰 비용보다 많이 지출합니다.	Preserve the strength of can using: 수 있습니다.
link_text_translation	minor		jq	Translate link text while preserving the URL target.
link_text_translation	minor		hf CLI guide	Translate link text while preserving the URL target.
link_text_translation	minor		agent-harnesses.ts	Translate link text while preserving the URL target.
link_text_translation	minor		Register your agent harness	Translate link text while preserving the URL target.

Issues

QL-001 technical / critical

• Message: inline code mismatch.
• Target: hf
• Suggested fix: Preserve source inline code exactly.
• Reason: Hard gate exact-match validator failed: extra=['hf']

QL-002 technical / major

• Message: model or dataset id mismatch.
• Target: curl/SDK, curl/SDK
• Suggested fix: Preserve source model or dataset id exactly.
• Reason: Review gate exact-match validator failed: extra=['curl/SDK', 'curl/SDK']

QL-003 technical / major

• Message: number/unit token mismatch.
• Source: 1, 4.6
• Target: 000, 000, 10, 4, 4, 7
• Suggested fix: Preserve source number/unit token exactly.
• Reason: Review gate exact-match validator failed: missing=['1', '4.6']; extra=['000', '000', '10', '4', '4', '7']

QL-004 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: Designing the hf CLI as an agent-optimized way to work with the Hub
• Target: hf CLI를 에이전트에 최적화된 방식으로 Hugging Face Hub와 함께 작동하도록 설계하기
• Suggested fix: 에이전트에 최적화된 Hub 작업을 위한 hf CLI 설계
• Reason: 의미는 대체로 전달되지만 ‘~와 함께 작동하도록 설계하기’가 영어 구조를 직역한 형태라 제목으로 길고 부자연스럽습니다. ‘agent-optimized’의 핵심인 에이전트 최적화와 Hub 작업 맥락을 더 간결하게 표현하는 편이 자연스럽습니다.

QL-005 terminology / minor

• Message: MQM judge reported terminology issue.
• Source: webhooks
• Target: webhooks
• Suggested fix: 웹훅(webhooks)
• Reason: 앞뒤 항목이 한국어 또는 공식 제품명으로 정리된 가운데 일반 기술 용어인 webhooks가 소문자 영어로만 남아 있어 용어 표기 일관성이 떨어집니다. 첫 등장에서는 검색성을 위해 한국어와 영문을 병기하는 편이 적절합니다.

QL-006 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: an agent hand-rolling curl or the Python SDK
• Target: 에이전트가 curl 요청을 직접 작성하거나 Python SDK를 사용하는
• Suggested fix: 에이전트가 curl을 직접 사용하거나 Python SDK를 사용하는
• Reason: 원문은 에이전트가 curl 또는 Python SDK를 직접 사용해 작업하는 상황을 뜻합니다. ‘curl 요청을 직접 작성하거나’는 curl 자체가 아니라 요청을 작성한다는 의미로 범위를 좁혀 읽힐 수 있어 기술적 표현이 다소 부자연스럽습니다.

QL-007 style_locale / minor

• Message: MQM judge reported style_locale issue.
• Source: <div class="flex justify-center"> <img class="block dark:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/huggingface_hub/chart-users.png" alt="Distinct users of the Hugging Face Hub by coding agent since April 2026. Claude Code leads with 39.5k users and 48.6M requests, then Codex with 34.8k users and 36.4M requests, followed by antigravity, cursor-cli, openclaw, cursor, gemini and pi." width="100%"/> <img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/huggingface_hub/chart-users-dark.png" alt="Distinct users of the Hugging Face Hub by coding agent since April 2026. Claude Code leads with 39.5k users and 48.6M requests, then Codex with 34.8k users and 36.4M requests, followed by antigravity, cursor-cli, openclaw, cursor, gemini and pi." width="100%"/> </div>
• Target: <div class="flex justify-center"> <img class="block dark:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/huggingface_hub/chart-users.png" alt="Distinct users of the Hugging Face Hub by coding agent since April 2026. Claude Code leads with 39.5k users and 48.6M requests, then Codex with 34.8k users and 36.4M requests, followed by antigravity, cursor-cli, openclaw, cursor, gemini and pi." width="100%"/> <img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/huggingface_hub/chart-users-dark.png" alt="Distinct users of the Hugging Face Hub by coding agent since April 2026. Claude Code leads with 39.5k users and 48.6M requests, then Codex with 34.8k users and 36.4M requests, followed by antigravity, cursor-cli, openclaw, cursor, gemini and pi." width="100%"/> </div>
• Suggested fix: alt="2026년 4월 이후 코딩 에이전트별 Hugging Face Hub의 순 사용자 수입니다. Claude Code가 사용자 39.5k명과 요청 48.6M건으로 가장 많고, Codex가 사용자 34.8k명과 요청 36.4M건으로 뒤를 이으며, antigravity, cursor-cli, openclaw, cursor, gemini, pi 순으로 이어집니다."
• Reason: 이미지의 alt 텍스트가 원문 그대로 남아 있어 한국어 현지화가 완료되지 않았습니다. 이미지 경로, HTML 구조, 제품명과 수치는 유지하면서 alt 텍스트를 번역해야 합니다.

QL-008 accuracy / minor

• Message: MQM judge reported accuracy issue.
• Source: we expect it to keep growing as coding agents become a standard way to work with the Hub
• Target: 코딩 에이전트가 Hub와 함께 작업하는 표준 방식으로 자리잡아 가면서 계속 커질 수 있습니다
• Suggested fix: 코딩 에이전트가 Hub와 함께 작업하는 표준 방식으로 자리 잡아 가면서 계속 성장할 것으로 예상합니다.
• Reason: 원문의 ‘we expect’는 계속 성장할 것으로 예상한다는 확신을 나타내지만, 번역은 ‘~할 수 있습니다’로 가능성 수준까지 약화했습니다.

QL-009 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: One command, multiple renderings
• Target: 하나의 명령, 다중 렌더링
• Suggested fix: 하나의 명령으로 여러 렌더링
• Reason: 의미는 전달되지만 ‘다중 렌더링’은 한국어 제목에서 다소 직역투이고, 명령 하나로 여러 결과물을 렌더링한다는 관계가 선명하지 않습니다.

QL-010 accuracy / minor

• Message: MQM judge reported accuracy issue.
• Source: A **human** gets an aligned table, truncated to fit the terminal, plus a hint on how to see more
• Target: 사람은 터미널에 맞춰 정렬된 표와, 화면에 맞게 잘려진 표와 함께 더 보려면 방법에 대한 힌트
• Suggested fix: 사람에게는 터미널에 맞게 잘린 정렬 표와 더 많은 내용을 보는 방법에 대한 힌트가 제공됩니다.
• Reason: 원문은 터미널에 맞게 잘린 정렬 표 하나와 더 많은 내용을 보는 방법에 대한 힌트를 제공한다는 뜻입니다. 번역에서는 ‘정렬된 표’와 ‘잘려진 표’를 별개의 표처럼 병렬로 제시해 구조와 의미가 어색해졌습니다.

QL-011 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: clean to parse and light on tokens
• Target: 파싱하기 쉽고 토큰을 가볍게 유지합니다
• Suggested fix: 파싱하기 쉽고 토큰 사용량도 적습니다
• Reason: ‘토큰을 가볍게 유지합니다’는 한국어 기술 문맥에서 부자연스럽고 원문의 ‘토큰을 적게 사용한다’는 의미를 명확히 전달하지 못합니다.

QL-012 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: In practice, we've implemented logging methods like .table(...), .result(...), .json(), etc., which take raw data as input and handle the formatting.
• Target: 실제로는 원시 데이터를 입력으로 받아 형식을 처리하는 .table(...), .result(...), .json() 등의 로깅 방식들을 구현했습니다.
• Suggested fix: 실제로 원시 데이터를 입력으로 받아 형식 지정까지 처리하는 .table(...), .result(...), .json() 등의 로깅 메서드를 구현했습니다.
• Reason: 의미는 전달되지만 “로깅 방식들”은 기술 문맥에서 다소 부자연스럽고, “형식을 처리하는”도 직역투로 읽힙니다. logging methods를 로깅 메서드로 옮기면 더 명확하고 자연스럽습니다.

QL-013 formatting / minor

• Message: MQM judge reported formatting issue.
• Source: --json and --quiet options
• Target: --json와 --quiet 옵션
• Suggested fix: --json과 --quiet 옵션
• Reason: 옵션명 자체는 보존되었지만, 영문 옵션 뒤 조사는 발음상 “--json과”가 자연스럽습니다. 현재 표기는 읽을 때 어색합니다.

QL-014 style_locale / minor

• Message: MQM judge reported style_locale issue.
• Source: Next-command hints
• Target: Next-command hints
• Suggested fix: 다음 명령어 힌트
• Reason: 일반적인 섹션 제목이 번역되지 않아 한국어 블로그 독자에게 의미가 즉시 전달되지 않습니다.

QL-015 accuracy / major

• Message: MQM judge adequacy score is low.
• Target: 0.7000
• Suggested fix: Review this segment against the MQM judge feedback.
• Reason: MQM adequacy score is below threshold 0.75.

QL-016 fluency / major

• Message: MQM judge fluency score is low.
• Target: 0.7000
• Suggested fix: Review this segment against the MQM judge feedback.
• Reason: MQM fluency score is below threshold 0.75.

QL-017 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: one step usually implies the next
• Target: 한 단계가 보통 다음 단계(git add가 먼저, 그다음 git commit)를 시사합니다
• Suggested fix: 한 단계가 보통 다음 단계로 이어집니다(git add 다음에 git commit).
• Reason: 원문의 ‘한 단계가 보통 다음 단계를 수반한다’는 의미가 ‘다음 단계를 시사한다’로 옮겨져 관계가 추론·암시로 약화되었습니다. 또한 git add와 git commit의 순서를 설명하는 괄호가 문장 안에서 어색하게 결합되어 있습니다.

QL-018 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: the exact next command to run, pre-filled with the IDs you just used
• Target: 방금 사용한 ID로 미리 채워진 정확한 다음 명령으로
• Suggested fix: 방금 사용한 ID가 미리 입력된, 다음에 실행할 정확한 명령을
• Reason: ‘정확한 다음 명령으로’가 문장 구조상 부자연스럽고, ‘명령을 포함합니다’와도 호응하지 않습니다. 원문의 수식 관계를 자연스러운 한국어로 풀어야 합니다.

QL-019 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: Start a Job in the background and it points you to its logs; create a Space and it points you to its boot status
• Target: 백그라운드에서 작업을 시작하면 로그로 안내하고, Space를 만들면 부트 상태로 안내합니다
• Suggested fix: 백그라운드에서 Job을 시작하면 해당 Job의 로그를, Space를 만들면 해당 Space의 부팅 상태를 확인할 수 있는 명령을 안내합니다.
• Reason: Job은 CLI의 기술적 리소스명일 가능성이 높은데 ‘작업’으로 일반화되어 searchable한 기술 용어가 사라졌습니다. 또한 ‘it points you to its logs/status’는 해당 Job/Space의 로그와 부팅 상태를 가리킨다는 뜻인데, 현재 번역은 목적지와 대상이 불분명합니다.

QL-020 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: For a human that's a convenience. For an agent it's a rail: the next action is named, parameterized with the right ids, and ready to run, so it takes fewer steps working out what to do.
• Target: 사람에게는 편의성입니다. 에이전트에게는 레일입니다: 다음 동작은 이름이 붙고, 올바른 ID로 매개변수화되어 실행 준비가 되어 있어, 무엇을 해야 할지 파악하는 단계를 줄여줍니다.
• Suggested fix: 사람에게는 편의 기능입니다. 에이전트에게는 레일과 같습니다. 다음 행동이 이름과 올바른 ID를 포함한 매개변수로 미리 정의되어 바로 실행할 수 있으므로, 무엇을 해야 할지 결정하는 데 필요한 단계가 줄어듭니다.
• Reason: 의미는 대체로 보존되지만 ‘레일입니다’와 콜론 뒤의 수동적·직역식 구조가 한국어 기술 블로그 문장으로 다소 어색합니다. ‘레일’의 비유를 유지하면서도 에이전트가 다음 행동을 더 적은 단계로 결정한다는 흐름을 자연스럽게 풀어 쓰는 편이 좋습니다.

QL-021 accuracy / minor

• Message: MQM judge reported accuracy issue.
• Source: Errors behave the same way, naming the fix instead of just failing:
• Target: 오류도 같은 방식으로 처리되어 수정 방법의 이름을 붙입니다:
• Suggested fix: 오류도 같은 방식으로 작동합니다. 단순히 실패하는 대신 해결 방법을 명시합니다:
• Reason: 원문은 오류가 단순히 실패하는 대신 해결 방법을 명시한다는 뜻인데, 현재 번역의 ‘수정 방법의 이름을 붙입니다’는 한국어에서 의미가 불분명하고 ‘오류가 처리된다’는 수동적 의미를 덧붙입니다.

QL-022 terminology / minor

• Message: MQM judge reported terminology issue.
• Source: hf never sits on an interactive prompt waiting for a key an agent can't press.
• Target: hf은 에이전트가 누를 수 없는 키를 기다리며 대화형 프롬프트에 머무르지 않습니다.
• Suggested fix: hf는 에이전트가 누를 수 없는 키를 기다리며 대화형 프롬프트에 머무르지 않습니다.
• Reason: CLI 이름 hf 뒤에 한국어 조사를 바로 붙여 hf은으로 표기해 검색성과 가독성이 떨어집니다. 보존된 명령줄 도구 이름을 코드 형식으로 표시하거나 문장 구조를 조정하는 편이 적절합니다.

QL-023 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: in agent mode it *fails fast* with the fix in the message (Use --yes to skip confirmation.)
• Target: 에이전트 모드에서는 메시지에 수정이 포함된 상태로 빠르게 실패합니다(Use --yes to skip confirmation.)
• Suggested fix: 에이전트 모드에서는 메시지에 해결 방법을 포함해 즉시 실패합니다(확인 절차를 건너뛰려면 --yes를 사용하세요).
• Reason: 원문의 with the fix in the message는 오류 메시지에 해결 방법이 함께 제공된다는 뜻인데, 메시지에 수정이 포함된 상태는 부자연스럽고 기술적 의미가 불명확합니다. 또한 영어 안내문을 그대로 두어 한국어 문맥과 일관되지 않습니다.

QL-024 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: hf repos create --exist-ok is a no-op if the repo already exists
• Target: hf repos create --exist-ok는 저장소가 이미 존재하면 무효(무시)이며
• Suggested fix: hf repos create --exist-ok는 저장소가 이미 존재하면 아무 작업도 수행하지 않으며
• Reason: no-op는 명령이 아무 동작도 하지 않는다는 의미입니다. 무효(무시)는 명령 자체가 유효하지 않거나 무시된다는 뜻으로 읽힐 수 있어 기술적 동작을 명확히 전달하지 못합니다.

QL-025 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: the commands that move real data take a --dry-run that shows exactly what they'll transfer before they run
• Target: 데이터를 실제로 옮기는 명령은 실행 전에 정확히 무엇을 전송할지 보여주는 --dry-run를 취합니다.
• Suggested fix: 실제 데이터를 옮기는 명령에는 실행 전에 전송할 내용을 정확히 보여주는 --dry-run 옵션이 있습니다.
• Reason: --dry-run를 취합니다는 한국어 기술 문장으로 부자연스럽고, 명령이 --dry-run 옵션을 지원한다는 의미를 정확히 표현하지 못합니다. 옵션 표기는 코드 형식으로 유지하는 것이 좋습니다.

QL-026 accuracy / minor

• Message: MQM judge reported accuracy issue.
• Source: since neither has to commit to a long download or blind sync:
• Target: 긴 다운로드나 무작정 동기화를 피할 수 있기 때문입니다:
• Suggested fix: 긴 다운로드나 맹목적인 동기화를 감수할 필요가 없기 때문입니다:
• Reason: 원문은 사전에 긴 다운로드나 맹목적인 동기화를 감수하지 않아도 된다는 뜻인데, 피할 수 있기 때문입니다는 회피가 보장되는 것처럼 다소 강하게 표현합니다. 실행 전에 내용을 확인할 수 있어 해당 작업을 감수할 필요가 없다는 의미를 유지해야 합니다.

QL-027 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: Discoverable, predictable commands
• Target: 검색 가능하고 예측 가능한 명령
• Suggested fix: 쉽게 찾고 동작을 예상할 수 있는 명령
• Reason: 의미는 전달되지만 '검색 가능하고'와 '예측 가능한 명령'은 한국어 제목으로 다소 직역투이며, 명령을 쉽게 찾고 동작을 예상할 수 있다는 의미가 자연스럽게 드러나지 않습니다.

QL-028 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: hf is built to be probed: run hf to see the resource groups, run --help on the one you need, and every --help ends with real, copy-pasteable examples (which an agent matches against far faster than it parses a description):
• Target: hf는 탐색 가능하게 설계되었습니다: 리소스 그룹을 보려면 hf를 실행하고, 필요한 항목에서 --help를 실행하며, 모든 --help은 실제로 복사-붙여넣기 가능한 예제로 끝납니다(에이전트가 설명을 파싱하는 것보다 훨씬 빠르게 매칭합니다):
• Suggested fix: hf는 직접 살펴볼 수 있도록 설계되었습니다. 리소스 그룹을 확인하려면 hf를 실행하고, 필요한 항목에서 --help를 실행해 보세요. 각 --help의 끝에는 그대로 복사해 붙여 넣어 실행할 수 있는 실제 예제가 포함되어 있어, 에이전트가 설명을 파싱하는 것보다 훨씬 빠르게 대조할 수 있습니다.
• Reason: 의미는 대체로 보존되지만 ‘탐색 가능하게 설계되었습니다’, 콜론과 긴 병렬 구조, ‘매칭합니다’가 영어식이고 문장이 어색합니다. 기술 명령어를 유지하면서 한국어 문장 구조로 다듬는 것이 좋습니다.

QL-029 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: The command tree is consistent, **resource + verb** with the obvious aliases (hf models ls, hf repos create, hf jobs ps, hf collections delete; list/ls, remove/rm), so once an agent learns one command it can guess the rest.
• Target: 명령 트리는 일관되게, **리소스 + 동사** 구조이며, 명확한 별칭들(hf models ls, hf repos create, hf jobs ps, hf collections delete; list/ls, remove/rm)으로 구성되어 있어, 에이전트가 한 명령을 배우면 나머지도 추정할 수 있습니다.
• Suggested fix: 명령 트리는 리소스 + 동사 구조로 일관되며, 명확한 별칭(hf models ls, hf repos create, hf jobs ps, hf collections delete; list/ls, remove/rm)도 제공합니다. 따라서 에이전트가 명령 하나를 배우면 나머지도 추측할 수 있습니다.
• Reason: ‘일관되게, ... 구조이며’와 ‘명확한 별칭들 ... 으로 구성되어 있어’가 영어식으로 연결되어 문장이 어색합니다. 의미는 대체로 보존되지만 한국어 문장 구조로 다듬을 필요가 있습니다.

QL-030 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: -q prints one id per line to pipe into the next command, --json gives you something to hand to jq.
• Target: -q는 한 줄에 하나의 ID를 출력해 다음 명령으로 파이프에 연결하고, --json는 jq에 넘길 수 있는 무언가를 제공합니다.
• Suggested fix: -q는 한 줄에 하나의 ID를 출력하므로 다음 명령으로 파이프할 수 있고, --json은 jq에 전달할 출력을 제공합니다.
• Reason: ‘다음 명령으로 파이프에 연결하고’와 ‘무언가를 제공합니다’는 기술적 의미를 이해할 수 있지만 부자연스럽고 번역투가 강합니다. 특히 --json의 출력이 jq에 전달할 수 있는 JSON이라는 기능이 흐려집니다.

QL-031 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: across both agents the hf CLI comes out ahead
• Target: 두 에이전트의 모든 경우에서 hf CLI가 앞섰고
• Suggested fix: 두 에이전트 모두에서 hf CLI가 앞섰고
• Reason: 원문은 두 에이전트 모두에서 hf CLI가 더 나은 결과를 냈다는 뜻인데, ‘모든 경우에서’는 모든 실행 사례에서 예외 없이 앞섰다는 의미를 추가해 범위를 과도하게 넓힙니다.

QL-032 technical / major

• Message: MQM judge reported technical issue.
• Source: curl / Python SDK
• Target: curl/SDK
• Suggested fix: curl / Python SDK
• Reason: 원문의 Python이 삭제되고 curl / Python SDK가 curl/SDK로 축약되어 표 항목의 구체적인 인터페이스 정보가 누락되었습니다. Python SDK를 별도의 항목으로 명시해야 합니다.

QL-033 technical / major

• Message: MQM judge reported technical issue.
• Source: curl / Python SDK
• Target: curl/SDK
• Suggested fix: curl / Python SDK
• Reason: 원문의 Python SDK가 SDK로 축약되어 Python이라는 기술 정보가 누락되었습니다. 표의 열 의미나 사용 가능한 인터페이스를 오해하게 만들 수 있습니다.

QL-034 accuracy / minor

• Message: MQM judge reported accuracy issue.
• Source: self-report error = the agent reported success on the 17 solvable tasks but the Hub said otherwise.
• Target: self-report error = 에이전트가 17개의 해결 가능한 작업에서 성공을 보고했으나 Hugging Face Hub가 다르게 말한 경우입니다.
• Suggested fix: *(자체 보고 오류(self-report error) = 에이전트는 해결 가능한 17개 작업에서 성공했다고 보고했지만, Hub의 판정은 달랐습니다.
• Reason: ‘self-report error’는 에이전트의 자체 보고와 Hub의 실제 판정이 불일치한 오류를 뜻하는데, 현재 번역은 ‘자체 보고 오류’라는 용어를 직접 설명하지 않아 주석의 핵심 레이블이 약화되었습니다. 또한 ‘the Hub’는 제품명인 Hub로 유지하는 편이 검색성과 명확성에 적합합니다.

QL-035 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: The hf CLI rows are the CLI with its skill installed; what the skill adds on top of the bare CLI (chiefly fewer tool calls) is broken out in the skill section below.
• Target: hf CLI 행은 스킬이 설치된 CLI이고, 기본 CLI 위에서 스킬이 추가하는 효과(주로 더 적은 도구 호출)는 아래 스킬 섹션에서 분리해 다룹니다.
• Suggested fix: hf CLI 행은 스킬이 설치된 CLI를 뜻합니다. 기본 CLI에 스킬이 추가하는 부분(주로 도구 호출 횟수 감소)은 아래 스킬 섹션에서 별도로 설명합니다.
• Reason: ‘what the skill adds on top of the bare CLI’와 ‘is broken out’의 관계가 직역투로 표현되어 문장이 다소 어색합니다. ‘hf CLI’와 ‘CLI’는 보존하되, 스킬이 기본 CLI에 더하는 차이를 아래 섹션에서 별도로 설명한다는 뜻으로 자연스럽게 풀어 쓰는 편이 명확합니다.

QL-036 accuracy / minor

• Message: MQM judge reported accuracy issue.
• Source: Representative transcripts are published in this bucket.
• Target: 대표 대화 기록은 이 버킷에 게시됩니다.
• Suggested fix: 대표 대화 기록은 이 버킷에 게시되어 있습니다.
• Reason: 원문은 대표 대화 기록이 해당 버킷에 이미 공개되어 있다는 사실을 현재형으로 서술합니다. ‘게시됩니다’는 향후 게시될 예정이라는 의미로도 읽혀 시제가 약간 달라질 수 있습니다.

QL-037 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: Each task goes to a fresh coding agent with exactly **one** way to talk to the Hub:
• Target: 각 작업은 Hugging Face Hub에 대해 정확히 하나의 대화 방식으로 대화하는 최신 코딩 에이전트로 전달됩니다:
• Suggested fix: 각 작업은 Hub와 통신하는 방법이 정확히 하나뿐인 새 코딩 에이전트에 전달됩니다:
• Reason: ‘fresh coding agent’는 각 작업에 새로 할당되는 코딩 에이전트를 뜻하지만, ‘최신 코딩 에이전트’로 번역되어 ‘fresh’의 의미가 ‘latest’로 바뀌었습니다. 또한 ‘with exactly one way to talk to the Hub’는 에이전트가 Hub와 통신하는 방법이 정확히 하나라는 뜻인데, 현재 번역은 ‘대화 방식으로 대화하는’ 구조가 어색하고 주체와 관계가 불명확합니다.

QL-038 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: aggregate a trending org's models, inspect a repo's files and their sizes
• Target: 트렌딩 조직의 모델을 집계하고, 리포지토리의 파일과 용량을 검사하고
• Suggested fix: 인기 조직의 모델을 집계하고, 리포지토리의 파일과 파일 크기를 확인하고
• Reason: ‘trending org’의 ‘trending’을 ‘트렌딩’으로 그대로 옮기면 기술 블로그 한국어에서 다소 부자연스럽고, 파일의 ‘sizes’를 ‘용량’ 하나로 처리하면 파일 크기라는 의미가 덜 명확합니다. ‘org’와 ‘repo’도 문서 전체 용어에 맞춰 조직과 리포지토리로 일관되게 다듬는 편이 자연스럽습니다.

QL-039 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: the agent falls back to curl against the REST API or the huggingface_hub Python library
• Target: 에이전트는 REST API에 대해 curl을 사용하거나 huggingface_hub Python 라이브러리에 의존합니다.
• Suggested fix: 에이전트는 REST API에 curl을 사용하거나 huggingface_hub Python 라이브러리를 대신 사용합니다.
• Reason: 기술적 의미는 보존되지만, ‘REST API에 대해 curl을 사용하거나’와 ‘라이브러리에 의존합니다’는 영어식이고 원문의 대체 수단(falls back) 관계가 다소 어색하게 전달됩니다.

QL-040 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: We run the hf CLI in two configurations, with and without its skill (a generated command reference we come back to in its own section).
• Target: 우리는 hf CLI를 두 가지 구성으로 실행합니다: 스킬이 있는 구성과 없는 구성(생성된 명령 참조는 별도 섹션에서 다시 다룹니다).
• Suggested fix: hf CLI는 스킬이 있는 구성과 없는 구성, 두 가지로 실행합니다. 스킬은 생성된 명령어 참조이며, 이에 대해서는 별도 섹션에서 다시 설명합니다.
• Reason: 콜론과 괄호를 원문 구조대로 옮겨 문장이 다소 딱딱하고 번역투로 읽힙니다. 또한 공식 기술 블로그 문맥에서는 불필요한 '우리는'을 생략하는 편이 자연스럽습니다.

QL-041 accuracy / minor

• Message: MQM judge reported accuracy issue.
• Source: the skill's incremental effect is small enough that we break it out on its own rather than crowd it into the main results
• Target: 스킬의 증가 효과는 충분히 작아서 메인 결과에 포함시키기보다 독립적으로 다룹니다.
• Suggested fix: 스킬의 추가 효과는 충분히 작기 때문에 주요 결과에 억지로 포함하는 대신 별도로 제시합니다.
• Reason: incremental effect는 '증가 효과'보다 추가적으로 발생하는 영향이나 효과를 뜻합니다. 현재 번역은 효과가 증가한다는 의미로 읽힐 수 있어 원문의 비교 맥락을 정확히 전달하지 못합니다.

QL-042 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: We ran the whole thing twice, on the two most popular coding agents (**Claude Code** with Sonnet 4.6 and **OpenAI Codex** with GPT-5.5).
• Target: 이를 두 에이전트(가장 인기 있는 두 코딩 에이전트: Claude Code와 OpenAI Codex)에서 각각 수행했습니다.
• Suggested fix: 이를 가장 인기 있는 두 코딩 에이전트인 (Claude Code(Sonnet 4.6)와 OpenAI Codex(GPT-5.5))에서 각각 두 번 수행했습니다.
• Reason: 원문에 있는 두 번째 실행의 구체적 조건인 Sonnet 4.6과 GPT-5.5가 누락되었습니다. 또한 모델 정보가 빠져 어떤 설정으로 실험했는지 확인할 수 없습니다.

QL-043 terminology / minor

• Message: MQM judge reported terminology issue.
• Source: no custom MCP servers, no CLAUDE.md or AGENTS.md, nothing in context to nudge behavior
• Target: 커스텀 MCP 서버 없음, CLAUDE.md나 AGENTS.md도 없음, 맥락에서의 동작을 좌우하는 어떠한 nudges도 없음
• Suggested fix: 커스텀 MCP 서버 없음, CLAUDE.md나 AGENTS.md도 없음, 컨텍스트에서 동작을 유도하는 요소도 없음
• Reason: 일반 기술 용어인 nudges를 영어로만 남겨 한국어 문장 안에서 의미가 불분명합니다. 행동을 유도할 만한 맥락상의 요소가 없다는 뜻으로 옮기는 편이 명확합니다.

QL-044 fluency / minor

• Message: MQM judge reported fluency issue.
• Source: by **re-querying the live Hub**
• Target: 라이브 Hub를 재질의로 재조회하여
• Suggested fix: 라이브 Hub를 다시 조회해
• Reason: 재질의로 재조회하여는 중복적이고 번역투가 강합니다. 원문의 검증 행위를 자연스럽게 표현할 수 있습니다.

QL-045 accuracy / major

• Message: MQM judge reported accuracy issue.
• Source: and ~1,000 graded runs in total
• Target: 약 **520회 실행**(18개 작업 × 3개 도구 × 10회 반복, 하나의 청구 가능한 Jobs 작업에 대한 상한 제외) 정도의 총 평가 실행이 필요합니다.
• Suggested fix: 전체적으로 약 1,000회의 평가 실행이 이루어졌습니다.
• Reason:

SEO report — ✅ Pass

SEO Eval Report

Gate: ✅ PASS — deterministic AND rubric

• File: ../target/_posts/2026-06-04-hf-cli-for-agents.md
• Source: —
• Primary keyword: (none — D5 skipped)
• Mode: file

Gate

• Status: PASS
• Blockers: ✅ pass
• Deterministic REQUIRED (D1–D7): ✅ pass
• Rubric (R1–R6): ✅ pass (mean None, min None)

Blockers

✅ body_not_empty: Body is not empty
✅ robots_indexable: Robots is indexable
✅ internal_links_resolve: All internal links resolve
✅ local_images_resolve: All local images resolve

Required checks (gated)

✅ heading_hierarchy: Heading hierarchy: Valid
✅ alt_text_coverage: Alt text coverage: 8/8 images
✅ descriptive_alt_text: Descriptive alt text: 8/8 (≥80% recommend)
✅ image_files_exist: All 0 local image file(s) exist

OpenAI rubric checks

✅ semantic_metadata: PASS (required) — 모든 주요 의미 요소가 원문과 일치합니다.
✅ alt_semantics: PASS (review) — —

Advisory checks (not gated)

✅ opening_summary: Opening 3 paragraphs: 66 words (recommend ≥50 for GEO)
✅ h1_count: Markdown H1 count: 1 (review against rendered layout)
✅ citations: Citations/statistics: 19 (recommend ≥1 for GEO)
⚠️ question_headings: Scannable H2/H3 (question or keyword): 0 (0 question, 0 keyword)
✅ internal_links: Internal links: 2 (recommend 2-3)
✅ word_count: Word count: 2614 (recommend ≥300)
ℹ️ primary_keyword: No primary_keyword in manifest — keyword check skipped
⚠️ webp_format: WebP format: 0/8 images (≥50% recommend)
⚠️ lazy_loading: Lazy loading: 0 images (optional)

Signals (evidence — not directly gated)

• Frontmatter: title 55 chars, description 64 chars, author present True
• Title text: hf CLI를 에이전트에 최적화된 방식으로 Hugging Face Hub와 함께 작동하도록 설계하기
• Description text: Hugging Face Hub 작업을 코딩 에이전트에 맞게 단순화한 hf CLI 설계와 벤치마크 결과를 소개합니다.
• Opening text: * TOC
  {:toc}

이 글은 Hugging Face 블로그의 Designing the hf CLI as an agent-optimized way to work with the Hub를 한국어로 번역한 글입니다.

• Opening: first paragraph 181 chars, first 3 paragraphs 438 chars
• Headings: markdown H1 1, rendered effective H1 2, layout title H1 True
• Links: total 8, external 6, internal 0, citation signals 19
• Images: total 8, empty alt 0, filename-like alt 0, missing local files 0

Semantic review packet

• Title: hf CLI를 에이전트에 최적화된 방식으로 Hugging Face Hub와 함께 작동하도록 설계하기
• Description: Hugging Face Hub 작업을 코딩 에이전트에 맞게 단순화한 hf CLI 설계와 벤치마크 결과를 소개합니다.
• Rendered H1 candidates: hf CLI를 에이전트에 최적화된 방식으로 Hugging Face Hub와 함께 작동하도록 설계하기, hf CLI를 에이전트에 최적화된 방식으로 Hugging Face Hub와 함께 작동하도록 설계하기
• Opening: * TOC
  {:toc}

이 글은 Hugging Face 블로그의 Designing the hf CLI as an agent-optimized way to work with the Hub를 한국어로 번역한 글입니다.

• Canonical/permalink: —
• Instruction: Compare title, description, rendered H1, and opening text for meaning consistency. This packet is evidence only; it does not decide pass/fail.

Frontmatter (advisory — written by metadata step, not gated)

✅ title: Title: 55 chars (recommend ≤60)
✅ description: Description: 64 chars (semantic quality reviewed separately)
✅ image: OG image: assets/images/blog/posts/2026-06-04-hf-cli-for-agents/thumbnail.png
✅ categories: Categories: 2 (recommend 2-3)
✅ author: Author: dailybot

SEO metadata suggestion — PARTIAL

This is a suggestion. SEO is applied only when the post frontmatter is updated.
To apply safe fields from a partial suggestion, leave a trusted PR comment: metadata apply.

• Auto apply: False
• Requires human: True
• Mode: frontmatter_only
• Reason: metadata candidate needs policy decisions or missing title/description

Candidate

• title: hf CLI를 에이전트에 최적화된 방식으로 Hugging Face Hub와 함께 작동하도록 설계하기
• description: Hugging Face Hub 작업을 코딩 에이전트에 맞게 단순화한 hf CLI 설계와 벤치마크 결과를 소개합니다.
• categories: ['Translation', 'HuggingFace']
• image: assets/images/blog/posts/2026-06-04-hf-cli-for-agents/thumbnail.png

Needs policy decision

• target_url
• source_url
• canonical_policy
• translation_indexing
• target_locale
• source_locale

Warnings

• source_url is empty in evidence
• content appears to be a translation of a Hugging Face blog post

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://hugging-face-krew.github.io/pr-preview/pr-181/
Built to branch gh-pages at 2026-08-02 14:18 UTC. Preview will be ready when the GitHub Pages deployment is complete.