Agent skill · Addy Osmani's Agent Skills
/constraint-driven-development Write down your quality bar and stop agents quietly lowering it
This skill turns a project's standards into a CONSTRAINTS.md file with real numbers and the command that checks each one. It asks at most four questions, each with a default, installs the tools behind every chosen dimension, places checks by how long they take, and watches diffs for the shortcuts agents use to turn a red check green.
Works with
- Claude Code
- Any agent via the skills CLI
- Codex
- Gemini CLI
- Antigravity CLI
- Command Code
When to use it
- A project has no written standard and agents now produce more code than anyone reads.
- CI runs checks but nobody knows which ones actually block a merge.
- You are about to let an agent run autonomously and want more than its own tests standing guard.
How it works
- 1Detect first
The agent reads the stack, test runner, linters, current coverage, CI and agent config before asking you anything.
- 2Ask four questions
It asks which dimensions to enforce, whether failures block or warn, whether to measure today's numbers, and the slowest check you will tolerate, offering a default for each.
- 3Write CONSTRAINTS.md
It records a floor, numbered rules with the command behind each, measured-only metrics with a direction, and an exceptions table with owners and expiry dates.
- 4Install and place checks
It installs established tools such as gitleaks, osv-scanner, Lighthouse or axe and assigns cheap checks to every edit and slow ones to CI.
- 5Guard the bar
At review it compares the diff for lowered thresholds, skipped or weakened tests, new suppression comments, stubs and unexplained exceptions.
What it steers the agent away from
- Coverage or performance targets that the codebase already fails, which teach the team to ignore red builds
- Agents adding @ts-ignore, eslint-disable or .skip to get a passing run
- Slow scanners in the edit loop that end with people passing --no-verify
Install this skill
It installs with the Addy Osmani's Agent Skills pack.
Claude CodeAdds the skills plus nine lifecycle slash commands; use /agent-skills:review where a built-in command shares the name.
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skillsAny agent via the skills CLIInstalls all skills into Claude Code, Cursor, Codex, Copilot, Cline and many other agents.
npx skills add addyosmani/agent-skillsCodexNeeds Codex CLI v0.122 or later; skills are then called with @ in chat.
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skillsGemini CLIInstalls the skills for auto-discovery.
gemini skills install https://github.com/addyosmani/agent-skills.git --path skillsAntigravity CLIInstalls as a native plugin; some releases need the namespaced skills invoked directly.
agy plugin install https://github.com/addyosmani/agent-skills.gitCommand CodeThe first form installs per project, the second for all projects.
cmd skills add addyosmani/agent-skills
cmd skills add addyosmani/agent-skills --globalCommands come from the author’s README; check it for changes before you run them.
Questions
What if I have no target numbers?
The skill records where the project stands today and treats that as a ratchet: the number may improve but any drop is reported as a finding.
Can it run in CI or an unattended loop?
The interview needs a person, so in non-interactive runs it applies only the floor rules, says so, and leaves the rest for a human.
More guides from Addy Osmani's Agent Skills
/browser-testing-with-devtoolsLet the agent check a real browser instead of guessingInspects a live page through Chrome DevTools MCP: DOM, console, network, performance traces and the accessibility tree.Read the guide →/code-review-and-qualityFive-axis code review with clear severity labelsReviews a change for correctness, readability, architecture, security and performance, labelling each finding by severity.Read the guide →/doubt-driven-developmentHave a fresh reviewer try to break each risky decisionHands each non-trivial decision to a fresh-context reviewer prompted to find faults, with an optional second model.Read the guide →/interview-meFind out what you actually want before anything is builtAsks you single questions, offering its own guessed answer for each, until it can state your real goal and you confirm it.Read the guide →
Also in this pack
/api-and-interface-designDesigns the contract before the code, applying Hyrum's Law, a one-version rule and clear error semantics to interfaces.↗/code-simplificationCuts complexity in working code while keeping every input, output, side effect and error exactly the same.↗/context-engineeringSets up rules files and decides which specs, source files and error output the agent should load for each task.↗/debugging-and-error-recoveryHalts feature work on any failure and walks a reproduce, localize, reduce, fix and guard checklist to the root cause.↗/deprecation-and-migrationDecides whether old code should go, then plans compulsory or advisory deprecation and migrates consumers off it.↗/documentation-and-adrsRecords significant decisions as ADRs in the project's existing format and spots docs that no longer match the code.↗/frontend-ui-engineeringBuilds accessible, responsive components with composition-first patterns and checks them with the project's own tooling.↗/git-workflow-and-versioningKeeps main deployable with short-lived branches and small atomic commits that act as save points.↗/idea-refineExpands a rough idea into variations, stress-tests them and saves a one-page proposal with MVP scope and a not-doing list.↗/incremental-implementationBuilds a change in thin vertical slices, testing, verifying and committing each one before starting the next.↗/observability-and-instrumentationLists the questions on-call will ask, then adds structured logs, metrics, traces and symptom-based alerts to answer them.↗/performance-optimizationMeasures a baseline against Core Web Vitals targets, fixes the proven bottleneck and measures again before keeping it.↗
Summary by trendhub. The skill itself lives in addyosmani/agent-skills/skills/constraint-driven-development by Addy Osmani (MIT); read the full, current text there.