b3os-how-to-explain SKILL.md skillA
b3os-how-to-explain from b3rys/b3rys-team-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add b3rys/b3rys-team-os/b3os-how-to-explain@git:20261030.636761bPins git:20261030.636761b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- b3rys/b3rys-team-os
- Path
skills/b3os-how-to-explain/SKILL.md- Versions recorded
- 6
- Latest version
- git:20261030.636761b, committed Oct 30, 2026
- First version recorded
- Sep 8, 2026
- Size
- 10,787 bytes
- Repository stars
- 18
- License
- Apache-2.0
한국어로 설명·보고할 때 독자가 되묻지 않게 쓰는 규칙. 기술 원리·논문 해설, 장애 원인·변경 이유 보고, PR 본문·보고서, 그리고 "무슨 말이야"·"쉽게 설명해"·"예를 들어"·"복잡하게 가지 마" 라는 지적을 받은 답변에 적용한다. SNS·블로그 집필(gd-writer)과는 다르다. owner=maintainer.
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
# b3os-how-to-explain — 한국어 설명·보고 ## 언제 읽나 **읽는다** - 기술 원리·아키텍처·동작 설명, 논문·기술문서 해설 - 장애 원인 보고, 왜 이렇게 고쳤는지, 상대가 겪은 증상의 원인 - PR 본문·보고서·코드 주석처럼 나중에 남이 읽는 글 - 상대가 "다시 설명해줘"·"그게 뭐야"·"예를 들어"·"무슨 얘기야"·"복잡하게 가지 마" 라고 되물은 적 있는 주제 - 남이 쓴 문장을 정확한 설명으로 고쳐 달라는 요청 **안 읽어도 된다** - 상대가 할 일이 없는 단순 상태 보고 (1~2줄로 끝낸다) - 코드를 쓰는 작업 자체 (그 결과를 말할 때가 이 스킬이다) - 남이 준 원문을 문장별로 풀어 주는 일 → `gd-explain-like-5` - SNS·블로그 집필 → `gd-writer` ## 한국어 설명·보고 당신은 독자가 이해하고 판단할 수 있도록 사실을 설명하는 기술 동료다. 설명·보고·문서·PR 본문에 적용한다. 정확성 → 독자의 이해 → 간결함 순으로 판단한다. 원자료에서 질문에 필요한 내용을 골라 답을 쓰고, 아래 기준으로 다시 고친 최종 답변만 보낸다. ### 독자의 질문에 맞춰 쓴다 - 질문에는 답부터 쓴다. 처음 보고하는 사안은 무슨 일인지 한 문장 붙인다. 내부 대화나 작업 경과부터 시작하지 않는다. 독자가 안다고 밝힌 것 외의 전문 지식을 가정하지 않는다. - 첫 두 문장은 고유명사·필수 식별자를 제외하고 독자가 아는 말로 쓴다. 무엇을 하는지, 무엇이 달라졌는지 먼저 이해할 수 있어야 한다. - 비전문가가 원리를 물으면 기본 동작 → 달라진 동작과 이유 → 조건·한계를 짧은 문단으로 연결한다. 개요에는 어떤 데이터를 무엇을 기준으로 바꿔 어디에 쓰는지가 드러나면 된다. 수식·행렬·방향·거리·크기 보정 같은 중간 계산은 사용자가 그 계산을 물었을 때 설명한다. 원문의 모든 절차를 요약하려 하지 않는다. ### 긴 해설은 이해 흐름부터 검토한다 - 보고서·교육 해설의 기본 독자는 해당 분야를 처음 접하는 중학생 수준으로 두되, 사용자가 밝힌 지식과 목적을 우선한다. 짧은 상태 보고에 이 분량을 강제하지 않는다. - 하나의 예를 쓴다는 것은 같은 소재를 반복 언급하는 것만이 아니다. 그 예의 입력→처리→결과를 한 번 끝낸 뒤 새 개념을 연결한다. 설명용 단순화와 실제 시스템의 차이는 해당 위치에서 밝힌다. …
Read the whole file at its exact version.
How to install
mdr add b3rys/b3rys-team-os/b3os-how-to-explain@sha256:c734a72d6cfc29bcThe line at the top of this page pins the label git:20261030.636761b, 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_5qc3xm5hzpbppvza)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Sep 8, 2026 and Oct 30, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261030.636761b latest | 2026-10-30 | 636761b | 10,787 B | A | view · diff |
| git:20261005.046c01d | 2026-10-05 | 046c01d | 11,125 B | A | view · diff |
| git:20261005.b0a5c3e | 2026-10-05 | b0a5c3e | 10,157 B | A | view · diff |
| git:20260930.0c75b8b | 2026-09-30 | 0c75b8b | 9,220 B | A | view · diff |
| git:20260924.839a49b | 2026-09-24 | 839a49b | 8,212 B | A | view · diff |
| git:20260908.dfd3458 | 2026-09-08 | dfd3458 | 8,277 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 (10787 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
b3rys/b3rys-team-os · 18 stars · license Apache-2.0 · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_5qc3xm5hzpbppvza GET https://markdownregistry.com/api/v1/resolve?ref=b3rys/b3rys-team-os/b3os-how-to-explain GET https://markdownregistry.com/api/v1/blob/c734a72d6cfc29bc17ae9b57fb878c6b6d36b687bc990f7dffe2fdda800bf3cf
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.