Skip to content

feat: add brand-explore skill for Studio#139

Draft
xerial wants to merge 1 commit intomainfrom
feature/brand-explore-skill
Draft

feat: add brand-explore skill for Studio#139
xerial wants to merge 1 commit intomainfrom
feature/brand-explore-skill

Conversation

@xerial
Copy link
Copy Markdown
Member

@xerial xerial commented Mar 23, 2026

Summary

  • Add studio-skills/brand-explore skill for generating 10+ genuinely distinct HTML/Tailwind brand page variations from a single brief
  • Register in marketplace.json under studio-skills plugin
  • Add trigger test

Skill capabilities

  • 12 named direction archetypes (immersive-hero, editorial-grid, split-screen, minimal-typographic, etc.)
  • Anti-patterns per archetype to prevent AI convergence (what NOT to do)
  • Font pairing guide forcing typographic diversity
  • Generation workflow: extract brand signals → create session → generate directions → write manifest → open gallery
  • Conversation-to-edit loop: targeted HTML edits, combine directions, new rounds, style/voice changes
  • Brand voice integration with messaging framework support

Companion PR

treasure-data/tdx PR (brand gallery MCP app + browse_explorations tool + creative SDK types)

Test plan

  • Trigger test added: "Explore brand directions for my company landing page" → brand-explore
  • Manual: install skill in Studio, trigger exploration, verify directions generate correctly

🤖 Generated with Claude Code

Add workspace skill that generates 10+ genuinely distinct HTML/Tailwind
brand page variations. Includes 12 named direction archetypes with
anti-patterns, font pairing guide, manifest format, and conversation-to-edit
loop instructions.

Companion to treasure-data/tdx brand gallery MCP app and browse_explorations
tool.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings March 23, 2026 02:25
@xerial xerial requested review from a team as code owners March 23, 2026 02:25
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Treasure Studio skill (“brand-explore”) to generate multiple distinct HTML/Tailwind brand landing page directions from a single brief, and wires it into the marketplace + trigger tests.

Changes:

  • Add new studio-skills/brand-explore skill definition and workflow (session folder, direction archetypes, manifest + gallery generation).
  • Register the skill under the studio-skills plugin collection in .claude-plugin/marketplace.json.
  • Add a trigger test prompt expected to route to brand-explore.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
tests/trigger-tests.yml Adds a new trigger test mapping a “brand directions” prompt to brand-explore.
studio-skills/brand-explore/SKILL.md Introduces the full skill spec: entry points, generation workflow, archetypes, templates, and edit loop.
.claude-plugin/marketplace.json Registers ./studio-skills/brand-explore in the studio-skills plugin and updates its description.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +31 to +35
```
{workspace}/attachments/brand-explore/{YYYY-MM-DD}-{brand-slug}/
```

Example: `attachments/brand-explore/2026-03-22-acme/`
Copy link

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

{workspace} is used as the base path for the session folder, but other skills in this repo use {cwd} as the working-directory placeholder (e.g., analysis-skills/seo-analysis). To keep these instructions executable/consistent, align on the same placeholder (or define what {workspace} refers to and use it consistently in both the template and the example path).

Copilot uses AI. Check for mistakes.
- **Layout**: Dark background throughout, dramatic contrast, spot lighting effects via CSS
- **Visual weight**: dense
- **Typography**: Light text on dark, high contrast, cinematic proportions
- **Anti-patterns**: NO white/light backgrounds. NO pastel colors. Background must be dark (#0a-#1a range).
Copy link

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The dark background constraint is ambiguous as written (“#0a-#1a range”). Please specify a valid hex range explicitly (e.g., #0a0a0a–#1a1a1a) so the instruction can be followed without guessing and avoids invalid color values.

Suggested change
- **Anti-patterns**: NO white/light backgrounds. NO pastel colors. Background must be dark (#0a-#1a range).
- **Anti-patterns**: NO white/light backgrounds. NO pastel colors. Background must be dark (hex range approximately #0a0a0a–#1a1a1a).

Copilot uses AI. Check for mistakes.
Comment on lines +144 to +153
```html
<!--
@brand-explore
direction: {Direction Name}
archetype: {archetype-key}
mood: {comma-separated mood words}
visual-weight: {minimal|balanced|dense}
round: {round number}
rationale: {1-2 sentence AI explanation of why this direction and what audience it suits}
-->
Copy link

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The required metadata marker is inconsistent: the template shows a multi-line comment block with an @brand-explore line, but the checklist requires the literal string <!--@brand-explore-->. If anything parses this marker, this inconsistency can cause missed detection; please standardize on one exact format and reference that consistently throughout the doc.

Copilot uses AI. Check for mistakes.
- editorial-grid: Lora + Inter
- split-screen: Montserrat + Hind
- minimal-typographic: Bebas Neue + Space Mono
- card-mosaic: DM Sans + DM Sans
Copy link

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The “Font Pairing Guide (force diversity)” lists card-mosaic: DM Sans + DM Sans, which undermines the stated goal of font pairing/typographic diversity. Either pick distinct heading/body fonts for this archetype or clarify that using the same font for both is intentional and still considered compliant.

Suggested change
- card-mosaic: DM Sans + DM Sans
- card-mosaic: DM Sans + Work Sans

Copilot uses AI. Check for mistakes.

### Mark favorite
User: "I like direction 3"
→ Update manifest.json to set `favorite: true` on that direction. Regenerate index.html.
Copy link

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The doc instructs setting favorite: true in manifest.json, but the manifest format example doesn’t include a favorite field for direction entries. Please update the manifest schema/example to include this field (or clarify it’s optional/ignored) so implementers know the canonical format.

Suggested change
Update manifest.json to set `favorite: true` on that direction. Regenerate index.html.
If your `manifest.json` format supports it, update the corresponding direction entry to set `favorite: true` (an optional boolean field) for that direction. Regenerate `index.html`.

Copilot uses AI. Check for mistakes.
@xerial xerial marked this pull request as draft March 23, 2026 23:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants