Skip to content

Release v2.0.0: libreuiux marketplace, 71 installable plugins, upstream credit - #4

Merged
HermeticOrmus merged 16 commits into
mainfrom
feature/3-v2.0.0-release
Sep 30, 2026
Merged

HermeticOrmus merged 16 commits into
mainfrom
feature/3-v2.0.0-release

Conversation

@HermeticOrmus

@HermeticOrmus HermeticOrmus commented Sep 30, 2026 •

Copy link
Copy Markdown
Collaborator

What changed

LibreUIUX v2.0.0. Major because the marketplace name changes; every plugin keeps its name and nothing is removed.

  • Marketplace renamed claude-code-workflows to libreuiux. The old name is also wshobson/agents' marketplace name, so anyone with that installed could not add this one. Owner Diego Bodart. metadata.description now says what is here (71 plugins: 5 original, 66 derived from wshobson/agents) instead of upstream's "64 focused plugins, 87 specialized agents, and 44 tools".
  • plugin.json for all 71 plugins, values taken from each marketplace entry (derived plugins keep Seth Hobson, Ryan Snodgrass, or "Community Contribution" as author). Entries drop strict: false and their component arrays: a plugin.json next to strict: false component lists is a manifest conflict, and Claude Code auto-discovers agents/, commands/, skills/ (checked with claude plugin details before and after).
  • Installable originals: archetypal-alchemy, mcp-integrations, vibe-coding were on disk but not in the marketplace; now they are.
  • libreuiux-hooks plugin (optional): hooks/hooks.json wires SessionStart, PreToolUse, PostToolUse via ${CLAUDE_PLUGIN_ROOT}. The scripts read stdin JSON with jq, keep the original intent, and stay quiet: one stack-context line for UI projects only; permissionDecision: "ask" for .env/.pem/.key/credentials/secret files, silent otherwise; PostToolUse returns additionalContext findings (design-token and global-style impact, related style/test/story files, contrast classes, missing alt, unnamed icon buttons, clickable divs, unlabeled inputs, small targets, reduced motion, autoplay, tiny fonts, fixed widths). No files written. Original hooks/ scripts untouched; hooks/README.md gets a pointer.
  • Credit: LICENSE keeps its line and adds Copyright (c) 2024 Seth Hobson for the derived plugins; new NOTICE.md lists the 66 derived plugins with upstream authors, the changes made here (READMEs, plugin.json, command frontmatter, year-reference bumps in 20 files), the three original skills inside derived plugins, and the upstream MIT text; README gets an Acknowledgments section crediting Seth Hobson and wshobson/agents with links.
  • Frontmatter: 67 derived commands had none; each gets a description (+ argument-hint where it takes input), body unchanged. Original plugins (archetypal-alchemy, design-mastery, mcp-integrations, vibe-coding) and the three UI skills inside derived plugins (ui-agent-patterns, design-system-context, prompt-engineering-ui) get routing descriptions and model: inherit. Derived content is otherwise untouched.
  • design-mastery 1.1.0 synced from design-mastery-claude-code v1.1.0 (Release v1.1.0: installable plugin, 24 new references, evals HermeticOrmus/design-mastery-claude-code#2): 24 new references (27 total), factual fixes, routing frontmatter, evals/.
  • setup.sh / bootstrap.sh: the old setup.sh was an interactive project bootstrap (CLAUDE.md template + .libreui-config.yaml), not a plugin installer. It moves unchanged to bootstrap.sh (git mv); setup.sh is now the CLI installer from the pack template, with --uninstall only touching installed plugins.
  • CI (.github/workflows/validate.yml, --strict per plugin + clean install of all plugins), feedback issue form (blank issues stay disabled per config.yml), README (tagline and tables with true counts, Install from Claude Code, Migrating from 1.x, Feedback with Discussions link, repository tree matching the files, * marks on original plugins), CHANGELOG 2.0.0 (previous Unreleased items folded in).

Counts

Before (main) After
Installable plugins (marketplace entries) 67 71
Plugin directories 70 71
plugin.json files 0 71
claude plugin validate plugins/<p> 23 pass (13 with warnings), 47 fail 71 pass with --strict, 0 warnings
Agent files / distinct agents 152 / 93 152 / 93
Command files / distinct commands 76 / 65 76 / 65 (all with frontmatter; 67 had none)
Skills 74 74
Registered hooks 0 (loose scripts) 3 (libreuiux-hooks)
design-mastery reference files 3 27

How it was verified

$ claude plugin validate .
Validating marketplace manifest: <repo>/.claude-plugin/marketplace.json

✔ Validation passed
exit=0
$ for p in plugins/*/: claude plugin validate --strict "$p"
passed=71 failed=0

$ claude plugin marketplace add <worktree> (fresh CLAUDE_CONFIG_DIR)
Adding marketplace…✔ Successfully added marketplace: libreuiux (declared in user settings)
exit=0
$ claude plugin marketplace list
Configured marketplaces:

  ❯ libreuiux
    Source: Directory (<repo>)

$ install every plugin
installed=71 failed=0
$ claude plugin list | summary
entries: 71, enabled: 71
$ claude plugin details design-mastery@libreuiux
design-mastery 1.1.0
  Description: Design principles, legendary designers, and historical movements applied to UI work, with agents and workflows for brand identity, design audits, style guides, and premium landing pages.
  Source: design-mastery@libreuiux

Component inventory
  Skills (9)  brand-identity, brand-systems, design-audit, design-masters, design-movements, design-principles, premium-landing, premium-saas-design, style-guide
  Agents (3)  brand-architect, design-master, visual-historian
  Hooks (0)
  MCP servers (0)
  LSP servers (0)

Projected token cost
$ claude plugin details libreuiux-hooks@libreuiux
libreuiux-hooks 1.0.0
  Description: Optional hooks for UI projects: one line of stack context at session start, a confirmation prompt before editing secrets files, and accessibility and design-system hints after UI file edits.
  Source: libreuiux-hooks@libreuiux

Component inventory
  Skills (0)
  Agents (0)
  Hooks (3)  SessionStart, PreToolUse, PostToolUse  (harness-only — no model context cost)
  MCP servers (0)
  LSP servers (0)

Projected token cost
$ claude plugin details archetypal-alchemy@libreuiux
archetypal-alchemy 1.0.0
  Description: Jungian archetypes and Major Arcana symbolism turned into UI structure and color systems, with commands that generate archetype-driven components and Tailwind palettes.
  Source: archetypal-alchemy@libreuiux

Component inventory
  Skills (5)  archetypal-colors, archetypal-combinations, archetypal-ui, jungian-archetypes, major-arcana
  Agents (1)  archetypal-alchemist
  Hooks (0)
  MCP servers (0)
  LSP servers (0)

Projected token cost
$ claude plugin details backend-development@libreuiux
backend-development 1.2.3
  Description: Backend API design, GraphQL architecture, workflow orchestration with Temporal, and test-driven backend development
  Source: backend-development@libreuiux

Component inventory
  Skills (6)  api-design-principles, architecture-patterns, feature-development, microservices-patterns, temporal-python-testing, workflow-orchestration-patterns
  Agents (4)  backend-architect, graphql-architect, tdd-orchestrator, temporal-python-pro
  Hooks (0)
  MCP servers (0)
  LSP servers (0)

Projected token cost

$ bash -n setup.sh
exit=0
$ ./setup.sh --list | head -5
code-documentation           Documentation generation, code explanation, and technical writing with automated doc generation and tutorial creation
debugging-toolkit            Interactive debugging, developer experience optimization, and smart debugging workflows
git-pr-workflows             Git workflow automation, pull request enhancement, and team onboarding processes
backend-development          Backend API design, GraphQL architecture, workflow orchestration with Temporal, and test-driven backend development
frontend-mobile-development  Frontend UI development and mobile application implementation across platforms
rows: 71
$ ./setup.sh --only design-mastery,libreuiux-hooks (fresh CLAUDE_CONFIG_DIR)
Adding marketplace…✔ Successfully added marketplace: libreuiux (declared in user settings)
Installing plugin "design-mastery@libreuiux"...✔ Successfully installed plugin: design-mastery@libreuiux (scope: user)
Installing plugin "libreuiux-hooks@libreuiux"...✔ Successfully installed plugin: libreuiux-hooks@libreuiux (scope: user)

Installed 2 plugin(s) from libreuiux. Restart Claude Code to load them.
Tell us what worked and what is missing: https://github.com/HermeticOrmus/LibreUIUX-Claude-Code/issues/new?template=feedback.yml
exit=0
Installed plugins:

  ❯ design-mastery@libreuiux
    Version: 1.1.0
    Scope: user
    Status: ✔ enabled

  ❯ libreuiux-hooks@libreuiux
    Version: 1.0.0
    Scope: user
    Status: ✔ enabled

$ ./setup.sh --only nope
error: 'nope' is not a plugin in this pack (see --list)
exit=1
$ ./setup.sh --uninstall
✔ Successfully uninstalled plugin: design-mastery (scope: user)
✔ Successfully uninstalled plugin: libreuiux-hooks (scope: user)
✔ Successfully removed marketplace: libreuiux
Removed. Restart Claude Code to unload the plugins.
exit=0
No plugins installed. Use `claude plugin install` to install a plugin.
$ bash -n bootstrap.sh
exit=0

Hook scripts: each was tested by piping sample JSON (UI project vs plain project, .env/.env.local/server.key/aws-credentials.json/secrets.yaml vs .env.example and a component, a component with nine issues vs a clean one, a large HTML file, a global stylesheet, a missing file, invalid JSON, and no jq on PATH). All exit 0; output only when expected.

Diff checks: no em dashes in new prose, no personal data, no timing language; commits follow OCS v1.0 with the GitHub noreply author. Not changed here: the GitHub About text still says "67 specialized agents" (repository metadata, not a file).

Closes #3

🤖 Generated with Claude Code

HermeticOrmus and others added 16 commits September 30, 2026 10:49
setup.sh was an interactive script that drops a CLAUDE.md template and a
.libreui-config.yaml into a project; it never installed the plugins.
The file moves unchanged so setup.sh can become the plugin installer,
matching every other Libre pack. Nothing in the repo referenced it.

Refs: #3
The hooks/ scripts were never registered by anything: they needed a
LIBREUIUX_HOOKS_DIR variable and a hand-edited settings.json, parsed the
input with grep, answered in a JSON shape Claude Code does not define,
set millisecond values in a field read as seconds, and wrote log files.
The plugin wires SessionStart, PreToolUse, and PostToolUse through
${CLAUDE_PLUGIN_ROOT}. Each script reads the stdin JSON with jq, keeps
the original intent, and stays quiet: one context line for UI projects,
an "ask" before editing secrets files, and additionalContext findings
after UI edits. No files are written. The original scripts stay put.

Verified: piped sample JSON through each script (UI and non-UI
projects, .env, .pem, credentials, .env.example, flawed and clean
components, invalid input, no jq on PATH)
Refs: #3
None of the 70 plugin directories had a manifest, so
claude plugin validate plugins/<p> failed for 47 of them and the rest
only passed as bare skill folders. Each plugin.json takes its name,
version, description, author, homepage, repository, license, and
keywords from the marketplace entry, so derived plugins keep Seth
Hobson (or their upstream contributor) as author.

Refs: #3
The marketplace was named claude-code-workflows, the same name as
wshobson/agents, so anyone with that marketplace installed could not
add this one. The owner is Diego Bodart and the description now says
what is here (71 plugins: 5 original, 66 derived from wshobson/agents)
instead of upstream's "64 focused plugins, 87 specialized agents".
Entries drop strict:false and their component lists, because a
plugin.json next to strict:false component lists is a manifest
conflict; Claude Code discovers agents/, commands/, and skills/ itself.
archetypal-alchemy, mcp-integrations, vibe-coding, and libreuiux-hooks
join the marketplace.

BREAKING CHANGE: install plugins as <plugin>@libreuiux; the
claude-code-workflows marketplace name is gone
Refs: #3
These commands came from wshobson/agents with no frontmatter, so
claude plugin validate warned on each and /help listed them without a
description. Each gets a short imperative description and, where the
command takes input, an argument-hint. The command text is unchanged.

Refs: #3
The archetypal-alchemy skills had no frontmatter and its agent, its
commands, and the original UI skills described themselves instead of
saying when to use them. Agents now start with "Use this agent when",
skills end with "Use when", commands get an argument-hint, and the
agent runs on the session model (model: inherit). Covers
archetypal-alchemy, mcp-integrations, vibe-coding, plus ui-agent-patterns,
design-system-context, and prompt-engineering-ui.

Refs: #3
Brings the plugin in line with the standalone repo's 1.1.0 release: 24
new reference files on masters, movements, principles, and brand
systems (27 in total), factual corrections across the skills and
agents, routing descriptions, model: inherit, and an eval suite for
claude plugin eval plugins/design-mastery. The plugin README links the
new profiles and shows the real structure. Eval results are ignored.

Refs: #3
66 of the plugins derive from wshobson/agents (MIT, Copyright (c) 2024
Seth Hobson), but LICENSE only named Hermetic Ormus, dropping the
upstream copyright notice that MIT requires copies to keep. LICENSE keeps its
line and adds Seth Hobson's for the derived plugins. NOTICE.md lists
the 66 plugins with their upstream authors, the changes made here, the
original work, and the upstream license text.

Refs: #3
setup.sh now registers the checkout as the libreuiux marketplace and
installs plugins with claude plugin install (--list, --only, --scope,
--uninstall), like every other Libre pack. Its help points to
bootstrap.sh for the project template setup it used to do.

Refs: #3
Validates the marketplace, runs claude plugin validate --strict on each
of the 71 plugins so a missing manifest or frontmatter fails the build,
then installs every plugin into an empty CLAUDE_CONFIG_DIR.

Refs: #3
Gives people who star or install LibreUIUX one structured place to say
what they used it for, what worked, and what is missing, with an opt-in
to be credited in the release notes. Blank issues stay disabled.

Refs: #3
The manual setup below still describes the original scripts. A note at
the top gives the two-line plugin install and explains that hook
timeouts are read as seconds.

Refs: #3
The README had no way to install the plugins through Claude Code, its
counts (70 plugins) and repository tree did not match the files, and it
did not credit wshobson/agents. It now opens Quick Start with
/plugin marketplace add, the terminal equivalent, ./setup.sh, and the
hooks plugin; explains migrating from the claude-code-workflows name;
states counts that match the manifests; marks the original plugins; and
adds Feedback (with Discussions) plus Acknowledgments for Seth Hobson.

Refs: #3
Major because the marketplace name changes. The entry says what
existing users gain (installable originals, the hooks plugin, plugin
manifests, design-mastery 1.1.0, credit) and what they must do (switch
to <plugin>@libreuiux). The previous Unreleased items fold into it.

Refs: #3
With 71 plugins, --uninstall after a partial install printed a "not
found in installed plugins" error for every plugin that was never
installed. It now reads claude plugin list first and skips those.

Verified: --only design-mastery,libreuiux-hooks then --uninstall in a
fresh CLAUDE_CONFIG_DIR removes both plugins and the marketplace with
no errors
Refs: #3
…uninstall

--help printed the first code line after the header, and --uninstall reported a failure for every plugin that was never installed.
@HermeticOrmus
HermeticOrmus merged commit cf9113c into main Sep 30, 2026
1 check passed
@HermeticOrmus
HermeticOrmus deleted the feature/3-v2.0.0-release branch September 30, 2026 15:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Release v2.0.0

1 participant