Skip to content

girishlade111/ai-agent-skills / skills/standards-kit

standards-kit

Verified

Unified development and design standards. Enforces code quality (complexity < 8), strict naming conventions, and the mandatory use of approved UI component libraries.

FileKindSize
SKILL.mdskill md1.7 KB
references/LOGIC.mdmarkdown3.1 KB
references/VISUALS.mdmarkdown2.2 KB

references/VISUALS.md

View on GitHub
# Visual Design Standards (Reference)

This document contains the visual design system and component standards for Wednesday Solutions projects.

## 1. Design Tokens

### Colors
- **Primary**: `#4ADE80` (Green)
- **Secondary**: `#0D9488` (Teal)
- **Gradient**: `linear-gradient(135deg, #4ADE80 0%, #0D9488 100%)`
- **Text**: `#18181B` (Primary), `#71717A` (Secondary), `#A3A3A3` (Muted)

### Typography
- **Display**: Instrument Serif (Hero: 60px, Section: 44px)
- **Body**: DM Sans (Standard: 16px, Small: 14px)

### Spacing
- Base Grid: **4px**
- Gaps: 8px, 12px, 16px, 24px, 32px

## 2. Component Guidelines

### Approved Libraries
1. **shadcn/ui**: Foundation
2. **Aceternity UI**: High-end effects
3. **Magic UI**: Text/Button animations
4. **Motion Primitives**: Advanced transitions

### Standard Styling
- **Cards**: 24px radius, 22px padding, lift (-8px) on hover.
- **Buttons**: 14px radius, 3D gradient, shimmer on hover.
- **Badges**: Pill shape (100px), subtle pulse for live states.

## 3. Animation Timing

| Interaction | Duration | Easing |
|:---|:---|:---|
| **Micro** | 100-150ms | `ease` |
| **Hover** | 200-300ms | `spring` |
| **Transition** | 300ms | `easeOutCubic` |
| **Reveal** | 500-800ms | `easeOutQuart` |

## 4. Responsive Design

### Breakpoints
- **sm**: `640px` (Mobile landscape)
- **md**: `768px` (Tablet)
- **lg**: `1024px` (Desktop)
- **xl**: `1280px` (Large desktop)
- **2xl**: `1536px` (Extra large)

### Best Practices
- Touch targets minimum **44x44px**.
- Stack layouts vertically on **sm** and **md**.
- Hide decorative background elements on smaller screens to improve performance.

## 5. Accessibility (A11y)

- **Contrast**: 4.5:1 for standard text.
- **Motion**: Wrap all animations in `prefers-reduced-motion` media queries.

```css
@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}
```

- **ARIA**: Mandatory `aria-label` for icons and `alt` text for images.

## 6. Layout Patterns

- **Hero**: Badge -> Headline -> Lead text -> CTA -> Social Proof.
- **Comparison**: Strikethrough "Old Way" vs Circled "New Way".
- **Steps**: Numbered cards (01, 02, 03) with connecting lines.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall