checklist-runner

Validate agent output against markdown checklists and generate acceptance decisions.

Updated May 25, 2026
One-click install
npx skills add https://github.com/FelipeMaines/ProjetoWeb --skill checklist-runner-felipemaines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checklist-runner
Source: https://github.com/FelipeMaines/ProjetoWeb/tree/main/.claude/skills/checklist-runner
Command: npx skills add https://github.com/FelipeMaines/ProjetoWeb --skill checklist-runner-felipemaines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps agents consistently validate their work against a defined checklist, reducing missed requirements and uneven quality across contributors.

Core Features & Use Cases

  • Generic checklist validation: Executes any .md checklist with predictable PASS/FAIL/PARTIAL/N/A verdicts.
  • Mode-based execution: Supports autonomous yolo runs for end-to-end reports and interactive runs for step-by-step confirmations.
  • Evidence-driven scoring: Loads story/source/test/diff context and matches each checklist item to supporting evidence, including embedded LLM instructions.
  • Use case: Before merging, validate that a story implementation meets the team’s Definition of Done and identify exactly which items need improvement.

Quick Start

Run the checklist against your current changes by invoking: /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 validate code changes against a Definition of Done checklist?

To validate code changes against a Definition of Done checklist, you can run a markdown checklist validation tool against your repository evidence and test artifacts to produce a consistent APPROVED or FAIL acceptance decision.

Can I automate pre-push quality gate checks using a markdown file?

Yes, you can automate pre-push quality gate checks by running a markdown checklist in autonomous yolo mode to generate per-section pass rates and an overall acceptance decision without manual step-by-step confirmation.

How does evidence-based checklist validation work for release readiness?

Evidence-based checklist validation works by loading story, source, test, and git diff context, then matching each markdown checklist item to supporting repository evidence to determine if release readiness criteria are met.

Does checklist validation support interactive step-by-step confirmations?

Yes, checklist validation supports interactive mode for step-by-step confirmations, allowing you to manually verify each checklist item against code and test artifacts instead of running fully autonomous checks.

What is the best way to enforce code quality gates before merging?

The best way to enforce code quality gates before merging is to execute a markdown checklist validation that thresholds pass rates and evaluates criticality to output an overall NEEDS_WORK or APPROVED decision.

How do I resolve a checklist file by name if the exact path is unknown?

You can resolve a checklist file by its name using optional fuzzy matching, allowing the validation process to locate and execute the correct markdown checklist without requiring the exact file path.