[sidharth0612]

Summary

This mirrors agentmail-to/agentmail-skills#19. Phase 2 of the provider → app rename renames the API-key permission provider_connect to app_connect.

• skills/agentid/SKILL.md: re-exported from the skills phase 2 branch with python3 scripts/skills.py build --target <this checkout>. The 403 missing_permission guidance names app_connect. No other generated file changed.
• README.md: the sign-in link "needs the app_connect permission on the credential."
• CHANGELOG.md: a new 0.5.1 - Unreleased entry. The 0.5.0 entry, including "The provider_connect permission keeps its name.", is left as written because it describes that release. See the version note under Release order.
• Manifests: all four (.claude-plugin, .codex-plugin, .cursor-plugin, .plugin) are bumped to 0.5.1, so installed plugins pick up the new guidance.

Unchanged on purpose

• compatibility.json. As on Re-export the skills with AgentID apps and release 0.5.0 #16, its drift predates this PR and it doesn't cover this change.

Dependencies (why this is a draft)

• Stacked on Re-export the skills with AgentID apps and release 0.5.0 #16 (phase 1). The base is claude/app-rename-plugins.
• Merge only after agentmail-api phase 2 PR 2a is live in prod (plans/specs/provider-to-app-rename-phase-2-permissions.md) and Serve connect_app naming app_connect from agentmail-toolkit 0.10.1 agentmail-mcp#64 is deployed.
• Ship together with Name app_connect in the AgentID skill's 403 guidance agentmail-skills#19. This releases with the other phase 2 tooling PRs: Name app_connect as the permission connect_app requires agentmail-toolkit#68 and Serve connect_app naming app_connect from agentmail-toolkit 0.10.1 agentmail-mcp#64.

Before marking ready

• Re-export if Canonicalize cross-client plugin releases #19 changed: run 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.
• python3 scripts/check_compatibility.py: reports only the existing registry drift, which this PR doesn't touch.
• From agentmail-skills#19: python3 scripts/skills.py build --check --target <this checkout> is clean.

Release order

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

0. agentmail-api phase 2 PR 2a (not open yet, stacked on agentmail-to/agentmail-api#1512) is live in prod. It accepts app_connect / app_share_owner beside the old names, returns both names, and its error fix text names only app_connect.
1. Phase 1 tooling releases first, or together with this set: Rename the provider tools to list_apps, search_apps, get_app, connect_app agentmail-toolkit#67, Serve the app tools from agentmail-toolkit 0.10.0 agentmail-mcp#63, Rename AgentID providers to apps in the skills agentmail-skills#18 and Re-export the skills with AgentID apps and release 0.5.0 #16. Each phase 2 PR is stacked on its phase 1 PR.
2. Toolkit: Name app_connect as the permission connect_app requires agentmail-toolkit#68. Publish agentmail-toolkit 0.10.1.
3. MCP: Serve connect_app naming app_connect from agentmail-toolkit 0.10.1 agentmail-mcp#64. Pin the published 0.10.1, regenerate the lockfile and mcp-manifest.json, then deploy the connector.
4. Skills and plugins, together: Name app_connect in the AgentID skill's 403 guidance agentmail-skills#19 (re-sync backend-contract.json against agentmail-mcp main) and Re-export the skills with app_connect and release 0.5.1 #17 (re-export from Canonicalize cross-client plugin releases #19, release 0.5.1).

The console relabel to "App: Connect" (agentmail-web apps/console/app/lib/permissions-config.ts, a separate phase 2 follow-up) should be live by step 4. The skill tells the user to enable app_connect on the key in the console.

Versions: 0.10.1 and 0.5.1 assume phase 1 publishes 0.10.0 and 0.5.0 on its own first. If both phases release together, publish the toolkit as 0.10.1 (skipping 0.10.0). For plugins, fold the 0.5.1 entry into 0.5.0, drop its "keeps its name" line, and stay on 0.5.0.

🤖 Generated with Claude Code

[sidharth0612]

Dependency links (opened after this PR): agentmail-api phase 2 PR 2a is agentmail-to/agentmail-api#1515 (stacked on #1512), writer flip 2b is #1516. This merges only after #1515 is live in prod.

[sidharth0612]

Folded into #16 so the rename ships as one 0.5.0 release.