mirror of https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git synced 2026-09-30 07:56:14 +00:00

fix(skills): skill-relative paths below SKILL.md, widen path contract (#482 )

Refs #474 (finding 1 follow-up to #476, which rewrote design/SKILL.md
and added a contract that grepped only */SKILL.md; the same defect one
level down survived).

- 29 home-rooted paths (~/.claude/skills/design/scripts/...) in
  design/references/{cip,icon,logo}-design.md -> scripts/... (27 at
  review time, two more added by #470); the printed
  hint in design/scripts/cip/generate.py now derives the absolute path
  from __file__
- 19 project-rooted invocations (.claude/skills/<skill>/scripts/...) in
  brand/, slides/ and design/ references -> scripts/... (own skill) or
  ../<skill>/scripts/... (sibling sub-skill; sub-skills are installed
  side by side in every layout)
- brand/scripts/sync-brand-to-tokens.cjs resolved its sibling script from
  process.cwd(), silently skipping CSS regeneration under plugin and
  --global installs; now resolved from __dirname, with a warning when
  the sibling skill is missing; regression test asserts the regeneration
- brand/scripts/extract-colors.cjs: tool-neutral hint instead of a
  project-rooted path into a skill this plugin does not ship
- "Script Paths" section in the five sub-skills that invoke scripts:
  script path from the skill directory, working directory at the
  project root
- new test_skill_script_paths.py (src, mirrored to both scripts/tests
  copies): every python/node/bash invocation in every shipped skill
  markdown must be skill-relative and name a file that ships
- check-asset-sync.yml: contract covers every file under both skill
  trees and home-/project-/variable-rooted forms; ${CLAUDE_PLUGIN_ROOT}
  allowed only in the plugin-only core SKILL.md; LC_ALL=C + -I for the tracked
  .coverage binary; grep errors fail instead of passing; push filter
  includes the workflow and sync-assets.mjs
- CLI copy regenerated via sync-assets.mjs

Co-authored-by: notbucki <daniel@buckenmaier.xyz>
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>

2026-09-03 15:14:02 +07:00

4.2 KiB

Raw Blame History

CIP Design Reference

Corporate Identity Program design with 50+ deliverables, 20 styles, 20 industries. Generate mockups with Gemini Nano Banana (Flash/Pro).

Scripts

Script	Purpose
`scripts/cip/search.py`	Search deliverables, styles, industries; generate CIP briefs
`scripts/cip/generate.py`	Generate CIP mockups with Gemini (Flash/Pro)
`scripts/cip/render-html.py`	Render HTML presentation from CIP mockups
`scripts/cip/core.py`	BM25 search engine for CIP data

Commands

CIP Brief (Start Here)

python3 scripts/cip/search.py "tech startup" --cip-brief -b "BrandName"

Search Domains

# Deliverables
python3 scripts/cip/search.py "business card letterhead" --domain deliverable

# Design styles
python3 scripts/cip/search.py "luxury premium elegant" --domain style

# Industry guidelines
python3 scripts/cip/search.py "hospitality hotel" --domain industry

# Mockup contexts
python3 scripts/cip/search.py "office reception" --domain mockup

Generate Mockups

# With logo (RECOMMENDED - uses image editing)
python3 scripts/cip/generate.py --brand "TopGroup" --logo /path/to/logo.png --deliverable "business card" --industry "consulting"

# Full CIP set with logo
python3 scripts/cip/generate.py --brand "TopGroup" --logo /path/to/logo.png --industry "consulting" --set

# Pro model for 4K text rendering
python3 scripts/cip/generate.py --brand "TopGroup" --logo logo.png --deliverable "business card" --model pro

# Custom deliverables with aspect ratio
python3 scripts/cip/generate.py --brand "GreenLeaf" --logo logo.png --industry "organic food" --deliverables "letterhead,packaging,vehicle" --ratio 16:9

# Without logo (AI generates interpretation)
python3 scripts/cip/generate.py --brand "TechFlow" --deliverable "business card" --no-logo-prompt

Render HTML Presentation

python3 scripts/cip/render-html.py --brand "TopGroup" --industry "consulting" --images /path/to/cip-output
python3 scripts/cip/render-html.py --brand "TopGroup" --industry "consulting" --images ./topgroup-cip --output presentation.html

Models

flash (default): gemini-2.5-flash-image - Fast, cost-effective
pro: gemini-3-pro-image-preview - Quality, 4K text rendering

Deliverable Categories

Category	Items
Core Identity	Logo, Logo Variations
Stationery	Business Card, Letterhead, Envelope, Folder, Notebook, Pen
Security/Access	ID Badge, Lanyard, Access Card
Office Environment	Reception Signage, Wayfinding, Meeting Room Signs, Wall Graphics
Apparel	Polo Shirt, T-Shirt, Cap, Jacket, Apron
Promotional	Tote Bag, Gift Box, USB Drive, Water Bottle, Mug, Umbrella
Vehicle	Car Sedan, Van, Truck
Digital	Social Media, Email Signature, PowerPoint, Document Templates
Product	Packaging Box, Labels, Tags, Retail Display
Events	Trade Show Booth, Banner Stand, Table Cover, Backdrop

Design Styles

Style	Colors	Best For
Corporate Minimal	Navy, White, Blue	Finance, Legal, Consulting
Modern Tech	Purple, Cyan, Green	Tech, Startups, SaaS
Luxury Premium	Black, Gold, White	Fashion, Jewelry, Hotels
Warm Organic	Brown, Green, Cream	Food, Organic, Artisan
Bold Dynamic	Red, Orange, Black	Sports, Entertainment

HTML Presentation Features

Hero section with brand name, industry, style, mood
Deliverable cards with mockup images
Descriptions: concept, purpose, specifications
Responsive desktop/mobile, dark theme
Images embedded as base64 (single-file portable)

Workflow

Generate CIP brief → scripts/cip/search.py --cip-brief
Generate mockups with logo → scripts/cip/generate.py --brand --logo --industry --set
Render HTML presentation → scripts/cip/render-html.py --brand --industry --images

Tip: If no logo exists, use Logo Design (built-in) to generate one first.

Detailed References

references/cip-deliverable-guide.md - Deliverable specifications
references/cip-style-guide.md - Design style descriptions
references/cip-prompt-engineering.md - AI generation prompts

Setup

export GEMINI_API_KEY="your-key"
pip install google-genai pillow

4.2 KiB Raw Blame History