New to Claude Skills? Learn how to install them →

sickn33 on GitHub

Duotone Design

Free

Create striking two-color designs effortlessly.

Get this skill

Free · Opens the source repo

What Duotone Design does

Duotone Design is a specialized skill aimed at developers and designers who want to implement visually impactful two-color schemes in their web and app projects. This skill provides a comprehensive guide to achieving a duotone aesthetic, which strips down photography and user interfaces to just two contrasting or complementary colors. It is particularly useful for projects that require a bold visual identity, reminiscent of Spotify's playlist aesthetics.

The core principles of Duotone Design revolve around using only two colors: a dark shade and a light shade. This restriction encourages creativity while ensuring that designs remain cohesive and striking. Imagery must be processed to fit within this duotone palette, and typography should be bold and flat, often utilizing heavy sans-serif fonts. This skill not only outlines the visual elements but also provides practical implementation details for web and app developers.

For web developers, Duotone Design includes modern CSS techniques that allow for duotone effects without the need for external image editing software. The provided CSS examples demonstrate how to use properties like mix-blend-mode and filters to achieve the desired effects. Similarly, for mobile app developers, the skill includes SwiftUI and Flutter code snippets that show how to replicate the duotone effect in native applications. This makes it accessible for developers working in different environments, ensuring that the duotone style can be effectively utilized across platforms.

Overall, Duotone Design serves as a valuable resource for anyone looking to enhance their design projects with a bold, modern aesthetic. By following the guidelines and examples provided, users can create visually striking interfaces and images that stand out in a crowded digital landscape.

When to use it

Use this skill when you want to implement a two-color design scheme that emphasizes bold contrasts and striking visuals.

When not to use it

This skill may not be suitable for designs requiring more than two colors or those that do not fit the duotone aesthetic.

What you can build with it

Creating a Music App Interface

Use duotone design principles to craft a visually appealing interface for a music app, enhancing user engagement.

Designing Marketing Materials

Implement duotone imagery in marketing materials to create striking visuals that capture attention and convey brand identity.

Developing a Portfolio Website

Utilize duotone design to showcase your work in a modern, cohesive manner that highlights your design skills.

How to install Duotone Design

View source

1. Install with the skills CLI

npx skills add sickn33/agentic-awesome-skills/duotone-design --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by sickn33

Duotone Design

"Striking contrast. Photography and UI stripped down to exactly two clashing or complementary colors."

When to Use

Use this sub-style when the user's request matches the aesthetic described above. This is a child reference of the design-it skill and is not meant to be triggered directly.

Core Principles

  1. Two Colors Only: The entire design is mapped to a dark color (replacing blacks/shadows) and a light color (replacing whites/highlights).
  2. Treated Imagery: All photos MUST be processed into the duotone palette.
  3. Bold, Flat Typography: Text is usually massive, solid, and uses one of the two colors.

Visual DNA

  • Colors: Very high contrast pairs. Navy and Peach, Deep Purple and Neon Green, Crimson and Cream. Look at Industrial Chic for inspiration.
  • Typography: Heavy, condensed sans-serifs (e.g., League Gothic, Oswald).
  • Imagery: High-contrast, gritty photography works best when mapped to duotone.

Web Implementation

  • Modern CSS can achieve image duotone effects without Photoshop, using mix-blend-mode and filters.
  • CSS Example:
:root {
  --duo-dark: #1E0045; /* Deep Purple */
  --duo-light: #CCFF00; /* Neon Lime */
}

body {
  background-color: var(--duo-dark);
  color: var(--duo-light);
}

/* CSS Duotone Image Effect */
.duotone-container {
  position: relative;
  width: 100%;
  height: 400px;
  background-color: var(--duo-light); /* Base color */
}

.duotone-container img {
  width: 100%;
  height: 100%;
  object-fit: cover;
  /* Convert image to grayscale, increase contrast */
  filter: grayscale(100%) contrast(1.5); 
  /* Multiply the grayscale image against the light background */
  mix-blend-mode: multiply;
}

.duotone-container::after {
  /* Overlay the dark color using screen/lighten */
  content: '';
  position: absolute;
  top: 0; left: 0; right: 0; bottom: 0;
  background-color: var(--duo-dark);
  mix-blend-mode: screen;
}

.duotone-btn {
  background: var(--duo-light);
  color: var(--duo-dark);
  border: none;
  font-weight: 900;
  text-transform: uppercase;
  padding: 16px 32px;
}

App Implementation

SwiftUI

struct DuotoneImage: View {
    let duoDark = Color(red: 0.12, green: 0.0, blue: 0.27)  // #1E0045
    let duoLight = Color(red: 0.8, green: 1.0, blue: 0.0)   // #CCFF00
    
    var body: some View {
        ZStack {
            // Background base color
            duoLight.ignoresSafeArea()
            
            // Image processing
            Image("sample_photo")
                .resizable()
                .scaledToFill()
                .grayscale(1.0)
                .contrast(1.5)
                .colorMultiply(duoLight) // Multiplies the light color into the grays
            
            // Dark color overlay
            duoDark
                .blendMode(.screen) // Equivalent to CSS screen blend mode
                .allowsHitTesting(false)
        }
        .frame(height: 400)
        .clipped()
    }
}
  • Real-time image processing is easy in SwiftUI.
  • Convert to .grayscale(), boost .contrast(), then use .colorMultiply() and .blendMode(.screen) layers to map the two colors exactly like CSS mix-blend-mode.

Flutter

class DuotoneImage extends StatelessWidget {
  final Color duoDark = const Color(0xFF1E0045);
  final Color duoLight = const Color(0xFFCCFF00);

  @override
  Widget build(BuildContext context) {
    return Container(
      height: 400,
      width: double.infinity,
      color: duoLight,
      child: Stack(
        fit: StackFit.expand,
        children: [
          // 1. Grayscale & Contrast (using ColorFilter matrix)
          // 2. Light Color Multiply
          ColorFiltered(
            colorFilter: ColorFilter.mode(duoLight, BlendMode.multiply),
            child: ColorFiltered(
              // Simple grayscale matrix
              colorFilter: const ColorFilter.matrix([
                0.2126, 0.7152, 0.0722, 0, 0,
                0.2126, 0.7152, 0.0722, 0, 0,
                0.2126, 0.7152, 0.0722, 0, 0,
                0,      0,      0,      1, 0,
              ]),
              child: Image.asset('assets/sample_photo.jpg', fit: BoxFit.cover),
            ),
          ),
          // 3. Dark Color Screen Overlay
          ColorFiltered(
            colorFilter: ColorFilter.mode(duoDark, BlendMode.screen),
            child: Container(color: Colors.transparent), // Applies filter to stack below
          ),
        ],
      ),
    );
  }
}
  • Flutter requires stacking ColorFiltered widgets.
  • Use a ColorFilter.matrix to convert the image to grayscale first.
  • Apply BlendMode.multiply with the light color, then overlay the dark color using BlendMode.screen.

React Native

// Real-time CSS-like blend modes do NOT exist natively in React Native.
// You must use react-native-skia or pre-process images.

import { Canvas, Image, useImage, ColorMatrix } from "@shopify/react-native-skia";

const DuotoneImage = () => {
  const image = useImage(require('./sample_photo.jpg'));
  
  if (!image) return null;

  // Skia allows custom SVG/CSS style color matrices.
  // Building a true duotone matrix requires math mapping black to duoDark
  // and white to duoLight.
  
  return (
    <View style={{ height: 400, backgroundColor: '#CCFF00' }}>
      <Canvas style={{ flex: 1 }}>
        <Image image={image} x={0} y={0} width={400} height={400} fit="cover">
          {/* Note: In production, you would construct a specific 
              ColorMatrix to map the luminance to the two hex colors. */}
          <ColorMatrix
            matrix={[
              -1, 0, 0, 0, 255,
              0, -1, 0, 0, 255,
              0, 0, -1, 0, 255,
              0, 0, 0, 1, 0,
            ]}
          />
        </Image>
      </Canvas>
    </View>
  );
};
  • Critical Limitation: Standard React Native <Image> cannot do duotone blending.
  • Solution 1: Use @shopify/react-native-skia to apply low-level color matrices and blend modes.
  • Solution 2: Pre-process all imagery in Photoshop/Figma before importing into the app. This is the safest and most performant route.

Jetpack Compose

@Composable
fun DuotoneImage() {
    val duoDark = Color(0xFF1E0045)
    val duoLight = Color(0xFFCCFF00)

    // A ColorMatrix to map luminance to the two colors is required for true duotone.
    // For simplicity, we use BlendModes here to approximate the CSS multiply/screen effect.
    Box(modifier = Modifier
        .fillMaxWidth()
        .height(400.dp)
        .background(duoLight)
    ) {
        Image(
            painter = painterResource(id = R.drawable.sample_photo),
            contentDescription = null,
            contentScale = ContentScale.Crop,
            modifier = Modifier.matchParentSize(),
            colorFilter = ColorFilter.colorMatrix(ColorMatrix().apply { 
                setToSaturation(0f) // Grayscale
            })
        )
        
        // Multiply light color
        Spacer(modifier = Modifier
            .matchParentSize()
            .background(duoLight)
            .graphicsLayer { blendMode = BlendMode.Multiply }
        )
        
        // Screen dark color
        Spacer(modifier = Modifier
            .matchParentSize()
            .background(duoDark)
            .graphicsLayer { blendMode = BlendMode.Screen }
        )
    }
}
  • Use ColorFilter.colorMatrix with setToSaturation(0f) to make the image grayscale.
  • Use Spacer overlays with Modifier.graphicsLayer { blendMode = BlendMode... } to apply the dual color mapping.
  • Similar to Flutter, layer Multiply (light) and Screen (dark) to achieve the effect.

Do's and Don'ts

  • DO: Ensure the dark color is dark enough to be legible when used as text against the light color.
  • DON'T: Add a third color. It instantly ruins the aesthetic.

Limitations

  • This is a styling reference and does not replace environment-specific validation, accessibility testing, or expert review.
  • Ensure appropriate contrast ratios and responsive behaviors are verified separately.

Frequently asked questions about Duotone Design

Similar skills