Add support for copilot

Author: gabrielmpetrescu

CLAUDE.md

@@ -63,7 +63,7 @@ src/aidocs_cli/
 ### Key Components
 
 - **CLI (cli.py)**: Uses Typer with Rich for terminal UI. Entry point is `app()`.
-- **Installer**: Copies command/workflow templates to target project's `.claude/` directory (or `.cursor/` for Cursor).
+- **Installer**: Copies command/workflow templates to target project's `.claude/` or `.cursor/` directory. For GitHub Copilot, installs skills to `~/.copilot/skills/` (global installation).
 - **Chunker**: Creates `.chunks.json` files alongside markdown, tracks changes via `docs/.chunks/manifest.json`.
 - **Coverage**: Analyzes codebase for routes/components/models, matches against docs, reports coverage with visual progress bars.
 - **Embeddings**: Calls OpenAI API (text-embedding-3-small, 1536 dimensions), outputs `docs/.chunks/sync.sql` for pgvector import.
@@ -72,7 +72,8 @@ src/aidocs_cli/
 ### Slash Commands Flow
 
 When `aidocs init` runs:
-1. Templates from `src/aidocs_cli/templates/` are copied to project's `.claude/commands/docs/` and `.claude/workflows/docs/`
+1. **For Claude/Cursor**: Templates from `src/aidocs_cli/templates/` are copied to project's `.claude/commands/docs/` and `.claude/workflows/docs/` (or `.cursor/` for Cursor)
+2. **For Copilot**: Skills from `src/aidocs_cli/copilot-templates/skills/` are copied to `~/.copilot/skills/` (global installation)
 2. Each command (e.g., `generate.md`) references a workflow that defines the multi-step process
 3. Workflows use Playwright MCP for browser automation when needed
 

README.md

@@ -180,19 +180,22 @@ aidocs init . --force          # Reinstall commands in project
 Initialize the docs module in a project.
 
 ```bash
-aidocs init .                  # Current directory
-aidocs init my-project         # New directory
+aidocs init .                  # Current directory (Claude)
+aidocs init my-project         # New directory (Claude)
 aidocs init . --force          # Overwrite existing
-aidocs init . --ai cursor      # Use with Cursor
+aidocs init . --ai cursor      # Use with Cursor IDE
+aidocs init . --ai copilot     # Use with GitHub Copilot (installs to ~/.copilot)
 ```
 
 **Options:**
 | Option | Description |
 |--------|-------------|
-| `--ai` | AI assistant: `claude`, `cursor`, `copilot` (default: `claude`) |
+| `--ai` | AI assistant: `claude` (project-local), `cursor` (project-local), `copilot` (global ~/.copilot) - default: `claude` |
 | `--force, -f` | Overwrite existing files |
 | `--no-git` | Skip git initialization |
 
+**Note:** Copilot mode installs skills globally to `~/.copilot/skills/` instead of the project directory.
+
 ### `aidocs check`
 
 Check for required tools and dependencies.

src/aidocs_cli/cli.py

@@ -76,11 +76,16 @@ def init(
     """Initialize docs module in a project.
 
     Examples:
-        aidocs init .              # Current directory
-        aidocs init my-project     # New directory
-        aidocs init . --force      # Overwrite existing
+        aidocs init .                # Current directory (Claude)
+        aidocs init my-project       # New directory (Claude)
+        aidocs init . --ai cursor    # For Cursor IDE
+        aidocs init . --ai copilot   # For GitHub Copilot (installs to ~/.copilot)
+        aidocs init . --force        # Overwrite existing
     """
-    if project_name is None or project_name == ".":
+    if ai == "copilot":
+        # For copilot, target_dir is not used (installs to ~/.copilot)
+        console.print(f"[blue]Installing Copilot skills to ~/.copilot...[/blue]")
+    elif project_name is None or project_name == ".":
         target_dir = Path.cwd()
         console.print(f"[blue]Initializing docs module in current directory...[/blue]")
     else:
@@ -89,20 +94,39 @@ def init(
             target_dir.mkdir(parents=True)
             console.print(f"[blue]Created directory: {project_name}[/blue]")
         console.print(f"[blue]Initializing docs module in {project_name}...[/blue]")
+    
+    # Set target_dir to current directory if not set (for copilot case)
+    if 'target_dir' not in locals():
+        target_dir = Path.cwd()
 
     try:
         install_docs_module(target_dir, ai=ai, force=force, no_git=no_git)
 
         console.print()
-        console.print(Panel.fit(
-            "[green]Docs module installed successfully![/green]\n\n"
-            "[bold]Next steps:[/bold]\n"
-            "1. Run [cyan]/docs:init[/cyan] in Claude Code to configure your project\n"
-            "2. Run [cyan]/docs:generate <url>[/cyan] to document a page\n\n"
-            "[dim]Requires Playwright MCP for browser automation.[/dim]",
-            title="Success",
-            border_style="green",
-        ))
+        if ai == "copilot":
+            console.print(Panel.fit(
+                "[green]Copilot skills installed successfully![/green]\n\n"
+                "[bold]Location:[/bold] ~/.copilot/skills/\n\n"
+                "[bold]Available skills:[/bold]\n"
+                "• /docs-generate - Generate documentation from URL\n"
+                "• /docs-init - Initialize documentation structure\n"
+                "• /docs-analyze - Analyze documentation coverage\n"
+                "• /docs-flow - Document user flows\n"
+                "• And more...\n\n"
+                "[dim]Use these skills in GitHub Copilot CLI with / prefix[/dim]",
+                title="Success",
+                border_style="green",
+            ))
+        else:
+            console.print(Panel.fit(
+                "[green]Docs module installed successfully![/green]\n\n"
+                "[bold]Next steps:[/bold]\n"
+                "1. Run [cyan]/docs:init[/cyan] in Claude Code to configure your project\n"
+                "2. Run [cyan]/docs:generate <url>[/cyan] to document a page\n\n"
+                "[dim]Requires Playwright MCP for browser automation.[/dim]",
+                title="Success",
+                border_style="green",
+            ))
     except Exception as e:
         console.print(f"[red]Error: {e}[/red]")
         raise typer.Exit(1)

src/aidocs_cli/copilot-templates/skills/convert_skills.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+for file in *.skill.md; do
+  name="${file%.skill.md}"
+  mkdir -p "$name"
+  
+  # Add YAML frontmatter and move content
+  {
+    echo "---"
+    echo "name: $name"
+    echo "description: |"
+    # Extract first few lines as description
+    head -10 "$file" | sed 's/^/  /'
+    echo "tags: [documentation]"
+    echo "---"
+    echo ""
+    cat "$file"
+  } > "$name/SKILL.md"
+  
+  echo "Created: $name/SKILL.md"
+done

src/aidocs_cli/copilot-templates/skills/docs-analyze.skill.md

@@ -0,0 +1,39 @@
+# Documentation Analysis Skill
+
+Analyze codebase for documentation coverage and specific routes/components.
+
+## What this skill does:
+
+1. Analyzes existing documentation coverage
+2. Identifies undocumented code areas
+3. Performs pure code analysis without requiring browser
+4. Analyzes specific routes or components on request
+
+## Instructions:
+
+Load and execute the workflow from: `.copilot/workflows/docs/analyze/workflow.md` in the project repository.
+
+Follow the workflow instructions exactly as specified in that file.
+
+## Usage Patterns:
+
+The user might say:
+- "analyze documentation coverage"
+- "check what's documented"
+- "analyze the campaigns route"
+- "analyze this component"
+
+## Arguments:
+
+```
+analyze <route>
+analyze --codebase ./src
+analyze app/Http/Controllers/CampaignController.php
+```
+
+## Output:
+
+- Coverage statistics
+- List of undocumented areas
+- Suggestions for improvement
+- Priority recommendations

src/aidocs_cli/copilot-templates/skills/docs-analyze/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: docs:analyze
+description: |
+  # Documentation Analysis Skill
+  
+  Analyze codebase for documentation coverage and specific routes/components.
+  
+  ## What this skill does:
+  
+  1. Analyzes existing documentation coverage
+  2. Identifies undocumented code areas
+  3. Performs pure code analysis without requiring browser
+  4. Analyzes specific routes or components on request
+tags: [documentation]
+---
+
+# Documentation Analysis Skill
+
+Analyze codebase for documentation coverage and specific routes/components.
+
+## What this skill does:
+
+1. Analyzes existing documentation coverage
+2. Identifies undocumented code areas
+3. Performs pure code analysis without requiring browser
+4. Analyzes specific routes or components on request
+
+## Instructions:
+
+Load and execute the workflow from: `.copilot/workflows/docs/analyze/workflow.md` in the project repository.
+
+Follow the workflow instructions exactly as specified in that file.
+
+## Usage Patterns:
+
+The user might say:
+- "analyze documentation coverage"
+- "check what's documented"
+- "analyze the campaigns route"
+- "analyze this component"
+
+## Arguments:
+
+```
+analyze <route>
+analyze --codebase ./src
+analyze app/Http/Controllers/CampaignController.php
+```
+
+## Output:
+
+- Coverage statistics
+- List of undocumented areas
+- Suggestions for improvement
+- Priority recommendations

src/aidocs_cli/copilot-templates/skills/docs-batch.skill.md

@@ -0,0 +1,46 @@
+# Documentation Batch Processing Skill
+
+Generate documentation for multiple pages from a list.
+
+## What this skill does:
+
+1. Batch processes multiple URLs or files
+2. Generates documentation for all items in the list
+3. Handles authentication if needed
+4. Organizes output systematically
+
+## Instructions:
+
+Load and execute the workflow from: `.copilot/workflows/docs/batch/workflow.md` in the project repository.
+
+Follow the workflow instructions exactly as specified in that file.
+
+## Usage Patterns:
+
+The user might say:
+- "batch document these pages"
+- "generate docs for all these URLs"
+- "document multiple pages at once"
+- "batch process this list"
+
+## Arguments:
+
+```
+batch <urls-file-or-list>
+batch urls.txt --auth user:pass
+batch --output ./docs
+```
+
+## Input Format:
+
+Can accept:
+- File containing URLs (one per line)
+- Comma-separated list of URLs
+- JSON array of URLs
+
+## Output:
+
+- Documentation for each URL/file
+- Summary report
+- Progress tracking
+- Error reporting for failed items

src/aidocs_cli/copilot-templates/skills/docs-batch/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: docs:batch
+description: |
+  # Documentation Batch Processing Skill
+  
+  Generate documentation for multiple pages from a list.
+  
+  ## What this skill does:
+  
+  1. Batch processes multiple URLs or files
+  2. Generates documentation for all items in the list
+  3. Handles authentication if needed
+  4. Organizes output systematically
+tags: [documentation]
+---
+
+# Documentation Batch Processing Skill
+
+Generate documentation for multiple pages from a list.
+
+## What this skill does:
+
+1. Batch processes multiple URLs or files
+2. Generates documentation for all items in the list
+3. Handles authentication if needed
+4. Organizes output systematically
+
+## Instructions:
+
+Load and execute the workflow from: `.copilot/workflows/docs/batch/workflow.md` in the project repository.
+
+Follow the workflow instructions exactly as specified in that file.
+
+## Usage Patterns:
+
+The user might say:
+- "batch document these pages"
+- "generate docs for all these URLs"
+- "document multiple pages at once"
+- "batch process this list"
+
+## Arguments:
+
+```
+batch <urls-file-or-list>
+batch urls.txt --auth user:pass
+batch --output ./docs
+```
+
+## Input Format:
+
+Can accept:
+- File containing URLs (one per line)
+- Comma-separated list of URLs
+- JSON array of URLs
+
+## Output:
+
+- Documentation for each URL/file
+- Summary report
+- Progress tracking
+- Error reporting for failed items

src/aidocs_cli/copilot-templates/skills/docs-discover.skill.md

@@ -0,0 +1,46 @@
+# Documentation Discovery Skill
+
+Scan and discover all modules and structure in the JobMatix-API codebase.
+
+## What this skill does:
+
+1. Scans backend for models, controllers, routes
+2. Scans frontend for pages, components
+3. Identifies relationships between modules
+4. Saves analysis to `docs/.knowledge/` directory
+
+## Instructions:
+
+Load and execute the workflow from: `.copilot/workflows/docs/discover/workflow.md` in the project repository.
+
+Follow the workflow instructions exactly as specified in that file.
+
+## Usage Patterns:
+
+The user might say:
+- "discover all modules"
+- "scan the codebase"
+- "map out the application structure"
+- "analyze the project structure"
+
+## Output Structure:
+
+Creates the following in `docs/.knowledge/`:
+```
+docs/.knowledge/
+├── _meta/
+│   ├── project.json
+│   └── modules-index.json
+└── modules/
+    ├── {module-name}/
+    │   ├── entity.json
+    │   ├── routes.json
+    │   ├── components.json
+    │   └── flows/
+```
+
+## Next Steps:
+
+After discovery, suggest running:
+- `/docs:plan` to create documentation plan
+- `/docs:generate` to generate docs for specific modules