qa-skills 3.0.0

package/README.md

@@ -0,0 +1,168 @@
+# qa-skills
+
+Interactive CLI installer for the **QA Skills Ecosystem** — install 56 specialized QA agent skills into Cursor, Claude Code, Codex, Cline, GitHub Copilot, Windsurf, and more.
+
+## Quick Start
+
+```bash
+npx qa-skills init
+```
+
+Or install globally:
+
+```bash
+npm install -g qa-skills
+qa-skills init
+```
+
+Running bare `qa-skills` is equivalent to `qa-skills init`.
+
+## Features
+
+- **Single `init` command** — one entry point for fresh machines and existing setups
+- **Skills bundled** — works offline, no need to clone the repo first
+- **Interactive prompts** — select skills with descriptions, grouped by category
+- **Multi-agent support** — install to 11+ coding agents simultaneously
+- **Dependency suggestions** — notifies when selected skills work best with companions
+- **Symlink / Copy** — symlink (recommended) for single source of truth, or copy for independence
+- **Project / Global scope** — install per-project or user-wide
+- **MCP configuration** — optionally configure Playwright, GitHub, Filesystem MCP servers
+- **Project structure rule** — maps each skill to an output directory via `AGENTS.md`
+- **Non-interactive mode** — CLI flags for CI/CD automation
+
+## Agent Support
+
+| Agent | `--agent` flag | Project Path | Global Path |
+|-------|---------------|--------------|-------------|
+| Cursor | `cursor` | `.cursor/skills/` | `~/.cursor/skills/` |
+| Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
+| Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
+| Cline | `cline` | `.agents/skills/` | `~/.agents/skills/` |
+| GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
+| Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
+| OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |
+| Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
+| Amp | `amp` | `.agents/skills/` | `~/.config/agents/skills/` |
+| VS Code | `vscode` | `.agents/skills/` | — |
+
+## CLI Options
+
+```
+qa-skills init [options]
+
+Options:
+  -a, --agent <agents...>   Target specific agents (e.g., cursor claude-code)
+  -s, --skill <skills...>   Install specific skills by name
+  -g, --global              Install to user home directory instead of project
+  --copy                    Copy files instead of symlinking
+  -y, --yes                 Skip all confirmation prompts
+  -l, --list                List available skills without installing
+  -V, --version             Output version number
+  -h, --help                Display help
+```
+
+### Examples
+
+```bash
+# Interactive — pick skills, agents, options
+qa-skills init
+
+# List available skills
+qa-skills init --list
+
+# Install specific skills to Cursor (non-interactive)
+qa-skills init -a cursor -s playwright-ts-writer jest-writer -y
+
+# Install all skills to multiple agents
+qa-skills init -a cursor claude-code codex -y
+
+# Install globally with copy method
+qa-skills init -g --copy -a cursor -s orchestrator -y
+
+# Shorthand (init is the default command)
+qa-skills -a cursor -s jest-writer -y
+```
+
+## Skill Categories
+
+| Category | Count | Skills |
+|----------|-------|--------|
+| Documentation & Planning | 8 | requirements-generator, spec-writer, nfr-analyst, api-contract-curator, plan-creator, diagram-generator, test-strategy, test-doc-compiler |
+| Test Case Design | 4 | testcase-from-docs, testcase-from-ui, browser-data-collector, manual-test-designer |
+| TypeScript Test Writers | 7 | jest-writer, vitest-writer, playwright-ts-writer, cypress-writer, webdriverio-writer, codeceptjs-writer, supertest-writer |
+| Python Test Writers | 5 | pytest-writer, playwright-py-writer, selenium-py-writer, robot-framework-writer, httpx-writer |
+| Java Test Writers | 4 | junit5-writer, selenium-java-writer, rest-assured-writer, spring-test-writer |
+| Performance & Specialized | 8 | k6-writer, locust-writer, jmeter-writer, security-test-writer, accessibility-test-writer, visual-regression-writer, pact-writer, mobile-test-writer |
+| Reporting & Analysis | 6 | test-reporter, coverage-analyzer, bug-ticket-creator, task-creator, risk-analyzer, spec-auditor |
+| Orchestration | 1 | orchestrator |
+| Support & Maintenance | 7 | test-healer, changelog-analyzer, flaky-detector, test-reviewer, data-factory, environment-checker, discovery-interview |
+| Integrations | 6 | qase-integration, github-issues-enhanced, jira-integration, linear-integration, clickup-integration, shortcut-integration |
+
+## Dependency System
+
+Skills can recommend companions. After selection, the installer checks for missing recommendations:
+
+```
+Some selected skills work best with additional skills:
+
+  qa-task-creator recommends qa-bug-ticket-creator
+    Paired mode: auto-create linked fix tasks from bug tickets
+
+  Add recommended skills? (space to toggle, enter to confirm)
+    [x] qa-bug-ticket-creator
+```
+
+## Project Structure Rule
+
+When enabled, the installer maps each skill to its output directory in two locations:
+
+1. **`AGENTS.md`** (project root) — always committed to git, readable by all agents
+2. **`.cursor/rules/qa-project-structure.mdc`** — only written if `.cursor/` is **not** in `.gitignore`
+
+```
+docs/requirements/    <- qa-requirements-generator
+docs/specs/           <- qa-spec-writer
+docs/plans/           <- qa-plan-creator, qa-test-strategy
+tests/e2e/            <- qa-playwright-ts-writer, qa-cypress-writer, ...
+reports/test-runs/    <- qa-test-reporter
+```
+
+Directories are created on-demand by skills — no empty folders are pre-created.
+
+## Gitignore Handling
+
+Many teams gitignore `.cursor/`, `.windsurf/`, etc. The installer handles this gracefully:
+
+| Artifact | `.cursor/` gitignored | `.cursor/` committed |
+|----------|----------------------|---------------------|
+| Skills | Installed locally, each dev runs `qa-skills init` | Committed with project |
+| Structure rule | Written to `AGENTS.md` only | Written to both `AGENTS.md` and `.cursor/rules/` |
+| MCP config | Installed locally | Committed with project |
+
+When `.cursor/` is gitignored, the installer shows a notice:
+```
+  warning .cursor/skills is in .gitignore — each developer must install individually
+```
+
+## Source Resolution
+
+The installer finds skills in this priority order:
+
+1. `QA_SKILLS_SOURCE` env var (explicit override)
+2. Monorepo sibling: `../.cursor/skills/` (author developing locally)
+3. Bundled: `skills/` inside the npm package (fresh machine via `npx`)
+
+## skills.sh Compatibility
+
+This repo is also compatible with the [skills.sh](https://skills.sh) ecosystem:
+
+```bash
+npx skills add owner/qa-skills
+```
+
+The `.cursor/skills/` directory is auto-discovered by the `skills` CLI.
+
+## License
+
+GPL-3.0 — see [LICENSE](../LICENSE)

package/bin/cli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+
+const initCmd = program
+  .name('qa-skills')
+  .description('QA Skills Ecosystem — install agent skills into Cursor, Claude Code, Codex, and more')
+  .version('3.0.0');
+
+initCmd
+  .command('init', { isDefault: true })
+  .description('Initialize QA skills in your project (default command)')
+  .option('-a, --agent <agents...>', 'Target specific agents (e.g., cursor, claude-code)')
+  .option('-s, --skill <skills...>', 'Install specific skills by name')
+  .option('-g, --global', 'Install to user home directory instead of project')
+  .option('--copy', 'Copy files instead of symlinking')
+  .option('-y, --yes', 'Skip all confirmation prompts')
+  .option('-l, --list', 'List available skills without installing')
+  .action(async (opts) => {
+    const { listSkills, runInteractive, runNonInteractive } = await import('../dist/installer.js');
+
+    if (opts.list) {
+      await listSkills();
+    } else if (opts.yes || (opts.agent && opts.skill)) {
+      await runNonInteractive({
+        agents: opts.agent,
+        skills: opts.skill,
+        global: opts.global,
+        copy: opts.copy,
+        yes: opts.yes,
+      });
+    } else {
+      await runInteractive({
+        agents: opts.agent,
+        skills: opts.skill,
+        global: opts.global,
+        copy: opts.copy,
+      });
+    }
+  });
+
+program.parse();

package/dist/agents/registry.d.ts

@@ -0,0 +1,5 @@
+import type { AgentConfig } from './types.js';
+export declare const AGENT_REGISTRY: AgentConfig[];
+export declare function getAgentById(id: string): AgentConfig | undefined;
+export declare function resolveGlobalPath(globalPath: string): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/agents/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,WAAW,EAyFvC,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM5D"}

package/dist/agents/registry.js

@@ -0,0 +1,101 @@
+export const AGENT_REGISTRY = [
+    {
+        id: 'cursor',
+        name: 'Cursor',
+        projectSkillsPath: '.cursor/skills',
+        globalSkillsPath: '~/.cursor/skills',
+        rulesPath: '.cursor/rules',
+        mcpPath: '.cursor/mcp.json',
+    },
+    {
+        id: 'claude-code',
+        name: 'Claude Code',
+        projectSkillsPath: '.claude/skills',
+        globalSkillsPath: '~/.claude/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'codex',
+        name: 'Codex',
+        projectSkillsPath: '.agents/skills',
+        globalSkillsPath: '~/.codex/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'cline',
+        name: 'Cline',
+        projectSkillsPath: '.agents/skills',
+        globalSkillsPath: '~/.agents/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'github-copilot',
+        name: 'GitHub Copilot',
+        projectSkillsPath: '.agents/skills',
+        globalSkillsPath: '~/.copilot/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'windsurf',
+        name: 'Windsurf',
+        projectSkillsPath: '.windsurf/skills',
+        globalSkillsPath: '~/.codeium/windsurf/skills',
+        rulesPath: '.windsurf/rules',
+        mcpPath: '.windsurf/mcp.json',
+    },
+    {
+        id: 'roo',
+        name: 'Roo Code',
+        projectSkillsPath: '.roo/skills',
+        globalSkillsPath: '~/.roo/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'opencode',
+        name: 'OpenCode',
+        projectSkillsPath: '.agents/skills',
+        globalSkillsPath: '~/.config/opencode/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'gemini-cli',
+        name: 'Gemini CLI',
+        projectSkillsPath: '.agents/skills',
+        globalSkillsPath: '~/.gemini/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'amp',
+        name: 'Amp',
+        projectSkillsPath: '.agents/skills',
+        globalSkillsPath: '~/.config/agents/skills',
+        rulesPath: null,
+        mcpPath: null,
+    },
+    {
+        id: 'vscode',
+        name: 'VS Code',
+        projectSkillsPath: '.agents/skills',
+        globalSkillsPath: null,
+        rulesPath: null,
+        mcpPath: null,
+    },
+];
+export function getAgentById(id) {
+    return AGENT_REGISTRY.find((a) => a.id === id);
+}
+export function resolveGlobalPath(globalPath) {
+    if (globalPath.startsWith('~/')) {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        return globalPath.replace('~', home);
+    }
+    return globalPath;
+}
+//# sourceMappingURL=registry.js.map

package/dist/agents/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,kBAAkB;QACpC,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,kBAAkB;KAC5B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,kBAAkB;QACpC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,iBAAiB;QACnC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,kBAAkB;QACpC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,mBAAmB;QACrC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,iBAAiB,EAAE,kBAAkB;QACrC,gBAAgB,EAAE,4BAA4B;QAC9C,SAAS,EAAE,iBAAiB;QAC5B,OAAO,EAAE,oBAAoB;KAC9B;IACD;QACE,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,UAAU;QAChB,iBAAiB,EAAE,aAAa;QAChC,gBAAgB,EAAE,eAAe;QACjC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,2BAA2B;QAC7C,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,kBAAkB;QACpC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK;QACX,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,yBAAyB;QAC3C,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,SAAS;QACf,iBAAiB,EAAE,gBAAgB;QACnC,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAC/D,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,9 @@
+export interface AgentConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly projectSkillsPath: string;
+    readonly globalSkillsPath: string | null;
+    readonly rulesPath: string | null;
+    readonly mcpPath: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC"}

package/dist/agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":""}

package/dist/dependencies.d.ts

@@ -0,0 +1,21 @@
+export interface SkillDependency {
+    recommended: string[];
+    reason: string;
+}
+/**
+ * Dependency map: skill ID (without qa- prefix) -> recommended companion skills.
+ * Only lists strong/moderate pairings where skills genuinely enhance each other.
+ * Pipeline-upstream skills (e.g. every writer recommending testcase-from-docs) are omitted.
+ */
+export declare const SKILL_DEPENDENCIES: Record<string, SkillDependency>;
+export interface DependencySuggestion {
+    requiredBy: string;
+    skillId: string;
+    reason: string;
+}
+/**
+ * Given a list of selected skill IDs (without qa- prefix),
+ * returns suggestions for missing recommended companions.
+ */
+export declare function resolveDependencies(selectedIds: string[]): DependencySuggestion[];
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../src/dependencies.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA6F9D,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAsBjF"}

package/dist/dependencies.js

@@ -0,0 +1,125 @@
+/**
+ * Dependency map: skill ID (without qa- prefix) -> recommended companion skills.
+ * Only lists strong/moderate pairings where skills genuinely enhance each other.
+ * Pipeline-upstream skills (e.g. every writer recommending testcase-from-docs) are omitted.
+ */
+export const SKILL_DEPENDENCIES = {
+    'requirements-generator': {
+        recommended: ['discovery-interview'],
+        reason: 'Auto-delegates when input is insufficient (<3 sentences)',
+    },
+    'spec-writer': {
+        recommended: ['requirements-generator'],
+        reason: 'Transforms requirements into detailed specs',
+    },
+    'plan-creator': {
+        recommended: ['diagram-generator'],
+        reason: 'Embeds diagrams into plans (Gantt, flowchart)',
+    },
+    'test-strategy': {
+        recommended: ['diagram-generator', 'risk-analyzer'],
+        reason: 'Uses diagrams for visualization and risk data for prioritization',
+    },
+    'test-doc-compiler': {
+        recommended: ['test-reporter'],
+        reason: 'Aggregates test reports into ISO 29119-3 documents',
+    },
+    'testcase-from-docs': {
+        recommended: ['requirements-generator', 'spec-writer'],
+        reason: 'Best results when fed structured requirements/specs',
+    },
+    'testcase-from-ui': {
+        recommended: ['browser-data-collector'],
+        reason: 'Browser data collector provides page structure for test case generation',
+    },
+    'task-creator': {
+        recommended: ['bug-ticket-creator'],
+        reason: 'Paired mode: auto-create linked fix tasks from bug tickets',
+    },
+    'bug-ticket-creator': {
+        recommended: ['task-creator', 'github-issues-enhanced'],
+        reason: 'Create GitHub Issues and linked fix tasks',
+    },
+    'spec-auditor': {
+        recommended: ['requirements-generator', 'spec-writer'],
+        reason: 'Compares live behavior against requirement and spec docs',
+    },
+    'risk-analyzer': {
+        recommended: ['coverage-analyzer'],
+        reason: 'Uses coverage data in risk formula: Risk = Complexity x ChangeFreq x (1 - Coverage)',
+    },
+    'flaky-detector': {
+        recommended: ['test-healer'],
+        reason: 'Test healer auto-fixes issues that flaky detector identifies',
+    },
+    'orchestrator': {
+        recommended: ['diagram-generator', 'discovery-interview'],
+        reason: 'Orchestrator chains depend on these embedded services',
+    },
+    'pact-writer': {
+        recommended: ['api-contract-curator'],
+        reason: 'Contract tests work best with formalized API contracts',
+    },
+    'supertest': {
+        recommended: ['api-contract-curator'],
+        reason: 'API tests benefit from structured OpenAPI contracts',
+    },
+    'httpx': {
+        recommended: ['api-contract-curator'],
+        reason: 'API tests benefit from structured OpenAPI contracts',
+    },
+    'rest-assured': {
+        recommended: ['api-contract-curator'],
+        reason: 'API tests benefit from structured OpenAPI contracts',
+    },
+    'github-issues-enhanced': {
+        recommended: ['bug-ticket-creator'],
+        reason: 'Enhanced GitHub workflows work with structured bug reports',
+    },
+    'jira-integration': {
+        recommended: ['bug-ticket-creator', 'task-creator'],
+        reason: 'Syncs bug tickets and tasks to Jira issues',
+    },
+    'linear-integration': {
+        recommended: ['bug-ticket-creator', 'task-creator'],
+        reason: 'Syncs bug tickets and tasks to Linear issues',
+    },
+    'clickup-integration': {
+        recommended: ['bug-ticket-creator', 'task-creator'],
+        reason: 'Syncs bug tickets and tasks to ClickUp tasks',
+    },
+    'shortcut-integration': {
+        recommended: ['bug-ticket-creator', 'task-creator'],
+        reason: 'Syncs bug tickets and tasks to Shortcut stories',
+    },
+    'qase-integration': {
+        recommended: ['testcase-from-docs', 'test-reporter'],
+        reason: 'Syncs test cases and results with Qase.io TMS',
+    },
+};
+/**
+ * Given a list of selected skill IDs (without qa- prefix),
+ * returns suggestions for missing recommended companions.
+ */
+export function resolveDependencies(selectedIds) {
+    const selectedSet = new Set(selectedIds);
+    const suggestions = [];
+    const alreadySuggested = new Set();
+    for (const id of selectedIds) {
+        const dep = SKILL_DEPENDENCIES[id];
+        if (!dep)
+            continue;
+        for (const rec of dep.recommended) {
+            if (!selectedSet.has(rec) && !alreadySuggested.has(rec)) {
+                suggestions.push({
+                    requiredBy: id,
+                    skillId: rec,
+                    reason: dep.reason,
+                });
+                alreadySuggested.add(rec);
+            }
+        }
+    }
+    return suggestions;
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../src/dependencies.ts"],"names":[],"mappings":"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"}

package/dist/installer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * qa-skills v3 — Interactive CLI for installing QA Skills into coding agents.
+ * Single entry point: `qa-skills init` (or bare `qa-skills`).
+ * Skills are bundled with the npm package for zero-config usage on fresh machines.
+ */
+export interface SkillInfo {
+    id: string;
+    dirName: string;
+    name: string;
+    description: string;
+    category: string;
+}
+export interface InstallerOptions {
+    agents?: string[];
+    skills?: string[];
+    global?: boolean;
+    copy?: boolean;
+    yes?: boolean;
+    list?: boolean;
+}
+export declare const SKILL_CATEGORIES: Record<string, string[]>;
+export declare function listSkills(): Promise<void>;
+export declare function runInteractive(opts?: InstallerOptions): Promise<void>;
+export declare function runNonInteractive(opts: InstallerOptions): Promise<void>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6BH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAyCrD,CAAC;AA8LF,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBhD;AAID,wBAAsB,cAAc,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8M/E;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD7E"}