user-centered-explanation SKILL.md skillA
This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.
user-centered-explanation from uzysjung/uzys-agent-harness is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add uzysjung/uzys-agent-harness/user-centered-explanation@git:20260920.4f13f6dPins git:20260920.4f13f6d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- uzysjung/uzys-agent-harness
- Path
templates/skills/user-centered-explanation/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260920.4f13f6d, committed Sep 20, 2026
- Size
- 10,551 bytes
- Repository stars
- 3
- License
- MIT
개발 중 문제·변경안·선택지를 사용자 행동과 결과의 관점에서, 사용자의 언어로 설명한다. 맥락·원인·대안·추천 이유를 연결하고, UI/UX 변경은 필요한 화면·문구·동작의 전후 차이를 보여준다. 사용자가 "뭔 소리야", "쉽게 설명해줘", "왜 문제야", "사용자에게 뭐가 달라져?", "화면으로 보여줘", "선택지와 추천을 정리해줘"라고 하거나 중요한 선택·승인의 차이와 근거를 설명할 때 사용한다. 이 스킬만 호출하면 현재 대화의 미해결 문제나 직전 선택 요청을 사용자 관점으로 재정리한다.
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
# User-Centered Explanation 개발 중 문제와 변경안을 사용자 행동·결과·선택의 관점으로 바꾸어 설명한다. 사용자가 앞선 대화나 코드를 다시 읽지 않아도 다음을 판단할 수 있게 한다. **무슨 상황인지 → 무엇이 왜 문제인지 → 어떤 선택지가 있고 무엇이 달라지는지 → 무엇을 추천하며 왜 그런지** 아래 순서·표·예시는 설명을 돕는 기본값이지 고정된 사고·작업 절차가 아니다. 사용자의 목적과 선호 형식을 존중하면서, 설명 깊이·비교 기준·표현 방식은 이해와 판단에 필요한 정보, 읽는 부담, 작업 비용을 고려해 선택한다. 설명과 의사결정을 돕는 스킬이며 작업 범위나 승인 정책 자체를 변경하지 않는다. 답변 언어는 사용자가 쓰는 언어를 따른다. ## 적용 직접 호출되면 현재 대화에서 다음 순서로 대상을 찾는다. **사용자가 지정한 주제 → 미해결 문제·직전 선택 요청 → 직전 설명** 대화에서 대상을 알 수 있으면 다시 묻지 않는다. 설명할 대상 자체가 없을 때만 원문이나 주제를 요청한다. 직접 호출하거나 중요한 선택·승인을 설명할 때는 아래 기본 표를 우선 사용한다. 기존 형식이 충분히 명확하면 유지한다. 짧은 설명이나 도식이 더 명확하면 판단에 필요한 내용을 유지하면서 항목을 합치거나 표현을 바꿀 수 있다. 직접 호출하지 않은 단순 정보 전달이나 완료 보고는 같은 설명 관점을 유지하되 필요한 내용만 짧게 전달한다. 사용자가 별도 형식을 지정하면 그 형식을 따른다. 어떤 형식이든 **맥락·원인·대안·추천 이유** 중 현재 판단에 필요한 내용이 드러나게 한다. ## 설명 원칙 ### 1. 사용자 관점에서 설명한다 파일·함수·오류명보다 먼저 다음을 연결한다. **사용자가 하려는 일 → 현재 상태 → 문제 또는 제약 → 발생 원인 → 실제 영향** 버그가 아니라 설계 선택, 요구사항 충돌, 환경 제약이라면 그대로 설명한다. 신규 기능은 달성할 목표를, 내부 개선은 직접적인 사용자 변화 여부와 유지보수·운영상의 이유를 설명한다. 설명을 듣는 사람과 실제 영향을 받는 서비스 이용자·관리자·운영자가 다르면 구분한다. 같은 이름이 서로 다른 대상·위치·단계를 가리키면 먼저 구분하고, 실제 영향을 받는 사람의 과업을 기준으로 설명한다. 기술 용어를 쉬운 단어로 바꾸는 데 그치지 않고, 어떤 상황에서 사용자가 무엇을 보거나 할 수 있는지 설명한다. …
Read the whole file at its exact version.
How to install
mdr add uzysjung/uzys-agent-harness/user-centered-explanation@sha256:eab47a91badce5d6The line at the top of this page pins the label git:20260920.4f13f6d, 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_rplj7p7ithgmjwmz)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 20, 2026.
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 (10551 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
uzysjung/uzys-agent-harness · 3 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_rplj7p7ithgmjwmz GET https://markdownregistry.com/api/v1/resolve?ref=uzysjung/uzys-agent-harness/user-centered-explanation GET https://markdownregistry.com/api/v1/blob/eab47a91badce5d6314f63889950c69c43fa5ea4660d544828794ada3684e0b8
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.
More from uzysjung/uzys-agent-harness
Every file in uzysjung/uzys-agent-harness