@cubis/foundry 0.3.70 → 0.3.72

package/workflows/skills/frontend-design/commands/brand.md

@@ -0,0 +1,167 @@
+# /brand
+
+Apply or enforce a specific brand identity across a frontend. Works from uploaded brand guidelines, a style guide document, hex palettes, or a named brand system.
+
+## Usage
+
+```
+/brand                           → Prompt for brand context, then apply
+/brand anthropic                 → Apply Anthropic's brand system
+/brand <hex-palette>             → Build tokens from provided hex values
+/brand <element>                 → Apply brand to a specific component or section
+```
+
+## What It Does
+
+Converts brand guidelines into a living CSS token system and applies it consistently across the interface. Outputs production-ready tokens plus updated component styles.
+
+## Workflow
+
+### 1. Gather Brand Inputs
+
+Ask for (or detect from context):
+
+- **Color values** — Primary, secondary, accent hex codes (or link to brand guide)
+- **Typography** — Font families for headings and body. If not specified, choose a pairing that matches the brand's tone
+- **Named brand** — If the user says "Anthropic", "Stripe", "Linear", "Vercel" etc., load known reference patterns from `references/brand-presets.md`
+
+### 2. Convert to OKLCH Tokens
+
+Translate all hex values to OKLCH for perceptual uniformity. See `references/brand-presets.md` for the full conversion workflow.
+
+```css
+/* Pattern: convert every color to oklch */
+--brand-[name]: oklch(L% C H);
+```
+
+### 3. Build Semantic Token Layer
+
+Map raw brand tokens to semantic roles. Never reference raw tokens directly in components:
+
+```css
+:root {
+  /* Surfaces */
+  --color-bg: var(--brand-surface);
+  --color-bg-subtle: var(--brand-subtle);
+  --color-bg-elevated: var(--brand-elevated);
+
+  /* Text */
+  --color-text: var(--brand-ink);
+  --color-text-muted: var(--brand-mid);
+
+  /* Interactive */
+  --color-accent: var(--brand-primary-accent);
+  --color-accent-hover: oklch(
+    from var(--brand-primary-accent) calc(l - 0.05) c h
+  );
+
+  /* Borders */
+  --color-border: var(--brand-subtle);
+  --color-border-focus: var(--brand-primary-accent);
+}
+```
+
+### 4. Apply Typography
+
+Set font families from brand guidelines and load them via Google Fonts or system stack:
+
+```css
+@import url("https://fonts.googleapis.com/css2?family=DISPLAY_FONT&family=BODY_FONT&display=swap");
+
+:root {
+  --font-display: "Display Font", fallback, sans-serif;
+  --font-body: "Body Font", fallback, serif;
+}
+```
+
+Apply via element targeting:
+
+- Headings, labels, buttons, nav → `var(--font-display)`
+- Body copy, prose, descriptions → `var(--font-body)`
+
+### 5. Output Deliverables
+
+Deliver:
+
+1. **Complete token file** — `tokens.css` or `:root {}` block with all brand tokens + semantic layer
+2. **Typography setup** — Font import + application rules
+3. **Component overrides** — Button, card, link, input, badge in brand style
+4. **Dark mode** — Inverted/adapted token values for `prefers-color-scheme: dark`
+5. **Usage notes** — How to swap the brand accent, where NOT to use accent color, contrast verification
+
+---
+
+## Anthropic Brand Quick-Apply
+
+When the user requests Anthropic brand styling, use this preset directly:
+
+```css
+/* ========================================
+   ANTHROPIC BRAND TOKENS
+   Source: github.com/anthropics/skills
+   ======================================== */
+@import url("https://fonts.googleapis.com/css2?family=Poppins:wght@400;500;600;700&family=Lora:ital,wght@0,400;0,500;0,600;1,400&display=swap");
+
+:root {
+  /* Neutrals */
+  --brand-ink: oklch(10.5% 0.006 85);
+  --brand-cream: oklch(98.2% 0.008 85);
+  --brand-mid: oklch(72% 0.009 85);
+  --brand-subtle: oklch(92% 0.01 85);
+
+  /* Accents */
+  --brand-orange: oklch(65% 0.145 42);
+  --brand-blue: oklch(65% 0.09 235);
+  --brand-green: oklch(57% 0.09 130);
+
+  /* Semantic layer */
+  --color-bg: var(--brand-cream);
+  --color-bg-subtle: var(--brand-subtle);
+  --color-text: var(--brand-ink);
+  --color-text-secondary: var(--brand-mid);
+  --color-accent: var(--brand-orange);
+  --color-accent-secondary: var(--brand-blue);
+  --color-border: var(--brand-subtle);
+
+  /* Typography */
+  --font-display: "Poppins", Arial, sans-serif;
+  --font-body: "Lora", Georgia, serif;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --color-bg: var(--brand-ink);
+    --color-bg-subtle: oklch(16% 0.008 85);
+    --color-text: var(--brand-cream);
+    --color-text-secondary: var(--brand-mid);
+    --color-border: oklch(22% 0.008 85);
+  }
+}
+```
+
+---
+
+## Accessibility Check After Applying
+
+After applying brand tokens, verify:
+
+1. **Text contrast**: `--color-text` on `--color-bg` must pass WCAG AA (4.5:1 normal, 3:1 large)
+2. **Accent on background**: `--color-accent` used as text or border must meet 3:1 minimum against its background
+3. **Focus states**: `--color-border-focus` must be visually distinct (3:1 against surrounding colors)
+
+For Anthropic's palette: cream `#faf9f5` on near-black `#141413` gives ~18:1 — passes AAA. Orange `#d97757` on cream gives ~3.2:1 — acceptable for large text and UI components, not for small body text.
+
+---
+
+## Tone Alignment
+
+After applying brand colors, make sure the _design choices_ match the brand character:
+
+| Brand character                      | Design implication                                                           |
+| ------------------------------------ | ---------------------------------------------------------------------------- |
+| Warm, editorial (Anthropic)          | Generous whitespace, serif body, soft borders, understated motion            |
+| Precise, minimal (Linear, Vercel)    | Tight spacing, geometric sans only, sharp edges, instant transitions         |
+| Bold, consumer (Spotify, Duolingo)   | Color-heavy, large type, playful shapes, expressive animation                |
+| Trustworthy, enterprise (Salesforce) | Blue-dominant, structured grids, conservative type, high information density |
+
+Color alone doesn't make a branded interface feel right — spacing, motion, and layout personality must match.

package/workflows/skills/frontend-design/references/brand-presets.md

@@ -0,0 +1,228 @@
+# Brand Presets Reference
+
+Use this reference when building interfaces that must conform to an existing brand system — whether a client-supplied style guide, a design system handoff, or a well-documented brand like Anthropic's.
+
+## Receiving Brand Guidelines
+
+When a user hands over brand guidelines, extract these five things before writing any code:
+
+| Extract            | Ask or infer                                                                 |
+| ------------------ | ---------------------------------------------------------------------------- |
+| **Color palette**  | What are the primary, secondary, and accent hex values?                      |
+| **Neutral system** | Are neutrals warm, cool, or truly achromatic?                                |
+| **Typography**     | Specific font families for headings and body? Variable font available?       |
+| **Spacing DNA**    | Base unit? Tight/airy preference?                                            |
+| **Tone**           | Where on the spectrum between playful ↔ authoritative, minimal ↔ expressive? |
+
+## Hex → OKLCH Conversion Workflow
+
+Always convert brand hex colors to OKLCH for CSS. OKLCH gives you perceptual uniformity — colors with the same L value look equally bright, unlike hex or HSL.
+
+```css
+/* Conversion pattern:  hex → oklch via CSS Color 4 */
+/* Most modern browsers accept oklch() natively */
+/* Use https://oklch.com to find values, or compute: */
+
+/* L = perceived lightness 0–100% */
+/* C = chroma (colorfulness) 0–0.37ish */
+/* H = hue angle 0–360 */
+
+/* Example: #d97757 (warm orange) */
+--brand-orange: oklch(65% 0.145 42);
+
+/* Example: #faf9f5 (warm cream) */
+--brand-surface: oklch(98.2% 0.008 85);
+
+/* Example: #141413 (warm near-black) */
+--brand-ink: oklch(10.5% 0.006 85);
+```
+
+**Shorthand**: enter any hex at [oklch.com](https://oklch.com) to get the L/C/H values.
+
+## Semantic Token Mapping
+
+Once you have OKLCH values, map them to semantic tokens — never use raw hex or oklch values directly in components:
+
+```css
+:root {
+  /* --- RAW BRAND TOKENS (source of truth) --- */
+  --brand-ink: oklch(10.5% 0.006 85); /* near-black, warm */
+  --brand-surface: oklch(98.2% 0.008 85); /* cream white */
+  --brand-mid: oklch(72% 0.009 85); /* mid-range gray */
+  --brand-subtle: oklch(92% 0.01 85); /* light gray */
+  --brand-orange: oklch(65% 0.145 42); /* primary accent */
+  --brand-blue: oklch(65% 0.09 235); /* secondary accent */
+  --brand-green: oklch(57% 0.09 130); /* tertiary accent */
+
+  /* --- SEMANTIC TOKENS (what components use) --- */
+  --color-bg: var(--brand-surface);
+  --color-bg-subtle: var(--brand-subtle);
+  --color-text: var(--brand-ink);
+  --color-text-secondary: var(--brand-mid);
+  --color-accent: var(--brand-orange);
+  --color-accent-secondary: var(--brand-blue);
+  --color-accent-tertiary: var(--brand-green);
+  --color-border: var(--brand-subtle);
+}
+```
+
+## Anthropic Brand System
+
+Anthropic's brand (from [anthropics/skills](https://github.com/anthropics/skills/tree/main/skills/brand-guidelines)) is a useful reference implementation. It's a warm, editorial system — earthy neutrals with bold accent contrast.
+
+### Color Palette
+
+```css
+:root {
+  /* Neutrals — warm hue angle ~85 (yellow-brown direction) */
+  --anthropic-ink: oklch(10.5% 0.006 85); /* #141413 — body text, dark bg */
+  --anthropic-cream: oklch(
+    98.2% 0.008 85
+  ); /* #faf9f5 — light bg, text on dark */
+  --anthropic-mid: oklch(72% 0.009 85); /* #b0aea5 — secondary text */
+  --anthropic-subtle: oklch(92% 0.01 85); /* #e8e6dc — dividers, subtle bg */
+
+  /* Accents — arranged in visual temperature order */
+  --anthropic-orange: oklch(
+    65% 0.145 42
+  ); /* #d97757 — primary CTA, highlights */
+  --anthropic-blue: oklch(65% 0.09 235); /* #6a9bcc — secondary actions */
+  --anthropic-green: oklch(
+    57% 0.09 130
+  ); /* #788c5d — tertiary, success states */
+}
+```
+
+### Typography
+
+```css
+/* Load from Google Fonts */
+@import url("https://fonts.googleapis.com/css2?family=Poppins:wght@400;500;600;700&family=Lora:ital,wght@0,400;0,500;0,600;1,400&display=swap");
+
+:root {
+  --font-display: "Poppins", Arial, sans-serif; /* headings, nav, labels */
+  --font-body: "Lora", Georgia, serif; /* body text, long-form */
+}
+
+/* Application rules */
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+.label,
+.nav-item,
+.button,
+.badge {
+  font-family: var(--font-display);
+}
+
+p,
+blockquote,
+.prose,
+article {
+  font-family: var(--font-body);
+}
+```
+
+**Why this pairing works**: Poppins is geometric and structured — clear, modern authority. Lora is elegant serif — warm, readable, literary. Together they balance clarity with warmth, matching Anthropic's positioning between scientific rigor and approachability.
+
+### Spacing DNA
+
+The brand leans into generous negative space. Use a `8px` base unit with larger gaps between major sections:
+
+```css
+:root {
+  --space-1: 0.5rem; /* 8px  — tight groupings */
+  --space-2: 1rem; /* 16px — component padding */
+  --space-3: 1.5rem; /* 24px — between related elements */
+  --space-4: 2rem; /* 32px — section mini-gap */
+  --space-6: 3rem; /* 48px — between sections */
+  --space-8: 4rem; /* 64px — major section spacing */
+}
+```
+
+### Component Patterns
+
+```css
+/* Card — warm border, generous padding, no shadow */
+.card {
+  background: var(--anthropic-subtle);
+  border: 1px solid var(--anthropic-mid);
+  border-radius: 4px; /* subtle — not pill-shaped */
+  padding: var(--space-4);
+}
+
+/* Button — orange CTA */
+.button-primary {
+  background: var(--anthropic-orange);
+  color: var(--anthropic-cream);
+  font-family: var(--font-display);
+  font-weight: 500;
+  letter-spacing: 0.01em;
+  border-radius: 4px;
+  padding: 0.625rem 1.5rem;
+  border: none;
+}
+.button-primary:hover {
+  background: oklch(60% 0.145 42); /* slightly darker orange */
+}
+
+/* Text link — uses orange, not blue */
+a {
+  color: var(--anthropic-orange);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 3px;
+}
+
+/* Code / monospace — uses ink on subtle bg */
+code {
+  background: var(--anthropic-subtle);
+  color: var(--anthropic-ink);
+  font-size: 0.875em;
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+}
+```
+
+### Dark Mode
+
+Anthropic's palette inverts gracefully — the cream and ink swap, mid-tones pull slightly warmer:
+
+```css
+@media (prefers-color-scheme: dark) {
+  :root {
+    --color-bg: var(--anthropic-ink);
+    --color-bg-subtle: oklch(16% 0.008 85); /* slightly elevated */
+    --color-text: var(--anthropic-cream);
+    --color-text-secondary: var(--anthropic-mid);
+    --color-border: oklch(22% 0.008 85);
+    /* Accents stay the same — they hold on both backgrounds */
+  }
+}
+```
+
+## Applying Other Brand Systems
+
+When adapting a different brand, follow this checklist:
+
+1. **Extract and convert** — Get all hex values, convert to oklch
+2. **Identify neutrals** — Are they warm, cool, or pure gray? Find the hue angle
+3. **Map the hierarchy** — Which color is dominant (60%), which secondary (30%), which accent (10%)?
+4. **Check contrast** — Use the WCAG APCa algorithm for text contrast. oklch makes this predictable
+5. **Find the typography voice** — Geometric sans = structured/modern; humanist sans = friendly; slab = authoritative; oldstyle serif = editorial; transitional serif = professional
+6. **Test the mood** — Show a prototype section in brand colors. Does it _feel_ like the brand in motion, not just color?
+
+## Common Brand Color Archetypes
+
+| Archetype                      | Neutrals                | Primary accent       | Feeling                           |
+| ------------------------------ | ----------------------- | -------------------- | --------------------------------- |
+| **Warm editorial** (Anthropic) | Cream / warm near-black | Orange / terracotta  | Thoughtful, approachable, premium |
+| **Cool tech**                  | True gray / white       | Electric blue / teal | Precise, efficient, modern        |
+| **Finance/enterprise**         | Navy / white            | Deep blue / gold     | Stable, trustworthy, conservative |
+| **Health/wellness**            | Off-white / dark green  | Sage green / amber   | Natural, calm, nurturing          |
+| **Startup/consumer**           | White / black           | Bold purple or coral | Energetic, fun, accessible        |
+| **Luxury**                     | White / true black      | Gold / burgundy      | Exclusive, refined, timeless      |
+
+When working with a brand that fits these archetypes, pull from the pattern — then make one unexpected choice to give it character.

package/workflows/skills/generated/skill-audit.json

@@ -2,7 +2,7 @@
   "$schema": "cubis-foundry-skill-audit-v1",
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "summary": {
-    "keep": 83,
+    "keep": 84,
     "review": 4,
     "alias-only": 0
   },
@@ -16,6 +16,15 @@
       "tier": "experimental",
       "reason": "Canonical skill remains active in the layered catalog."
     },
+    {
+      "id": "agent-design",
+      "canonical_id": "agent-design",
+      "status": "keep",
+      "layer": "workflow-specialists",
+      "category": "workflow-specialists",
+      "tier": "experimental",
+      "reason": "Canonical skill remains active in the layered catalog."
+    },
     {
       "id": "agentic-eval",
       "canonical_id": "agentic-eval",
@@ -791,5 +800,5 @@
       "reason": "Canonical skill remains active in the layered catalog."
     }
   ],
-  "contentHash": "06725220390d194e"
+  "contentHash": "43f23105321976ee"
 }

package/workflows/skills/generated/skill-catalog.json

@@ -2,10 +2,10 @@
   "$schema": "cubis-foundry-skill-catalog-v1",
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "summary": {
-    "totalEntries": 87,
-    "totalSkills": 87,
+    "totalEntries": 88,
+    "totalSkills": 88,
     "totalSubskills": 0,
-    "canonicalSkills": 87,
+    "canonicalSkills": 88,
     "compatibilityAliases": 0,
     "layers": [
       "core-operating",
@@ -56,6 +56,38 @@
         "workflow-specialists"
       ]
     },
+    {
+      "id": "agent-design",
+      "package_id": "agent-design",
+      "catalog_id": "agent-design",
+      "kind": "skill",
+      "path": "workflows/skills/agent-design/SKILL.md",
+      "name": "agent-design",
+      "description": "Use when designing, building, or improving a CBX agent, skill, or workflow: clarification strategy, progressive disclosure structure, workflow pattern selection (sequential, parallel, evaluator-optimizer), skill type taxonomy, description tuning, and eval-first testing.",
+      "canonical": true,
+      "canonical_id": "agent-design",
+      "deprecated": false,
+      "replaced_by": null,
+      "aliases": [],
+      "category": "workflow-specialists",
+      "layer": "workflow-specialists",
+      "maturity": "incubating",
+      "tier": "experimental",
+      "tags": [
+        "agent",
+        "agent design",
+        "agent-design",
+        "design",
+        "workflow-specialists"
+      ],
+      "triggers": [
+        "agent-design",
+        "agent design",
+        "agent",
+        "design",
+        "workflow-specialists"
+      ]
+    },
     {
       "id": "agentic-eval",
       "package_id": "agentic-eval",
@@ -567,7 +599,7 @@
       "kind": "skill",
       "path": "workflows/skills/deep-research/SKILL.md",
       "name": "deep-research",
-      "description": "Use when a task needs multi-round research rather than a quick lookup: iterative search, gap finding, corroboration across sources, contradiction handling, or evidence-led synthesis before planning or implementation.",
+      "description": "Use when a task needs multi-round research rather than a quick lookup: iterative search, gap finding, corroboration across sources, contradiction handling, evidence-led synthesis before planning or implementation. Also use when the user asks for 'deep research', 'latest info', or 'how does X compare to Y publicly'.",
       "canonical": true,
       "canonical_id": "deep-research",
       "deprecated": false,
@@ -2735,5 +2767,5 @@
       ]
     }
   ],
-  "contentHash": "b905038bd1d0765e"
+  "contentHash": "986ed2f78188d530"
 }

package/workflows/skills/skills_index.json

@@ -552,7 +552,7 @@
       "research"
     ],
     "path": ".agents/skills/deep-research/SKILL.md",
-    "description": "Use when a task needs multi-round research rather than a quick lookup: iterative search, gap finding, corroboration across sources, contradiction handling, or evidence-led synthesis before planning or implementation.",
+    "description": "Use when a task needs multi-round research rather than a quick lookup: iterative search, gap finding, corroboration across sources, contradiction handling, evidence-led synthesis before planning or implementation. Also use when the user asks for 'deep research', 'latest info', or 'how does X compare to Y publicly'.",
     "triggers": [
       "deep-research",
       "deep research",