karenina-adapter-gather-context

Gathers SDK documentation and capability requirements for designing new karenina adapters.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building a new karenina adapter requires understanding how a target SDK maps to karenina's three port interfaces (AgentPort, LLMPort, ParserPort), but SDK capabilities like streaming, structured output, and trace access vary widely and are easy to overlook. This Skill structures Phase 1 of adapter creation by systematically collecting SDK documentation, probing capabilities, and resolving design decisions before any code is written. ## Core Features & Use Cases - SDK Documentation Collection: Fetches README, API references, trace/observability docs, and message type documentation for the target SDK via web retrieval. - Capability Assessment: Walks through a structured capability matrix covering agent loops, async support, MCP integration, tool definitions, usage/token tracking, streaming, structured output, recursion limits, timeout recovery, and filesystem backends. - Design Decision Resolution: Asks targeted clarifying questions about deep-agent vs scaffolded orchestration, built-in tool handling, registry naming, availability checks, fallback behavior, and distribution model (built-in, plugin, or manual). - Use Case: When integrating a new agent framework like CrewAI or AutoGen into karenina, run this Skill first to produce a context document at docs/adapters/<name>-context.md that Phase 2 (adapter design) consumes directly. ## Quick Start Ask the assistant to gather context for a new karenina adapter for your target SDK, providing the SDK name, documentation URL, and PyPI package name.

Frequently Asked Questions about karenina-adapter-gather-context

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

FAQPage Schema
How do I start creating a new karenina adapter for an agent SDK?

Begin with Phase 1 context gathering: provide the SDK name, documentation URL, and PyPI package name. The process fetches SDK docs, assesses capabilities against karenina's AgentPort, LLMPort, and ParserPort interfaces, and saves a context document to docs/adapters/<name>-context.md.

What port interfaces must a karenina adapter implement?

Every karenina adapter must implement three ports: AgentPort for multi-turn agent loops with tool calling and MCP servers, LLMPort for single-turn calls used in judging and rubric evaluation, and ParserPort for extracting typed Pydantic models from free-form text.

What SDK capabilities are evaluated during adapter context gathering?

The assessment covers agent loops, async support, MCP integration, tool definition, message types, trace access, token usage tracking, streaming behavior, structured output, no-tools fallback, system prompts, recursion limits, timeout recovery, and filesystem backends.

How are karenina adapters distributed and registered?

Adapters can be built-in (shipped with karenina and imported in _load_builtins()), registered as plugins via the karenina.adapters entry point group in pyproject.toml, or registered manually by calling AdapterRegistry.register() before creating a ModelConfig.

What happens after the adapter context document is created?

The context document feeds Phase 2, where the adapter design skill uses the recorded capability matrix, concept mappings, and resolved design questions to plan the actual implementation of the three port interfaces.