Post

HN
Hacker News

Show HN: QUALITY.md – open format/specification, agent skill, and CLI

Engineer loops to improve project quality, aligning your team and agents on what quality means for what matters most.

QUALITY.md is an open file format for declaring a project quality model: a holistic rubric of the desired quality characteristics (security, maintainability, code quality, test/spec quality, etc.), their quality requirements (guides, sensors, principles, standards, rules, specs), and the context (mission/purpose, user/stakeholder needs, risks, etc.) for why they matter.

The QUALITY.md format specification is designed to be agent, tool, and vendor agnostic. The companion /quality agent skill and qualitymd CLI serve as both a reference implementation and starter kit for working with QUALITY.md files, including the ability to create a comprehensive quality evaluation report with prioritized improvement recommendations ready for handoff or further review, useful for engineering quality loops or augmenting your existing workflow.

Maintaining the quality of a thing is caring for it. When a thing exists for the benefit of another, caring for it well is caring for the other well.

The aim of QUALITY.md is to help others care well by making the practice of maintenance accessible to humans and agents.

See getting started for other install methods.