chore: versioning setup — CHANGELOG + GitHub Actions release pipeline

.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+
+      - name: Extract changelog section for this version
+        id: changelog
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          # Strip leading 'v' for changelog lookup
+          VERSION_NUM="${VERSION#v}"
+          # Extract the section between this version and the previous one
+          NOTES=$(awk "/^## \[$VERSION_NUM\]/{found=1; next} found && /^## \[/{exit} found{print}" CHANGELOG.md)
+          # Escape for GitHub Actions output
+          echo "notes<<EOF" >> $GITHUB_OUTPUT
+          echo "$NOTES" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Validate skill before release
+        run: |
+          npm install -g agent-skills-cli
+          skills validate ./ui-restructure
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.version }}
+          name: ${{ steps.version.outputs.version }}
+          body: |
+            ## What's in this release
+
+            ${{ steps.changelog.outputs.notes }}
+
+            ---
+
+            ## Install
+
+            ```bash
+            npx openskills install vamsivarma27/claude-ui-restructure
+            ```
+
+            Or manually copy `ui-restructure/` into `.claude/skills/` in your project.
+
+            **[View on SkillsMP →](https://skillsmp.com/skills/ui-restructure)**
+          draft: false
+          prerelease: false

.github/workflows/validate.yml

@@ -0,0 +1,31 @@
+name: Validate Skill
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  validate:
+    name: Validate SKILL.md
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install agent-skills-cli
+        run: npm install -g agent-skills-cli
+
+      - name: Validate skill
+        run: skills validate ./ui-restructure
+
+      - name: Check CHANGELOG.md updated
+        if: github.event_name == 'pull_request'
+        run: |
+          if git diff --name-only origin/main...HEAD | grep -q "CHANGELOG.md"; then
+            echo "✓ CHANGELOG.md updated"
+          else
+            echo "⚠ Warning: CHANGELOG.md was not updated in this PR"
+          fi

CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+All notable changes to `ui-restructure` are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Added
+- `--god-mode` parameter — user-first UI redesign that simulates 100 user mindsets
+- `--remove-tokens` flag — explicit token reset (default in god mode is to preserve tokens)
+- `modes/godmode.md` — 7-phase god mode pipeline
+- `references/user-mindset.md` — 10 Laws of User Behavior + 10 common developer UX mistakes
+
+---
+
+## [1.1.0] — 2026-04-06
+
+### Added
+- `references/ui-craft.md` — world-class frontend engineering reference (motion, micro-interactions, typography, iconography, color theory, shadows, accessibility)
+- Step 11 (mandatory polish pass) added to SKILL.md — runs after every rebuild
+- Framer Motion spring presets, easing curve guide, duration scale
+- 35-point polish checklist
+- 5-state interaction model for every component
+- WCAG AA contrast enforcement
+
+### Changed
+- Skill description updated to mention Stripe/Linear/Vercel quality output
+- Version bumped 1.0.0 → 1.1.0
+
+---
+
+## [1.0.1] — 2026-04-06
+
+### Fixed
+- Renamed skill from `claude-ui-restructure` to `ui-restructure` — SkillsMP rejects reserved word `claude` in skill names
+- Slash command is now `/ui-restructure`
+
+### Added
+- `CODEOWNERS` — all changes require `@vamsivarma27` review
+- `SECURITY.md` — private vulnerability reporting policy
+- `.github/PULL_REQUEST_TEMPLATE.md` — contributor checklist
+- `.github/CONTRIBUTING.md` — branch naming, commit format rules
+
+---
+
+## [1.0.0] — 2026-04-06
+
+### Added
+- Initial release — `ui-restructure` skill
+- `SKILL.md` — 10-step execution pipeline solving UI lock-in
+- Style engines: `apple`, `linear`, `minimal`, `dashboard`
+- Modes: `full`, `layout`, `theme`, `grid`
+- `parser/commands.md` — full argument parsing rules
+- `prompts/restructure-flow.md` — master execution flow
+- Supports: Next.js, React (Vite/CRA), Vue 3, Tailwind, CSS modules, styled-components, shadcn
+- Published to SkillsMP (status: approved)
+- Branch protection, secret scanning, Dependabot enabled on GitHub repo
+
+---
+
+## Versioning Rules
+
+| Change type | Version bump | Example |
+|---|---|---|
+| New `--flag` or new mode/engine | Minor (x.**Y**.0) | Adding `--god-mode` → 1.1.0 → 1.2.0 |
+| Bug fix, copy fix, typo | Patch (x.x.**Z**) | Fix broken reference → 1.2.0 → 1.2.1 |
+| Breaking change to SKILL.md interface | Major (**X**.0.0) | Rename existing flag → 1.x.x → 2.0.0 |
+| Security fix | Patch + release note | Same as patch |
+| Docs/meta only | Patch | README update → patch |

README.md

@@ -24,7 +24,7 @@ Your hooks, API calls, handlers, data mappings — untouched.
 
 ```bash
 # Using openskills
-npx openskills install vamsivarma27/claude-ui-restructure
+npx openskills install vamsivarma27/ui-restructure
 
 # Manual (copy to project)
 cp -r claude-ui-restructure .claude/skills/

SECURITY.md

@@ -11,7 +11,7 @@
 **Do not open a public GitHub issue for security vulnerabilities.**
 
 Please use GitHub's private vulnerability reporting:
-👉 [Report a vulnerability](https://github.com/vamsivarma27/claude-ui-restructure/security/advisories/new)
+👉 [Report a vulnerability](https://github.com/vamsivarma27/ui-restructure/security/advisories/new)
 
 Include:
 - Description of the vulnerability

package.json

@@ -1,13 +1,12 @@
 {
-  "name": "claude-ui-restructure",
-  "version": "1.0.0",
-  "description": "Claude Code skill — restructure UI from scratch without deleting project logic. Solves UI lock-in across Next.js, React, Vue, Tailwind, and more.",
+  "name": "ui-restructure",
+  "version": "1.1.0",
+  "description": "AI skill — restructure UI from scratch without deleting project logic. Works with Claude Code, Cursor, Windsurf, Cline, Copilot, and any Agent Skills-compatible tool.",
   "keywords": [
-    "claude",
-    "claude-code",
     "skill",
     "skill-md",
     "skillsmp",
+    "agent-skills",
     "ui",
     "redesign",
     "restructure",
@@ -17,25 +16,31 @@
     "react",
     "vue",
     "tokens",
+    "claude-code",
+    "cursor",
+    "windsurf",
+    "cline",
     "glassmorphism",
     "apple",
     "linear",
-    "dashboard"
+    "dashboard",
+    "god-mode",
+    "ux"
   ],
   "author": "Vamsi Varma",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/vamsivarma27/claude-ui-restructure.git"
+    "url": "https://github.com/vamsivarma27/ui-restructure.git"
   },
-  "homepage": "https://github.com/vamsivarma27/claude-ui-restructure#readme",
+  "homepage": "https://github.com/vamsivarma27/ui-restructure#readme",
   "bugs": {
-    "url": "https://github.com/vamsivarma27/claude-ui-restructure/issues"
+    "url": "https://github.com/vamsivarma27/ui-restructure/issues"
   },
   "files": [
-    "claude-ui-restructure/"
+    "ui-restructure/"
   ],
   "scripts": {
-    "validate": "npx skills-ref validate ./claude-ui-restructure"
+    "validate": "npx agent-skills-cli validate ./ui-restructure"
   }
 }