Skip to content
SkillModel-led5,125 tokens in use

constraint-driven-development

Write down a project's quality bar in CONSTRAINTS.md with default thresholds, wire checks to the dev loop and catch agents that weaken it.

119,377 stars on the repository MIT Licenseaddyosmani/agent-skills · skills/constraint-driven-development
npx skills add addyosmani/agent-skills --skill constraint-driven-development
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing constraint-driven-development costs

176tokens idle
5,125tokens in use
8,081tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/quality-gate.mjs.

Touches

shelldetectednetworkdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples12/15
  • Output15/15
  • Size11/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity96
  • Maintenance100
  • Community76
  • Maturity32
  • Momentum40

Constraint-Driven Development interviews the user in four questions, each with a default, and records the answers in CONSTRAINTS.md at the repository root. The file holds a floor that is always enforced, numbered rules with the command that checks each one, measured metrics held by ratchets and a table of exceptions with owners and expiry dates.

The skill also installs a de facto tool for each chosen dimension, places each check by cost in the build, test, review and ship stages, and watches the diff for five moves that lower the bar.

What You Get

  • A CONSTRAINTS.md with floor, enforced rules, measured metrics and exceptions
  • A tool and command table for the common quality dimensions
  • A diff-scoped floor-guard reference script and a quality-gate script for Semgrep and axe results
  • A verification checklist that each enforced command fails on a known violation

Common Use Cases

  • Setting up quality gates for a new project
  • Choosing thresholds when no number exists
  • Stopping an agent from silencing checks to reach green
  • Guarding an autonomous build loop

What Makes It Unique

Most quality skills describe what good looks like in prose. This one records the project’s own bar with numbers and a command per rule, ranks checks by whether the agent can pass them with code that does not work, and requires at least one external check such as axe-core or osv-scanner.

Under The Hood

The SKILL.md loads when quality standards are discussed. It tells the agent to read package manifests, linter configs, CI files and coverage output, then to write CONSTRAINTS.md and update AGENTS.md or CLAUDE.md. It names install commands for npm, pip, pipx and brew tools. Bundled files are quality-gate.mjs, a Node script that reads Semgrep or axe JSON and sets an exit code, and a floor-guard reference that runs git commands over the diff.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers