feat(plugins): add Design Taste Libraries router by Baltsat · Pull Request #6194 · nexu-io/open-design

Baltsat · 2026-07-29T01:47:50Z

Supersedes #4728, which was auto-closed for inactivity after its blocking code feedback was fixed and the corrected head was approved. It also supersedes #6193, an intermediate continuation that exposed a conflict with the newer community marketplace manifest. This PR recreates the same scoped contribution directly on the current main without that conflict.

Why

Open Design already has strong individual design systems and examples, but it lacks one opt-in routing step for choosing among them by surface before generation or critique. This plugin fills that workflow gap: it prefers existing Open Design coverage, adds external references only for genuine procedural gaps, and prevents agents from stacking unrelated taste libraries into generic output.

I wrote it while consolidating source-backed frontend, mobile, dashboard, shadcn, and motion guidance for repeated Open Design work. Without a router, the same brief can silently fall back to generic generation or duplicate capabilities already covered by Hallmark, shadcn, dashboard, mobile, Material, or HyperFrames plugins.

What users will see

After installing and applying community/design-taste-libraries, generation and critique runs first select one primary design library and at most two secondary references, state the chosen set and visual thesis, prefer matching built-in Open Design plugins, and run surface-specific proof checks before returning the artifact or critique. Surface defaults to web app; Brief can be supplied by an input-capable surface or falls back to the user's current request, attachments, and project context. Both values interpolate into the visible composer text. The runtime source index and selection matrix are embedded in the injected skill, so execution does not depend on discovering a staged side file. The plugin is opt-in and does not change existing users' default behavior.

Surface area

UI — new page / dialog / panel / menu item / setting / empty state in apps/web or apps/desktop (including Electron menu bar)
Keyboard shortcut — new or changed
CLI / env var — new od subcommand or flag, new tools-dev / tools-pack flag, or new OD_* env var
API / contract — new /api/* endpoint, new SSE event, or changed shape in packages/contracts
Extension point — adds an installable community plugin with a plugin-local SKILL.md router and reference catalog
i18n keys — added new translation keys
New top-level dependency — adds an entry to the root package.json
Default behavior change — the plugin is opt-in and affects only runs where it is installed and applied
None — internal refactor, docs, tests, or translation update only

Screenshots

Not applicable. This adds no new UI surface; discovery uses the existing Plugins Available marketplace UI.

Bug fix verification

Not applicable; this is a new community extension.

Validation

The router, catalog, and integration wiring derive from the corrected head previously approved on #4728. That review confirmed:

od.context.skills: [{ "path": "./SKILL.md" }] reaches the daemon's plugin-local skill loader;
references/LIBRARIES.md remains a staged asset rather than a skill reference;
the marketplace entry exposes community/design-taste-libraries with capabilitiesSummary: ["prompt:inject"];
targeted manifest checks and JSON parsing passed.

For this refreshed branch:

created directly from current upstream main (f52fda29a8a6fc65c501a45bb165b6f5208194a1), with that commit still the merge base and the branch 0 commits behind;
only four expected paths changed: SKILL.md, open-design.json, references/LIBRARIES.md, and the community marketplace manifest;
preserved the newer community/humanize-ppt registry entry and bumped both marketplace version fields from 0.2.3 to 0.2.4;
normalized the manifest to current community conventions: community-design-taste-libraries, community tag, author URL, and homepage;
re-audited the catalog against current plugin manifests, removed the deleted example-cinematic-landing-page reference, and replaced it with registered HyperFrames/motion examples;
repaired moved dashboard and Expo Native UI paths, then replaced intermediary catalog URLs with canonical GitHub SKILL.md sources;
embedded the operative source index and surface selection matrix directly in SKILL.md; references/LIBRARIES.md is provenance-only, so runtime no longer searches wildcard staged aliases or risks opening a stale copy;
interpolated {{surface}} and {{brief}} into the visible use-case query;
kept inputless attach/apply paths working by giving surface and brief schema defaults; PluginsSection seeds those defaults before renderPluginBriefTemplate;
answered and resolved all six Codex review threads;
current-head Codex review on 7f917e2 found no major issues;
verified one community/design-taste-libraries marketplace entry, plugin-local skill injection, reference asset path, and prompt:inject capability;
GitHub currently reports the PR mergeable.

Full repository guard/typecheck is waiting for the upstream maintainer to approve fork workflows; this PR changes no runtime code or dependencies.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Baltsat · 2026-07-29T01:48:12Z

@lefarcen @PerishCode this is the conflict-free continuation of #4728 on current main.

The original blocking integration fixes are preserved, the PR-template feedback is complete, and the community registry refresh preserves community/humanize-ppt while bumping the seed to 0.2.4.

All six Codex findings on the refreshed branch have been addressed and their threads resolved:

the operative source index and selection matrix live directly in SKILL.md, so runtime cannot select a stale staged catalog copy;
the deleted cinematic example ID was replaced with registered motion examples;
Surface and Brief interpolate into the visible composer brief;
inputless attach/apply remains supported through schema defaults;
moved dashboard/Expo links and intermediary catalog URLs were replaced with canonical GitHub sources.

Current-head Codex review on 7f917e2 found no major issues. GitHub reports the PR mergeable, exactly four changed paths, and 0 commits behind current main.

Only upstream gates remain:

Approve and run workflows — the repository's trusted auto-approver intentionally excludes plugins/**, so all three runs are action_required with zero jobs started.
Human approval and merge after CI passes.

lefarcen · 2026-07-29T01:51:07Z

Thanks @Baltsat — carrying the #4728/#6193 continuation onto current main and keeping the marketplace manifest update in sync is helpful. I’m routing this through pool review now.

💡 To drive this PR to merge hands-free, paste this to your AI coding agent (Claude Code / Codex / opencode / Cursor …):
Take over nexu-io/open-design#6194 until it merges — read https://raw.githubusercontent.com/nexu-io/looper/main/skills/pr-takeover/SKILL.md and follow it.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c93a16300a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

lefarcen · 2026-07-29T01:57:44Z

Thanks for the refresh and for normalizing the manifest to the current community conventions. Noted on head 4582e88 — this is still waiting on the fresh pool-review pass, and the fork workflow approval will need to be cleared before that run can fully proceed.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: feabaa011c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Baltsat · 2026-07-29T02:08:38Z

@codex review

Please review current head aea642b, focusing on the staged catalog path, input interpolation, manifest/marketplace consistency, and any remaining broken local or external references.

Baltsat · 2026-07-29T02:13:50Z

@codex review

Please review current head b3ddec9. Previous P1/P2 threads are fixed and resolved; focus on any remaining correctness issue in plugin-local skill staging, input rendering, manifest/marketplace identity, and catalog references. The staged lookup is now scoped to .od-skills/design-taste-libraries-*/... to avoid selecting another skill.

Baltsat · 2026-07-29T02:16:54Z

@lefarcen confirmed the repository's scripts/approve-fork-pr-workflows.ts intentionally does not allowlist plugins/** changes, so the trusted auto-approval workflow will skip this PR. The current action_required runs therefore need a maintainer to click Approve and run workflows manually for head 7f917e2; there are no jobs or failure logs yet.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b5385b1b58

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Baltsat · 2026-07-29T02:22:50Z

@codex review

Current head is b3ddec9. Please review the final four-file diff; all earlier threads are resolved.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b3ddec90db

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Baltsat · 2026-07-29T02:26:52Z

@codex review

Current head is c2c738a. The latest P2 was fixed by making brief optional with a schema default; all four review threads are resolved. Please review the final four-file diff.

Baltsat · 2026-07-29T02:29:22Z

@codex review

Current head is 978c202. The latest P1 was fixed by matching both marketplace and local-source staged directory names. All five review threads are resolved; please review the final four-file diff.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 978c202888

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Baltsat · 2026-07-29T02:45:12Z

@codex review

Current head is 7f917e2. The latest P2 was fixed by removing runtime staged-catalog discovery entirely and embedding the authoritative source index plus selection matrix in SKILL.md. All six review threads are resolved; please review the final four-file diff.

chatgpt-codex-connector · 2026-07-29T02:48:55Z

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: 7f917e2075

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

PerishCode

@Baltsat I reviewed all four changed files on the current head, including the plugin manifest and marketplace identity, input defaults and interpolation, the embedded runtime routing matrix, local plugin references, and the provenance catalog. The earlier staged-catalog and reference issues are resolved, and the plugin-runtime typecheck passes. This is a thoughtful, well-contained addition—thanks for carrying the fixes through and keeping the community registry refresh consistent.

_{🔁 Powered by Looper · runner=reviewer · agent=codex · An autonomous AI dev team for your GitHub repos.}

Baltsat added 4 commits July 29, 2026 09:44

feat(plugins): add Design Taste Libraries skill

71ce785

feat(plugins): add Design Taste Libraries manifest

0326230

docs(plugins): add Design Taste Libraries catalog

017ef2e

feat(plugins): register Design Taste Libraries

c93a163

Copilot AI review requested due to automatic review settings July 29, 2026 01:47

Copilot AI reviewed Jul 29, 2026

This was referenced Jul 29, 2026

Add Design Taste Libraries plugin #6193

Closed

Add Design Taste Libraries plugin #4728

Closed

lefarcen requested a review from PerishCode July 29, 2026 01:51

lefarcen added size/L PR changes 300-700 lines risk/medium Medium risk: regular code changes type/feature New feature labels Jul 29, 2026

fix(plugins): align community manifest identity

4582e88

chatgpt-codex-connector Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread plugins/community/design-taste-libraries/SKILL.md Outdated

Comment thread plugins/community/design-taste-libraries/references/LIBRARIES.md Outdated

docs(plugins): refresh Design Taste Libraries catalog

feabaa0

chatgpt-codex-connector Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread plugins/community/design-taste-libraries/open-design.json Outdated

Baltsat added 3 commits July 29, 2026 10:03

docs(plugins): repair external design-library sources

c1ab1e0

fix(plugins): make staged design catalog discoverable

1bdac2d

fix(plugins): interpolate Design Taste Libraries inputs

aea642b

Baltsat added 2 commits July 29, 2026 10:10

fix(plugins): require interpolated router inputs

6c94c45

docs(plugins): use canonical GitHub skill sources

b5385b1

chatgpt-codex-connector Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread plugins/community/design-taste-libraries/open-design.json Outdated

fix(plugins): scope staged catalog lookup to this skill

b3ddec9

fix(plugins): allow inputless router attachment

c2c738a

chatgpt-codex-connector Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread plugins/community/design-taste-libraries/SKILL.md Outdated

fix(plugins): match installed skill staging name

978c202

chatgpt-codex-connector Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread plugins/community/design-taste-libraries/SKILL.md Outdated

fix(plugins): make design routing runtime self-contained

7f917e2

PerishCode approved these changes Jul 29, 2026

View reviewed changes

Uh oh!

Conversation

Baltsat commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why

What users will see

Surface area

Screenshots

Bug fix verification

Validation

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Baltsat commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lefarcen commented Jul 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

lefarcen commented Jul 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Baltsat commented Jul 29, 2026

Uh oh!

Baltsat commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Baltsat commented Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Baltsat commented Jul 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Baltsat commented Jul 29, 2026

Uh oh!

Baltsat commented Jul 29, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Baltsat commented Jul 29, 2026

Uh oh!

chatgpt-codex-connector Bot commented Jul 29, 2026

Uh oh!

PerishCode left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Baltsat commented Jul 29, 2026 •

edited

Loading

Baltsat commented Jul 29, 2026 •

edited

Loading

Baltsat commented Jul 29, 2026 •

edited

Loading

Baltsat commented Jul 29, 2026 •

edited

Loading