Skip to content

Adopt Agent Plugins 1.0.0 portable format - #78

Merged
AvdLee merged 2 commits into
mainfrom
agent-plugins-format
Aug 12, 2026
Merged

Adopt Agent Plugins 1.0.0 portable format#78
AvdLee merged 2 commits into
mainfrom
agent-plugins-format

Conversation

@AvdLee

@AvdLee AvdLee commented Aug 7, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds a root plugin.json manifest and moves the skill to the canonical skills/swiftui-expert-skill/ location per the Agent Plugins 1.0.0 specification, the vendor-neutral packaging standard backed by Amazon, Cursor, Microsoft, OpenAI, and Vercel. Compatible clients (including Cursor) now discover the skill with zero client-specific configuration.
  • Keeps full backwards compatibility: a symlink at the old swiftui-expert-skill/ root path preserves existing clones and scripts (removal planned for the next major version), and all client wrappers (Claude, Cursor, Codex, pi) are updated in the same release.
  • Fixes version drift: agents/openai.yaml was stuck at 2.2.0 while plugin manifests were at 4.0.0 — everything now agrees on 4.1.0, and the release workflow bumps every manifest going forward.
  • Adds skill-level ChatGPT desktop interface metadata (display name, icons, brand color) and a homepage field to the Cursor manifest. Updates test, CI, and doc paths to the new location; the repo-maintenance skill under .agents/skills/ intentionally stays outside skills/ so clients don't distribute it.

Test plan

  • python3 -m unittest discover -s tests — 3 tests pass with the new script path
  • Structure validated against the Agent Plugins 1.0.0 spec — 0 errors, 0 warnings
  • All wrapper manifests point at existing SKILL.md paths and agree on version 4.1.0
  • Load locally in Cursor from ~/.cursor/plugins/local and confirm skill discovery
  • Reinstall via Claude Code marketplace and confirm the skill resolves from the new path

AvdLee added 2 commits August 7, 2026 15:14
Add a root plugin.json manifest and move the skill to the canonical
skills/swiftui-expert-skill/ location per the Agent Plugins
specification (https://agent-plugins.org). A symlink at the old root
path keeps existing clones and scripts working until the next major
version.

Aligns all wrapper versions at 4.1.0 (agents/openai.yaml had drifted to
2.2.0), adds ChatGPT desktop interface metadata to the skill, and
updates the release workflow to bump every manifest.
Adds the Codex plugin manifest with listing metadata, PNG icons for the
portal (raw GitHub URLs cannot serve SVGs or symlinks), bumps the release
workflow to version all manifests including .codex-plugin, and
restructures the README around the primary install paths with the
remaining clients moved to INSTALLATION.md.
@AvdLee
AvdLee merged commit e8f654e into main Aug 12, 2026
1 check passed
@AvdLee
AvdLee deleted the agent-plugins-format branch August 12, 2026 13:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant