feat: guide adoption of existing library skills

[LadyBluenotes]

🎯 Changes

Stacked on #260. Adds intent maintainer adopt so an existing library can register its skills without rewriting their content or assembling each registration by hand.

• Preview root and workspace package skills as a read-only JSON plan, including existing, missing, invalid, planned, and retired entries. Custom directories require an explicit path.
• Use interactive selection and confirmation in a human terminal, or apply reviewed JSON choices. Domain decisions and repository distribution stay explicit.
• Plan the complete batch before writing, preserve authored guidance and existing records, and reject stale plans. Adoption does not approve content or publish anything.
• Keep CI noninteractive. JSON preview reports discovery; maintainer check remains the read-only completion gate.

Public documentation is in #259. This PR contains implementation, tests, and a changeset, with no narrative documentation changes.

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

[coderabbitai]

Warning

Review limit reached

Next included review available in 51 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 2 included reviews currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 69c635fb-888b-4455-8121-8b752d868f16

📥 Commits

Reviewing files that changed from the base of the PR and between 6da7880 and 183aab0.

📒 Files selected for processing (10)

• .changeset/guided-maintainer-adoption.md
• packages/intent/src/cli.ts
• packages/intent/src/commands/maintainer.ts
• packages/intent/src/maintainer/add.ts
• packages/intent/src/maintainer/adopt.ts
• packages/intent/src/maintainer/adoption-prompts.ts
• packages/intent/src/maintainer/distribution.ts
• packages/intent/src/maintainer/project.ts
• packages/intent/tests/integration/packed-release.test.ts
• packages/intent/tests/maintainer.test.ts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[nx-cloud]

View your CI Pipeline Execution ↗ for commit ac21ac4

---

☁️ Nx Cloud last updated this comment at 2026-09-11 04:24:32 UTC

[nx-cloud]

View your CI Pipeline Execution ↗ for commit ac21ac4

Command	Status	Duration	Result
nx run-many --targets=build	✅ Succeeded	<1s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-09-11 04:24:32 UTC

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@tanstack/intent@262

commit: ac21ac4

[codspeed-hq]

Merging this PR will not alter performance

✅ 9 untouched benchmarks

---

_{Comparing feat-maintainer-adoption (183aab0) with feat-skill-distribution (8133d37)}