From 249a43132ee93211b6ac3099c8c2cd9d84ef1bf4 Mon Sep 17 00:00:00 2001
From: brennanb2025 <brennankbenson@gmail.com>
Date: Fri, 12 Jun 2026 11:19:35 -0700
Subject: [PATCH] Simplify Linear skill setup modal copy

Co-authored-by: Orca <help@stably.ai>
---
 .../LinearAgentSkillSetupPrompt.test.tsx      | 15 ++++++++---
 .../sidebar/LinearAgentSkillSetupPrompt.tsx   | 27 ++++++++++++-------
 2 files changed, 29 insertions(+), 13 deletions(-)

diff --git a/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.test.tsx b/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.test.tsx
index 533887643b8..4e445da582d 100644
--- a/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.test.tsx
+++ b/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.test.tsx
@@ -357,9 +357,12 @@ describe('LinearAgentSkillSetupPrompt', () => {
     await renderPrompt({ linked: true, remote: false, surface: 'modal' })
 
     expect(container?.textContent).not.toContain('Set up Linear agent skill')
-    expect(document.body.textContent).toContain('Install Linear ticket access')
     expect(document.body.textContent).toContain(
-      'Install the Linear skill so agents can read linked Linear tickets through the Orca CLI.'
+      'Enable agents to read and edit the attached Linear ticket.'
+    )
+    expect(document.body.textContent).toContain('Mock install')
+    expect(document.body.textContent).not.toContain(
+      'Before opening setup, Orca may show a system prompt'
     )
 
     const notNowButton = Array.from(document.body.querySelectorAll('button')).find(
@@ -370,7 +373,9 @@ describe('LinearAgentSkillSetupPrompt', () => {
     })
 
     expect(window.localStorage.getItem(HOST_DISMISS_STORAGE_KEY)).toBeNull()
-    expect(document.body.textContent).not.toContain('Install Linear ticket access')
+    expect(document.body.textContent).not.toContain(
+      'Enable agents to read and edit the attached Linear ticket.'
+    )
   })
 
   it('permanently dismisses the modal-only prompt when requested', async () => {
@@ -384,6 +389,8 @@ describe('LinearAgentSkillSetupPrompt', () => {
     })
 
     expect(window.localStorage.getItem(HOST_DISMISS_STORAGE_KEY)).toBe('1')
-    expect(document.body.textContent).not.toContain('Install Linear ticket access')
+    expect(document.body.textContent).not.toContain(
+      'Enable agents to read and edit the attached Linear ticket.'
+    )
   })
 })
diff --git a/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.tsx b/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.tsx
index dbbc941693b..11d781458e1 100644
--- a/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.tsx
+++ b/src/renderer/src/components/sidebar/LinearAgentSkillSetupPrompt.tsx
@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useMemo, useState } from 'react'
-import { RefreshCw, TicketCheck, X } from 'lucide-react'
+import { Info, RefreshCw, TicketCheck, X } from 'lucide-react'
 import type { CliInstallStatus } from '../../../../shared/cli-install-types'
 import type { SkillDiscoveryTarget } from '../../../../shared/skills'
 import { Button } from '@/components/ui/button'
@@ -197,20 +197,29 @@ export function LinearAgentSkillSetupPrompt({
     >
       <DialogContent className="gap-0 overflow-hidden p-0 sm:max-w-[640px]">
         <div className="px-6 pt-6 pr-14">
-          <DialogHeader className="gap-2">
-            <DialogTitle className="text-base leading-snug">
+          <DialogHeader>
+            <DialogTitle className="sr-only">
               {translate(
                 'auto.components.sidebar.LinearAgentSkillSetupPrompt.modalTitle',
-                'Install Linear ticket access'
+                'Enable Linear ticket access'
               )}
             </DialogTitle>
-            <DialogDescription className="text-xs leading-relaxed">
+            <DialogDescription className="sr-only">
               {translate(
                 'auto.components.sidebar.LinearAgentSkillSetupPrompt.modalDescription',
-                'Install the Linear skill so agents can read linked Linear tickets through the Orca CLI.'
+                'Install the Linear skill from a terminal.'
               )}
             </DialogDescription>
           </DialogHeader>
+          <div className="flex items-start gap-2 text-[13px] leading-snug text-foreground">
+            <Info className="mt-0.5 size-4 shrink-0 text-muted-foreground" />
+            <p>
+              {translate(
+                'auto.components.sidebar.LinearAgentSkillSetupPrompt.modalPrompt',
+                'Enable agents to read and edit the attached Linear ticket.'
+              )}
+            </p>
+          </div>
         </div>
         <AgentSkillSetupPanel
           className="px-6 pt-4 pb-3"
@@ -218,9 +227,9 @@ export function LinearAgentSkillSetupPrompt({
           hideHeader
           title={translate(
             'auto.components.sidebar.LinearAgentSkillSetupPrompt.modalTitle',
-            'Install Linear ticket access'
+            'Enable Linear ticket access'
           )}
-          description={missingLabel}
+          description=""
           command={command}
           terminalTitle={translate(
             'auto.components.sidebar.LinearAgentSkillSetupPrompt.terminalTitle',
@@ -240,7 +249,7 @@ export function LinearAgentSkillSetupPrompt({
             'auto.components.sidebar.LinearAgentSkillSetupPrompt.install',
             'Install CLI & Skill'
           )}
-          preInstallNotice={AGENT_SKILL_CLI_PREREQUISITE_NOTICE}
+          preInstallNotice={surface === 'inline' ? AGENT_SKILL_CLI_PREREQUISITE_NOTICE : undefined}
           getPrerequisiteStatus={
             agentRuntime.runtime === 'wsl'
               ? () => window.api.cli.getWslInstallStatus(getWslCliDistroRequest(agentRuntime))