eval-render

Compare patched mandoc binary renders against the mandoc-md baseline and produce diff reports.

14.2k|847|Updated Aug 30, 2013
One-click install
npx skills add https://github.com/idank/explainshell --skill eval-render
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval-render
Source: https://github.com/idank/explainshell/tree/main/.claude/skills/eval-render
Command: npx skills add https://github.com/idank/explainshell --skill eval-render

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evaluate and compare the rendering of a candidate mandoc binary against the current mandoc-md, producing a verdict (merge/regression/defer) and a structured handoff prompt for regressions.

Core Features & Use Cases

  • End-to-end render evaluation against a candidate mandoc binary.
  • Generates baseline vs. candidate render diffs and a per-page regression analysis.
  • Produces actionable handoff prompts for mandoc worktree reviewers.

Quick Start

Run the eval with a candidate mandoc path and optional worktree to render, compare, and classify results.

Frequently Asked Questions about eval-render

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

FAQPage Schema
How do I check for render regressions when patching a mandoc binary?

You can validate a patched mandoc binary by comparing its rendered Markdown output against the current tools/mandoc-md baseline. The evaluation produces per-page diffs and a deterministic report classifying any regressions found.

What is a mandoc render regression evaluation workflow?

A mandoc render regression evaluation is an end-to-end process that executes baseline and candidate renders, aggregates per-page diffs, and produces a verdict of merge, regression, or defer for the patched binary.

How do I generate a structured handoff prompt for mandoc rendering regressions?

You generate a structured handoff prompt by running an end-to-end render evaluation against a candidate mandoc binary. The resulting diff report identifies regressions and produces actionable guidance for worktree reviewers.

Can I evaluate a candidate mandoc binary against a specific worktree baseline?

Yes, you can run the evaluation with a candidate mandoc path and an optional worktree. It renders and compares the candidate output against the current mandoc-md baseline to classify results and guide validation workflows.

When should I use an automated diff report for mandoc validation?

You should use an automated diff report for mandoc validation when you need deterministic regression risk assessment before merging a patched binary. It aggregates per-page differences to provide a clear merge, regression, or defer verdict.