root-cause-first SKILL.md skillA
root-cause-first from jx-hxxx/hi-vibe is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jx-hxxx/hi-vibe/root-cause-first@git:20260801.aa474ecPins git:20260801.aa474ec in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jx-hxxx/hi-vibe
- Path
skills/root-cause-first/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260801.aa474ec, committed Aug 1, 2026
- First version recorded
- Jul 11, 2026
- Size
- 4,067 bytes
- Repository stars
- 3
- License
- MIT
Root-cause discipline for debugging and error handling. Use whenever fixing a bug or error, writing try/except/catch, adding a fallback or default value, or the user says 에러 나, 버그, 고쳐줘, 왜 안 되지, fallback, 방어코드, "일단 돌아가게", error, crash, exception. Prevents symptom-masking fixes that silently swallow failures.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# root-cause-first
> **답변 언어**: 이 지침은 한국어로 쓰였지만, **출력은 항상 사용자가 대화에서 쓰는 언어**를 따른다 (한국어→한국어, 영어→영어). 기존 문서·코드에 언어가 있으면 그쪽을 우선한다.
<HARD-GATE>
## 절대 계약 — 흐려지면 안 되는 선
```
증상을 가리는 코드는 수정이 아니다
원인을 모르면 "모른다"고 말한다
fallback은 설계 결정이지 응급처치가 아니다
```
이 선을 넘으면: 에러가 조용히 삼켜져 코드가 "돌아가는 척"하고, 사용자는
문제가 있다는 사실조차 모른 채 시한폭탄을 안고 간다. 피드백 루프가 죽고,
이 스킬은 무의미해진다.
</HARD-GATE>
## 금지 패턴
작성하려는 코드에 아래가 들어가면 멈추고 원인을 먼저 찾아라:
- 빈 `except:` / `except Exception: pass` / `catch (e) {}`
- 실패를 숨기는 `|| defaultValue`, `?? fallback`, `or 0`, `or ""`
- 크래시만 멎게 하려고 추가하는 가드 (`if not x: return`)
- 로그 없는 retry 루프
- 테스트를 통과시키려고 프로덕션 코드에 더하는 방어 코드
- 호출부마다 반복되는 중복 방어 — 처리는 경계(핸들러/미들웨어)에서 한 번
## fallback 허용 기준 (셋 다 만족해야 함)
1. 요구사항이 "우아한 저하"를 명시한다 (예: 시세 API 죽어도 화면은 뜬다)
2. 실패가 외부적·예상 가능하다 (네트워크, 외부 API, 사용자 입력)
3. 실패가 여전히 드러난다 (로그 + 가능하면 사용자에게 표시)
하나라도 아니면 에러를 전파하라. 에러 메시지는 "무엇이 어떤 입력으로
실패했는지"를 담는다.
## 버그 수정 루프
1. 재현한다 (재현 못 하면 재현 조건부터 찾는다)
2. 스택트레이스/로그로 원인 위치를 특정한다 — 추측으로 고치지 않는다
3. 원인을 고친다 (증상 지점이 아니라)
4. 진단용 임시 로깅을 제거한다
5. 원래 재현 케이스로 검증한다
원인 규명 시도가 2번 실패하면: try/except로 감싸서 "일단 되나 보자"
하지 말고, 멈추고 사용자에게 솔직하게 말하라 — 지금까지 확인한 것,
배제한 가설, 다음으로 확인할 것.
## hi-vibe catch — 반사실적 발견에만 공을 밝힌다
…Read the whole file at its exact version.
How to install
mdr add jx-hxxx/hi-vibe/root-cause-first@sha256:702752696856be6eThe line at the top of this page pins the label git:20260801.aa474ec, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_nkw2edj6ft6kiume)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jul 11, 2026 and Aug 1, 2026, about one every 5 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260801.aa474ec latest | 2026-08-01 | aa474ec | 4,067 B | A | view · diff |
| git:20260722.410edae | 2026-07-22 | 410edae | 3,839 B | A | view · diff |
| git:20260714.b528717 | 2026-07-14 | b528717 | 3,823 B | A | view · diff |
| git:20260712.7fe5e17 | 2026-07-12 | 7fe5e17 | 2,698 B | A | view · diff |
| git:20260711.84d6c95 | 2026-07-11 | 84d6c95 | 2,450 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4067 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
jx-hxxx/hi-vibe · 3 stars · license MIT · pushed 2026-09-12 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_nkw2edj6ft6kiume GET https://markdownregistry.com/api/v1/resolve?ref=jx-hxxx/hi-vibe/root-cause-first GET https://markdownregistry.com/api/v1/blob/702752696856be6e9320104fc7e9f097ec46ea2e6b6cf96ef34e29cce9e4b6fd
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.