explain
/explain
Wyjaśnia decyzję lub kompromis w zrozumiałych dla użytkownika słowach, w stałej formie krótkiego opisu przed ważnym wyborem.
- Autor
- kriegcloud ↗
- Repozytorium
- beep-beginners ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Wyjaśnia decyzję lub kompromis w zrozumiałych dla użytkownika słowach, w stałej formie krótkiego opisu przed ważnym wyborem.
Wyzwalacze z opisu
Oryginalny opis (EN)
Explain a decision, tradeoff or technical choice to the user in their own terms, as a fixed-shape decision brief. Use before any non-trivial choice (a tool, a cost, a stack, a security setting, something the caretaker couldn't decide), when the user asks "why did you do that?", "what are my options?", "what does this mean?", or when writing a NEEDS-YOU item.
Jak działa
- Writing it
- Where it goes
- When the user answers
Podgląd SKILL.md
---
name: explain
description: >
Explain a decision, tradeoff or technical choice to the user in their own
terms, as a fixed-shape decision brief. Use before any non-trivial choice
(a tool, a cost, a stack, a security setting, something the caretaker
couldn't decide), when the user asks "why did you do that?", "what are my
options?", "what does this mean?", or when writing a NEEDS-YOU item.
---
# Explain
A brief has one shape, always, so the user learns where to look:
1. **What I'm deciding.** One sentence, their words.
2. **Your options.** One line each. Two to four.
3. **What each costs you.** Time, money or risk, per option. Numbers where
you have them.
4. **What I recommend, and why.** The pick and the one reason that matters
most to this person.
5. **What you'd have to do.** Nothing, one click, a yes or no, or a decision
by a date.
Get the template with:
```
uv run --script "${CLAUDE_PLUGIN_ROOT}/scripts/kit.py" explain --template brief --title "<the decision>"
```
Or render a filled one from JSON (`title`, `deciding`, `options`, `costs`,
`recommendation`, `action`) with `kit explain --json <file>`.
## Writing it
- Read the "How the user learns" section of `AGENTS.md` first. Use the
analogies it names (an accountant gets "source of record"; a bartender gets
"the till has to balance"). If nothing fits, say it plainly without one.
- Short sentences. No code, no file paths, no git words. If a technical
term is unavoidable, define it in the sentence and add it to the glossary:
`kit glossary add "<term>" --meaning "<one plain sentence>"`.
- Run `unslop` on the whole brief.
- Be honest about uncertainty: "I don't know what this costs yet" beats a
guess.
## Where it goes
- A decision inside an exploration or goal: into that packet's
`DECISIONS.md`, under a dated heading.
- Something the caretaker couldn't decide: the brief is the body of the
NEEDS-YOU item (`kit needs-you add --title "..." --brief-file <file>`).
- A quick answer in chat: the same five parts, in prose if that reads
better. The shape is for the user's benefit, not a form to fill.
## When the user answers
Record it where the brief lives (the packet's `DECISIONS.md`, or
`kit needs-you resolve <id> --outcome "<what they chose>"`), then act on it.
If they pick an option you didn't recommend, do it their way and say nothing
more about it unless it's unsafe or costs money they didn't expect.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · kriegcloud/beep-beginners | 100 | Apache-2.0 |
| crbnos/carbon | 100 | AGPL-3.0 |
| PerilloAI/flowtrace-plugin | 100 | Apache-2.0 |
| mickeyyaya/evolve-loop | 100 | Apache-2.0 |
| zenobi-us/dotfiles | 100 | MIT |
| imgly/agent-skills | 100 | MIT |
| marcel-bich/marcel-bich-claude-marketplace | 100 | MIT |
| nicodiansk/draw-it-out | 100 | MIT |
| ramboz/jig | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 74ac561e9de2 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 86caretaker-pause
Wstrzymuje lub wznawia zadania chmurowe opiekuna z poziomu sesji i pokazuje, ile Claude zużywa na ich potrzeby. - 100local-evaluate-skill-c8912f39
Ocenia lokalną umiejętność Codex w zrozumiałych słowach: tłumaczy wynik, wskazuje poprawki i przygotowuje raport przed testami. - 100ctx-add-decision
Zapisuje decyzję architektoniczną, gdy rozstrzygnięto kompromis lub dokonano nieoczywistego wyboru projektowego, który przyszłe sesje powinny znać. - 100ctx-decision-add
Zapisuje decyzję architektoniczną, gdy rozstrzygnięto kompromis lub dokonano nieoczywistego wyboru projektowego, który przyszłe sesje powinny znać. - 85atlas-explain
Wyjaśnia fragment pracy osobie spoza zespołu prostymi słowami: mechanizm, decyzję z kosztami lub zestaw pomiarów z tym, co dowodzą. - 90decision-audit
Sprawdza decyzje agenta przed wyborem podejścia, edycją, usunięciem lub zmianą współdzieloną i po korekcie użytkownika.