checklist-runner

Validate work against Markdown checklists and generate approval decisions.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/hyagoviana/Sistema_Hyago_Viana_Adabtech --skill checklist-runner-hyagoviana
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checklist-runner
Source: https://github.com/hyagoviana/Sistema_Hyago_Viana_Adabtech/tree/main/meu-projeto/.claude/skills/checklist-runner
Command: npx skills add https://github.com/hyagoviana/Sistema_Hyago_Viana_Adabtech --skill checklist-runner-hyagoviana

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes inconsistency in how agents review and verify deliverables by providing a repeatable way to score evidence against a shared Markdown checklist.

Core Features & Use Cases

  • Checklist-driven validation: Runs against any .md checklist and produces consistent PASS/FAIL/PARTIAL/N/A verdicts per item.
  • Two execution modes: Supports yolo for autonomous full runs and interactive for section-by-section confirmation.
  • Evidence-aware context loading: Checks documentation, story-related files, test results from npm test, and the current Git diff against what the checklist requires.
  • Decision-ready reporting: Summarizes section pass rates, highlights failed items with reasons and recommendations, and outputs an approval decision based on defined thresholds.

Quick Start

Ask the AI to run your quality gate by using: /checklist-runner pre-push-checklist --mode yolo.

Frequently Asked Questions about checklist-runner

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

FAQPage Schema
How do I automate release readiness validation against a Markdown checklist?

To automate release readiness validation, run checklist-runner in yolo mode against your Markdown checklist. It autonomously scores evidence from Git diffs and test results, applying PASS/FAIL/PARTIAL logic to generate an APPROVED or FAIL decision.

What is checklist validation and how does it evaluate Git diff evidence?

Checklist validation is the process of scoring work artifacts against shared Markdown criteria. It evaluates Git diff evidence by loading context, applying PASS/FAIL/PARTIAL/N/A logic per item, and generating a structured section-level decision report.

Can I use this for pre-push quality checks in an interactive workflow?

Yes, you can use checklist-runner for pre-push quality checks in an interactive workflow. It supports section-by-section confirmation, allowing you to validate Git diff changes and test evidence incrementally before finalizing the approval decision.

Does checklist validation work with npm test results and story documentation?

Yes, checklist validation works with npm test results and story documentation. The evidence-aware context loading mechanism checks these artifacts alongside the current Git diff to verify deliverables against your Markdown checklist.

What is the best way to resolve checklists by name during autonomous quality gate runs?

The best way to resolve checklists by name during autonomous quality gate runs is using the fuzzy checklist resolution feature in yolo mode. It locates the Markdown checklist from configured paths, loads context artifacts, and produces a structured final report.

When should I not use autonomous checklist validation for my workflow?

You should not use autonomous checklist validation in yolo mode when you need strict manual oversight of the quality gate process. Instead, use interactive mode to review evidence, verify test results, and confirm section-level decisions incrementally.