sh-qa

What problem does it solve?

This skill provides a simple, AI-invokable wrapper around the superharness qa CLI so users do not need to run commands manually or inspect raw files to understand external QA outcomes. It centralizes QA execution and reporting into the AI session, reducing friction when validating completed tasks.

Core Features & Use Cases

• Invoke external QA services: Runs the configured external QA checks for a specific task using the superharness qa command.
• Generate human- and machine-readable reports: Ensures qa-report.md (human-readable) and qa-issues.json (machine-readable) are written to the task directory for review and automation.
• Summarize results and recommend next steps: Provides totals for checks run, passed and failed counts, lists issues by severity, and suggests follow-up actions such as running the fix workflow or finalizing the branch.
• Use Case: After completing a task, run this skill to execute external QA, get a concise summary of problems, and decide whether to run automated fixes or proceed to merge.

Quick Start

Ask the AI to run the superharness qa command for the target task path under .superharness/tasks and summarize the resulting report.