universal-plugin 0.16.3 → 0.17.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "universal-plugin",
-	"version": "0.16.3",
+	"version": "0.17.1",
 	"description": "Research and design toolkit for building universal AI coding agent plugins that work across Claude Code, Cursor, Codex, and GitHub Copilot CLI.",
 	"author": {
 		"name": "unional"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "universal-plugin",
-	"version": "0.16.3",
+	"version": "0.17.1",
 	"description": "Research and design toolkit for building universal AI coding agent plugins that work across Claude Code, Cursor, Codex, and GitHub Copilot CLI.",
 	"author": {
 		"name": "unional"

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "universal-plugin",
-	"version": "0.16.3",
+	"version": "0.17.1",
 	"description": "Research and design toolkit for building universal AI coding agent plugins that work across Claude Code, Cursor, Codex, and GitHub Copilot CLI.",
 	"author": {
 		"name": "unional"

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # universal-plugin
 
+## 0.17.1
+
+### Patch Changes
+
+- 7c951cc: `plugin bundle` and `publish sync-version` no longer warn that they are removed "in the next minor release", a release that has already shipped. The warning now says they have been deprecated since 0.14.0 and will be removed in a later release.
+- 621d36d: The `publish-plugin` skill's clone, fork and pull request commands now use the marketplace repo the user chose instead of always naming `cyberuni/cyberplace`.
+- 621d36d: The skill references no longer contradict each other on how the plugin is built and shipped: Copilot CLI reads the canonical `plugin.json` directly, a local install goes through `plugin install` rather than a hand-written symlink, `anthropics/claude-plugins-official` takes no pull requests, the build writes no Cursor command or Codex prompt, `packagePath` lives in `.agents/universal-plugin.json`, and `plugin build` has a `--check` flag.
+- 621d36d: The plugin references and the `agentskills-specialist` agent now say Copilot CLI hooks keep the canonical PascalCase event names, which is what the build writes, instead of camelCase.
+- 621d36d: The skills now name skills that exist: `buddy-agent-harness:init-buddy-agent-harness`, `buddy-agent-harness:doctor-buddy-agent-harness`, `buddy-changesets:changesets`, `aced:improve-skill` and its `validate.mjs` script, and the `marketplace` skill for a repository-local catalog.
+- 621d36d: The plugin references now name `mcp.json` as a plugin's MCP config, the fixed location the build reads, and drop the rule that it must be a symlink to `.mcp.json`.
+- 621d36d: The plugin references and the `agentskills-specialist` agent drop claims nothing backs: a fixed `SKILL.md` section template, a 6,000-character limit for every runtime, a `skill.json`, support for Zed, Continue.dev and Cline, `$ARGUMENTS` expanding everywhere, and dated "next minor release" wording. They also call references references, not governances.
+
+## 0.17.0
+
+### Minor Changes
+
+- 08e9790: Add `marketplace update <name>`, which changes one entry a repository's catalogs already list and keeps every field it is not asked to change. Move an entry to a new source (a new git source keeps the old pin), bump `--ref` or `--sha`, set one field such as `--description` or `--category`, or remove one with `--unset`. Each catalog is validated before anything is written, and an update that would introduce an issue writes nothing.
+
+### Patch Changes
+
+- 2dc4e84: Depend on `cyber-agentkit` `^2.0.0`. The docs now name `reference load`, which replaces `reference show`.
+- 80582de: Move `commander`, `semver`, `cyber-agentkit`, and `@toon-format/toon` to `devDependencies`. The `universal-plugin` bin already inlines them, so installing the package no longer pulls them in.
+- b53f4c8: The `publish-plugin` skill now changes an entry already listed in the marketplace with `marketplace update` instead of editing the catalogs by hand, so curator fields are kept and each catalog is validated before it is written.
+
 ## 0.16.3
 
 ### Patch Changes

package/agents/agentskills-specialist.md

@@ -14,7 +14,7 @@ model: opus
 # AgentSkills Specialist
 
 ## Role
-You are an expert AgentSkills engineer who designs, audits, and improves skills across Claude Code, Cursor, Codex, GitHub Copilot CLI, Windsurf, Zed, Continue.dev, and Cline runtimes.
+You are an expert AgentSkills engineer who designs, audits, and improves skills across Claude Code, Cursor, Codex, and GitHub Copilot CLI, the runtimes `plugin build` targets. Flag a skill meant for Windsurf as needing conversion, and Zed, Aider, Continue.dev, or Cline as incompatible.
 
 ## Core Responsibilities
 
@@ -32,14 +32,9 @@ skills/<name>/SKILL.md       # Universal skill definition (primary)
 .agents/skills/<name>/SKILL.md  # Project-level extension (if present)
 ```
 
-A `SKILL.md` must include:
-- **Purpose**: One sentence describing what the skill does.
-- **Trigger**: When/how this skill is invoked.
-- **Inputs**: What context or parameters the skill consumes.
-- **Outputs / Side Effects**: What the skill produces or changes.
-- **Steps**: Numbered, concrete procedural steps.
-- **Runtime Notes**: Any known incompatibilities or runtime-specific behavior.
-- **Examples**: At least one concrete invocation example.
+A `SKILL.md` should make clear what the skill does, when it is invoked, what it consumes and
+produces, and the steps it follows, plus runtime limitations and an example where they help. These
+are questions the body answers, not required section names.
 
 ## Auditing Workflow
 
@@ -75,7 +70,7 @@ For skill creation or edits, write the full `SKILL.md` content directly — no p
 ## Key Research Context
 
 - A root `plugin.json` on Agent Plugins Spec 1.0.0 is the universal manifest; `skills/<name>/SKILL.md` is the universal skill entry point.
-- Hook event naming is the sharpest incompatibility: PascalCase (Claude Code, Codex), camelCase (Cursor, Copilot CLI), snake_case (Windsurf).
+- Hook event naming is the sharpest incompatibility: PascalCase (Claude Code, Codex, Copilot CLI), camelCase (Cursor), snake_case (Windsurf).
 - Only Claude Code and Cursor publish machine-readable JSON Schemas.
 
 ## Out of Scope
@@ -87,7 +82,7 @@ For skill creation or edits, write the full `SKILL.md` content directly — no p
 ## Quality Gates
 
 Before declaring any skill complete:
-- [ ] SKILL.md is present and complete per the standard above.
+- [ ] SKILL.md is present and answers the questions above.
 - [ ] No runtime-specific assumptions are baked into the universal layer.
 - [ ] Project-level `.agents/skills/<name>/SKILL.md` extension is merged, not duplicated.
 - [ ] Examples are concrete and runnable.

package/com.github.copilot/agents/agentskills-specialist.agent.md

@@ -14,7 +14,7 @@ model: opus
 # AgentSkills Specialist
 
 ## Role
-You are an expert AgentSkills engineer who designs, audits, and improves skills across Claude Code, Cursor, Codex, GitHub Copilot CLI, Windsurf, Zed, Continue.dev, and Cline runtimes.
+You are an expert AgentSkills engineer who designs, audits, and improves skills across Claude Code, Cursor, Codex, and GitHub Copilot CLI, the runtimes `plugin build` targets. Flag a skill meant for Windsurf as needing conversion, and Zed, Aider, Continue.dev, or Cline as incompatible.
 
 ## Core Responsibilities
 
@@ -32,14 +32,9 @@ skills/<name>/SKILL.md       # Universal skill definition (primary)
 .agents/skills/<name>/SKILL.md  # Project-level extension (if present)
 ```
 
-A `SKILL.md` must include:
-- **Purpose**: One sentence describing what the skill does.
-- **Trigger**: When/how this skill is invoked.
-- **Inputs**: What context or parameters the skill consumes.
-- **Outputs / Side Effects**: What the skill produces or changes.
-- **Steps**: Numbered, concrete procedural steps.
-- **Runtime Notes**: Any known incompatibilities or runtime-specific behavior.
-- **Examples**: At least one concrete invocation example.
+A `SKILL.md` should make clear what the skill does, when it is invoked, what it consumes and
+produces, and the steps it follows, plus runtime limitations and an example where they help. These
+are questions the body answers, not required section names.
 
 ## Auditing Workflow
 
@@ -75,7 +70,7 @@ For skill creation or edits, write the full `SKILL.md` content directly — no p
 ## Key Research Context
 
 - A root `plugin.json` on Agent Plugins Spec 1.0.0 is the universal manifest; `skills/<name>/SKILL.md` is the universal skill entry point.
-- Hook event naming is the sharpest incompatibility: PascalCase (Claude Code, Codex), camelCase (Cursor, Copilot CLI), snake_case (Windsurf).
+- Hook event naming is the sharpest incompatibility: PascalCase (Claude Code, Codex, Copilot CLI), camelCase (Cursor), snake_case (Windsurf).
 - Only Claude Code and Cursor publish machine-readable JSON Schemas.
 
 ## Out of Scope
@@ -87,7 +82,7 @@ For skill creation or edits, write the full `SKILL.md` content directly — no p
 ## Quality Gates
 
 Before declaring any skill complete:
-- [ ] SKILL.md is present and complete per the standard above.
+- [ ] SKILL.md is present and answers the questions above.
 - [ ] No runtime-specific assumptions are baked into the universal layer.
 - [ ] Project-level `.agents/skills/<name>/SKILL.md` extension is merged, not duplicated.
 - [ ] Examples are concrete and runnable.