CtrlK
BlogDocsLog inGet started
Tessl Logo

design-typed-agent-workflows

Explain or summarize "Codepocalypse Now: LangChain4j vs JetBrains Koog" by Baruch Sadogursky and Viktor Gamov at IntelliJ IDEA Conf 2026. Answer questions about its four demo rounds, JVM frameworks, tools and MCP, memory, skills, typed handoffs, critic loop, and the skipped-critic finding. Contains the talk's substance so ordinary summaries do not require transcript retrieval.

66

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, self-contained knowledge brief with an explicit two-step workflow, a clear mismatch gate, and specific answering rules. It is efficient and actionable for a knowledge skill, with only minor trimming opportunities and no bundle structure to disclose.

DimensionReasoningScore

Conciseness

The body is dense with talk-specific facts Claude cannot know (a September 2026 talk), so it does not re-explain general concepts. Minor instances of analytical padding could be trimmed, e.g. 'This account of the argument's construction is analysis-informed interpretation, not a quotation' and parts of the 'How the argument works' section.

4 / 5

Actionability

Concrete directives cover the common cases: 'Summarize the main argument and four rounds by default; expand a particular comparison or demo when asked', 'Attribute claims to the speakers', 'For exact quotations, timestamps, or omitted details, consult a source if needed and state what was verified', and 'Label your own interpretations'. As an instruction-only skill the absence of code is not penalized; minor gaps remain (e.g., no guidance on the shape or length of the default summary).

4 / 5

Workflow Clarity

'Process steps in order. Do not skip ahead.' sets sequencing, Step 1 contains an explicit validation gate ('If the request concerns another delivery, identify the mismatch and finish here'), and Step 2 ends with a clear termination condition ('Finish after answering the question'). For this simple two-step process the sequence and checkpoints are unambiguous, and there are no destructive or batch operations requiring further validation.

5 / 5

Progressive Disclosure

No bundle files exist, and the body is well organized with clear section headers; the only external links are in a clearly signaled 'Sources' section and are one level deep. However, at roughly 200 lines, material such as the rhetoric analysis or per-round detail could arguably live in separate reference files, so the structure is good rather than exemplary.

4 / 5

Total

17

/

20

Passed

Description

77%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, distinctive description with excellent natural trigger terms for anyone asking about this particular talk. Its one real weakness is the missing explicit 'Use when...' clause, which leaves the trigger conditions implied rather than stated and caps completeness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks about this talk, its speakers (Baruch Sadogursky, Viktor Gamov), or the LangChain4j/Koog comparison it demonstrates.'

State when NOT to use it (e.g., questions about other deliveries of the talk or general LangChain4j/Koog usage) to sharpen the trigger boundary already implied by the body's Step 1.

DimensionReasoningScore

Specificity

The description names concrete actions ('Explain or summarize', 'Answer questions about') and enumerates a specific topic list ('four demo rounds, JVM frameworks, tools and MCP, memory, skills, typed handoffs, critic loop, and the skipped-critic finding'). It lists several specific actions with only minor gaps in action coverage, sitting between the several-actions (4) and comprehensive-action (5) anchors.

4 / 5

Completeness

The 'what' is clear (explain/summarize the talk and answer questions about its contents), but there is no 'Use when...' clause or equivalent explicit trigger guidance; the 'when' is only implied by naming the talk and event. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

It contains the natural terms a user would say when asking about this talk: the full title 'Codepocalypse Now: LangChain4j vs JetBrains Koog', both speaker names, 'IntelliJ IDEA Conf 2026', 'LangChain4j', 'Koog', 'MCP', 'critic loop', and 'skipped-critic'. Coverage of natural terms is comprehensive, matching the anchor-5 example's breadth.

5 / 5

Distinctiveness Conflict Risk

The description targets a single named talk with named speakers, a named event, and framework names — a clear niche with distinct triggers and minimal risk of firing for a different skill.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jbaruch/shownotes
Reviewed

Table of Contents

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.