karenina-verification

Configure and run karenina's LLM verification pipeline with models, adapters, guards, and presets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Setting up karenina's verification pipeline requires coordinating many configuration surfaces—answering and parsing models, adapter interfaces, guard stages, replicates, presets, deep judgment, and MCP integration—and misconfiguration leads to cryptic auto-fails or silently skipped rubric evaluation. This Skill organizes the entire VerificationConfig and ModelConfig surface by task so you can configure, run, and debug verification runs correctly. ## Core Features & Use Cases - Model and Adapter Configuration: Define answering and parsing ModelConfigs and choose the right interface (langchain, claude_tool, claude_agent_sdk, openai_endpoint, manual, and more) with a decision table covering MCP and tool support. - Guards, Replicates, and Presets: Understand the four auto-fail guard stages, set replicate counts for variance measurement, and save or load reusable JSON presets with overrides. - Advanced Pipeline Features: Configure prompt assembly, deep judgment (template and rubric), MCP tool-use evaluation, run extension via extend_template/extend_rubric, and progressive save-and-resume sinks for long runs. - Use Case: You want to evaluate a tool-using biomedical agent with 3 replicates, an abstention guard, and deep judgment enabled, then resume the run after an interruption. This Skill gives you the exact config fields, code snippets, and debugging fields (result.metadata.failure) to do it. ## Quick Start Ask the assistant to create a VerificationConfig with a Claude answering model, a Haiku judge model, three replicates, and the abstention guard enabled, then run it with a progressive file sink.

Frequently Asked Questions about karenina-verification

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

FAQPage Schema
How do I configure a karenina VerificationConfig with answering and parsing models?

Create a VerificationConfig with an answering_models list and a parsing_models list of ModelConfig objects. Each ModelConfig needs id, model_name, and model_provider (e.g., anthropic), plus optional temperature, max_tokens, and interface fields.

Which karenina adapter interface should I use for my model?

Use the default langchain interface for Anthropic, OpenAI, and Google models. Switch to claude_tool for Anthropic tool-use benchmarks, claude_agent_sdk or langchain_deep_agents for agentic parsing, openai_endpoint for self-hosted models, and manual for pre-recorded traces.

Why does my karenina verification show verify_result False with no parsed output?

A guard stage auto-failed the question before parsing. Check result.template.recursion_limit_reached, result.template.abstention_detected, and result.metadata.failure (.category, .stage, .reason) to identify whether recursion limit, trace validation, abstention, or sufficiency triggered.

Does attaching a rubric automatically enable rubric evaluation in karenina?

No. evaluation_mode defaults to template_only and has no auto mode. You must explicitly set evaluation_mode to template_and_rubric or rubric_only, otherwise attached rubrics are silently not scored.

How do I resume an interrupted karenina verification run?

Run with a ProgressiveFileSink so results persist incrementally to a .results.jsonl sidecar and .state manifest. Then call benchmark.resume_verification with the state file path, or use the CLI --resume flag, to skip completed triples.

Can karenina evaluate agents that call MCP tools?

Yes. Set mcp_urls_dict on the answering ModelConfig with server URLs, optionally restrict tools via mcp_tool_filter, and control trace usage with use_full_trace_for_template and use_full_trace_for_rubric. Per-request MCP timeouts are also configurable.