Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
feat(init): install the clerk-expo setup skill for Expo projects by manovotny · Pull Request #328 · clerk/cli · GitHub
Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(init): install the clerk-expo setup skill for Expo projects by manovotny · Pull Request #328 · clerk/cli · GitHub
Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(init): install the clerk-expo setup skill for Expo projects by manovotny · Pull Request #328 · clerk/cli · GitHub
Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' feat(init): install the clerk-expo setup skill for Expo projects by manovotny · Pull Request #328 · clerk/cli · GitHub
Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(init): install the clerk-expo setup skill for Expo projects by manovotny · Pull Request #328 · clerk/cli · GitHub
Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(init): install the clerk-expo setup skill for Expo projects by manovotny · Pull Request #328 · clerk/cli · GitHub
Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); feat(init): install the clerk-expo setup skill for Expo projects by manovotny · Pull Request #328 · clerk/cli · GitHub
Skip to content

feat(init): install the clerk-expo setup skill for Expo projects - #328

Merged
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill
Jun 17, 2026
Merged

feat(init): install the clerk-expo setup skill for Expo projects#328
manovotny merged 2 commits into
mainfrom
manovotny/init-expo-setup-skill

Conversation

@manovotny

Copy link
Copy Markdown
Contributor

clerk init on Expo projects only installs clerk-expo-patterns. The expo entry in FRAMEWORK_SKILL_MAP (#86, April) predates the mobile/clerk-expo setup skill (clerk/skills@7f7b6ea, May), so the dedicated Expo setup skill never made it into the init flow.

This makes the framework skill map support multiple skills per framework and adds clerk-expo for Expo inits. Prompt summary becomes (clerk-cli + core + features + expo + expo-patterns).

If the exclusion was deliberate, feel free to close — we'll note the intent in docs instead. Surfaced while tightening CLI ↔ Skills cross-referencing in clerk-docs#3427 (DOCS-11816).

The expo entry in FRAMEWORK_SKILL_MAP (added in #86, 2026-04) predates the mobile/clerk-expo setup skill (added to clerk/skills in 2026-05), so Expo inits only got clerk-expo-patterns. The map now supports multiple skills per framework and Expo installs both.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@changeset-bot

changeset-botBot commented Jun 10, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 438581c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
clerkMinor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitaiBot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc5116b6-a96c-4b5d-930a-9793237d16f2

📥 Commits

Reviewing files that changed from the base of the PR and between aa36552 and 438581c.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/init/skills.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • packages/cli-core/src/commands/init/skills.ts

📝 Walkthrough

Walkthrough

This PR refactors the skills system to support multiple framework-specific skills per framework. FRAMEWORK_SKILL_MAP now maps frameworks to arrays of skills; getFrameworkSkills() returns all mapped skills; resolveUpstreamSkills(), formatSkillsSummary(), and formatSkillsPromptMessage() operate on skill arrays; installSkills() and runSkillsAdd() use the array-based summaries. Tests cover Expo mapping to both "clerk-expo" and "clerk-expo-patterns", and release notes document the change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main objective: installing the clerk-expo setup skill for Expo projects, which is the central change across all modified files.
Description check✅ PassedThe description is directly related to the changeset, clearly explaining the motivation (clerk-expo skill was never included in init flow) and the solution (support multiple skills per framework).
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@packages/cli-core/src/commands/init/skills.ts`:
- Around line 70-72: getFrameworkSkills currently returns the original array
from FRAMEWORK_SKILL_MAP which allows external mutation; change
getFrameworkSkills to return an immutable copy of the skills array (e.g., create
a new array via slice/spread or Object.freeze) when
FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still returning an empty array
for unknown frameworkDep, so callers cannot modify the global
FRAMEWORK_SKILL_MAP contents.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7d6df06-9251-4bce-91ff-470e6da2f40b

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd85a8 and aa36552.

📒 Files selected for processing (3)
  • .changeset/init-expo-setup-skill.md
  • packages/cli-core/src/commands/init/skills.test.ts
  • packages/cli-core/src/commands/init/skills.ts

Comment on lines 70 to 72
export function getFrameworkSkills(frameworkDep: string | undefined): string[] {
return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];
}

@coderabbitaicoderabbitaiBotJun 10, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Return an immutable/copy value from getFrameworkSkills to prevent global map mutation.

Line 71 currently leaks the original array stored in FRAMEWORK_SKILL_MAP. Because this function is exported, any caller can mutate that array and silently change future skill resolution/install behavior.

Suggested fix
-export function getFrameworkSkills(frameworkDep: string | undefined): string[] {- return (frameworkDep && FRAMEWORK_SKILL_MAP[frameworkDep]) || [];+export function getFrameworkSkills(frameworkDep: string | undefined): readonly string[] {+ const skills = frameworkDep ? FRAMEWORK_SKILL_MAP[frameworkDep] : undefined;+ return skills ? [...skills] : [];
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/cli-core/src/commands/init/skills.ts` around lines 70 - 72,
getFrameworkSkills currently returns the original array from FRAMEWORK_SKILL_MAP
which allows external mutation; change getFrameworkSkills to return an immutable
copy of the skills array (e.g., create a new array via slice/spread or
Object.freeze) when FRAMEWORK_SKILL_MAP[frameworkDep] exists, while still
returning an empty array for unknown frameworkDep, so callers cannot modify the
global FRAMEWORK_SKILL_MAP contents.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would suggest implementing this fix @manovotny

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could if you like just modify the return type to be readonly which would enforce it on the type layer like:

Suggested change
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): string[]{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}
exportfunctiongetFrameworkSkills(frameworkDep: string|undefined): ReadonlyArray<string>{
return(frameworkDep&&FRAMEWORK_SKILL_MAP[frameworkDep])||[];
}

@manovotnymanovotnyJun 12, 2026

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied in 438581c, one level up from the return-type fix: FRAMEWORK_SKILL_MAP itself is now Record<string, readonly string[]>, so immutability is declared at the source and getFrameworkSkills inherits readonly string[] (matching the existing annotations on the format helpers).

Skipped the runtime copy — both callers only iterate, and with the readonly type any future mutation fails typecheck at the call site.

Review feedback on the FRAMEWORK_SKILL_MAP leak: type the map as
Record<string, readonly string[]> so immutability is declared at the
source and getFrameworkSkills inherits it, instead of copying at
runtime.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@manovotny
manovotny requested a review from wyattjohJune 16, 2026 19:58
@manovotny
manovotny merged commit 34cb930 into mainJun 17, 2026
10 checks passed
@manovotny
manovotny deleted the manovotny/init-expo-setup-skill branch June 17, 2026 16:12
@github-actionsgithub-actionsBot mentioned this pull request Jun 17, 2026
Sign up for freeto 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

@manovotny@wyattjoh