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

Hacker News Top Tools

Summary

QUALITY.md is an open file format and CLI tool for defining and evaluating project quality, helping teams and agents align on quality standards.

Hello all, I created QUALITY.md to help build a holistic quality evaluation process for my projects. Turns out it&#x27;s also ideal for loop engineering. I&#x27;m hoping this provides a valuable contribution to the conversation around quality and craft and having AI help us in the effort. I hope to shift the mindset from a reactive&#x2F;review&#x2F;repair mindset to a proactive care mindset.<p>Give it a go. I look forward to your thoughts&#x2F;comments&#x2F;feedback!<p>Website: <a href="https:&#x2F;&#x2F;getquality.md" rel="nofollow">https:&#x2F;&#x2F;getquality.md</a> GitHub: <a href="https:&#x2F;&#x2F;github.com&#x2F;qualitymd&#x2F;quality.md" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;qualitymd&#x2F;quality.md</a>
Original Article
View Cached Full Text

Cached at: 07/02/26, 05:07 PM

# Welcome - QUALITY.md Source: [https://getquality.md/](https://getquality.md/) [Open format](https://getquality.md/specification)[Agent skill](https://getquality.md/skill)[CLI](https://getquality.md/cli) Engineer loops to improve project quality, aligning your team and agents on what quality means for what matters most\. [Getting started](https://getquality.md/quickstart)[Engineer quality loops](https://getquality.md/loops)[Read the spec](https://getquality.md/specification) ### What is QUALITY\.md? QUALITY\.md is an[open file format](https://getquality.md/specification)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](https://getquality.md/specification)is designed to be agent, tool, and vendor agnostic\. The companion`/quality`[agent skill](https://getquality.md/skill)and`qualitymd`[CLI](https://getquality.md/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](https://github.com/qualitymd/quality.md/blob/main/examples/report-gallery/software-service/.quality/evaluations/0001-full-eval/report.md)with prioritized[improvement recommendations](https://github.com/qualitymd/quality.md/blob/main/examples/report-gallery/software-service/.quality/evaluations/0001-full-eval/recommendations.md)ready for handoff or further review, useful for engineering quality loops or augmenting your existing workflow\. ### Why QUALITY\.md? - Ensure stakeholders are aligned on what matters most and why - Identify the most impactful and low risk quality improvements - Build agentic control loops to continuously maintain and improve quality - Manage quality proactively instead of reactively - Tackle intent, comprehension, and technical debt - Move judgement and taste up the loop stack - Compound learning at the highest leverage point ### Philosophy 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\. ### How to use QUALITY\.md? ### FAQ

Similar Articles

QA Crow

Product Hunt

QA Crow is a bug tracking and quality assurance tool designed to help manage bug backlogs for development teams.

Designing the hf CLI as an agent-optimized way to work with the Hub

Hugging Face Blog

Hugging Face redesigned its `hf` CLI to be optimized for both human users and AI coding agents like Claude Code and Codex, with agent-aware output rendering and benchmarking showing up to 6× token savings versus no-CLI baselines on complex tasks.