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

HKTITAN · claude · HKTITAN · commit eac5991c17e3 · 2026-05-22T12:17:38.000+05:30
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.

- .claude-plugin/plugin.json (new) — minimal Claude Code plugin
  metadata; no skills field, auto-discovery from skills/.
- .claude-plugin/marketplace.json (refactored) — single-entry pattern
  with source: ./, top-level owner instead of author, drops nested
  skills[] in favor of auto-discovery.
- .codex-plugin/plugin.json (new) — full Codex manifest with
  keywords, skills path, and an interface block (displayName,
  shortDescription, longDescription, category Design, capabilities,
  defaultPrompt array, brandColor #0a0a0a).
- .cursor-plugin/plugin.json (new) — Cursor IDE manifest with
  $schema, displayName, publisher, category developer-tools, tags,
  keywords, skills path.

CI gains two new 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). Required-files check extended to the three new manifests.

README's Install section grows per-agent commands. AGENTS.md adds a
Plugin manifests section documenting the version-parity convention.

Co-Authored-By: Claude Opus 4.7 &lt;noreply@anthropic.com&gt;
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -1,28 +1,19 @@
 {
   "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/marketplace.schema.json",
   "name": "design-engineering",
-  "displayName": "Design Engineering",
-  "description": "Design engineering wisdom — animation, transitions, taste, typography, color, components, layout, accessibility, anti-patterns. Plus Agentation workflow, design.md consumption, SOUL.md identity layer, and six workflow subagents (ui-reviewer, motion-auditor, anti-pattern-scanner, agentation-fix-loop, design-md-consumer, pov-curator). From Emil Kowalski, Benji Taylor, Jakub Antalik, guidelines.sh, Vercel, Ben DC, DiceBear, lucide-animated, Google Labs design.md.",
-  "author": {
+  "owner": {
     "name": "HKTITAN",
     "email": "harshitkhemani@gmail.com",
     "url": "https://github.com/HKTITAN"
   },
-  "homepage": "https://github.com/AgentsORG/design-engineering",
-  "repository": "https://github.com/AgentsORG/design-engineering",
-  "license": "MIT",
-  "version": "1.6.0",
   "plugins": [
     {
       "name": "design-engineering",
-      "displayName": "Design Engineering",
-      "description": "A skill graph for design engineering — animation decisions, transition techniques, taste, typography, color, hover states, anti-patterns.",
-      "skills": [
-        {
-          "name": "design-engineering",
-          "path": "skills/design-engineering"
-        }
-      ]
+      "source": "./",
+      "description": "Design engineering for AI agents — animation, transitions, typography, color, components, layout, accessibility, anti-patterns. Plus a SOUL.md identity layer and six workflow subagents. Distills Emil Kowalski, Benji Taylor, Jakub Antalik, guidelines.sh, Vercel, Ben DC, DiceBear, lucide-animated, Google Labs design.md, Agentation.",
+      "version": "1.7.0",
+      "homepage": "https://github.com/AgentsORG/design-engineering",
+      "license": "MIT"
     }
   ]
 }
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -0,0 +1,13 @@
+{
+  "name": "design-engineering",
+  "description": "Design engineering for AI agents — animation timing, transitions, typography, color, components, layout, accessibility, anti-patterns. Plus a SOUL.md identity layer and six workflow subagents (ui-reviewer, motion-auditor, anti-pattern-scanner, agentation-fix-loop, design-md-consumer, pov-curator). Distills Emil Kowalski, Benji Taylor, Jakub Antalik, guidelines.sh, Vercel, Ben DC, DiceBear, lucide-animated, Google Labs design.md, Agentation.",
+  "version": "1.7.0",
+  "author": {
+    "name": "HKTITAN",
+    "email": "harshitkhemani@gmail.com",
+    "url": "https://github.com/HKTITAN"
+  },
+  "homepage": "https://github.com/AgentsORG/design-engineering",
+  "repository": "https://github.com/AgentsORG/design-engineering",
+  "license": "MIT"
+}
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
@@ -0,0 +1,51 @@
+{
+  "name": "design-engineering",
+  "version": "1.7.0",
+  "description": "Design engineering for AI agents — animation timing, transitions, typography, color, components, layout, accessibility, anti-patterns. Plus a SOUL.md identity layer and six workflow subagents. Distills Emil Kowalski, Benji Taylor, Jakub Antalik (transitions.dev), guidelines.sh, Vercel, Ben DC, DiceBear, lucide-animated, Google Labs design.md, Agentation.",
+  "author": {
+    "name": "HKTITAN",
+    "email": "harshitkhemani@gmail.com",
+    "url": "https://github.com/HKTITAN"
+  },
+  "homepage": "https://github.com/AgentsORG/design-engineering",
+  "repository": "https://github.com/AgentsORG/design-engineering",
+  "license": "MIT",
+  "keywords": [
+    "design-engineering",
+    "design-system",
+    "animation",
+    "motion",
+    "transitions",
+    "typography",
+    "color",
+    "shadows",
+    "components",
+    "layout",
+    "accessibility",
+    "anti-patterns",
+    "ui-review",
+    "taste",
+    "agentation",
+    "design-md",
+    "obsidian",
+    "skill-graph"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Design Engineering by HKTITAN",
+    "shortDescription": "Make AI-generated UI feel right",
+    "longDescription": "A navigable skill graph for design engineering. Eight themed clusters (philosophy, motion, typography, surface, components, layout, anti-patterns, meta), 63 atomic nodes, six workflow subagents, a SOUL.md identity layer, and an AGENTS.md operating guide. Load it when reviewing UI code, choosing an easing curve, auditing for AI-default tells, consuming a DESIGN.md, or asking 'why does this feel flat?' Distills Emil Kowalski, Benji Taylor, Jakub Antalik (transitions.dev), guidelines.sh, Vercel design guidelines, Ben DC, DiceBear, lucide-animated, Google Labs design.md, and Agentation into one Obsidian-compatible graph.",
+    "developerName": "HKTITAN",
+    "category": "Design",
+    "capabilities": ["Read", "Write"],
+    "websiteURL": "https://github.com/AgentsORG/design-engineering",
+    "defaultPrompt": [
+      "Review this component for design-engineering issues",
+      "Audit this animation against the motion cluster",
+      "Scan this page for AI-default tells",
+      "Apply our DESIGN.md tokens to this layout",
+      "Help me fork pov.md for my own taste"
+    ],
+    "brandColor": "#0a0a0a"
+  }
+}
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
@@ -0,0 +1,44 @@
+{
+  "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
+  "name": "design-engineering",
+  "displayName": "Design Engineering by HKTITAN",
+  "version": "1.7.0",
+  "description": "Design engineering for AI agents — animation timing, transitions, typography, color, components, layout, accessibility, anti-patterns. Plus a SOUL.md identity layer and six workflow subagents. Distills Emil Kowalski, Benji Taylor, Jakub Antalik, guidelines.sh, Vercel, Ben DC, DiceBear, lucide-animated, Google Labs design.md, Agentation.",
+  "author": {
+    "name": "HKTITAN",
+    "email": "harshitkhemani@gmail.com"
+  },
+  "publisher": "HKTITAN",
+  "homepage": "https://github.com/AgentsORG/design-engineering",
+  "repository": "https://github.com/AgentsORG/design-engineering",
+  "license": "MIT",
+  "category": "developer-tools",
+  "keywords": [
+    "design-engineering",
+    "design-system",
+    "animation",
+    "motion",
+    "transitions",
+    "typography",
+    "color",
+    "shadows",
+    "components",
+    "layout",
+    "accessibility",
+    "anti-patterns",
+    "ui-review",
+    "taste",
+    "agentation",
+    "design-md",
+    "obsidian",
+    "skill-graph"
+  ],
+  "tags": [
+    "design",
+    "animation",
+    "ui-review",
+    "design-system",
+    "workflow"
+  ],
+  "skills": "./skills/"
+}
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
@@ -77,6 +77,9 @@ jobs:
             "spec/agent-skills-spec.md"
             "template/TEMPLATE.md"
             ".claude-plugin/marketplace.json"
+            ".claude-plugin/plugin.json"
+            ".codex-plugin/plugin.json"
+            ".cursor-plugin/plugin.json"
           )
           for f in "${required[@]}"; do
             if [ ! -f "$f" ]; then
@@ -146,6 +149,36 @@ jobs:
           fi
           echo "All subagents carry a ## Soul section."
 
+      - name: Plugin manifests are valid JSON
+        run: |
+          set -e
+          fails=0
+          for f in .claude-plugin/plugin.json .claude-plugin/marketplace.json .codex-plugin/plugin.json .cursor-plugin/plugin.json; do
+            if ! python3 -c "import json,sys; json.load(open('$f'))" 2>/dev/null; then
+              echo "::error file=$f::Invalid JSON"
+              fails=$((fails + 1))
+            fi
+          done
+          if [ $fails -gt 0 ]; then
+            echo "::error::$fails plugin manifest(s) failed JSON validation"
+            exit 1
+          fi
+          echo "All four plugin manifests are valid JSON."
+
+      - name: Plugin manifest versions match
+        run: |
+          set -e
+          v_claude=$(python3 -c "import json; print(json.load(open('.claude-plugin/plugin.json'))['version'])")
+          v_market=$(python3 -c "import json; print(json.load(open('.claude-plugin/marketplace.json'))['plugins'][0]['version'])")
+          v_codex=$(python3 -c "import json; print(json.load(open('.codex-plugin/plugin.json'))['version'])")
+          v_cursor=$(python3 -c "import json; print(json.load(open('.cursor-plugin/plugin.json'))['version'])")
+          v_skill=$(grep -m 1 'version:' skills/design-engineering/SKILL.md | sed -E 's/.*"([^"]+)".*/\1/')
+          if [ "$v_claude" != "$v_market" ] || [ "$v_claude" != "$v_codex" ] || [ "$v_claude" != "$v_cursor" ] || [ "$v_claude" != "$v_skill" ]; then
+            echo "::error::Version mismatch — claude:$v_claude marketplace:$v_market codex:$v_codex cursor:$v_cursor skill:$v_skill"
+            exit 1
+          fi
+          echo "All plugin manifests + SKILL.md report version $v_claude."
+
   link-check:
     name: Internal wikilink check
     runs-on: ubuntu-latest
diff --git a/AGENTS.md b/AGENTS.md
@@ -103,6 +103,17 @@ The lint job is the authoritative gate. If it passes on your branch, the PR is m
 
 This skill is indexed at [skills.sh/agentsorg/design-engineering/design-engineering](https://www.skills.sh/agentsorg/design-engineering/design-engineering). Discovery is automatic — skills.sh re-indexes on `npx skills add` calls. If the live page shows stale metadata after a release, re-run `npx skills add AgentsORG/design-engineering` once to trigger a re-index. There is no manual publish step.
 
+## Plugin manifests
+
+Three agent-specific manifests ship alongside the skills.sh registry entry, following the same pattern as [heygen-com/hyperframes](https://github.com/heygen-com/hyperframes):
+
+- **`.claude-plugin/plugin.json`** — minimal Claude Code plugin metadata (name, description, version, author, homepage, repository, license). Omits a `skills` field — Claude Code auto-discovers the root `skills/` directory.
+- **`.claude-plugin/marketplace.json`** — single-entry marketplace with `"source": "./"` so the repo doubles as its own marketplace. Add via `/plugin marketplace add AgentsORG/design-engineering`.
+- **`.codex-plugin/plugin.json`** — richer manifest with `keywords`, `skills: "./skills/"`, and an `interface` block (displayName, shortDescription, longDescription, developerName, category, capabilities, defaultPrompt, brandColor).
+- **`.cursor-plugin/plugin.json`** — Cursor IDE manifest with `$schema`, `displayName`, `publisher`, `category`, `tags`, `keywords`, and the same `skills` path.
+
+When changing version: bump it in all four files plus `skills/design-engineering/SKILL.md`. The `Plugin manifest versions match` CI step enforces parity — drift will fail the lint job.
+
 ## License
 
 MIT.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,44 @@ All notable changes to this skill are recorded here. Format follows [Keep a Chan
 
 ## [Unreleased]
 
+## [1.7.0] — 2026-05-22
+
+### Added — multi-agent plugin manifests (hyperframes pattern)
+
+The repo now ships three agent-specific plugin manifests in addition to the skills.sh / `npx skills add` install path, following the same pattern as [heygen-com/hyperframes](https://github.com/heygen-com/hyperframes). Each major agent host can install the design-engineering skill via its native plugin system without going through the cross-agent `skills.sh` shim.
+
+- **`.claude-plugin/plugin.json`** (NEW) — minimal Claude Code plugin metadata (name, description, version, author, homepage, repository, license). No `skills` field — Claude Code auto-discovers from `skills/`.
+- **`.claude-plugin/marketplace.json`** (refactored) — single-entry pattern with `"source": "./"` so the repo doubles as its own marketplace. Drops the nested `plugins[].skills[]` array in favor of auto-discovery. Top-level `owner` instead of `author` (matches the hyperframes / Claude Code marketplace schema).
+- **`.codex-plugin/plugin.json`** (NEW) — full OpenAI Codex manifest with `keywords`, `skills: "./skills/"`, and an `interface` block (displayName: "Design Engineering by HKTITAN", shortDescription, longDescription, developerName, category: Design, capabilities: Read+Write, defaultPrompt array, brandColor: `#0a0a0a`).
+- **`.cursor-plugin/plugin.json`** (NEW) — Cursor IDE manifest with `$schema`, `displayName`, `publisher`, `category: developer-tools`, `tags`, `keywords`, and the same `skills` path.
+
+Install paths now read:
+
+```bash
+# Cross-agent (recommended) — skills.sh
+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 — sideload via Settings → Plugins → Load unpacked
+```
+
+### Changed
+
+- **`README.md`** — Install section expanded with per-agent commands. Repository-layout tree updated to show all three plugin dotfolders.
+- **`AGENTS.md`** — new `## Plugin manifests` section documenting the four manifests and the version-parity convention.
+- **`.github/workflows/lint.yml`** — required-files check extended to `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, `.cursor-plugin/plugin.json`. New `Plugin manifests are valid JSON` step parses all four manifests with Python. New `Plugin manifest versions match` step verifies that all four manifests + SKILL.md report the same version (drift fails the lint job).
+- **`skills/design-engineering/SKILL.md`** version bumped to 1.7.0.
+
+### Breaking-ish
+
+The Claude Code `marketplace.json` schema changed shape: top-level `owner` replaces `author`, and the nested `plugins[].skills[]` array was removed in favor of auto-discovery from `skills/`. Existing installs continue to work because the skill content path (`skills/design-engineering/SKILL.md`) is unchanged. New installs via `/plugin marketplace add` use the simpler pattern.
+
 ## [1.6.0] — 2026-05-22
 
 ### Added — per-agent souls
@@ -212,7 +250,8 @@ Initial public release of the `design-engineering` skill graph.
 npx skills add AgentsORG/design-engineering
 ```
 
-[Unreleased]: https://github.com/AgentsORG/design-engineering/compare/v1.6.0...HEAD
+[Unreleased]: https://github.com/AgentsORG/design-engineering/compare/v1.7.0...HEAD
+[1.7.0]: https://github.com/AgentsORG/design-engineering/compare/v1.6.0...v1.7.0
 [1.6.0]: https://github.com/AgentsORG/design-engineering/compare/v1.5.0...v1.6.0
 [1.5.0]: https://github.com/AgentsORG/design-engineering/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/AgentsORG/design-engineering/compare/v1.3.0...v1.4.0
diff --git a/README.md b/README.md
@@ -10,12 +10,43 @@ Not a tutorial. Not a doc site. **A working memory the agent loads** when you're
 
 ## Install
 
+The fastest path — one command, any agent:
+
 ```bash
 npx skills add AgentsORG/design-engineering
 ```
 
 This uses the [skills.sh](https://skills.sh) CLI to install into your detected agent (Claude Code, Cursor, Windsurf, Codex, Gemini, Cline, Aider, and [18+ others](https://www.skills.sh/agent)). The CLI prompts for scope (project vs. global) and method (symlink vs. copy).
 
+### Per-agent install
+
+The repo also ships agent-specific plugin manifests so you can install via each agent's native plugin system:
+
+**Claude Code** — uses `.claude-plugin/marketplace.json` + `.claude-plugin/plugin.json`. Skills under `skills/` auto-discover.
+
+```bash
+# Add as a marketplace
+/plugin marketplace add AgentsORG/design-engineering
+/plugin install design-engineering
+
+# Or test locally
+claude --plugin-dir .
+```
+
+**Codex** — uses `.codex-plugin/plugin.json` with the full `interface` block (default prompts, brand color, capabilities).
+
+```bash
+codex plugin marketplace add AgentsORG/design-engineering --sparse .codex-plugin --sparse skills
+```
+
+**Cursor** — uses `.cursor-plugin/plugin.json`. Install via the Cursor Marketplace or sideload locally.
+
+```text
+Settings → Plugins → Load unpacked → point at this repo root
+```
+
+All three manifests share the same `name`, `version`, `description`, `author`, `homepage`, `repository`, and `license` so plugin identity stays consistent across hosts. The Codex manifest adds `interface` (default prompts, brand color, capabilities); the Cursor manifest adds `displayName`, `publisher`, `tags`, and a `$schema` URL. CI lints all four manifests for valid JSON and version-parity with `SKILL.md` on every PR.
+
 ### Recommended companions
 
 Two tools that compound the value of this skill — install both:
@@ -134,9 +165,15 @@ design-engineering/
 ├── CHANGELOG.md                       ← Keep a Changelog / SemVer
 ├── LICENSE                            ← MIT
 ├── .github/
-│   ├── workflows/lint.yml             ← markdownlint + frontmatter + wikilinks + subagent fields
+│   ├── workflows/lint.yml             ← markdownlint + frontmatter + wikilinks + subagent fields + manifest version-parity
 │   └── PULL_REQUEST_TEMPLATE.md
-├── .claude-plugin/marketplace.json    ← Claude Code marketplace manifest
+├── .claude-plugin/
+│   ├── marketplace.json               ← Claude Code marketplace manifest (single-entry, auto-discovery)
+│   └── plugin.json                    ← Claude Code plugin metadata
+├── .codex-plugin/
+│   └── plugin.json                    ← OpenAI Codex manifest with full interface block
+├── .cursor-plugin/
+│   └── plugin.json                    ← Cursor IDE plugin manifest
 ├── .markdownlint.jsonc
 ├── spec/
 │   └── agent-skills-spec.md           ← pointer to the Agent Skills specification
diff --git a/skills/design-engineering/SKILL.md b/skills/design-engineering/SKILL.md
@@ -5,7 +5,7 @@ license: MIT
 compatibility: Agent-agnostic. Pairs with Obsidian as a vault, Agentation for click-to-annotate review, and any coding agent that reads SKILL.md (Claude Code, Cursor, Codex, Windsurf, Aider, Cline, Gemini, 18+ via skills.sh).
 metadata:
   author: HKTITAN
-  version: "1.6.0"
+  version: "1.7.0"
   graph: true
   subagents: skills/design-engineering/agents/
   soul: SOUL.md
