checklist-runner

Execute Markdown checklists and score project state via commands and file content.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pytest, ruff, mypy, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the validation of project work against predefined checklists, ensuring quality and adherence to standards without manual verification.

Core Features & Use Cases

  • Automated Checklist Execution: Runs commands and checks file content to verify checklist items.
  • Scoring and Reporting: Calculates a project score based on checklist item pass/fail status and generates a summary report.
  • Use Case: A developer can use this Skill to automatically run all tests, linting, and static analysis checks defined in a project's quality checklist before committing code.

Quick Start

Use the checklist-runner skill to run the checklist located at 'project-checks.md' in interactive mode.

Frequently Asked Questions about checklist-runner

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

FAQPage Schema
How do I automate checklist validation for project quality assurance?

To automate checklist validation, this Skill runs commands and reads file content to verify Markdown checklist items against your project state, calculating a score and generating a summary report for quality assurance.

What is the best way to run pytest, ruff, and mypy checks before a git commit?

You can run pytest, ruff, and mypy checks before a commit by defining them as commands in a Markdown checklist. The checklist-runner executes these verification tools and scores the results to ensure code quality before committing.

Can I use Markdown checklists for automated compliance checks in software engineering?

Markdown checklists support automated compliance checks by defining required validation commands and file content rules. The checklist-runner reads the Markdown file, executes the specified checks, and scores project compliance automatically.

Does checklist validation work with my existing pytest and git workflow?

Checklist validation works with your existing workflow by using pytest, ruff, mypy, and git as dependencies for verification. It runs these tools directly as specified in your Markdown checklist to validate the current project state.

How do I generate a scoring report for project validation checks?

To generate a scoring report for project validation, the checklist-runner executes your defined checklist items, calculates a pass/fail score based on the results, and outputs a summary report detailing the overall project compliance state.