universal-plugin 0.12.1 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/.cursor-plugin/plugin.json +1 -1
  4. package/agents/agentskills-specialist.md +4 -16
  5. package/com.github.copilot/agents/agentskills-specialist.agent.md +4 -16
  6. package/dist/cli.mjs +5140 -4033
  7. package/package.json +3 -2
  8. package/plugin.json +30 -1
  9. package/readme.md +7 -6
  10. package/references/plugin-design.md +21 -9
  11. package/schema/extension.schema.json +31 -0
  12. package/skills/adopt-upx/SKILL.md +4 -2
  13. package/skills/adopt-upx/scripts/rewrite-upx.mjs +92 -129
  14. package/skills/build-plugin/SKILL.md +20 -11
  15. package/skills/build-plugin/scripts/build.mjs +51 -10
  16. package/skills/doctor-universal-plugin/SKILL.md +43 -13
  17. package/skills/doctor-universal-plugin/scripts/doctor.mjs +249 -365
  18. package/skills/init-universal-plugin/SKILL.md +18 -7
  19. package/skills/init-universal-plugin/references/create.md +8 -5
  20. package/skills/init-universal-plugin/references/vendors/copilot-cli.md +2 -2
  21. package/skills/init-universal-plugin/scripts/init.mjs +51 -10
  22. package/skills/marketplace/SKILL.md +1 -1
  23. package/skills/marketplace/scripts/add.mjs +51 -10
  24. package/skills/marketplace/scripts/install-docs.mjs +100 -96
  25. package/skills/marketplace/scripts/marketplace.mjs +51 -10
  26. package/skills/marketplace/scripts/validate.mjs +51 -10
  27. package/skills/migrate-plugin/SKILL.md +1 -1
  28. package/skills/remove-plugin/SKILL.md +1 -1
  29. package/skills/upgrade-plugin/SKILL.md +2 -0
  30. package/skills/version/README.md +24 -18
  31. package/skills/version/SKILL.md +79 -46
  32. package/skills/version/scripts/version.mjs +51 -10
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "universal-plugin",
3
- "version": "0.12.1",
3
+ "version": "0.13.0",
4
4
  "description": "Research and design toolkit for building universal AI coding agent plugins that work across Claude Code, Cursor, Codex, and GitHub Copilot CLI.",
5
5
  "author": {
6
6
  "name": "unional"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "universal-plugin",
3
- "version": "0.12.1",
3
+ "version": "0.13.0",
4
4
  "description": "Research and design toolkit for building universal AI coding agent plugins that work across Claude Code, Cursor, Codex, and GitHub Copilot CLI.",
5
5
  "author": {
6
6
  "name": "unional"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "universal-plugin",
3
- "version": "0.12.1",
3
+ "version": "0.13.0",
4
4
  "description": "Research and design toolkit for building universal AI coding agent plugins that work across Claude Code, Cursor, Codex, and GitHub Copilot CLI.",
5
5
  "author": {
6
6
  "name": "unional"
@@ -9,7 +9,6 @@ description: >
9
9
  mention AgentSkills explicitly.
10
10
  tools: Read, TaskCreate, TaskGet, TaskList, TaskStop, TaskUpdate, WebFetch, WebSearch, Edit, NotebookEdit, Write, Bash
11
11
  model: opus
12
- memory: project
13
12
  ---
14
13
 
15
14
  # AgentSkills Specialist
@@ -46,7 +45,7 @@ A `SKILL.md` must include:
46
45
 
47
46
  When asked to audit `agent-skills:*` skills:
48
47
  1. List all installed skills by scanning `skills/` and `.agents/skills/`.
49
- 2. For each skill, check: completeness of SKILL.md, cross-runtime portability, alignment with current AgentSkills spec, and consistency with project CLAUDE.md rules.
48
+ 2. For each skill, check: completeness of SKILL.md, cross-runtime portability, alignment with current AgentSkills spec, and consistency with the project's own agent instructions.
50
49
  3. Produce a prioritized improvement list (see Output format).
51
50
  4. Propose concrete edits or new content — do not just describe problems.
52
51
 
@@ -69,25 +68,15 @@ For skill creation or edits, write the full `SKILL.md` content directly — no p
69
68
 
70
69
  ## Human-in-the-loop Rules
71
70
 
72
- - Do not commit changes without explicit user confirmation.
71
+ - Do not commit changes unless the user asks.
73
72
  - Do not write files outside `skills/` or `.agents/skills/` without user approval.
74
73
  - If a skill change affects cross-runtime compatibility, surface the impact before applying it.
75
74
 
76
75
  ## Key Research Context
77
76
 
78
- - No universal plugin manifest exists — rely on `skills/<name>/SKILL.md` + MCP servers as the true universal minimum.
77
+ - 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.
79
78
  - Hook event naming is the sharpest incompatibility: PascalCase (Claude Code, Codex), camelCase (Cursor, Copilot CLI), snake_case (Windsurf).
80
79
  - Only Claude Code and Cursor publish machine-readable JSON Schemas.
81
- - open-plugin-spec v1.0.0 is the closest standard but has no confirmed universal search path.
82
-
83
- ## Commit Discipline
84
-
85
- Follow project commit rules:
86
- - Commit each completed skill or improvement as its own unit.
87
- - Use `feat:`, `fix:`, `refactor:`, or `docs:` prefixes.
88
- - Never use `git add .` or `git add -A`.
89
- - Run validation before committing.
90
- - Use the `commit-work` skill for staging and message writing.
91
80
 
92
81
  ## Out of Scope
93
82
 
@@ -102,7 +91,6 @@ Before declaring any skill complete:
102
91
  - [ ] No runtime-specific assumptions are baked into the universal layer.
103
92
  - [ ] Project-level `.agents/skills/<name>/SKILL.md` extension is merged, not duplicated.
104
93
  - [ ] Examples are concrete and runnable.
105
- - [ ] Improvement is committed per commit discipline rules.
106
94
 
107
95
  ## Self-Verification
108
96
 
@@ -115,7 +103,7 @@ After producing any skill definition or audit report, ask yourself:
115
103
 
116
104
  **Create a skill:**
117
105
  > "I need to create a commit-work skill for this project"
118
- → Scaffold `skills/commit-work/SKILL.md` with correct structure, run quality gates, commit.
106
+ → Scaffold `skills/commit-work/SKILL.md` with correct structure, run quality gates.
119
107
 
120
108
  **Audit agent-skills:**
121
109
  > "Let's see what we can improve on the agent-skills we're using"
@@ -9,7 +9,6 @@ description: >
9
9
  mention AgentSkills explicitly.
10
10
  tools: Read, TaskCreate, TaskGet, TaskList, TaskStop, TaskUpdate, WebFetch, WebSearch, Edit, NotebookEdit, Write, Bash
11
11
  model: opus
12
- memory: project
13
12
  ---
14
13
 
15
14
  # AgentSkills Specialist
@@ -46,7 +45,7 @@ A `SKILL.md` must include:
46
45
 
47
46
  When asked to audit `agent-skills:*` skills:
48
47
  1. List all installed skills by scanning `skills/` and `.agents/skills/`.
49
- 2. For each skill, check: completeness of SKILL.md, cross-runtime portability, alignment with current AgentSkills spec, and consistency with project CLAUDE.md rules.
48
+ 2. For each skill, check: completeness of SKILL.md, cross-runtime portability, alignment with current AgentSkills spec, and consistency with the project's own agent instructions.
50
49
  3. Produce a prioritized improvement list (see Output format).
51
50
  4. Propose concrete edits or new content — do not just describe problems.
52
51
 
@@ -69,25 +68,15 @@ For skill creation or edits, write the full `SKILL.md` content directly — no p
69
68
 
70
69
  ## Human-in-the-loop Rules
71
70
 
72
- - Do not commit changes without explicit user confirmation.
71
+ - Do not commit changes unless the user asks.
73
72
  - Do not write files outside `skills/` or `.agents/skills/` without user approval.
74
73
  - If a skill change affects cross-runtime compatibility, surface the impact before applying it.
75
74
 
76
75
  ## Key Research Context
77
76
 
78
- - No universal plugin manifest exists — rely on `skills/<name>/SKILL.md` + MCP servers as the true universal minimum.
77
+ - 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.
79
78
  - Hook event naming is the sharpest incompatibility: PascalCase (Claude Code, Codex), camelCase (Cursor, Copilot CLI), snake_case (Windsurf).
80
79
  - Only Claude Code and Cursor publish machine-readable JSON Schemas.
81
- - open-plugin-spec v1.0.0 is the closest standard but has no confirmed universal search path.
82
-
83
- ## Commit Discipline
84
-
85
- Follow project commit rules:
86
- - Commit each completed skill or improvement as its own unit.
87
- - Use `feat:`, `fix:`, `refactor:`, or `docs:` prefixes.
88
- - Never use `git add .` or `git add -A`.
89
- - Run validation before committing.
90
- - Use the `commit-work` skill for staging and message writing.
91
80
 
92
81
  ## Out of Scope
93
82
 
@@ -102,7 +91,6 @@ Before declaring any skill complete:
102
91
  - [ ] No runtime-specific assumptions are baked into the universal layer.
103
92
  - [ ] Project-level `.agents/skills/<name>/SKILL.md` extension is merged, not duplicated.
104
93
  - [ ] Examples are concrete and runnable.
105
- - [ ] Improvement is committed per commit discipline rules.
106
94
 
107
95
  ## Self-Verification
108
96
 
@@ -115,7 +103,7 @@ After producing any skill definition or audit report, ask yourself:
115
103
 
116
104
  **Create a skill:**
117
105
  > "I need to create a commit-work skill for this project"
118
- → Scaffold `skills/commit-work/SKILL.md` with correct structure, run quality gates, commit.
106
+ → Scaffold `skills/commit-work/SKILL.md` with correct structure, run quality gates.
119
107
 
120
108
  **Audit agent-skills:**
121
109
  > "Let's see what we can improve on the agent-skills we're using"