using-karenina

Routes LLM evaluation requests to karenina workflow skills with shared API references and gotchas.

13|3|Updated Jun 27, 2025
One-click install
npx skills add https://github.com/biocypher/karenina --skill using-karenina-biocypher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-karenina
Source: https://github.com/biocypher/karenina/tree/main/skills/using-karenina
Command: npx skills add https://github.com/biocypher/karenina --skill using-karenina-biocypher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Evaluating LLMs with the karenina framework spans many workflows—benchmarks, rubrics, templates, verification, scenarios—and users often don't know which API or entry point fits their task. This Skill acts as a dispatcher: it interprets the user's request, supplies cross-cutting karenina knowledge (imports, API tables, common pitfalls), and routes to the correct specialized leaf skill. ## Core Features & Use Cases - Intent-based routing: A decision tree maps requests to nine leaf skills (karenina-qa, karenina-task-eval, karenina-scenarios, karenina-template-authoring, karenina-rubric-authoring, karenina-verification, karenina-cli, karenina-manual, karenina-results), with clarification questions for ambiguous cases. - Cross-cutting reference context: Auto-generated Benchmark API and VerificationResult accessor tables, correct import paths, and gotchas for templates, rubrics, configuration, checkpoints, and pipeline guards. - Synced documentation: A references/ directory with 113 files mirrored from the karenina docs, indexed by topic for answering conceptual questions directly. - Use Case: A user says "I have chatbot logs and want to score them for safety." The Skill recognizes pre-recorded outputs, routes to karenina-task-eval, and supplies the parsing_only=True requirement and TaskEval import path so work starts correctly. ## Quick Start Ask the agent to evaluate an LLM's outputs or build a benchmark with karenina, describing whether you have pre-recorded outputs, need multi-turn conversations, or want single-turn Q&A verification.

Frequently Asked Questions about using-karenina

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate an LLM with the karenina framework?

Describe your evaluation goal and this Skill routes you to the right workflow: karenina-qa for single-turn benchmarks, karenina-scenarios for multi-turn branching conversations, or karenina-task-eval for scoring pre-recorded outputs. All modes share the same template and rubric evaluation engine.

What is the difference between TaskEval and QA benchmarks in karenina?

TaskEval scores pre-recorded outputs (logs, traces, JSON files) without calling an LLM, using parsing_only=True. QA benchmarks generate answers from an answering LLM and verify them against ground truth templates in a closed loop.

How do I write an answer template in karenina?

Create a class inheriting from BaseAnswer (not Pydantic BaseModel) with VerifiedField attributes whose descriptions instruct the judge LLM. Import via from karenina.schemas.entities import BaseAnswer, VerifiedField, and match ground_truth types to the verification primitive.

Why does karenina verification fail before parsing my results?

Pipeline guards (abstention check, sufficiency check, recursion limit, trace validation) auto-fail questions before parsing. Inspect result.template.abstention_detected and result.metadata.failure, or disable guards with abstention_enabled=False and sufficiency_enabled=False in VerificationConfig.

Does karenina support rubric-based quality evaluation?

Yes, karenina supports five rubric trait types: LLM, regex, callable, metric, and agentic, plus DynamicRubric for conditional evaluation. Attach them with benchmark.set_global_rubric() and set evaluation_mode to template_and_rubric or rubric_only.

When should I use the manual adapter instead of TaskEval?

Use ManualAdapter when you want the full verification pipeline (all stages, guards, deep judgment) but supply answers yourself. Use TaskEval for lightweight scoring of existing outputs that skips pipeline stages entirely.