annotate

Convert raw agent transcripts into structured JudgeInput and ai_annotation data.

17|1|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/haizelabs/annotate --skill annotate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: annotate
Source: https://github.com/haizelabs/annotate/tree/main/annotate_skill
Command: npx skills add https://github.com/haizelabs/annotate --skill annotate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fastapi, react, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Tired of manual AI log analysis and complex evaluation setups? This Skill automates the intricate process of evaluating AI agent performance, extracting key data, and setting up LLM-as-a-judge systems. Save significant time and reduce complexity in your AI development lifecycle, allowing you to focus on improving your models.

Core Features & Use Cases

  • Automated Data Ingestion: Seamlessly transform raw AI agent log data into a normalized, structured format ready for analysis.
  • Flexible Feedback Configuration: Define precise evaluation criteria, granularity, and rubrics for both human and AI judges via a dedicated API.
  • Interactive Annotation Workflow: Utilize a powerful React-based frontend and FastAPI backend to efficiently annotate AI agent transcripts and collect high-quality feedback.
  • Use Case: Imagine you're developing an AI chatbot. Use this Skill to ingest conversation logs, define criteria for "helpful" and "unhelpful" responses, and then efficiently annotate interactions to train or fine-tune your model, ensuring better performance and user satisfaction.

Quick Start

Generate the boilerplate ingestion script to prepare your raw AI agent logs for annotation and evaluation.

Frequently Asked Questions about annotate

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

FAQPage Schema
How do I convert raw AI agent logs into structured evaluation data?

Convert agent transcripts into structured judge inputs by loading raw data, applying summarization with optional context and attribute matchers, and producing normalized JudgeInput objects ready for AI evaluation and annotation workflows.

What's the best way to set up an LLM-as-a-judge evaluation system?

Define precise evaluation criteria and feedback configurations via dedicated APIs, then use the React frontend and FastAPI backend to annotate transcripts at step, interaction, or group granularities—supporting both pointwise and ranking test cases.

Can I automate feedback collection across different AI agent interactions?

Yes. Ingest agent conversation logs, configure rubrics for specific evaluation dimensions like helpfulness, then efficiently collect human and AI annotations across multiple interaction types and granularity levels in a single workflow.

How do I prepare AI chatbot conversation logs for model fine-tuning?

Transform raw conversation logs into annotated training data by extracting interactions, defining feedback criteria through the API, and generating structured annotations that capture performance signals for downstream model improvement.

What data formats and workflows does this support for agent evaluation?

Supports ingestion of raw agent transcripts, extraction and validation at multiple granularities—steps, interactions, and groups—with flexible feedback configurations and output as structured JudgeInput and ai_annotation objects for evaluation pipelines.

Do I need machine learning expertise to set up AI-based annotation?

No. The skill automates the setup complexity; you define evaluation criteria through the API and use the interactive React interface to annotate transcripts, letting the system handle the LLM-as-a-judge logic and data normalization.