Skip to content

Re-export the skills with AgentID apps and release 0.5.0 - #16

Merged
sidharth0612 merged 2 commits into
mainfrom
claude/app-rename-plugins
Oct 2, 2026
Merged

sidharth0612 merged 2 commits into
mainfrom
claude/app-rename-plugins

Conversation

@sidharth0612

@sidharth0612 sidharth0612 commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This mirrors agentmail-to/agentmail-skills#18. AgentID's services are now apps, and the hosted MCP tools are renamed outright with no aliases: list_apps, search_apps, get_app and connect_app, with appId / appName fields. list_accounts keeps its name.

  • skills/: re-exported from the skills PR branch with python3 scripts/skills.py build --target <this checkout>. Only these generated files changed:
    • skills/agentid/SKILL.md: "AgentID: Accounts at Apps", with the app tools and fields, and "App" as the resource a 404 names.
    • skills/agentid/agents/openai.yaml: "Create accounts at apps for your agent".
    • skills/agentmail-mcp/SKILL.md: the catalog group and the verify step.
    • skills/agent-email-patterns/references/threat-model.md: the canonical row is "Connect inbox to app".
  • README.md: the AgentID intro and the tool table now list the app tools, and the safety model says "App sign-ins require a direct request naming the app and inbox."
  • CHANGELOG.md: a new 0.5.0 - Unreleased entry. Earlier entries are left as written, since they are history.
  • Manifests: all four (.claude-plugin, .codex-plugin, .cursor-plugin, .plugin) are bumped to 0.5.0, so installed Claude Code and Codex plugins pick up the renamed tools. This follows the 0.4.0 release.

Unchanged on purpose

  • The provider_connect permission name in the README and the skill. It is renamed in phase 2.
  • Email-provider meanings in agent-email-patterns.
  • compatibility.json. Its drift predates this PR and it doesn't cover this change.

Dependencies (why this is a draft)

Ship together with agentmail-to/agentmail-skills#18, and only after agentmail-to/agentmail-mcp#63 is deployed. The 0.5.0 bump is what reaches installed plugins. Shipping it before the connector serves the app tools would point agents at tools that don't exist yet.

Before marking ready

  • Re-export if Release 0.5.0 #18 changed: python3 scripts/skills.py build --target <this checkout> from agentmail-skills.
  • Replace Unreleased in CHANGELOG.md with the release date.

Checks run

  • python3 scripts/validate_repo.py: passed (4 manifests, 9 skills). This includes the manifest-version sync and the CHANGELOG entry check.
  • claude plugin validate . --strict: passed.
  • From agentmail-skills#18: python3 scripts/skills.py build --check --target <this checkout> is clean.

Release order

Phase 1 of the provider → app rename. The spec is plans/specs/provider-to-app-rename-phase-1.md in agentmail-api.

  1. agentmail-api Slice A (not open yet) deploys to prod. It serves /v0/apps* beside /v0/providers* and adds app_id / app_name to every Account.
  2. SDK: the agentmail-docs Fern PR (not open yet) adds apps.yml. agentmail-node then releases client.apps.*, with client.providers.* kept but deprecated.
  3. Toolkit: Rename the provider tools to list_apps, search_apps, get_app, connect_app agentmail-toolkit#67. Bump agentmail to that SDK, then publish agentmail-toolkit 0.10.0.
  4. MCP: Serve the app tools from agentmail-toolkit 0.10.0 agentmail-mcp#63. Pin the published toolkit 0.10.0 and that SDK, regenerate the lockfile and mcp-manifest.json, then deploy the connector.
  5. Skills and plugins, together: Rename AgentID providers to apps in the skills agentmail-skills#18 (re-sync backend-contract.json against agentmail-mcp main) and Re-export the skills with AgentID apps and release 0.5.0 #16 (re-export from Release 0.5.0 #18).

The MCP tools are renamed outright, with no alias tools. Once the connector deploys, the skills and plugins must ship the same day. Until then they name tools that no longer exist.

🤖 Generated with Claude Code

AgentMail is renaming the AgentID noun "provider" to "app"
(plans/specs/provider-to-app-rename-phase-1.md in agentmail-api). The
hosted MCP tools are renamed outright to list_apps, search_apps,
get_app and connect_app, with appId / appName fields.

- skills/ is re-exported from the agentmail-skills PR branch with
  `skills.py build --target`: agentid ("AgentID: Accounts at Apps",
  plus its openai.yaml display copy), agentmail-mcp, and the "Connect
  inbox to app" row in the agent-email-patterns threat model.
- README: the AgentID intro, the tool table, and the safety model say
  app and name the app tools.
- CHANGELOG adds 0.5.0, and every manifest is bumped to 0.5.0 so
  installed plugins pick up the renamed tools.

provider_connect stays the permission name until phase 2.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sidharth0612

Copy link
Copy Markdown
Contributor Author

Dependency links (opened after this PR): agentmail-api phase 1 is agentmail-to/agentmail-api#1512; the Fern/SDK change is agentmail-to/agentmail-docs#282.

Folded from #17 so the rename ships as one 0.5.0 release (one changelog entry).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sidharth0612

Copy link
Copy Markdown
Contributor Author

Folded #17 in: skills re-exported with app_connect (from skills #18's current head), README names app_connect, and the 0.5.0/0.5.1 changelog entries are merged into one 0.5.0 entry (all four manifests at 0.5.0). validate_repo.py, claude plugin validate . --strict, and the skills export check all pass. Merge the same day the MCP connector deploys with agentmail-mcp #63, alongside skills #18.

@sidharth0612
sidharth0612 marked this pull request as ready for review October 1, 2026 23:36
@sidharth0612
sidharth0612 merged commit 1e42b95 into main Oct 2, 2026
2 checks passed
@sidharth0612 sidharth0612 mentioned this pull request Oct 2, 2026
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.

2 participants