Compare commits

...
4 Commits
Author SHA1 Message Date
ThomasandThomas Schneider bdf1179bcf fix: replace colon with hyphen in skill names (#383)
The Agent Skills spec requires names to match [a-z0-9-] only.
The colon in 'ckm:' prefix causes daily validation errors:

  name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)

This affects all six ckm-prefixed skills. Replace ':' with '-'.

Co-authored-by: Thomas Schneider <tho.schneider@sap.com>
2026-06-24 19:38:31 +07:00
xiaolai 381f01d9e5 fix: pin shadcn version instead of @latest
Merge PR #284: pin the shadcn CLI helper to a deterministic version fallback while still allowing project package.json overrides.
2026-06-24 19:08:07 +07:00
PengQi Shiandshipengqi a13b2a02fd fix: bump skill.json version to 2.6.2 (#382)
* fix: bump skill.json version to 2.6.2

* fix: bump marketplace.json and plugin.json version to 2.6.2

---------

Co-authored-by: shipengqi <pooky.shi@gamil.com>
2026-06-24 08:04:10 +07:00
bhasan26andBilal Hasan 1518fec29d docs: add CONTRIBUTING.md guide for new contributors (#264)
Co-authored-by: Bilal Hasan <bhaasan26@my.whitworth.edu>
2026-06-23 13:00:53 +07:00
11 changed files with 209 additions and 12 deletions
+2 -2
View File
@@ -6,14 +6,14 @@
},
"metadata": {
"description": "UI/UX design intelligence skill with 67 styles, 161 palettes, 57 font pairings, 25 charts, and 15 stack guidelines",
"version": "2.5.0"
"version": "2.6.2"
},
"plugins": [
{
"name": "ui-ux-pro-max",
"source": "./",
"description": "Professional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and Jetpack Compose.",
"version": "2.5.0",
"version": "2.6.2",
"author": {
"name": "nextlevelbuilder"
},
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "ui-ux-pro-max",
"description": "UI/UX design intelligence. 67 styles, 161 palettes, 57 font pairings, 25 charts, 15 stacks (React, Next.js, Vue, Svelte, Astro, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Nuxt, Jetpack Compose). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.",
"version": "2.5.0",
"version": "2.6.2",
"author": {
"name": "nextlevelbuilder"
},
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: ckm:banner-design
name: ckm-banner-design
description: "Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills."
argument-hint: "[platform] [style] [dimensions]"
license: MIT
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: ckm:brand
name: ckm-brand
description: Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.
argument-hint: "[update|review|create] [args]"
metadata:
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: ckm:design-system
name: ckm-design-system
description: Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing/typography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations.
argument-hint: "[component or token]"
license: MIT
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: ckm:design
name: ckm-design
description: "Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads."
argument-hint: "[design-type] [context]"
license: MIT
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: ckm:slides
name: ckm-slides
description: Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.
argument-hint: "[topic] [slide-count]"
metadata:
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: ckm:ui-styling
name: ckm-ui-styling
description: Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.
argument-hint: "[component or layout]"
license: MIT
@@ -64,6 +64,20 @@ class ShadcnInstaller:
except (json.JSONDecodeError, KeyError, OSError):
return []
def _get_shadcn_version(self) -> str:
"""Read shadcn version from project package.json; fall back to a pinned default."""
pkg_json = self.project_root / "package.json"
if pkg_json.exists():
try:
pkg = json.loads(pkg_json.read_text())
for section in ("dependencies", "devDependencies"):
version = pkg.get(section, {}).get("shadcn")
if version:
return version.lstrip("^~>=<").split()[0]
except (json.JSONDecodeError, KeyError):
pass
return "2.3.0" # pinned fallback; update when newer stable release is needed
def add_components(
self, components: List[str], overwrite: bool = False
) -> tuple[bool, str]:
@@ -98,7 +112,8 @@ class ShadcnInstaller:
)
# Build command
cmd = ["npx", "shadcn@latest", "add"] + components
shadcn_version = self._get_shadcn_version()
cmd = ["npx", f"shadcn@{shadcn_version}", "add"] + components
if overwrite:
cmd.append("--overwrite")
@@ -144,7 +159,8 @@ class ShadcnInstaller:
"shadcn not initialized. Run 'npx shadcn@latest init' first",
)
cmd = ["npx", "shadcn@latest", "add", "--all"]
shadcn_version = self._get_shadcn_version()
cmd = ["npx", f"shadcn@{shadcn_version}", "add", "--all"]
if overwrite:
cmd.append("--overwrite")
+181
View File
@@ -0,0 +1,181 @@
# Contributing to UI/UX Pro Max
Thank you for taking the time to contribute! 🎉
This guide will help you get started quickly.
---
## Table of Contents
- [Getting Started](#getting-started)
- [Project Structure](#project-structure)
- [Ways to Contribute](#ways-to-contribute)
- [Development Workflow](#development-workflow)
- [Commit Message Format](#commit-message-format)
- [Pull Request Guidelines](#pull-request-guidelines)
- [Reporting Bugs](#reporting-bugs)
- [Code of Conduct](#code-of-conduct)
---
## Getting Started
### Prerequisites
- **Node.js** 18+ and **npm**
- **Python 3.x**
- **Bun** (for building the CLI)
- **Git**
### Fork & Clone
```bash
# 1. Fork the repo on GitHub, then clone your fork
git clone https://github.com/YOUR_USERNAME/ui-ux-pro-max-skill.git
cd ui-ux-pro-max-skill
# 2. Add the upstream remote
git remote add upstream https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
# 3. Install CLI dependencies
cd cli && npm install && cd ..
```
---
## Project Structure
```
ui-ux-pro-max-skill/
├── src/ui-ux-pro-max/ # Source of truth — edit here, not in .claude/
│ ├── data/ # CSV databases (styles, colors, typography, rules)
│ ├── scripts/ # Python search engine & design system generator
│ └── templates/ # Platform-specific skill templates
├── cli/ # npm CLI installer (uipro-cli)
├── .claude/ # Local dev/test files for Claude Code
├── .factory/ # Local dev/test files for Droid (Factory)
├── docs/ # Documentation
└── preview/ # Preview screenshots and demos
```
> **Important:** Always make data/script changes in `src/ui-ux-pro-max/`, then sync to the CLI (see below). Do not edit `.claude/` or `.factory/` directly for permanent changes.
---
## Ways to Contribute
### 🐛 Bug Fixes
Check the [Issues tab](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/issues) for bugs labeled `bug`. Comment on the issue before starting so we don't duplicate work.
### ✨ New UI Styles
Add a new entry to `src/ui-ux-pro-max/data/styles.csv`. Each row needs:
- Style name
- Description
- Best for (use cases)
- Key CSS properties/effects
### 🎨 New Color Palettes
Add entries to `src/ui-ux-pro-max/data/colors.csv`. Match the existing format (primary, secondary, CTA, background, text, notes).
### 🏭 New Industry Reasoning Rules
Add rules to `src/ui-ux-pro-max/data/rules.csv`. Each rule needs a product type, recommended pattern, style priority, color mood, typography mood, key effects, and anti-patterns.
### 🌍 Translations
Translate `README.md` into your language and save it as `README.[lang].md` (e.g., `README.zh.md`, `README.es.md`).
### 📝 Documentation Improvements
Fix typos, clarify confusing sections, or add missing examples in `README.md` or `docs/`.
### 🔧 CLI Improvements
Improvements to the `cli/` installer. Run `cd cli && bun run build` to test locally.
---
## Development Workflow
```bash
# 1. Create a feature branch from main
git checkout -b feat/your-feature-name
# 2. Make your changes in src/ui-ux-pro-max/
# 3. Sync changes to CLI assets
cp -r src/ui-ux-pro-max/data/* cli/assets/data/
cp -r src/ui-ux-pro-max/scripts/* cli/assets/scripts/
cp -r src/ui-ux-pro-max/templates/* cli/assets/templates/
# 4. Build and test the CLI locally
cd cli && bun run build
mkdir /tmp/test-project && cd /tmp/test-project
node /path/to/cli/dist/index.js init --ai claude --offline
# 5. Test the Python search script
cd /path/to/repo
python3 src/ui-ux-pro-max/scripts/search.py "your query" --design-system
# 6. Push your branch
git push -u origin feat/your-feature-name
```
---
## Commit Message Format
We follow [Conventional Commits](https://www.conventionalcommits.org/):
```
<type>: <short description>
Types:
feat → New feature or content (new style, rule, palette)
fix → Bug fix
docs → Documentation only
refactor → Code change without new feature or fix
chore → Build process, dependency updates
test → Adding or fixing tests
```
**Examples:**
```
feat: add Skeuomorphism 2.0 style to general styles
fix: correct color palette for fintech industry rule
docs: translate README to Spanish
chore: update uipro-cli to v2.6.0
```
---
## Pull Request Guidelines
1. **One PR per change** — keep PRs focused and small
2. **Reference related issues** — use `Closes #123` in the PR description
3. **Fill out the PR template** — describe what you changed and why
4. **Never push directly to `main`** — always use a feature branch
5. **Wait for review** — a maintainer will review within a few days
---
## Reporting Bugs
Please [open an issue](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/issues/new) and include:
- Your OS and terminal
- The AI assistant you're using (Claude Code, Cursor, etc.)
- The exact command or prompt that triggered the bug
- Expected vs. actual behavior
- Any error messages or screenshots
---
## Code of Conduct
Be kind, constructive, and respectful. We're all here to build something useful together.
Harassment, spam, or low-effort contributions will be closed without review.
---
## Questions?
Open a [Discussion](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/discussions) or check the [README](README.md) first.
Happy contributing! 🚀
+1 -1
View File
@@ -2,7 +2,7 @@
"name": "ui-ux-pro-max",
"displayName": "UI/UX Pro Max",
"description": "AI-powered design intelligence with 67 UI styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 15+ tech stacks.",
"version": "2.5.0",
"version": "2.6.2",
"author": "NextLevelBuilder",
"license": "MIT",
"homepage": "https://uupm.cc",