quality

Compose and run shifts that work a project's quality debt including tests, coverage, and dependencies.

63|3|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/orwa-mahmoud/nightshift --skill quality-orwa-mahmoud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quality
Source: https://github.com/orwa-mahmoud/nightshift/tree/main/plugins/nightshift/skills/quality
Command: npx skills add https://github.com/orwa-mahmoud/nightshift --skill quality-orwa-mahmoud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running coding agents often stop after easy work and leave quality debt—failing tests, lint errors, coverage gaps, outdated dependencies, and documentation drift—unaddressed. This Skill turns that debt into an explicit, verifiable work order with a deadline and a clock-out gate. ## Core Features & Use Cases - Quality Debt Composition: Scans the project's own tooling for lint, types, tests, flaky tests, coverage, dead code, TODO/FIXME debt, accessibility, localization, API contract drift, documentation drift, CI warnings, dependencies, and vulnerability advisories, then ranks and deduplicates findings. - Guided or Automatic Selection: Lets the owner pick quality areas (Guided) or lets Nightshift select every applicable high-value area that fits the available hours (Automatic), with review-first or run-direct launch modes. - Verified Shift Execution: Composes one ordered Hunt work order, arms a shift through the Start preflight, and holds unfinished work at a clock-out gate with receipts and token usage recorded. - Use Case: Ask the agent to spend four hours on quality debt; it runs the project's test and lint tools, ranks findings, composes a work order, and produces reviewable commits with per-item evidence. ## Quick Start Ask the agent to compose a quality shift for this project with a four-hour budget covering tests, lint, and dependency advisories.

Frequently Asked Questions about quality

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

FAQPage Schema
How do I run an automated quality debt scan on my project?

Invoke the quality skill with a time budget and quality objective; it runs the project's own lint, test, and coverage tools in report-only mode, ranks findings, and composes an ordered work order. Choose Guided to pick areas yourself or Automatic to let it select high-value areas.

What quality areas does the Nightshift quality skill cover?

It covers lint, types, tests, flaky tests, coverage, dead code, TODO/FIXME debt, accessibility, localization, API contract drift, documentation drift, CI warnings, direct dependencies, and vulnerability advisories. GitHub issue hunts are handled separately under the Hunt skill.

Does the quality skill work on Windows, macOS, and Linux?

Yes, it runs through the Nightshift runtime on macOS, Linux, and Windows. On native Windows it invokes the ns.ps1 PowerShell script with the same verbs, and arming uses New-Item instead of touch.

What is the difference between review-first and run-direct modes?

Review-first scans read-only, presents findings with fix now, draft for later, or ignore options, and starts the clock only after approval. Run-direct settles the tooling policy, composes the work order, and arms the shift immediately without a review pause.

Why does the quality skill skip some checks in artifact mode?

Artifact mode targets a persistent folder rather than a git repository, so documentation drift, TODO/FIXME debt, coverage hunts, and tooling-dependent entries are skipped because they require repository history or stack detection. Completion is tracked through receipts instead of git logs.