root-cause-first SKILL.md skillA
root-cause-first from jeong-sik/masc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jeong-sik/masc/root-cause-first@git:20261013.f2be3c7Pins git:20261013.f2be3c7 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jeong-sik/masc
- Path
skills/root-cause-first/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261013.f2be3c7, committed Oct 13, 2026
- First version recorded
- Sep 15, 2026
- Size
- 3,928 bytes
- Repository stars
- 4
- License
- MIT
버그·테스트 실패·런타임 예외에서 다음 행동을 고를 때, 실패 증거와 가설을 연결해 원인을 좁히고 수정한다. 이미 확보한 재현·로그를 재사용하고, 가설을 구분하는 관측만 추가한다. 원인이 분명한 오타 수정에는 생략한다. 환경 준비가 막히면 원래 작업의 완료 조건을 보존한 채 환경 문제를 분리한다. 같은 실패를 조건 변화 없이 반복하거나, 로그·문자열 분기·상한으로 증상만 가리려 할 때 사용한다.
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
# 근본 원인 먼저 ## 언제 쓰나 - 테스트가 빨갛다. 빌드는 되는데 스위트가 실패한다. 기본 브랜치가 안 빌드된다. - 런타임에 예외가 뜬다. 턴이 죽는다. 판정 레인이 거절한다. - "어제까지 됐는데 안 된다." 그 사이 누가 무엇을 바꿨는지 모른다. 원인이 이미 보이는 수정에는 쓰지 않는다. 오타 하나, 빠진 구분자, 컴파일러가 정확히 짚어 준 한 줄은 그냥 고친다. ## 원칙 **원인을 밝히기 전에 고치지 않는다.** 증상이 사라지는 것과 원인이 사라지는 것은 다르다. 인증이 안 된다고 인증을 끄는 것은 해결이 아니다. ## 네 단계 이미 확보한 증거에서 이어간다. 부족한 단계만 보완한다. 1. **실패 증거.** 입력, 기대 결과, 실제 오류와 환경을 적는다. 기존 로그나 재현이 같은 조건을 다루면 재사용한다. 재현이 안 되면 가설을 구분할 입력이나 관측을 고른다. 시간만 늘려 같은 동작을 반복하지 않는다. 2. **원인.** 증상에서 거슬러 올라간다. 스택을 따라가고, 마지막으로 됐던 커밋과 지금을 `git log --oneline` 으로 가른다. "여기서 틀렸다"가 아니라 "여기서부터 틀리기 시작했다"를 찾는다. 3. **가설.** 원인을 한 문장으로 쓰고, 그게 맞다면 무엇을 바꿨을 때 무엇이 달라지는지 예측한다. 예측 없는 수정은 추측이다. 4. **수정.** 가설이 가리킨 자리만 고친다. 1의 재현을 다시 돌려 증상이 사라졌는지, 다른 것이 깨지지 않았는지 본다. 환경 준비가 원래 작업을 막으면 오류·재현 명령·작업 경로와 필요한 수리를 분리해 기록하고 담당 Keeper에게 전달한다. 원래 완료 조건과 다음 단계는 보존한다. 수리가 끝나면 원래 작업의 남은 단계에서 이어간다. ## 가설을 다시 확인할 신호 - 같은 조건에서 같은 수정이 실패한다 → 호출하는 쪽을 하나씩 막는 것을 멈추고, 그 실수가 생길 수 없게 만드는 한 곳(타입, 공용 함수, 검사 도구)을 찾는다. - "일단 이렇게 넘기고"라고 쓰고 있다 → 그게 증상 가리기다. 왜 넘어가야 하는지부터 본다. - 수정 범위가 넓어진다 → 같은 원인을 고치는 데 필요한지 확인한다. 새 증거가 가설을 뒤집었다면 가설을 수정하고, 그대로 유효한 증거는 보존한다. - 고친 결과가 "이제 실패가 보인다"뿐이다 → 카운터나 로그는 경보다. 실패는 그대로 난다. …
Read the whole file at its exact version.
How to install
mdr add jeong-sik/masc/root-cause-first@sha256:33fd1ece0bd43e68The line at the top of this page pins the label git:20261013.f2be3c7, 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_ccv2iueopbp3glya)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Sep 15, 2026 and Oct 13, 2026, about one every 28 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261013.f2be3c7 latest | 2026-10-13 | f2be3c7 | 3,928 B | A | view · diff |
| git:20260915.1b5578d | 2026-09-15 | 1b5578d | 3,452 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 (3928 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
jeong-sik/masc · 4 stars · license MIT · pushed 2026-11-04 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ccv2iueopbp3glya GET https://markdownregistry.com/api/v1/resolve?ref=jeong-sik/masc/root-cause-first GET https://markdownregistry.com/api/v1/blob/33fd1ece0bd43e68418374f55cf6846fa6c60cf8138d2aa7d257cec9255d1072
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.