v1.7.2 — plugins CLI support

Install as a full agent plugin (skill + subagents + slash commands):

npx plugins add AgentsORG/design-engineering

Or the skill graph only:

npx skills add AgentsORG/design-engineering

Added

• .plugin/plugin.json — vendor-neutral manifest for vercel-labs/plugins
• agents/ (repo root) — six workflow subagents hoisted for plugin discovery
• commands/ — review-ui, motion-audit, scan-ai-tells, agentation-fix, apply-design-md, fork-pov

Changed

• Cursor and Codex manifests declare agents and commands paths
• README Plugins CLI install section; CI checks root agents/ and five-manifest version parity

Removed

• Subagent bodies under skills/design-engineering/agents/ (redirect README remains)

v1.7.1 — indexer-safe SKILL.md description

Patch release. No content changes, no behavioral changes in the CLI install path — purely a parser-portability fix for the skills.sh web indexer.

Fixed

• skills/design-engineering/SKILL.md — description rewrapped as a double-quoted YAML scalar; the two embedded "..." rhetorical questions are now plain prose. The skills.sh web indexer was reporting "0 skills" despite the CLI installing fine. The CLI's YAML parser tolerates unquoted scalars containing "..." substrings; the indexer's parser appears stricter. Pattern matches prior reports at vercel-labs/skills#1017 and #1036.
• All four plugin manifests bumped to 1.7.1 so the version-parity CI check passes.

Install (unchanged)

```bash
npx skills add AgentsORG/design-engineering
```

Full changelog: https://github.com/AgentsORG/design-engineering/blob/main/CHANGELOG.md#171--2026-05-22

v1.7.0 — multi-agent plugin manifests (hyperframes pattern)

Ship three agent-specific plugin manifests alongside the skills.sh install path, following the heygen-com/hyperframes layout. Each major host can now install via its native plugin system without going through the cross-agent skills.sh shim.

Added

• .claude-plugin/plugin.json — minimal Claude Code plugin metadata. No skills field; auto-discovery from skills/.
• .codex-plugin/plugin.json — full OpenAI Codex manifest with keywords, skills: ./skills/, and an interface block (displayName, shortDescription, longDescription, category: Design, capabilities, defaultPrompt array, brandColor #0a0a0a).
• .cursor-plugin/plugin.json — Cursor IDE manifest with $schema, displayName, publisher, category: developer-tools, tags, keywords, skills path.

Changed

• .claude-plugin/marketplace.json — refactored to the hyperframes single-entry pattern with "source": "./". Top-level owner replaces author. The nested plugins[].skills[] array is gone in favor of Claude Code's skills/ auto-discovery.
• README.md — Install section now shows three per-agent commands (Claude Code marketplace, Codex, Cursor sideload) alongside npx skills add.
• AGENTS.md — new ## Plugin manifests section documents all four files + the version-parity convention.
• .github/workflows/lint.yml — required-files check extended to all three new manifests. New CI steps: Plugin manifests are valid JSON (parses all four with Python) and Plugin manifest versions match (verifies all four manifests + SKILL.md report the same version — drift fails the lint).
• skills/design-engineering/SKILL.md version bumped to 1.7.0.

Install

```bash

Cross-agent (recommended)

npx skills add AgentsORG/design-engineering

Claude Code marketplace

/plugin marketplace add AgentsORG/design-engineering
/plugin install design-engineering

Codex marketplace

codex plugin marketplace add AgentsORG/design-engineering --sparse .codex-plugin --sparse skills

Cursor — Settings → Plugins → Load unpacked → point at repo root

```

Full changelog: https://github.com/AgentsORG/design-engineering/blob/main/CHANGELOG.md#170--2026-05-22

v1.6.0 — per-agent souls

Each of the six workflow subagents now ships its own ## Soul block at the bottom of its file. The block inherits from the repo-root SOUL.md and narrows that floor to the subagent's specific job — who it is, truths it holds, boundaries it refuses, voice it speaks in.

Added

Inline ## Soul blocks tailored to each subagent's role:

• ui-reviewer — Senior design engineer pairing on code review. Table is the deliverable; prose is throat-clearing.
• motion-auditor — Tuner of timing and easing. Animator's precision, no flourish; cite the curve and the number.
• anti-pattern-scanner — Deletion specialist. Clinical, surgical; flag the unmotivated, not the merely common.
• agentation-fix-loop — Implementer's voice. Annotation is the spec; the diff is the deliverable.
• design-md-consumer — Consumer, not author. Deferential to the project's design system.
• pov-curator — Facilitator, not author. Prompts with the right questions; writes only what the installer dictates.

Changed

• SOUL.md — Related section now flags per-agent soul blocks.
• agents/README.md — "What they all share" section documents the soul-block convention.
• .github/workflows/lint.yml — new Subagent soul block CI step verifies every subagent file declares a ## Soul section.

Install

```bash
npx skills add AgentsORG/design-engineering
```

Full changelog: https://github.com/AgentsORG/design-engineering/blob/main/CHANGELOG.md#160--2026-05-22

v1.5.0 — SOUL.md + 6 workflow subagents + skills.sh polish

Adds an identity layer (SOUL.md) and six narrow-purpose subagents that cover the highest-value design-engineering workflows. Everything stays Obsidian-compatible and skills.sh-compliant.

Added

• SOUL.md at repo root — the steipete/SOUL.md + OpenClaw five-section template (Core Truths, Boundaries, Vibe, Continuity, Related). Anchors voice in the existing taste lineage (Emil, Benji, Jakub, guidelines.sh, Vercel, Ben DC). Cross-linked from AGENTS.md and SKILL.md.
• skills/design-engineering/agents/ — six workflow subagents, each ~80–150 lines, with name / description / tools / model frontmatter per the Claude Code subagent spec:
  • ui-reviewer — runs the [[review-format]] Before / After / Why table + [[review-checklist]] audit.
  • motion-auditor — animation / transition critique against the motion cluster + transitions.dev.
  • anti-pattern-scanner — AI-default-tell deletion list.
  • agentation-fix-loop — Session-2 fix side of the [[agentation-workflow]] two-session pattern.
  • design-md-consumer — reads a project's DESIGN.md and threads tokens through generated UI.
  • pov-curator — helps installers fork [[pov]] and append to [[gotchas]].
• skills/design-engineering/agents/README.md — directory index + selection guide.

Changed

• AGENTS.md — adds explicit ## Testing section, a ## skills.sh discovery paragraph, and a cross-link to SOUL.md.
• SKILL.md — adds compatibility: frontmatter, metadata.subagents + metadata.soul pointers, and two new MOC sections (Workflow subagents, Identity / SOUL.md).
• .github/workflows/lint.yml — required-files check extended to SOUL.md and all six subagent files. New Subagent frontmatter fields step verifies each subagent declares name, description, tools, model, and that the name matches the filename. Wikilink resolver now indexes agents/ basenames.

Install

npx skills add AgentsORG/design-engineering

Full changelog: https://github.com/AgentsORG/design-engineering/blob/main/CHANGELOG.md#150--2026-05-22

v1.4.0 — Obsidian vault polish (themed graph + tokenized snippet)

Adds a coherent visual layer to the `.obsidian/` config so installers who open the repo as an Obsidian vault see the structure of the graph at a glance.

Nothing in the published skill content (`SKILL.md`, `references/`, `evals/`) changed — these are vault-view-only polish.

Graph view — themed color groups

Every node is now colored by its theme cluster:

Cluster	Color
`file:MOC-` (hub anchors)	coral red
`philosophy/`	dusty violet
`motion/`	amber
`typography/`	olive
`surface/`	warm steel
`components/`	teal-green
`layout/`	warm blue
`anti-patterns/`	deep wine
`meta/`	dusty rose

`repelStrength` bumped to 12 and `nodeSizeMultiplier` to 1.1 so themed clusters separate cleanly.

New: `.obsidian/snippets/vault-tokens.css`

A small CSS snippet that eats the skill's own dog food — UI animations and radii follow the same tokens the skill itself recommends:

• One easing curve reused everywhere (`motion/easing-curves`).
• Three durations: `60ms` / `180ms` / `220ms` (`motion/duration-table`).
• `6` / `10` / `14px` radius scale (`surface/border-radius`).
• `translateY(-1px)` hover lift (`components/hover-states-subtle`).
• `scale(0.98)` active press with 60ms duration (`components/responsive-feedback`).
• Full `prefers-reduced-motion` guard (`motion/prefers-reduced-motion`).

`.obsidian/appearance.json`

`accentColor` set to a calm coral; the `vault-tokens` snippet is declared enabled so it's active on first vault-open.

Versions bumped

• `skills/design-engineering/SKILL.md` frontmatter `metadata.version` → 1.4.0
• `.claude-plugin/marketplace.json` version → 1.4.0
• `CHANGELOG.md` v1.4.0 entry added

Full diff

v1.3.0…v1.4.0

v1.3.0 — migrate to AgentsORG/design-engineering

The skill's canonical home moved from `HKTITAN/design-engineering` (auto-redirects) to `AgentsORG/design-engineering`.

Install (new URL)

```bash
npx skills add AgentsORG/design-engineering
```

The old URL still works via GitHub's auto-redirect — existing installs and clones continue to work — but new installs should use the AgentsORG URL.

What changed

All repo URLs in the project metadata:

• `README.md` — `skills.sh` badge, CI badge, paste-into-agent block, file-tree mentions, Sources section.
• `AGENTS.md` — install command + `skills-ref validate` path.
• `CONTRIBUTING.md` — `git clone` URL + issues link.
• `CHANGELOG.md` — compare / release link table.
• `.claude-plugin/marketplace.json` — `homepage` and `repository` URLs; version bumped to 1.3.0.
• `skills/design-engineering/SKILL.md` — frontmatter `metadata.version` bumped to 1.3.0.

Attribution unchanged

• `LICENSE` copyright stays HKTITAN (individual author).
• `metadata.author: HKTITAN` in SKILL.md frontmatter — unchanged.
• `marketplace.json` `author.name: HKTITAN`, `author.url: github.com/HKTITAN` — unchanged.
• `meta/pov.md` HKTITAN starter POV — unchanged (it's an example installers override).

HKTITAN authors and maintains the skill; AgentsORG is the new repo owner.

Existing tags preserved

All previous tags (`v1.0.0`, `v1.1.0`, `v1.2.0`, `v1.2.1`) are intact on the AgentsORG remote.

Full diff

v1.2.1…v1.3.0

v1.2.1 — fix CLI false-positive on template file

Patch fix: the `skills.sh` CLI was picking up `template/SKILL.md` as a second installable skill (`your-skill-name`) in the install picker. Renaming the template file fixes the false-positive.

What changed

• `template/SKILL.md` → `template/TEMPLATE.md` (via `git mv`, so blame is preserved).
• Template body rewritten to be self-documenting: explains why it's named TEMPLATE.md, how to use it, and links to related docs.
• CI required-files check updated.
• README file tree updated.

Before / after

```text

Before (npx skills add HKTITAN/design-engineering picker)

Found 2 skills
☐ design-engineering
☐ your-skill-name ← the template file, picked up by **/SKILL.md glob

After

Found 1 skill
☐ design-engineering
```

Install / upgrade

```bash
npx skills add HKTITAN/design-engineering
```

If you already had v1.2.0 installed, this is a no-op for end users — the template file isn't part of the installable skill. The change matters only for the install picker UX.

Full diff

v1.2.0…v1.2.1

v1.2.0 — agentskills + design.md specs; Agentation integration

Adds two upstream spec mirrors and integrates Benji Taylor's Agentation as both an installer-recommended companion tool and a node in the core skill graph.

Install / upgrade

```bash
npx skills add HKTITAN/design-engineering
```

Recommended companions (NEW in README)

```bash

Click-to-annotate design review in your localhost dev environment

npx skills add benjitaylor/agentation
```

Plus install Obsidian and open this repo as a vault — `Cmd/Ctrl + G` reveals the graph.

Spec mirrors

• `spec/agent-skills-spec.md` — Full mirror of the canonical Agent Skills specification. Apache-2.0 / CC-BY-4.0. Previously only a one-line pointer; now the full spec is available offline.
• `spec/design-md-spec.md` — Full mirror of Google Labs' design.md format. Apache-2.0. YAML token schema, section order, CLI commands, linter rules, programmatic API.

3 new nodes

philosophy/

• `pointing-beats-describing.md` — Benji Taylor's framing: precise machine-readable selection (selectors, file paths, computed styles) outperforms prose when feedback goes to an AI agent.

meta/

• `using-design-md.md` — How the agent reads, respects, and rarely updates a project's DESIGN.md. Cross-reference table mapping design.md token categories to relevant skill nodes (`colors` → `color-monochromatic`, etc.).
• `agentation-workflow.md` — Install Agentation. Click to annotate. Two-session critique-then-fix workflow with MCP. Critique style guidelines (2-3 sentences max, name the principle, reference comparable products).

Updated

• `SKILL.md` description expanded to mention consuming DESIGN.md and giving feedback through Agentation. v1.2.0.
• `README.md` adds NEW Recommended companions section. Sources adds Google Labs Code, agentskills.io, Agentation. See-also links the new spec mirrors. File count → 75 markdown files.
• `AGENTS.md` adds Google Labs Code, Agentation, agentskills.io to Sources of truth.
• `marketplace.json` v1.2.0; description mentions Agentation workflow and design.md consumption.
• `MOC-philosophy` links `pointing-beats-describing`; `SKILL.md` Meta section links the two new meta nodes.

Full diff

v1.1.0…v1.2.0

v1.1.0 — Vercel + bendc nodes

Adds two more named sources — Vercel's web-interface guidelines and Ben DC's frontend-guidelines — distilled into 7 new atomic nodes covering accessibility, copy voice, URL state, contrast math, optimistic updates, CSS conventions, and dependency discipline.

Install / upgrade

```bash
npx skills add HKTITAN/design-engineering
```

(If you already have it installed, the CLI updates in place.)

New nodes (7)

components/

• `accessibility-baseline.md` — Keyboard-everywhere, `:focus-visible`, hit targets (24/44px), ARIA names on icon-only buttons, polite `aria-live` for async. The a11y floor below taste. (Vercel + bendc)
• `optimistic-updates.md` — Update UI immediately on likely-success actions, reconcile or undo on failure. The largest perceived-latency win without infra changes. Pair destructive actions with Undo toasts. (Vercel)
• `copy-voice.md` — Active voice, Title Case for headings + buttons, "&" over "and", numerals for counts, error messages that guide the exit. Microcopy is design. (Vercel)

layout/

• `url-as-state.md` — Filters, tabs, pagination, modals — all live in the URL. Back/forward restores scroll. Deep-link everything. (Vercel)

surface/

• `contrast-and-color-scheme.md` — APCA over WCAG 2 for contrast math. `<meta name="theme-color">` + `color-scheme: dark`. Interactions raise contrast. Avoid gradient banding. (Vercel)

motion/

• `css-conventions.md` — `1turn` over `360deg`, unitless line-height, hex over rgb, native browser APIs over libraries. Ben DC's CSS dialect choices. (bendc)

philosophy/

• `dependency-discipline.md` — Every dependency is a tax. Replicate simple utilities. Draw shapes in CSS. Prefer native browser APIs. The bundle is design. (bendc)

Updated

• `SKILL.md` description expanded to mention writing UI copy and auditing a11y. All 5 affected MOCs link the new nodes.
• `marketplace.json` v1.1.0; description lists new source authors.
• `README.md` repo layout tree includes new nodes; Sources section adds Vercel + bendc with their specific contributions; file count is now 72 markdown files.
• `AGENTS.md` adds Vercel + bendc to the Sources of truth section.
• `CHANGELOG.md` 1.1.0 entry (Keep a Changelog format).

Full diff

v1.0.0…v1.1.0