diff --git a/gitnexus/src/cli/ai-context.ts b/gitnexus/src/cli/ai-context.ts index 41ba6c73e..f65a91284 100644 --- a/gitnexus/src/cli/ai-context.ts +++ b/gitnexus/src/cli/ai-context.ts @@ -28,6 +28,7 @@ interface RepoStats { export interface AIContextOptions { skipAgentsMd?: boolean; noStats?: boolean; + skipSkills?: boolean; } const GITNEXUS_START_MARKER = ''; @@ -337,10 +338,14 @@ export async function generateAIContextFiles( createdFiles.push('CLAUDE.md (skipped via --skip-agents-md)'); } - // Install skills to .claude/skills/gitnexus/ - const installedSkills = await installSkills(repoPath); - if (installedSkills.length > 0) { - createdFiles.push(`.claude/skills/gitnexus/ (${installedSkills.length} skills)`); + // Install skills to .claude/skills/gitnexus/ (unless --skip-skills) + if (!options?.skipSkills) { + const installedSkills = await installSkills(repoPath); + if (installedSkills.length > 0) { + createdFiles.push(`.claude/skills/gitnexus/ (${installedSkills.length} skills)`); + } + } else { + createdFiles.push('.claude/skills/gitnexus/ (skipped via --skip-skills)'); } return { files: createdFiles }; diff --git a/gitnexus/src/cli/analyze.ts b/gitnexus/src/cli/analyze.ts index 47745c575..d22592141 100644 --- a/gitnexus/src/cli/analyze.ts +++ b/gitnexus/src/cli/analyze.ts @@ -119,6 +119,10 @@ export interface AnalyzeOptions { skipAgentsMd?: boolean; /** Omit volatile symbol/relationship counts from AGENTS.md and CLAUDE.md. */ noStats?: boolean; + /** Skip installing standard GitNexus skill files to .claude/skills/gitnexus/. */ + skipSkills?: boolean; + /** Pure index mode: skip all file injection (AGENTS.md, CLAUDE.md, skills). */ + indexOnly?: boolean; /** Index the folder even when no .git directory is present. */ skipGit?: boolean; /** @@ -399,6 +403,9 @@ export const analyzeCommand = async (inputPath?: string, options?: AnalyzeOption // ── Run shared analysis orchestrator ─────────────────────────────── try { + const skipAll = options?.indexOnly; + const skipAgentsMd = skipAll || options?.skipAgentsMd; + const skipSkills = skipAll || options?.skipSkills; const result = await runFullAnalysis( repoPath, { @@ -410,7 +417,8 @@ export const analyzeCommand = async (inputPath?: string, options?: AnalyzeOption embeddingsNodeLimit, dropEmbeddings: options?.dropEmbeddings, skipGit: options?.skipGit, - skipAgentsMd: options?.skipAgentsMd, + skipAgentsMd, + skipSkills, noStats: options?.noStats, registryName: options?.name, // Registry-collision bypass — its own CLI flag, intentionally NOT @@ -497,7 +505,7 @@ export const analyzeCommand = async (inputPath?: string, options?: AnalyzeOption processes: s.processes, }, skillResult.skills, - { skipAgentsMd: options?.skipAgentsMd, noStats: options?.noStats }, + { skipAgentsMd, skipSkills, noStats: options?.noStats }, ); } } catch { diff --git a/gitnexus/src/cli/index.ts b/gitnexus/src/cli/index.ts index e4a455d40..47d933c21 100644 --- a/gitnexus/src/cli/index.ts +++ b/gitnexus/src/cli/index.ts @@ -36,6 +36,11 @@ program .option('--skills', 'Generate repo-specific skill files from detected communities') .option('--skip-agents-md', 'Skip updating the gitnexus section in AGENTS.md and CLAUDE.md') .option('--no-stats', 'Omit volatile file/symbol counts from AGENTS.md and CLAUDE.md') + .option( + '--skip-skills', + 'Skip installing standard GitNexus skill files to .claude/skills/gitnexus/', + ) + .option('--index-only', 'Pure index mode: skip all file injection (AGENTS.md, CLAUDE.md, skills)') .option( '--skip-git', 'Treat the provided path/cwd as the index root and skip parent git-root discovery', diff --git a/gitnexus/src/core/run-analyze.ts b/gitnexus/src/core/run-analyze.ts index 7227fd945..fa2757f45 100644 --- a/gitnexus/src/core/run-analyze.ts +++ b/gitnexus/src/core/run-analyze.ts @@ -81,6 +81,8 @@ export interface AnalyzeOptions { skipAgentsMd?: boolean; /** Omit volatile symbol/relationship counts from AGENTS.md and CLAUDE.md. */ noStats?: boolean; + /** Skip installing standard GitNexus skill files to .claude/skills/gitnexus/. */ + skipSkills?: boolean; /** * User-provided alias for the registry `name` (#829). When set, * forwarded to `registerRepo` so the indexed repo is stored under @@ -527,7 +529,11 @@ export async function runFullAnalysis( processes: pipelineResult.processResult?.stats.totalProcesses, }, undefined, - { skipAgentsMd: options.skipAgentsMd, noStats: options.noStats }, + { + skipAgentsMd: options.skipAgentsMd, + skipSkills: options.skipSkills, + noStats: options.noStats, + }, ); } catch { // Best-effort — don't fail the entire analysis for context file issues