Compare commits

...
3 Commits
Author SHA1 Message Date
Viet Tran 0ed327fc18 fix(cli): generate runnable script paths (#181)
Resolve platform-root-relative script paths for local and global installs, with regression coverage across Claude, Codex, Copilot, and Kiro.
2026-08-12 16:34:27 +07:00
PengQi Shi abb7f2fd5a fix: bump skill.json version to 2.13.0 (#438)
Bumps skill.json, marketplace.json, and plugin.json version from 2.11.0 to 2.13.0 to match the latest GitHub release.
2026-08-06 08:29:01 +07:00
PengQi Shi f4d3b71dbe feat(ci): auto-bump skill JSON versions after release (#439)
Adds a workflow that triggers on release published, checks out main,
updates the version field in skill.json, marketplace.json, and plugin.json
to match the release tag, then opens a PR automatically.
2026-08-06 08:02:05 +07:00
9 changed files with 141 additions and 56 deletions
+2 -2
View File
@@ -6,14 +6,14 @@
},
"metadata": {
"description": "UI/UX design intelligence skill with 84 styles, 192 palettes, 74 font pairings, 25 charts, and 22 stack guidelines",
"version": "2.11.0"
"version": "2.13.0"
},
"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, Jetpack Compose, Angular, Laravel, JavaFX, and Three.js.",
"version": "2.11.0",
"version": "2.13.0",
"author": {
"name": "nextlevelbuilder"
},
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "ui-ux-pro-max",
"description": "UI/UX design intelligence. Searchable local database with 84 styles, 192 palettes, 74 font pairings, 25 charts, and 22 stacks (React, Next.js, Vue, Nuxt.js, Nuxt UI, Svelte, Astro, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, WPF, WinUI, Avalonia, Uno Platform, UWP, Three.js). Use when designing, building, or reviewing UI: pages, components, color schemes, typography, layout, accessibility, animation, or data visualization.",
"version": "2.11.0",
"version": "2.13.0",
"author": {
"name": "nextlevelbuilder"
},
+61
View File
@@ -0,0 +1,61 @@
name: Bump JSON versions after release
on:
release:
types: [published]
permissions:
contents: write
pull-requests: write
jobs:
bump-versions:
name: Bump skill.json versions
runs-on: ubuntu-latest
if: |
github.repository == 'nextlevelbuilder/ui-ux-pro-max-skill' &&
!contains(github.ref_name, 'beta')
steps:
- name: Checkout main
uses: actions/checkout@v4
with:
ref: main
- name: Extract version
id: version
run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
- name: Update skill.json
run: |
jq --arg v "${{ steps.version.outputs.version }}" '.version = $v' \
skill.json > skill.json.tmp && mv skill.json.tmp skill.json
- name: Update .claude-plugin/marketplace.json
run: |
jq --arg v "${{ steps.version.outputs.version }}" '
.metadata.version = $v | .plugins[0].version = $v
' .claude-plugin/marketplace.json > marketplace.json.tmp \
&& mv marketplace.json.tmp .claude-plugin/marketplace.json
- name: Update .claude-plugin/plugin.json
run: |
jq --arg v "${{ steps.version.outputs.version }}" '.version = $v' \
.claude-plugin/plugin.json > plugin.json.tmp \
&& mv plugin.json.tmp .claude-plugin/plugin.json
- name: Create pull request
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
VERSION: ${{ steps.version.outputs.version }}
run: |
BRANCH="fix/bump-json-version-${VERSION}"
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git checkout -b "$BRANCH"
git add skill.json .claude-plugin/marketplace.json .claude-plugin/plugin.json
git commit -m "fix: bump skill.json version to ${VERSION}"
git push origin "$BRANCH"
gh pr create \
--title "fix: bump skill.json version to ${VERSION}" \
--body "Bumps \`skill.json\`, \`marketplace.json\`, and \`plugin.json\` version to \`${VERSION}\` to match the latest GitHub release."
+4
View File
@@ -5,6 +5,10 @@ on:
paths:
- '.claude/skills/**'
- 'cli/assets/skills/**'
- 'cli/assets/templates/**'
- 'cli/src/**'
- 'cli/tests/**'
- 'src/ui-ux-pro-max/templates/**'
- '.github/workflows/tests.yml'
push:
branches: [main]
+16 -16
View File
@@ -54,7 +54,7 @@ Extract key information from user request:
**Always start with `--design-system`** to get comprehensive recommendations with reasoning:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
python3 {{SCRIPT_PATH}} "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
```
This command:
@@ -65,7 +65,7 @@ This command:
**Example:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
python3 {{SCRIPT_PATH}} "beauty spa wellness service" --design-system -p "Serenity Spa"
```
### Step 2b: Persist Design System (Master + Overrides Pattern)
@@ -73,7 +73,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --d
To save the design system for **hierarchical retrieval across sessions**, add `--persist`:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"
python3 {{SCRIPT_PATH}} "<query>" --design-system --persist -p "Project Name"
```
This creates:
@@ -82,7 +82,7 @@ This creates:
**With page-specific override:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"
python3 {{SCRIPT_PATH}} "<query>" --design-system --persist -p "Project Name" --page "dashboard"
```
This also creates:
@@ -107,7 +107,7 @@ Now, generate the code...
Three optional 1-10 sliders that tune `--design-system` output without changing your query. Add any combination of them to the same command:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --variance <1-10> --motion <1-10> --density <1-10>
python3 {{SCRIPT_PATH}} "<query>" --design-system --variance <1-10> --motion <1-10> --density <1-10>
```
| Dial | Low (1-3) | Mid (4-7) | High (8-10) |
@@ -122,7 +122,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --varia
**Example:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "internal analytics dashboard" --design-system --variance 8 --motion 7 --density 8 -p "Ops Console"
python3 {{SCRIPT_PATH}} "internal analytics dashboard" --design-system --variance 8 --motion 7 --density 8 -p "Ops Console"
```
### Step 3: Supplement with Detailed Searches (as needed)
@@ -130,7 +130,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "internal analytics dashboard" --
After getting the design system, use domain searches to get additional details:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
python3 {{SCRIPT_PATH}} "<keyword>" --domain <domain> [-n <max_results>]
```
**When to use detailed searches:**
@@ -155,7 +155,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n
Get implementation-specific best practices for the user's stack:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack <stack>
python3 {{SCRIPT_PATH}} "<keyword>" --stack <stack>
```
---
@@ -186,8 +186,8 @@ python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack <stack>
**JavaFX enterprise examples:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
python3 skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx
python3 {{SCRIPT_PATH}} "atlantafx primer enterprise theme" --stack javafx
python3 {{SCRIPT_PATH}} "enterprise tableview density permission" --stack javafx
```
---
@@ -205,7 +205,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density per
### Step 2: Generate Design System (REQUIRED)
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "AI search tool modern minimal" --design-system -p "AI Search"
python3 {{SCRIPT_PATH}} "AI search tool modern minimal" --design-system -p "AI Search"
```
**Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
@@ -214,16 +214,16 @@ python3 skills/ui-ux-pro-max/scripts/search.py "AI search tool modern minimal" -
```bash
# Get style options for a modern tool product
python3 skills/ui-ux-pro-max/scripts/search.py "minimalism dark mode" --domain style
python3 {{SCRIPT_PATH}} "minimalism dark mode" --domain style
# Get UX best practices for search interaction and loading
python3 skills/ui-ux-pro-max/scripts/search.py "search loading animation" --domain ux
python3 {{SCRIPT_PATH}} "search loading animation" --domain ux
```
### Step 4: Stack Guidelines
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "list performance navigation" --stack react-native
python3 {{SCRIPT_PATH}} "list performance navigation" --stack react-native
```
**Then:** Synthesize design system + detailed searches and implement the design.
@@ -236,10 +236,10 @@ The `--design-system` flag supports two output formats:
```bash
# ASCII box (default) - best for terminal display
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
python3 {{SCRIPT_PATH}} "fintech crypto" --design-system
# Markdown - best for documentation
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
python3 {{SCRIPT_PATH}} "fintech crypto" --design-system -f markdown
```
---
+8 -20
View File
@@ -139,6 +139,13 @@ export async function renderSkillFile(config: PlatformConfig, isGlobal = false):
quickReferenceContent = await loadTemplate('base/quick-reference.md');
}
// scriptPath is relative to the platform root. Generated commands run from
// the user's project root, so local installs need the platform root prefix;
// global installs need the same path anchored at the user's home directory.
const rootedScriptPath = `${config.folderStructure.root}/${config.scriptPath}`
.replace(/\/{2,}/g, '/');
const commandScriptPath = isGlobal ? `~/${rootedScriptPath}` : rootedScriptPath;
// Build the final content
const frontmatter = renderFrontmatter(config.frontmatter);
@@ -149,29 +156,10 @@ export async function renderSkillFile(config: PlatformConfig, isGlobal = false):
content = content
.replace(/\{\{TITLE\}\}/g, config.title)
.replace(/\{\{DESCRIPTION\}\}/g, config.description)
.replace(/\{\{SCRIPT_PATH\}\}/g, config.scriptPath)
.replace(/\{\{SCRIPT_PATH\}\}/g, commandScriptPath)
.replace(/\{\{SKILL_OR_WORKFLOW\}\}/g, config.skillOrWorkflow)
.replace(/\{\{QUICK_REFERENCE\}\}/g, quickRefWithNewline);
// Rewrite the hardcoded default script path to the platform-specific path
const defaultScriptPath = 'skills/ui-ux-pro-max/scripts/search.py';
if (config.scriptPath !== defaultScriptPath) {
content = content.replace(
new RegExp(defaultScriptPath.replace(/\//g, '\\/'), 'g'),
config.scriptPath
);
}
// For global install, rewrite relative script paths to absolute ~/root/ paths
if (isGlobal) {
const globalPrefix = `~/${config.folderStructure.root}/`;
// Match any platform's script path pattern (skills/, prompts/, steering/, etc.)
content = content.replace(
new RegExp(`python3 ${config.scriptPath.replace(/\//g, '\\/')}`, 'g'),
`python3 ${globalPrefix}${config.scriptPath}`
);
}
return frontmatter + content;
}
@@ -0,0 +1,32 @@
import { expect, test } from '@playwright/test';
import { loadPlatformConfig, renderSkillFile } from '../../src/utils/template.js';
const cases = [
['claude', '.claude/skills/ui-ux-pro-max/scripts/search.py'],
['codex', '.agents/skills/ui-ux-pro-max/scripts/search.py'],
['copilot', '.github/prompts/ui-ux-pro-max/scripts/search.py'],
['kiro', '.kiro/steering/ui-ux-pro-max/scripts/search.py'],
] as const;
const SEARCH_COMMAND_COUNT = 16;
function extractSearchScriptPaths(content: string): string[] {
return [...content.matchAll(/^python3\s+(\S*search\.py)\b/gm)].map(match => match[1]);
}
for (const [platform, localPath] of cases) {
test(`${platform} renders project-root and global script paths`, async () => {
const config = await loadPlatformConfig(platform);
const localContent = await renderSkillFile(config);
const localPaths = extractSearchScriptPaths(localContent);
expect(localPaths).toHaveLength(SEARCH_COMMAND_COUNT);
expect(new Set(localPaths)).toEqual(new Set([localPath]));
expect(localContent).not.toContain('{{SCRIPT_PATH}}');
const globalContent = await renderSkillFile(config, true);
const globalPaths = extractSearchScriptPaths(globalContent);
expect(globalPaths).toHaveLength(SEARCH_COMMAND_COUNT);
expect(new Set(globalPaths)).toEqual(new Set([`~/${localPath}`]));
expect(globalContent).not.toContain('{{SCRIPT_PATH}}');
});
}
+1 -1
View File
@@ -2,7 +2,7 @@
"name": "ui-ux-pro-max",
"displayName": "UI/UX Pro Max",
"description": "AI-powered design intelligence with 84 UI styles, 192 color palettes, 74 font pairings, 98 UX guidelines, and 25 chart types across 22 tech stacks.",
"version": "2.11.0",
"version": "2.13.0",
"author": "NextLevelBuilder",
"license": "MIT",
"homepage": "https://uupm.cc",
@@ -54,7 +54,7 @@ Extract key information from user request:
**Always start with `--design-system`** to get comprehensive recommendations with reasoning:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
python3 {{SCRIPT_PATH}} "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
```
This command:
@@ -65,7 +65,7 @@ This command:
**Example:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
python3 {{SCRIPT_PATH}} "beauty spa wellness service" --design-system -p "Serenity Spa"
```
### Step 2b: Persist Design System (Master + Overrides Pattern)
@@ -73,7 +73,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --d
To save the design system for **hierarchical retrieval across sessions**, add `--persist`:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"
python3 {{SCRIPT_PATH}} "<query>" --design-system --persist -p "Project Name"
```
This creates:
@@ -82,7 +82,7 @@ This creates:
**With page-specific override:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"
python3 {{SCRIPT_PATH}} "<query>" --design-system --persist -p "Project Name" --page "dashboard"
```
This also creates:
@@ -107,7 +107,7 @@ Now, generate the code...
Three optional 1-10 sliders that tune `--design-system` output without changing your query. Add any combination of them to the same command:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --variance <1-10> --motion <1-10> --density <1-10>
python3 {{SCRIPT_PATH}} "<query>" --design-system --variance <1-10> --motion <1-10> --density <1-10>
```
| Dial | Low (1-3) | Mid (4-7) | High (8-10) |
@@ -122,7 +122,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --varia
**Example:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "internal analytics dashboard" --design-system --variance 8 --motion 7 --density 8 -p "Ops Console"
python3 {{SCRIPT_PATH}} "internal analytics dashboard" --design-system --variance 8 --motion 7 --density 8 -p "Ops Console"
```
### Step 3: Supplement with Detailed Searches (as needed)
@@ -130,7 +130,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "internal analytics dashboard" --
After getting the design system, use domain searches to get additional details:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
python3 {{SCRIPT_PATH}} "<keyword>" --domain <domain> [-n <max_results>]
```
**When to use detailed searches:**
@@ -155,7 +155,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n
Get implementation-specific best practices for the user's stack:
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack <stack>
python3 {{SCRIPT_PATH}} "<keyword>" --stack <stack>
```
---
@@ -186,8 +186,8 @@ python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack <stack>
**JavaFX enterprise examples:**
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
python3 skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx
python3 {{SCRIPT_PATH}} "atlantafx primer enterprise theme" --stack javafx
python3 {{SCRIPT_PATH}} "enterprise tableview density permission" --stack javafx
```
---
@@ -205,7 +205,7 @@ python3 skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density per
### Step 2: Generate Design System (REQUIRED)
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "AI search tool modern minimal" --design-system -p "AI Search"
python3 {{SCRIPT_PATH}} "AI search tool modern minimal" --design-system -p "AI Search"
```
**Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
@@ -214,16 +214,16 @@ python3 skills/ui-ux-pro-max/scripts/search.py "AI search tool modern minimal" -
```bash
# Get style options for a modern tool product
python3 skills/ui-ux-pro-max/scripts/search.py "minimalism dark mode" --domain style
python3 {{SCRIPT_PATH}} "minimalism dark mode" --domain style
# Get UX best practices for search interaction and loading
python3 skills/ui-ux-pro-max/scripts/search.py "search loading animation" --domain ux
python3 {{SCRIPT_PATH}} "search loading animation" --domain ux
```
### Step 4: Stack Guidelines
```bash
python3 skills/ui-ux-pro-max/scripts/search.py "list performance navigation" --stack react-native
python3 {{SCRIPT_PATH}} "list performance navigation" --stack react-native
```
**Then:** Synthesize design system + detailed searches and implement the design.
@@ -236,10 +236,10 @@ The `--design-system` flag supports two output formats:
```bash
# ASCII box (default) - best for terminal display
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
python3 {{SCRIPT_PATH}} "fintech crypto" --design-system
# Markdown - best for documentation
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
python3 {{SCRIPT_PATH}} "fintech crypto" --design-system -f markdown
```
---