# Xxd Color Brief

> Xxd Color Brief is an Agent Skill for design published in the nevertoday/zhongguo-traditional-colors repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Turn vague visual direction into a practical Chinese traditional color brief. Use when a user has mood words, client feedback, audience positioning, references, or an unclear Chinese traditional color direction that must become palette constraints before choosing colors.

- Skill name: `xxd-color-brief`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/nevertoday/zhongguo-traditional-colors/blob/HEAD/skills/xxd-color-brief/SKILL.md
- Repository: nevertoday/zhongguo-traditional-colors (1,117 GitHub stars when collected)

## SKILL.md

# xxd-color-brief

## Purpose

Use this skill before picking colors. Its job is to turn soft language like "高级", "东方", "年轻", "克制", "松弛", "科技感", or "不要太俗" into a brief that a designer can defend and reuse.

## Pain Points This Solves

- Stakeholders use adjectives, references, or dislikes, but the designer needs concrete color constraints.
- Moodboards create alignment, but they often stop before deciding hue, brightness, saturation, contrast, and usage risk.
- Teams jump into swatches too early and later argue because the success criteria were never named.

## Data Contract

- Use the bundled references inside this skill:
  - `references/chinese-color-master-list.md`: full 742-color Markdown source list.
  - `references/chinese-color-harmony.csv`: complete machine-readable harmony table for all 742 colors.
  - `references/chinese-color-harmony.md`: Markdown version of the same harmony relationships.
- Starting colors must include color name, HEX, and the reason they fit the brief.
- If the user provides an outside HEX, map it to the nearest project color and label it as a mapping.
- Do not produce a full palette unless the user explicitly asks; route to the next skill instead.

## Briefing Workflow

1. Identify the job behind the words: brand, UI, poster, data visualization, content series, packaging, or audit.
2. Translate each adjective into observable constraints:
   - Temperature: warm, cool, neutral, or controlled contrast.
   - Lightness: pale, mid, deep, or high-contrast.
   - Saturation: muted, clean, vivid, gray-toned, or ceremonial.
   - Cultural signal: historical, editorial, product, youthful, premium, festive, technical.
   - Risk: cliche, low readability, too decorative, too flat, too commercial, too nostalgic.
3. Detect conflicts. For example, "年轻又古典" needs a modern neutral base plus one traditional accent, not an all-antique palette.
4. Choose 3 to 5 starting colors from the 742-color set, each with a role hypothesis.
5. Name the avoid list as concrete color families, contrast levels, or usage patterns.
6. Route the next step:
   - Need actual color combinations: `xxd-palette-builder`
   - Need placement on a layout: `xxd-palette-applier`
   - Need UI variables: `xxd-ui-token`
   - Need contrast repair: `xxd-accessible-color`
   - Need long-term brand rules: `xxd-brand-system`
   - Need charts: `xxd-data-viz`
   - Need to repair existing work: `xxd-existing-design-audit`
   - Need repeated content: `xxd-content-series`
   - Need physical production: `xxd-print-packaging`

## Output Shape

- Brief name: one project-facing phrase.
- Design decision: 2 to 4 sentences explaining the color direction in plain Chinese.
- Constraint table: mood word, translated color constraint, risk if misread.
- Starting colors: role hypothesis, color name, HEX, why it belongs.
- Avoid list: 2 to 4 concrete exclusions.
- Next move: one recommended skill and what it should produce.

If the user only provides a mood word with no surface, state the missing surface and give a provisional brief instead of blocking.

---

Source: https://www.openparable.com/skill/design/xxd-color-brief (OpenParable). Cite the canonical URL above.
