ek-dev-architecture

Defines the architectural framework for Knowledge Evaluation systems with a two-layer data model.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/thorwhalen/ek --skill ek-dev-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ek-dev-architecture
Source: https://github.com/thorwhalen/ek/tree/main/skills/ek-dev-architecture
Command: npx skills add https://github.com/thorwhalen/ek --skill ek-dev-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides the essential orientation map for developers building on the ek framework, preventing architectural misalignment and ensuring consistent implementation of evaluation systems.

Core Features & Use Cases

  • Architectural Index: Defines the 2x2 evaluation matrix (reference-based vs. reference-free, instance vs. system) and the two-layer data model.
  • Component Guidance: Maps specific modules to their corresponding research reports, ensuring developers build on the correct theoretical foundation.
  • Use Case: When deciding where to implement a new metric or how to integrate a custom OCR engine, use this Skill to identify the correct module, protocol, and dependency requirements.

Quick Start

Use the ek-dev-architecture skill to retrieve the module layout and the corresponding research report for implementing a new reference-based metric.

Frequently Asked Questions about ek-dev-architecture

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

FAQPage Schema
How to build a knowledge evaluation system for information extraction outputs?

To build a knowledge evaluation system, use a unified architectural framework that integrates reference-based and reference-free evaluation strategies. It provides a two-layer data model to standardize the development of metrics, validators, and calibration engines.

What is the difference between reference-based and reference-free evaluation in information extraction?

Reference-based and reference-free evaluation differ by their reliance on ground truth data. The framework defines a 2x2 evaluation matrix mapping these strategies across instance and system levels within a unified two-layer data model.

How do I integrate a custom OCR engine into an evaluation framework?

To integrate a custom OCR engine, use the architectural index to identify the correct module, protocol, and dependency requirements. This ensures the engine aligns with the two-layer data model and evaluation matrix.

Where should I implement a new metric in an information extraction evaluation system?

Implement a new metric by mapping it to the correct module within the two-layer data model. The framework guides you to the corresponding research report to ensure the metric is built on the correct theoretical foundation.

Does the ek framework architecture enforce strict dependency and licensing discipline?

Yes, the ek framework architecture enforces strict dependency and licensing discipline. This prevents architectural misalignment and ensures consistent implementation of evaluation systems across different modules.

When do I need a two-layer data model for evaluating information extraction outputs?

You need a two-layer data model when developing both instance-level and system-level evaluations. It facilitates the standardized development of metrics and validators by unifying reference-based and reference-free strategies.