CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

explain

Explain what was just implemented in this conversation in plain English for a junior dev, so the user can understand the full picture and make a decision. Default output is exactly two paragraphs; the argument "more" gives a longer, detailed version. Not for questions about how existing code works when nothing was changed in this conversation; answer those directly.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/explain/SKILL.md
SKILL.md
Quality
Evals
Security

Explain What You Just Did

Summarize the work you just completed in this conversation (the most recent implementation, fix, or change) in plain English, written for a junior developer who has not been following along. If you were given a topic that wasn't changed in this conversation, such as existing code the user wants to understand, explain it in the same format and say it wasn't changed here. If nothing was built or changed and no topic was given, say so in one sentence instead of explaining something else.

Output contract (default: no arguments)

  • Exactly two paragraphs. Not one, not three. No headers, no bullet points, no numbered lists, no code blocks, no tables.
  • Paragraph 1 — the what and why: what problem existed or what was requested, and what was built or changed to address it, at the conceptual level. Name the services/files only when knowing them changes the reader's understanding.
  • Paragraph 2 — how it works and what it means: how the pieces fit together end to end, any trade-offs or decisions that were made along the way, and anything the reader would need to know to make a decision about the work (risks, follow-ups, alternatives that were rejected and why, and what was and wasn't tested).
  • Plain English throughout. Expand or briefly define any jargon, acronym, or project-specific codename on first use. Write as if to a capable junior dev: no condescension, but no assumed context either.
  • No process narration. Do not describe the sequence of tool calls, searches, or edits you performed — describe the resulting design and behavior.
  • Do not end with questions or offers ("let me know if..."). The user will ask for more if they want it.

With arguments

  • more (or detail, details, deep): produce a longer, detailed version — 4 to 8 paragraphs. Structure is still prose-first, but short code snippets and file references are allowed where they genuinely aid understanding. Cover edge cases, error handling, and data flow explicitly. Same plain-English, junior-dev register.
  • <topic>: apply the default two-paragraph contract, but scope the explanation to the named topic/change instead of the most recent work.
  • more <topic>: the longer version, scoped to the named topic.
Repository

bezmoradi/knackpack

Path

skills/explain/SKILL.md

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.