AI-powered design assistant using Claude's multi-agent architecture. Get expert UI/UX reviews, accessibility audits, and design system guidance.
- Features
- Available Agents
- Included Frameworks
- Quick Start
- Examples
- Configuration
- Advanced Usage
- Project Structure
- Contributing
- License
- 7 Specialized AI Agents — each expert in a specific design domain
- Comprehensive Frameworks — 200KB+ of battle-tested UI/UX best practices
- Built on Claude Agent SDK — leverages Anthropic's official agent framework
- CLI & Programmatic API — use from terminal or integrate into your workflow
- TypeScript First — full type safety and great DX
| Agent | Expertise |
|---|---|
ui-ux-expert |
Layout, spacing, colors, forms, accessibility, responsive design |
design-system-expert |
Design tokens, components, micro-interactions, motion |
layout-expert |
Bento grids, scroll animations, photography, iconography |
typography-expert |
Font pairing, readability, text hierarchy |
marketing-expert |
Copywriting, CTAs, conversion optimization |
design-code-reviewer |
Code review for design compliance |
project-strategist |
Project planning, brand strategy |
The toolkit includes comprehensive design frameworks covering:
- UI/UX Best Practices — core principles, 8px grid, WCAG accessibility
- Advanced UI/UX — design tokens, optical corrections, Fitts's Law, Hick's Law
- Layout & Media — CSS Grid, Bento layouts, responsive images, video
- Typography — modular scale, fluid typography, font loading
- Marketing & Conversion — AIDA, PAS, social proof, persuasion psychology
- Project Kickoff — discovery, stakeholder alignment, deliverables
npm install design-agent-toolkit
# or
pnpm add design-agent-toolkit
# or
yarn add design-agent-toolkit# Set your API key
export ANTHROPIC_API_KEY=your_key_here
# Run a design review
npx design-agent-toolkit ./my-project "Review the landing page for UI/UX issues"
# Check accessibility
npx design-agent-toolkit ./src/components "Audit form components for accessibility"
# Get help
npx design-agent-toolkit --helpimport { runDesignAgent } from 'design-agent-toolkit';
const result = await runDesignAgent({
projectPath: './my-project',
task: 'Review the hero section for conversion optimization',
verbose: true,
});
console.log(result.response);
console.log(`Cost: $${result.totalCostUsd}`);import { streamDesignAgent } from 'design-agent-toolkit';
for await (const chunk of streamDesignAgent({
projectPath: './my-project',
task: 'Analyze the component library structure',
})) {
process.stdout.write(chunk);
}import { runDesignAgent } from 'design-agent-toolkit';
await runDesignAgent({
projectPath: './landing-page',
task: `
Review the landing page with focus on:
1. Visual hierarchy and CTA placement
2. Mobile responsiveness
3. Loading performance
4. Accessibility compliance
`,
});await runDesignAgent({
projectPath: './src/components',
task: 'Audit all form components for WCAG 2.1 AA compliance',
model: 'claude-opus-4-5-20251101', // Use Opus for deep analysis
});await runDesignAgent({
projectPath: './design-system',
task: `
Review the design tokens and component library:
- Are tokens following naming conventions?
- Is the spacing scale consistent?
- Are color contrast ratios WCAG compliant?
`,
});| Option | Type | Default | Description |
|---|---|---|---|
projectPath |
string |
required | Path to the project to analyze |
task |
string |
required | The design task or question |
model |
string |
claude-sonnet-4-5-20250929 |
Claude model to use |
frameworksPath |
string |
bundled | Custom frameworks directory |
maxTurns |
number |
50 |
Maximum agent turns |
maxBudgetUsd |
number |
10.0 |
Maximum cost in USD |
verbose |
boolean |
false |
Enable detailed logging |
additionalDirectories |
string[] |
[] |
Extra directories to access |
ANTHROPIC_API_KEY=sk-ant-... # Required: Your Anthropic API keyimport { getAgent, DESIGN_AGENTS } from 'design-agent-toolkit';
// Get a specific agent's config
const uiExpert = getAgent('ui-ux-expert');
console.log(uiExpert.prompt);
// List all agents
import { listAgents } from 'design-agent-toolkit';
console.log(listAgents());
// ['ui-ux-expert', 'design-system-expert', ...]await runDesignAgent({
projectPath: './my-project',
task: 'Review using our custom guidelines',
frameworksPath: './our-design-system/docs',
});design-agent-toolkit/
├── src/
│ ├── agents/ # Specialized design agents
│ │ ├── ui-ux-expert.ts
│ │ ├── design-system-expert.ts
│ │ ├── layout-expert.ts
│ │ ├── typography-expert.ts
│ │ ├── marketing-expert.ts
│ │ ├── project-strategist.ts
│ │ └── design-code-reviewer.ts
│ ├── types.ts # TypeScript definitions
│ ├── index.ts # Main exports
│ └── cli.ts # CLI entry point
├── frameworks/ # UI/UX best practice documents
│ ├── ui-ux-best-practices.md
│ ├── advanced-ui-ux.md
│ ├── advanced-layout-media.md
│ ├── ui-text.md
│ ├── marketing-conversion.md
│ └── project-kickoff.md
└── examples/ # Usage examples
Contributions are welcome! Please read our contributing guidelines first.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
MIT