proverbs

This repository holds custom skills and instructions for AI coding agents. Skills are reusable, on-demand capabilities the agent can invoke; instructions are standing behavior rules applied globally.

Skills

Skill	What it does
api-contract-validator	Validates API endpoints/payloads/OpenAPI specs against REST best practices
clean-code	Refactors bloated or coupled code into proper architectural layers
create-agents-md	Scans a repo and generates a root AGENTS.md
create-skill	Creates or updates agent skills in the standard format
grill-me	Stress-tests a plan/design with brutal, targeted questions
mr-description	Generates a lean, fixed-structure merge/pull request description
validate-merge-request	Reviews the current branch diff and issues a READY / NOT READY verdict

DESIGN.md

google-labs-code/design.md — a file spec that describes a project's design system (colors, typography, spacing, components) in a format coding agents can read and apply directly, so you don't have to re-explain the visual identity on every prompt.

Install

npm install -D @google/design.md

Validate

npx @google/design.md lint DESIGN.md

Prompt to generate this project's DESIGN.md

Scan this repository (components, CSS/Tailwind config, themes, any existing design tokens) and generate a DESIGN.md file at the root following the spec at github.com/google-labs-code/design.md: YAML front matter with colors, typography, rounded and spacing extracted from the actual code, followed by the sections Overview, Colors, Typography, Layout, Elevation & Depth, Shapes, Components, and Do's and Don'ts. Don't invent values — use what's already implemented.