Skip to content

Teach the new plugin and skill names for the Adapty skills repo - #529

Merged
eandreeva-twr merged 2 commits into
mainfrom
docs/adapty-skills-rename
Aug 20, 2026
Merged

Teach the new plugin and skill names for the Adapty skills repo#529
eandreeva-twr merged 2 commits into
mainfrom
docs/adapty-skills-rename

Conversation

@eandreeva-twr

@eandreeva-twr eandreeva-twr commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

What

The Claude Code plugin is now adapty-skills and the SDK skill is adapty-integration (adaptyteam/adapty-skills#35). This updates what the docs tell readers to type:

  • AdaptySdkIntegrationSkill.mdx — install command, /adapty-integration invocation, and the two prose mentions
  • agent-tools.jsonusageCommand and the Claude Code install command
  • 7 platform page descriptions — "the adapty-integration skill"
  • generate-md.mjs + generate-platform-llms-full.mjs — the injected "use the … skill" sentence
  • briefs.mjs — keeps both names in the non-article denylist
  • .claude/context-mill/zones/agent-tooling.md — internal agent notes

What is deliberately NOT changed

Page slugs and repo URLs. adapty-sdk-integration-skill* page ids stay — those are published URLs. The GitHub repo is not being renamed either, so every adaptyteam/adapty-sdk-integration-skill link is correct as-is. The substitution was boundary-aware and the diff contains zero adapty-integration-skill strings; please spot-check that.

Locales. The 7 locale copies carry the same strings, but their .hashes caches embed translated content keyed to the source fileHash. This change invalidates them, so the translation pipeline should regenerate them. I did not hand-edit translations — flagging in case the pipeline needs a nudge, and note the install-command line is language-independent if you'd rather patch it directly.

whats-new.mdx. A dated release note recording what was announced at the time; archival accuracy over findability. Say the word if you'd rather it point at the current name.

Timing

Nothing here is urgent or breaking: the old plugin handle still resolves via a deprecated marketplace entry, so the current docs are stale rather than wrong. Merge whenever. The alias on the other side will only be dropped after this lands.


⛔ BLOCKED until the repo is renamed

These commits assume the GitHub repo has been renamed adaptyteam/adapty-sdk-integration-skilladaptyteam/adapty-skills. That rename has not happened yet. Every updated URL here 404s until it does, so do not merge before the rename.

Rename steps (repo Settings → General → Repository name), then in whatever order:

  1. Rename the repo on GitHub. Open PRs, branches and stars move with it; git and web traffic redirect from the old name indefinitely.
  2. Never create anything at adaptyteam/adapty-sdk-integration-skill again — reusing the name permanently kills the redirect.
  3. Re-register the skills.sh listing and the Context7 entry — both key on owner/repo, and the old slugs remain as stale duplicates that cannot be redirected.
  4. Merge Point the skill fetch at the renamed adapty-integration directory adapty-cli#17 after the skills-repo PR. RAW_BASE is a raw.githubusercontent.com URL and raw does not follow repo renames.

What survives the rename with no action: existing claude plugin installs (git remotes follow the redirect), existing clones, and every published docs page slug — adapty-sdk-integration-skill* page ids are unrelated to the repo name and deliberately unchanged.

The Claude Code plugin is now `adapty-skills` and the SDK skill is
`adapty-integration`. Updates the install command and the invocation in the
reusable component and in agent-tools.json, plus the skill name in the seven
platform page descriptions and the two generated-output injectors.

English sources only. The locale copies carry the same strings, but their
.hashes caches key on the source fileHash, so this change invalidates them and
the translation pipeline should regenerate them rather than hand-editing.

whats-new.mdx is deliberately untouched: it is a dated release note recording
what was announced at the time. briefs.mjs keeps both names in its non-article
denylist for the same reason.
The repo is being renamed alongside the plugin and skill. Updates the 13
`adaptyteam/adapty-sdk-integration-skill` references in the reusable component,
agent-tools.json and the two generated-output injectors.

Deliberately scoped to references prefixed with `adaptyteam/`, because
`adapty-sdk-integration-skill` is ALSO the docs page slug: the 7 platform slugs
in InstallToolsModal.astro and SkillPromo.astro, the 7 sidebar ids, and the
Homepage.tsx href are published URLs and must not move. Verified unchanged.
@eandreeva-twr
eandreeva-twr merged commit 5fb7695 into main Aug 20, 2026
2 checks passed
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