Przejdź do treści
Biblioteka skilli
AI i agenci · Nauka i wyjaśnianie

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.

Repozytorium
beep-beginners ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

t decide), when the user askswhat are my options?what does this mean?
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

  1. Writing it
  2. Where it goes
  3. When the user answers
Sekcje z nagłówków SKILL.md, w oryginale · 51 linii, 342 słów
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

RepozytoriumWynikLicencja
Ta strona · kriegcloud/beep-beginners100Apache-2.0
crbnos/carbon100AGPL-3.0
PerilloAI/flowtrace-plugin100Apache-2.0
mickeyyaya/evolve-loop100Apache-2.0
zenobi-us/dotfiles100MIT
imgly/agent-skills100MIT
marcel-bich/marcel-bich-claude-marketplace100MIT
nicodiansk/draw-it-out100MIT
ramboz/jig100MIT

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.