---

name: quolar-setup description: | This skill should be used when the user asks to "setup quolar", "configure quolar", "configure test automation", "verify MCP servers", "create quolar.config.ts", or is using Quolar for the first time. Provides interactive configuration wizard for Quolar test automation including MCP server validation and directory setup. allowed-tools: Read, Write, Bash(claude:), Bash(npx:), Bash(ls:), Bash(mkdir:) user-invocable: true

Quolar Setup Wizard

Interactive configuration wizard for Quolar test automation.

Quick Overview

Complete 5 phases to set up Quolar:

Total: ~5 minutes

---

Phase 1: Pre-Flight Checks

1.1 Check MCP Servers

List connected servers:

Copy/mcp

1.2 Verify Required Servers

Confirm these servers are connected:

1.3 Install Missing Servers

If servers are missing, guide installation:

Linear MCP (requires LINEAR_API_KEY):

Copy"linear": {
  "command": "npx",
  "args": ["-y", "@linear/mcp-server"],
  "env": { "LINEAR_API_KEY": "lin_api_xxx" }
}

Quoth MCP:

Copyclaude mcp add --transport http quoth https://quoth.ai-innovation.site/api/mcp

Exolar MCP (optional):

Copyclaude mcp add exolar-qa --transport http https://exolar.ai-innovation.site/api/mcp/mcp -s user

See references/mcp-setup.md for detailed setup instructions.

---

Phase 2: Configuration File

2.1 Check for Existing Config

Copyls quolar.config.ts 2>/dev/null || echo "No config found"

2.2 Gather Information

If config missing, ask user for:

1. Linear workspace name (e.g., "attorneyshare")
2. Test directory path (default: ./automation/playwright/tests)
3. Playwright config path (default: ./playwright.config.ts)

2.3 Generate Configuration

Create quolar.config.ts:

Copyimport { defineConfig } from '@quolar/core'

export default defineConfig({
  testFramework: {
    provider: 'playwright',
    config: './playwright.config.ts',
    testDir: './automation/playwright/tests'
  },
  tickets: {
    provider: 'linear',
    workspace: '{user-provided-workspace}'
  },
  documentation: {
    provider: 'quoth'
  },
  analytics: {
    provider: 'exolar'
  },
  workflow: {
    maxHealingAttempts: 3
  }
})

---

Phase 3: Directory Setup

Create required directories:

Copymkdir -p automation/playwright/tests
mkdir -p automation/playwright/page-objects
mkdir -p automation/playwright/utils
mkdir -p docs/test-analysis
mkdir -p docs/test-plans

---

Phase 4: Verification

4.1 Test Linear Connection

Copymcp__linear__list_issues({ first: 1 })

Verify workspace is accessible.

4.2 Test Quoth Connection

Copymcp__quoth__quoth_search_index({ query: "playwright test patterns" })

Verify documentation access.

4.3 Test Playwright Setup

Copynpx playwright --version

If not installed:

Copynpm install -D @playwright/test
npx playwright install

---

Phase 5: Success Summary

Display completion status:

Copy===================================
     Quolar Setup Complete!
===================================

MCP Servers:
  [x] linear - Connected (workspace: {workspace})
  [x] quoth - Connected
  [ ] exolar - Not configured (optional)

Configuration:
  [x] quolar.config.ts created

Directories:
  [x] automation/playwright/tests/
  [x] automation/playwright/page-objects/
  [x] docs/test-analysis/
  [x] docs/test-plans/

Playwright:
  [x] Version: {version}

===================================
         Next Steps
===================================

1. Run: /test-ticket <your-ticket-id>
2. See: skills/test-ticket/SKILL.md for full docs
3. Optional: Configure Exolar for test analytics

---

Additional Resources

Reference Files

• references/mcp-setup.md - Detailed MCP server setup instructions
• references/troubleshooting.md - Common issues and solutions

Related Documentation

• ../test-ticket/SKILL.md - Main test automation workflow
• ../test-ticket/reference.md - Full configuration options