사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/kjetilhartveit/kjetils-skills --skill explain-with-preview시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Explain with Preview
A two-column chapter: a short framing sentence and a few clickable cards on the left, and a sticky panel on the right that switches when the reader picks a card. Switching back and forth makes the differences obvious.
Use this skill when
- The user asks for a visual explanation of changes with a preview.
- Used by an orchestrator to explain changes visually with a preview.
Two modes
| Mode | Cards | Starts on |
|---|---|---|
| Options (decision) | One per option, 2–3, including a cautious / low-risk one | The recommended option |
| Before / after | Exactly two: "Before · today" and "After · with the change" | After ("selected") |
Content
- Every option has the same rows in the same order so only the differences change: for a decision usually
Keeps (ok), Loses (removed), Fix first (decision, concrete actions), Risks (risk), plus effort (hours or days, and what the work is). 2–4 short items per row, real names and numbers from the facts: every finding that matters for that option belongs in one of its rows.
- Fragility, dependencies and complexity belong in these rows (e.g. "Fix first: port 3 path checks into the local
plugin"), not in chapters of their own.
- Gloss a tool or term in the row where it first appears ("nursery (Biome's unstable rules)").
code(optional per option): ≤ 8 real lines of the config or code that option adds or changes, with its file
path. Give the recommended option one when the change is config or code.
flip: what would change the recommendation (1–3 items).details: "How it was measured" (the commands,
versions, machine, single or repeated runs, what was not measured) and "Sources" (links).
- Use real content. Label an illustration as one.
Build it from JSON
Write the chapter as JSON and generate the fragment; no HTML, CSS or script by hand:
python <explainer-kit>/assets/preview.py decide.json --out frag-decide.htmlThe JSON shape is documented at the top of preview.py and in the kit's FRAGMENT-CONTRACT.md ("Preview chapters from JSON"). Text fields may contain inline <b>, <code> and <a href>.
