rampstackco/creative-brief-selector
Produce a creative brief grounded in live reference sites and deliberately distinct from existing demos, for any new brand build. Composes with brand-archetype-system and creative-direction. Use this skill at the start of any brand or microsite build when the result needs to land in a specific aesthetic position and not drift into a default house style. Triggers on creative brief, design brief, build brief, brand direction, where should this brand sit, what should this site look like, reference sites for, archetype for, distinct from our other brands, divergence from prior, not the same as. Also triggers when prior builds have come out as siblings and a systematic divergence approach is needed.
npx skills add https://github.com/rampstackco/claude-skills --skill creative-brief-selector
A starting-point selector for brand and microsite builds. Given a business spec (name, vertical, shape, one-line vibe, optional list of shipped demos), produces a creative brief grounded in three things:
brand-archetype-system, picked or composed to be deliberately distinct from the shipped demos.The brief output is concrete tokens, not abstract families, including explicit section-shape choices (hero shape and footer shape) as first-class outputs alongside palette and voice. It is meant to be loaded by downstream build skills as the single creative artifact for the build.
creative-direction).logo-design, brand-identity).brand-voice).brand-ideation first, then return to this skill).This skill works upstream of build-time skills and parallel to the aesthetic methodology layer:
brand-archetype-system (upstream input). The archetype catalog this skill picks from. The skill names the archetype in the rendered brief; it does not redefine the archetype's defaults.creative-direction (parallel input). The four-axis vocabulary the archetypes reference. If the consumer needs the full axis brief, run creative-direction first; this skill's brief consumes its outputs.brand-identity (downstream). Once the brief is approved, brand-identity turns it into a finished identity system.landing-page-copy, content-and-copy, art-direction (downstream). Every downstream skill that produces aesthetic output references this skill's brief.Direct verbatim copying of an archetype's default palette into a new brand is the failure mode this skill exists to prevent. The brief shifts the archetype's defaults toward the business spec's specifics.
brand-archetype-system that fit the vertical and shape.references/reference-bank/, load the file(s) matching the chosen archetype-and-vertical. Augment with one to two discovered live references if the bank is sparse. Add discovered references back to the bank in the build PR.references/02-brief-template.md. Run output-side divergence. Output the brief plus the references list plus the divergence-check result.Full step-by-step in references/01-process.md. The divergence schema and its three overlap rules are in references/03-divergence-check.md.
A curated bank that grows with each build. Each file under references/reference-bank/ covers one archetype-and-vertical combination and holds three to six live reference URLs, each with a one-line why and optional palette or type observations. The bank ships with three seed combinations covering western-boot maker, heritage barbershop, and balloon-ride experience.
When a build draws from a sparse combination, the build is expected to commit the live references it discovered back to the bank as part of its build PR. The bank gets denser with use.
Each shipped demo carries a signature with seven fields:
slugarchetype (the canonical archetype name from brand-archetype-system)dominant_hue_family (the recognizable colour family, e.g. leather-bone-saddle, dawn-navy-coral, dark-linen-amber)voice_register (e.g. story-forward third-person, atmospheric second-person, fitment-first technical)primary_structural_pattern (e.g. shoppable-grid-product-forward, arc-timeline-hero, fitment-selector-then-rails)hero_shape (e.g. dual-column-image-and-text, wide-photograph-with-band-below, full-bleed-image-with-overlay; canonical vocabulary in references/05-section-shapes-vocabulary.md)footer_shape (e.g. single-line-strip, multi-column-sitemap, type-only-no-links; same vocabulary file)Overlap rules (full set in references/03-divergence-check.md):
A worked example file of seven signatures lives at references/04-shipped-demos-signatures-example.md for illustration; the live signatures file for any consuming project lives in that project, not in this skill.
Archetypes are NAMED for aesthetic families, NOT for brands, following the convention of brand-archetype-system. Live reference sites are cited as exemplars using nominative attribution language: "exemplified by [URL]", "characteristic of", "in the register of". This is descriptive and nominative fair use territory, durable across brand redesigns. A brand that pivots its identity does not invalidate the archetype it once exemplified.
references/00-overview.md - The case for the skill, the hybrid references model, the two-direction divergence, the trademark posture.references/01-process.md - The five-step process, each step concrete enough to execute.references/02-brief-template.md - The fillable brief template with section-by-section guidance.references/03-divergence-check.md - The signature schema and the overlap rules.references/04-shipped-demos-signatures-example.md - Worked example signatures file with seven demos.references/05-section-shapes-vocabulary.md - Canonical open vocabulary of hero and footer section shapes plus archetype affinities.The curated reference bank lives in a reference-bank/ subdirectory under references/. The bank ships with a README plus three seed archetype-and-vertical files: premium-dtc-maker-western-boots.md, heritage-local-service-barbershop.md, and hospitality-experience-balloon-ride.md. The bank's purpose and extension procedure are documented in its README; the seed files each carry three to four positive live references and one to two negative references for the chosen position. Load the bank file matching the build's archetype-and-vertical at step 3 of the process.
Take rampstackco/creative-brief-selector from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.