karenina-rubric-authoring

Create karenina evaluation rubrics with LLM, regex, callable, metric, and agentic traits.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Defining quality criteria beyond correctness for LLM evaluation is error-prone: trait types must be matched to the quality being assessed, judge prompts must be explicit, and construction rules (unique names, no dots, required fields) are easy to violate. This Skill guides rubric authoring for the karenina framework through a validated five-step procedure. ## Core Features & Use Cases - Trait Type Selection: Maps each quality (safety, citations, readability, coverage, fact-checking) to the right trait type among LLMRubricTrait, RegexRubricTrait, CallableRubricTrait, MetricRubricTrait, and AgenticRubricTrait. - DynamicRubric Support: Builds conditional rubrics where traits are evaluated only when their concept is detected in the response. - Validation Workflow: Runs a validation script against generated rubric files and iterates on errors until the rubric passes. - Use Case: A researcher evaluating biomedical AI answers wants to score safety, citation presence, and key-point coverage. The Skill interviews them, generates the trait definitions from a skeleton, validates the file, and confirms the final rubric. ## Quick Start Create a karenina rubric that evaluates safety, citation quality, and coverage of key points for my question-answering benchmark.

Frequently Asked Questions about karenina-rubric-authoring

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

FAQPage Schema
How do I create a rubric for LLM response evaluation in karenina?

Define traits for each quality dimension and collect them in a Rubric object with typed lists: llm_traits, regex_traits, callable_traits, metric_traits, and agentic_traits. Each trait needs a unique name without dots, and LLM traits require an explicit description that serves as the judge's full prompt.

Which trait type should I use for evaluating response quality?

Use RegexRubricTrait for deterministic text patterns like citations, LLMRubricTrait for subjective judgments like safety or tone, CallableRubricTrait for computable metrics like word count, MetricRubricTrait for instruction-level coverage with precision/recall/F1, and AgenticRubricTrait for multi-step investigation requiring tools.

What is the difference between Rubric and DynamicRubric in karenina?

Rubric evaluates all traits unconditionally on every response, while DynamicRubric first checks whether each trait's concept is present using its summary or description, evaluating only matching traits. Both accept the same five typed trait lists and enforce identical name uniqueness rules.

Why does my karenina rubric fail validation with a trait name error?

Trait names must be unique across all trait lists and must not contain dots, since dotted keys are reserved for template-kind result fields. Violations raise a ValueError at construction naming the offending trait, surfaced as a pydantic ValidationError.

Can I apply a new rubric to existing karenina verification results?

Yes, use Benchmark.extend_rubric to replay prior traces under rubric_only evaluation mode and enrich existing rows with new trait scores without re-generating answers. Metric traits are not supported because they depend on parsed template fields that rubric_only mode skips.