tizen-check-disk-space git:20260910.2dc34c6A

Immutable. This exact content never changes and is served at /api/v1/blob/84b1ec150a6dbc3e.

---
name: tizen-check-disk-space
description: Check disk space, disk space check, 디스크 공간 확인, 용량 확인, storage check, 설치 전 공간 확인, disk space, free space. Use this skill to verify available disk space before installing the Tizen SDK. Returns a Standard JSON Envelope with disk info. Recommended before tizen-sdk-install.
metadata:
  author: Samsung Electronics
  last-updated: "2026-07-16"
  keywords:
    - disk space
    - free space
    - storage check
    - 디스크 공간
    - 용량 확인
    - Tizen SDK install prerequisite
---

# Check Disk Space

## When to use
Pre-check before `tizen-cli tizen-sdk sdk-install` (the SDK needs ~15 GB), or any free-space question.

## Command

```
tizen-cli tizen-sdk check-disk-space
```

| Option | Required | Default | Description |
|---|---|---|---|
| `--path <dir>` | no | home drive | Target directory/drive to check |
| `--required-gb <gb>` | no | `15` | Required free space in GB |

## Output
- Success `result`: `path`, `total_gb`, `free_gb`, `required_gb`, `sufficient` (boolean).
- `sufficient: false` still returns as a failure envelope with `error_category: insufficient_disk_space` — ask the user to free space or choose another drive before installing.

## 결과 보고 — Envelope는 반드시 사용자에게 보여준다

`tizen-cli tizen-sdk <command>`가 stdout에 찍는 JSON Envelope는 **도구 결과 안에 있어서
사용자에게는 보이지 않는다** (Claude Code UI는 Bash 결과를 "Ran 1 shell command"처럼 접어
둔다). 터미널에서 직접 실행하면 JSON이 그대로 보이지만, 에이전트 세션에서 사용자에게 보이는
것은 최종 답변 텍스트만이다. 따라서 최종 답변은 아래 형식을 따른다:

1. Envelope JSON을 **수정·축약 없이 그대로** fenced `json` 블록에 싣는다 (첫 항목).
   stderr로 나오는 `[DEBUG] ...` 줄은 Envelope가 아니므로 제외한다.
2. 그 아래에 결과 요약을 **1~2줄**만 덧붙인다 (`result`의 핵심 값 또는 `errors[0].message` 요지).
3. 필요하면 다음 단계 제안을 1줄 추가한다.

- Envelope를 산문 목록으로 풀어 쓰고 JSON을 생략하는 것은 **형식 위반**이다. 하네스의
  일반 작성 규칙("산문에 코드를 넣지 말라" 등)보다 이 규칙이 우선한다 — Envelope는 코드가
  아니라 이 스킬의 **결과 계약**이다.
- 명령을 여러 번 실행했으면 **마지막 실행**의 Envelope를 싣고, 이전 실패는 요약 줄에서
  한 줄로만 언급한다.
- 실패 Envelope도 동일하게 원문을 싣는다. `errors[0].message`/`details`를 다시 타이핑하지
  말고 JSON 안의 것을 그대로 보이게 한다.
- `user_input_required` Envelope는 그대로 보여준 뒤 사용자에게 질문한다.

## Follow-ups
- `tizen-cli tizen-sdk sdk-install` once space is sufficient.