Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
ef57cbe
refactor(setup): move the project bootstrap to bootstrap.sh
HermeticOrmus Sep 30, 2026
7e09921
feat(hooks): package the UI hooks as the libreuiux-hooks plugin
HermeticOrmus Sep 30, 2026
c684a05
build(plugins): add plugin.json to every plugin
HermeticOrmus Sep 30, 2026
47c94b1
build(marketplace): rename the marketplace to libreuiux
HermeticOrmus Sep 30, 2026
147f99c
fix(frontmatter): describe the 67 derived commands that had none
HermeticOrmus Sep 30, 2026
3e5b83d
fix(frontmatter): add routing descriptions to the original plugins
HermeticOrmus Sep 30, 2026
7e5bf04
feat(design-mastery): sync with design-mastery-claude-code 1.1.0
HermeticOrmus Sep 30, 2026
676cec2
docs(license): credit Seth Hobson for the derived plugins
HermeticOrmus Sep 30, 2026
b2fdc45
build(setup): make setup.sh install through the Claude CLI
HermeticOrmus Sep 30, 2026
15370af
ci(validate): check every manifest, then clean-install all plugins
HermeticOrmus Sep 30, 2026
b9e4be8
docs(github): add a feedback issue form
HermeticOrmus Sep 30, 2026
619c394
docs(hooks): point the hooks README at the libreuiux-hooks plugin
HermeticOrmus Sep 30, 2026
3464e9e
docs(readme): add install, migration, feedback, credit sections
HermeticOrmus Sep 30, 2026
5b4deb6
docs(changelog): add the 2.0.0 entry
HermeticOrmus Sep 30, 2026
e2251ad
fix(setup): uninstall only the plugins that are installed
HermeticOrmus Sep 30, 2026
e9a9d76
fix(setup): print only usage text for --help, skip absent plugins on …
HermeticOrmus Sep 30, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
881 changes: 169 additions & 712 deletions .claude-plugin/marketplace.json

Large diffs are not rendered by default.

41 changes: 41 additions & 0 deletions .github/ISSUE_TEMPLATE/feedback.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
name: Feedback
description: Tell us what worked, what is missing, and what to build next.
title: "[Feedback] "
labels: ["feedback"]
body:
- type: markdown
attributes:
value: |
Thanks for trying this. Every piece of feedback gets read and answered. When feedback turns into a change, the release notes say so, and credit you if you tick the box at the bottom.
- type: input
id: using-for
attributes:
label: What are you using it for?
placeholder: "redesigning a dashboard, building a component library"
validations:
required: true
- type: input
id: plugins
attributes:
label: Which plugins, agents, or skills did you use?
placeholder: "Names as they appear in /plugin, or 'just browsing'"
- type: textarea
id: worked
attributes:
label: What worked well?
- type: textarea
id: missing
attributes:
label: What is missing, wrong, or got in your way?
validations:
required: true
- type: textarea
id: next
attributes:
label: If you could add one thing next, what would it be?
- type: checkboxes
id: credit
attributes:
label: Credit
options:
- label: If this feedback leads to a change, you may credit my GitHub handle in the changelog and release notes.
37 changes: 37 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
name: validate

on:
push:
branches: [main]
pull_request:

jobs:
plugins:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 22
- name: Install the Claude Code CLI
run: npm install -g @anthropic-ai/claude-code
- name: Validate the marketplace manifest
run: claude plugin validate .
- name: Validate every plugin
run: |
set -euo pipefail
for p in $(jq -r '.plugins[].source | strings' .claude-plugin/marketplace.json); do
echo "::group::$p"
claude plugin validate --strict "$p"
echo "::endgroup::"
done
- name: Install every plugin into a clean config
run: |
set -euo pipefail
export CLAUDE_CONFIG_DIR="$RUNNER_TEMP/claude-config"
claude plugin marketplace add "$GITHUB_WORKSPACE"
mk=$(jq -r '.name' .claude-plugin/marketplace.json)
for p in $(jq -r '.plugins[].name' .claude-plugin/marketplace.json); do
claude plugin install "$p@$mk"
done
claude plugin list
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -46,3 +46,7 @@ coverage/
.cache/
.temp/
.tmp/

# Eval results (claude plugin eval)
plugins/*/evals/results/
evals/results/
35 changes: 34 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,48 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## [Unreleased]

## [2.0.0] - 2026-09-30

A major release because the marketplace name changes. Every plugin keeps its name, and nothing is removed. See "Migrating from 1.x" in the README.

### Changed (breaking)

- The marketplace is now named `libreuiux` (it was `claude-code-workflows`). The old name is also the name of [wshobson/agents](https://github.com/wshobson/agents), so anyone who had that marketplace installed could not add this one. Install plugins as `<plugin>@libreuiux`. If `/plugin marketplace list` shows `claude-code-workflows` pointing to this repository, remove it and add this repository again; if it points to wshobson/agents, leave it.
- `setup.sh` now installs the plugins through the Claude Code CLI (`--list`, `--only`, `--scope`, `--uninstall`). The old interactive project bootstrap is unchanged and moved to `bootstrap.sh`.

### Added

- `.claude-plugin/plugin.json` for all 71 plugins, so `claude plugin validate plugins/<plugin>` passes for each (with `--strict`, no warnings).
- Three original plugins that were on disk but not installable are now in the marketplace: `archetypal-alchemy`, `mcp-integrations`, `vibe-coding`.
- `libreuiux-hooks`, an optional plugin that registers the UI/UX hooks: one line of stack context at session start in UI projects, a confirmation prompt before editing `.env`, key, certificate, or credentials files, and accessibility and design-system hints after UI file edits. The scripts read Claude Code's JSON hook input with `jq`, use the documented output format, and write no files. The original scripts stay in `hooks/`.
- design-mastery 1.1.0, synced with [design-mastery-claude-code](https://github.com/HermeticOrmus/design-mastery-claude-code) v1.1.0: 24 new reference files (masters, movements, principles, brand systems; 27 in total), factual corrections, routing descriptions, and an eval suite for `claude plugin eval plugins/design-mastery`.
- `NOTICE.md`, which lists the 66 plugins derived from wshobson/agents and reproduces the upstream MIT license.
- A GitHub Actions workflow that validates the marketplace and every plugin, then installs every plugin into a clean config.
- A feedback issue form, and a Feedback section in the README that links it and GitHub Discussions.

### Changed

- The marketplace owner is Diego Bodart, and its description states what the repository actually contains (71 plugins: 5 original, 66 derived from wshobson/agents). The old description was upstream's ("64 focused plugins, 87 specialized agents, and 44 tools").
- Marketplace entries drop `strict: false` and their component lists; each plugin's plugin.json is the manifest and Claude Code discovers `agents/`, `commands/`, and `skills/` itself.
- Every command in the derived plugins that had no frontmatter (67 files) now has a `description` and, where it takes input, an `argument-hint`, so it shows up with a description in `/help`. The command text is unchanged.
- The original plugins (design-mastery, archetypal-alchemy, mcp-integrations, vibe-coding) and the three UI skills inside derived plugins (`ui-agent-patterns`, `design-system-context`, `prompt-engineering-ui`) have routing descriptions ("Use this agent when", "Use when"). Their agents use `model: inherit`.
- README: counts match the manifests (71 plugins, 152 agent definitions of which 93 are distinct, 76 command files of which 65 are distinct, 74 skills, 3 hooks), install instructions for Claude Code, the terminal, and `./setup.sh`, a "Migrating from 1.x" note, a repository tree that matches the files, and an Acknowledgments section.

### Fixed

- Credit for the upstream work: LICENSE now carries `Copyright (c) 2024 Seth Hobson` for the derived plugins next to the existing notice, NOTICE.md lists them, and the README credits Seth Hobson and wshobson/agents.

### Also in this release (previously listed as Unreleased)

#### Fixed
- Corrected plugin/agent/command/skill counts in README (70 plugins, 152 agents, 76 commands, 74 skills)
- Fixed broken internal links (beginner/examples/, modern-component-template.md)
- Restored execute permissions on hook scripts
- Updated LICENSE copyright to 2025-2026
- Fixed git clone URL to point to actual repository
- Corrected FUNDING.yml GitHub username

### Added
#### Added
- `.gitignore` for standard project hygiene
- Pull request template (`.github/PULL_REQUEST_TEMPLATE.md`)
- This CHANGELOG
Expand Down
1 change: 1 addition & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
MIT License

Copyright (c) 2025-2026 Hermetic Ormus
Copyright (c) 2024 Seth Hobson (the plugins derived from wshobson/agents, listed in NOTICE.md)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
118 changes: 118 additions & 0 deletions NOTICE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
# Notice

LibreUIUX for Claude Code combines original work by Diego Bodart (Hermetic Ormus) with plugins derived from [wshobson/agents](https://github.com/wshobson/agents) by Seth Hobson and its contributors, used under the MIT License.

## Plugins derived from wshobson/agents

The 66 plugins below come from wshobson/agents, forked in late 2025 (their files match upstream commit `ddbd034`). The author column is the author recorded in that repository's marketplace manifest; plugins by Ryan Snodgrass and the community were contributed to wshobson/agents and are distributed under its license.

| Plugin | Author in wshobson/agents |
|--------|---------------------------|
| `accessibility-compliance` | Seth Hobson |
| `agent-orchestration` | Seth Hobson |
| `api-scaffolding` | Seth Hobson |
| `api-testing-observability` | Seth Hobson |
| `application-performance` | Seth Hobson |
| `arm-cortex-microcontrollers` | Ryan Snodgrass |
| `backend-api-security` | Seth Hobson |
| `backend-development` | Seth Hobson |
| `blockchain-web3` | Seth Hobson |
| `business-analytics` | Seth Hobson |
| `cicd-automation` | Seth Hobson |
| `cloud-infrastructure` | Seth Hobson |
| `code-documentation` | Seth Hobson |
| `code-refactoring` | Seth Hobson |
| `code-review-ai` | Seth Hobson |
| `codebase-cleanup` | Seth Hobson |
| `comprehensive-review` | Seth Hobson |
| `content-marketing` | Seth Hobson |
| `context-management` | Seth Hobson |
| `customer-sales-automation` | Seth Hobson |
| `data-engineering` | Seth Hobson |
| `data-validation-suite` | Seth Hobson |
| `database-cloud-optimization` | Seth Hobson |
| `database-design` | Seth Hobson |
| `database-migrations` | Seth Hobson |
| `debugging-toolkit` | Seth Hobson |
| `dependency-management` | Seth Hobson |
| `deployment-strategies` | Seth Hobson |
| `deployment-validation` | Seth Hobson |
| `developer-essentials` | Seth Hobson |
| `distributed-debugging` | Seth Hobson |
| `documentation-generation` | Seth Hobson |
| `error-debugging` | Seth Hobson |
| `error-diagnostics` | Seth Hobson |
| `framework-migration` | Seth Hobson |
| `frontend-mobile-development` | Seth Hobson |
| `frontend-mobile-security` | Seth Hobson |
| `full-stack-orchestration` | Seth Hobson |
| `functional-programming` | Seth Hobson |
| `game-development` | Seth Hobson |
| `git-pr-workflows` | Seth Hobson |
| `hr-legal-compliance` | Seth Hobson |
| `incident-response` | Seth Hobson |
| `javascript-typescript` | Seth Hobson |
| `julia-development` | Community Contribution |
| `jvm-languages` | Seth Hobson |
| `kubernetes-operations` | Seth Hobson |
| `llm-application-dev` | Seth Hobson |
| `machine-learning-ops` | Seth Hobson |
| `multi-platform-apps` | Seth Hobson |
| `observability-monitoring` | Seth Hobson |
| `payment-processing` | Seth Hobson |
| `performance-testing-review` | Seth Hobson |
| `python-development` | Seth Hobson |
| `quantitative-trading` | Seth Hobson |
| `security-compliance` | Seth Hobson |
| `security-scanning` | Seth Hobson |
| `seo-analysis-monitoring` | Seth Hobson |
| `seo-content-creation` | Seth Hobson |
| `seo-technical-optimization` | Seth Hobson |
| `shell-scripting` | Ryan Snodgrass |
| `systems-programming` | Seth Hobson |
| `tdd-workflows` | Seth Hobson |
| `team-collaboration` | Seth Hobson |
| `unit-testing` | Seth Hobson |
| `web-scripting` | Seth Hobson |

Changes made in this repository to those plugins:

- A README.md for each plugin.
- A `.claude-plugin/plugin.json` for each plugin, with the values from the marketplace entry.
- YAML frontmatter (`description`, and `argument-hint` where the command takes input) on commands that had none, so Claude Code can list and route them. The command text itself is unchanged.
- Small edits to twenty agent and command files: year references moved forward by one year (for example 2024/2025 to 2025/2026), and the Python and Julia version floors raised (3.13+, 1.11+).
- Three original skills added inside derived plugins, which are Diego Bodart's work, not Seth Hobson's: `agent-orchestration/skills/ui-agent-patterns`, `context-management/skills/design-system-context`, and `llm-application-dev/skills/prompt-engineering-ui`.

## Original plugins

`design-mastery`, `archetypal-alchemy`, `mcp-integrations`, `vibe-coding`, and `libreuiux-hooks` are original to this repository, as are the learning paths (`beginner/`, `intermediate/`, `advanced/`), `templates/`, `resources/`, `hooks/`, and the root `.claude/` commands and agent.

## Upstream license

The derived plugins are covered by the upstream MIT License, reproduced here as required by its terms:

```
MIT License

Copyright (c) 2024 Seth Hobson

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

The repository as a whole is licensed under the MIT License in [LICENSE](LICENSE), which carries both copyright notices.
Loading
Loading