feat: distribute selected skills from their owning packages

[LadyBluenotes]

🎯 Changes

Stacked on #258. Adds a saved repository-distribution choice to the maintainer workflow so package-owned skills can also reach consumers through GitHub skill installers and native plugins.

maintainer setup records explicitly selected skills or an opt-out in skill_tree.yaml. maintainer sync generates Claude/Cursor plugin metadata and copyable npx skills add and gh skill add commands pointing to the existing directories. maintainer check catches an unconfigured choice and stale generated files. Adding a skill never expands the selection automatically.

Skills stay alongside their code. Existing plugin fields and other marketplace entries are preserved; conflicting identities, source roots, and missing selected prerequisites are reported before synchronization writes files. The authoring procedure explains this choice during setup and distinguishes pre-install discovery guidance from installed-version implementation guidance.

The selection controls generated metadata and suggested commands; third-party installers retain their own repository discovery behavior. Publication stays with the library's release process. Documentation is in #259, which remains open for the maintainer release.

✅ 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 52 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: 7518dd5b-5c7d-47d2-822e-d04595756cde

📥 Commits

Reviewing files that changed from the base of the PR and between 44e2540 and 6da7880.

📒 Files selected for processing (14)

• .changeset/selected-skill-distribution.md
• CONTRIBUTING.md
• packages/intent/meta/generate-skill/SKILL.md
• packages/intent/meta/generate-skill/references/distribution.md
• packages/intent/meta/generate-skill/references/maintainer-commands.md
• packages/intent/package.json
• packages/intent/src/cli.ts
• packages/intent/src/commands/maintainer.ts
• packages/intent/src/maintainer/distribution.ts
• packages/intent/src/maintainer/sync.ts
• packages/intent/tests/cli.test.ts
• packages/intent/tests/distribution.test.ts
• packages/intent/tests/integration/distribution-installers.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 8133d37

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:sherif,t...	✅ Succeeded	46s	View ↗
nx run-many --targets=build	✅ Succeeded	3s	View ↗

---

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

[pkg-pr-new]

Open in StackBlitz

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

commit: 8133d37

[codspeed-hq]

Merging this PR will not alter performance

✅ 9 untouched benchmarks

---

_{Comparing feat-skill-distribution (6da7880) with feat-focused-authoring-review (44e2540)}