Merge branch 'feat/skill-telemetry-tracking'

LLM-powered /learn advisor, /skills package manager, telemetry tracking,
config docs updated in 8 languages, --auto-skill improved with LearnAdvisor.

Author: igorcosta

docs/config-reference.md

@@ -798,17 +798,40 @@ Autohand supports special prefixes in the input prompt:
 
 ### Slash Commands
 
+#### `/skills` — Package Manager
+
 | Command | Description |
 |---------|-------------|
 | `/skills` | List all available skills |
 | `/skills use <name>` | Activate a skill for the current session |
 | `/skills deactivate <name>` | Deactivate a skill |
 | `/skills info <name>` | Show detailed skill information |
+| `/skills install` | Browse and install from community registry |
+| `/skills install @<slug>` | Install a community skill by slug |
+| `/skills search <query>` | Search the community skills registry |
+| `/skills trending` | Show trending community skills |
+| `/skills remove <slug>` | Uninstall a community skill |
 | `/skills new` | Create a new skill interactively |
+| `/skills feedback <slug> <1-5>` | Rate a community skill |
+
+#### `/learn` — LLM-Powered Skill Advisor
+
+| Command | Description |
+|---------|-------------|
+| `/learn` | Analyze project and recommend skills (quick scan) |
+| `/learn --deep` | Deep-scan project (reads source files) for more targeted results |
+| `/learn update` | Re-analyze project and regenerate outdated LLM-generated skills |
 
-### Auto-Skill Generation
+`/learn` uses a two-phase LLM flow:
 
-The `--auto-skill` flag analyzes your project and generates relevant skills:
+1. **Phase 1 — Analyze + Rank + Audit**: Scans your project structure, audits installed skills for redundancy/conflicts, and ranks community skills by relevance (0-100).
+2. **Phase 2 — Generate** (conditional): If no community skill scores above 60, offers to generate a custom skill tailored to your project.
+
+Generated skills include metadata (`agentskill-source: llm-generated`, `agentskill-project-hash`) so `/learn update` can detect when your codebase changes and regenerate stale skills.
+
+### Auto-Skill Generation (`--auto-skill`)
+
+The `--auto-skill` CLI flag generates skills without the interactive advisor flow:
 
 ```bash
 autohand --auto-skill
@@ -817,9 +840,11 @@ autohand --auto-skill
 This will:
 1. Analyze your project structure (package.json, requirements.txt, etc.)
 2. Detect languages, frameworks, and patterns
-3. Generate 3-5 relevant skills using LLM
+3. Generate 3 relevant skills using LLM
 4. Save skills to `<project>/.autohand/skills/`
 
+For a more targeted, interactive experience, use `/learn` inside a session instead.
+
 Detected patterns include:
 - **Languages**: TypeScript, JavaScript, Python, Rust, Go
 - **Frameworks**: React, Next.js, Vue, Express, Flask, Django
@@ -1438,7 +1463,7 @@ These flags override config file settings:
 | `--permissions` | Display current permission settings and exit |
 | `--patch` | Generate git patch without applying changes |
 | `--output <file>` | Output file for patch (used with --patch) |
-| `--auto-skill` | Auto-generate skills based on project analysis |
+| `--auto-skill` | Auto-generate skills based on project analysis (see also `/learn` for interactive advisor) |
 | `-c, --auto-commit` | Auto-commit changes after completing tasks |
 | `--login` | Sign in to your Autohand account |
 | `--logout` | Sign out of your Autohand account |

docs/config-reference_es.md

@@ -467,6 +467,59 @@ También se puede configurar mediante variables de entorno:
 
 ---
 
+## Sistema de Skills
+
+### Comandos Slash
+
+#### `/skills` — Gestor de Paquetes
+
+| Comando | Descripción |
+|---------|-------------|
+| `/skills` | Listar todos los skills disponibles |
+| `/skills use <nombre>` | Activar un skill para la sesión actual |
+| `/skills deactivate <nombre>` | Desactivar un skill |
+| `/skills info <nombre>` | Mostrar información detallada del skill |
+| `/skills install` | Explorar e instalar del registro comunitario |
+| `/skills install @<slug>` | Instalar un skill comunitario por slug |
+| `/skills search <consulta>` | Buscar en el registro de skills comunitarios |
+| `/skills trending` | Mostrar skills comunitarios en tendencia |
+| `/skills remove <slug>` | Desinstalar un skill comunitario |
+| `/skills new` | Crear un nuevo skill interactivamente |
+| `/skills feedback <slug> <1-5>` | Calificar un skill comunitario |
+
+#### `/learn` — Asesor de Skills con LLM
+
+| Comando | Descripción |
+|---------|-------------|
+| `/learn` | Analizar proyecto y recomendar skills (escaneo rápido) |
+| `/learn --deep` | Escaneo profundo del proyecto (lee archivos fuente) para resultados más precisos |
+| `/learn update` | Re-analizar proyecto y regenerar skills LLM generados obsoletos |
+
+`/learn` utiliza un flujo LLM de dos fases:
+
+1. **Fase 1 — Análisis + Ranking + Auditoría**: Escanea la estructura del proyecto, audita skills instalados buscando redundancias/conflictos, y clasifica skills comunitarios por relevancia (0-100).
+2. **Fase 2 — Generación** (condicional): Si ningún skill comunitario obtiene más de 60 puntos, ofrece generar un skill personalizado adaptado a su proyecto.
+
+Los skills generados incluyen metadatos (`agentskill-source: llm-generated`, `agentskill-project-hash`) para que `/learn update` pueda detectar cambios en el código y regenerar skills obsoletos.
+
+### Generación Automática de Skills (`--auto-skill`)
+
+El flag `--auto-skill` genera skills sin el flujo interactivo del asesor:
+
+```bash
+autohand --auto-skill
+```
+
+Esto hará:
+1. Analizar la estructura del proyecto (package.json, requirements.txt, etc.)
+2. Detectar lenguajes, frameworks y patrones
+3. Generar 3 skills relevantes usando LLM
+4. Guardar skills en `<proyecto>/.autohand/skills/`
+
+Para una experiencia interactiva más precisa, use `/learn` dentro de una sesión.
+
+---
+
 ## Ejemplo Completo
 
 ### Formato JSON (`~/.autohand/config.json`)
@@ -640,6 +693,7 @@ Estos flags sobrescriben la configuración del archivo:
 | `--dry-run` | Vista previa sin ejecutar |
 | `--unrestricted` | Sin solicitudes de aprobación |
 | `--restricted` | Denegar operaciones peligrosas |
+| `--auto-skill` | Auto-generar skills basado en análisis del proyecto (ver también `/learn` para asesor interactivo) |
 | `--setup` | Ejecutar el asistente de configuración para configurar o reconfigurar Autohand |
 | `--about` | Mostrar información sobre Autohand (versión, enlaces, información de contribución) |
 | `--sys-prompt <valor>` | Reemplazar completamente el prompt del sistema (cadena en línea o ruta de archivo) |

docs/config-reference_hi.md

@@ -15,6 +15,7 @@
 - [टेलीमेट्री सेटिंग्स](#टेलीमेट्री-सेटिंग्स)
 - [एक्सटर्नल एजेंट्स](#एक्सटर्नल-एजेंट्स)
 - [API सेटिंग्स](#api-सेटिंग्स)
+- [स्किल सिस्टम](#स्किल-सिस्टम)
 - [पूर्ण उदाहरण](#पूर्ण-उदाहरण)
 
 ---
@@ -467,6 +468,57 @@ export AUTOHAND_SKIP_UPDATE_CHECK=1
 
 ---
 
+## स्किल सिस्टम
+
+### स्लैश कमांड
+
+#### `/skills` — पैकेज मैनेजर
+
+| कमांड | विवरण |
+|-------|-------|
+| `/skills` | सभी उपलब्ध स्किल्स की सूची |
+| `/skills use <name>` | वर्तमान सत्र के लिए स्किल सक्रिय करें |
+| `/skills deactivate <name>` | स्किल निष्क्रिय करें |
+| `/skills info <name>` | स्किल की विस्तृत जानकारी दिखाएं |
+| `/skills install` | कम्युनिटी रजिस्ट्री से ब्राउज़ और इंस्टॉल करें |
+| `/skills install @<slug>` | स्लग द्वारा कम्युनिटी स्किल इंस्टॉल करें |
+| `/skills search <query>` | कम्युनिटी स्किल रजिस्ट्री में खोजें |
+| `/skills trending` | ट्रेंडिंग कम्युनिटी स्किल्स दिखाएं |
+| `/skills remove <slug>` | कम्युनिटी स्किल अनइंस्टॉल करें |
+| `/skills new` | इंटरैक्टिव रूप से नया स्किल बनाएं |
+| `/skills feedback <slug> <1-5>` | कम्युनिटी स्किल को रेट करें |
+
+#### `/learn` — LLM-संचालित स्किल सलाहकार
+
+| कमांड | विवरण |
+|-------|-------|
+| `/learn` | प्रोजेक्ट का विश्लेषण करें और स्किल्स की सिफारिश करें (त्वरित स्कैन) |
+| `/learn --deep` | अधिक सटीक परिणामों के लिए डीप-स्कैन (सोर्स फाइलें पढ़ता है) |
+| `/learn update` | प्रोजेक्ट का पुनर्विश्लेषण करें और पुराने LLM-जनित स्किल्स को पुनर्जनित करें |
+
+`/learn` दो-चरणीय LLM फ्लो का उपयोग करता है:
+
+1. **चरण 1 — विश्लेषण + रैंकिंग + ऑडिट**: प्रोजेक्ट संरचना स्कैन करता है, इंस्टॉल किए गए स्किल्स की अतिरेक/विरोध के लिए ऑडिट करता है, और कम्युनिटी स्किल्स को प्रासंगिकता (0-100) के अनुसार रैंक करता है।
+2. **चरण 2 — जनरेशन** (सशर्त): यदि कोई कम्युनिटी स्किल 60 से अधिक स्कोर नहीं करता, तो आपके प्रोजेक्ट के लिए अनुकूलित कस्टम स्किल जनरेट करने का प्रस्ताव देता है।
+
+### स्वचालित स्किल जनरेशन (`--auto-skill`)
+
+`--auto-skill` CLI फ्लैग इंटरैक्टिव सलाहकार फ्लो के बिना स्किल्स जनरेट करता है:
+
+```bash
+autohand --auto-skill
+```
+
+यह करेगा:
+1. प्रोजेक्ट संरचना का विश्लेषण (package.json, requirements.txt, आदि)
+2. भाषाओं, फ्रेमवर्क और पैटर्न का पता लगाना
+3. LLM का उपयोग करके 3 प्रासंगिक स्किल्स जनरेट करना
+4. स्किल्स को `<project>/.autohand/skills/` में सहेजना
+
+अधिक सटीक इंटरैक्टिव अनुभव के लिए, सत्र के अंदर `/learn` का उपयोग करें।
+
+---
+
 ## पूर्ण उदाहरण
 
 ### JSON फॉर्मेट (`~/.autohand/config.json`)
@@ -641,6 +693,7 @@ Autohand `~/.autohand/` (या `$AUTOHAND_HOME`) में डेटा स्
 | `--unrestricted` | कोई अप्रूवल प्रॉम्प्ट नहीं |
 | `--restricted` | खतरनाक ऑपरेशन अस्वीकार करें |
 | `--setup` | Autohand को कॉन्फ़िगर या रीकॉन्फ़िगर करने के लिए सेटअप विज़ार्ड चलाएं |
+| `--auto-skill` | प्रोजेक्ट विश्लेषण के आधार पर स्किल्स स्वचालित रूप से जनरेट करें (`/learn` भी देखें) |
 | `--sys-prompt <मान>` | पूरे सिस्टम प्रॉम्प्ट को बदलें (इनलाइन स्ट्रिंग या फ़ाइल पथ) |
 | `--append-sys-prompt <मान>` | सिस्टम प्रॉम्प्ट में जोड़ें (इनलाइन स्ट्रिंग या फ़ाइल पथ) |
 

docs/config-reference_id.md

@@ -15,6 +15,7 @@ Referensi lengkap untuk semua opsi konfigurasi di `~/.autohand/config.json` (ata
 - [Pengaturan Telemetri](#pengaturan-telemetri)
 - [Agent Eksternal](#agent-eksternal)
 - [Pengaturan API](#pengaturan-api)
+- [Sistem Skill](#sistem-skill)
 - [Contoh Lengkap](#contoh-lengkap)
 
 ---
@@ -467,6 +468,57 @@ Juga dapat diatur melalui variabel lingkungan:
 
 ---
 
+## Sistem Skill
+
+### Perintah Slash
+
+#### `/skills` — Manajer Paket
+
+| Perintah | Deskripsi |
+|----------|-----------|
+| `/skills` | Daftar semua skill yang tersedia |
+| `/skills use <nama>` | Aktifkan skill untuk sesi saat ini |
+| `/skills deactivate <nama>` | Nonaktifkan skill |
+| `/skills info <nama>` | Tampilkan informasi detail skill |
+| `/skills install` | Jelajahi dan instal dari registri komunitas |
+| `/skills install @<slug>` | Instal skill komunitas berdasarkan slug |
+| `/skills search <kueri>` | Cari di registri skill komunitas |
+| `/skills trending` | Tampilkan skill komunitas yang sedang tren |
+| `/skills remove <slug>` | Hapus instalasi skill komunitas |
+| `/skills new` | Buat skill baru secara interaktif |
+| `/skills feedback <slug> <1-5>` | Beri rating skill komunitas |
+
+#### `/learn` — Penasihat Skill Berbasis LLM
+
+| Perintah | Deskripsi |
+|----------|-----------|
+| `/learn` | Analisis proyek dan rekomendasikan skill (pemindaian cepat) |
+| `/learn --deep` | Pemindaian mendalam (membaca file sumber) untuk hasil lebih akurat |
+| `/learn update` | Analisis ulang proyek dan regenerasi skill LLM yang sudah usang |
+
+`/learn` menggunakan alur LLM dua fase:
+
+1. **Fase 1 — Analisis + Peringkat + Audit**: Memindai struktur proyek, mengaudit skill terinstal untuk redundansi/konflik, dan memberi peringkat skill komunitas berdasarkan relevansi (0-100).
+2. **Fase 2 — Generasi** (kondisional): Jika tidak ada skill komunitas yang mendapat skor di atas 60, menawarkan untuk menghasilkan skill kustom yang disesuaikan dengan proyek Anda.
+
+### Generasi Skill Otomatis (`--auto-skill`)
+
+Flag `--auto-skill` menghasilkan skill tanpa alur penasihat interaktif:
+
+```bash
+autohand --auto-skill
+```
+
+Ini akan:
+1. Menganalisis struktur proyek (package.json, requirements.txt, dll.)
+2. Mendeteksi bahasa, framework, dan pola
+3. Menghasilkan 3 skill relevan menggunakan LLM
+4. Menyimpan skill ke `<proyek>/.autohand/skills/`
+
+Untuk pengalaman interaktif yang lebih tepat, gunakan `/learn` dalam sesi.
+
+---
+
 ## Contoh Lengkap
 
 ### Format JSON (`~/.autohand/config.json`)
@@ -643,6 +695,7 @@ Flag-flag ini mengganti pengaturan file konfigurasi:
 | `--setup` | Jalankan wizard setup untuk mengkonfigurasi atau mengkonfigurasi ulang Autohand |
 | `--sys-prompt <nilai>` | Ganti seluruh system prompt (string inline atau path file) |
 | `--append-sys-prompt <nilai>` | Tambahkan ke system prompt (string inline atau path file) |
+| `--auto-skill` | Otomatis menghasilkan skill berdasarkan analisis proyek (lihat juga `/learn` untuk penasihat interaktif) |
 
 ---
 

docs/config-reference_ja.md

@@ -729,17 +729,40 @@ AIエージェントへの詳細な指示...
 
 ### スラッシュコマンド
 
+#### `/skills` — パッケージマネージャー
+
 | コマンド | 説明 |
 |----------|------|
 | `/skills` | 利用可能なすべてのスキルを一覧表示 |
 | `/skills use <name>` | 現在のセッションでスキルをアクティベート |
 | `/skills deactivate <name>` | スキルを非アクティベート |
 | `/skills info <name>` | スキルの詳細情報を表示 |
+| `/skills install` | コミュニティレジストリを閲覧してインストール |
+| `/skills install @<slug>` | スラグでコミュニティスキルをインストール |
+| `/skills search <query>` | コミュニティスキルレジストリを検索 |
+| `/skills trending` | トレンドのコミュニティスキルを表示 |
+| `/skills remove <slug>` | コミュニティスキルをアンインストール |
 | `/skills new` | 対話的に新しいスキルを作成 |
+| `/skills feedback <slug> <1-5>` | コミュニティスキルを評価 |
+
+#### `/learn` — LLMスキルアドバイザー
+
+| コマンド | 説明 |
+|----------|------|
+| `/learn` | プロジェクトを分析してスキルを推薦（クイックスキャン） |
+| `/learn --deep` | ソースファイルを読み取るディープスキャンでより的確な結果を提供 |
+| `/learn update` | プロジェクトを再分析し、古くなったLLM生成スキルを再生成 |
 
-### 自動スキル生成
+`/learn` は2フェーズのLLMフローを使用します：
 
-`--auto-skill` フラグはプロジェクトを分析し、関連するスキルを生成します：
+1. **フェーズ1 — 分析＋ランキング＋監査**: プロジェクト構造をスキャンし、インストール済みスキルの冗長性・競合を監査し、コミュニティスキルを関連性（0-100）でランク付けします。
+2. **フェーズ2 — 生成**（条件付き）: コミュニティスキルのスコアが60以上のものがない場合、プロジェクトに最適なカスタムスキルの生成を提案します。
+
+生成されたスキルにはメタデータ（`agentskill-source: llm-generated`、`agentskill-project-hash`）が含まれ、`/learn update` がコードベースの変更を検出して古いスキルを再生成できます。
+
+### 自動スキル生成（`--auto-skill`）
+
+`--auto-skill` CLIフラグは、対話的なアドバイザーフローなしでスキルを生成します：
 
 ```bash
 autohand --auto-skill
@@ -748,9 +771,11 @@ autohand --auto-skill
 これにより：
 1. プロジェクト構造を分析（package.json、requirements.txtなど）
 2. 言語、フレームワーク、パターンを検出
-3. LLMを使用して3〜5個の関連スキルを生成
+3. LLMを使用して3個の関連スキルを生成
 4. スキルを `<project>/.autohand/skills/` に保存
 
+より的確な対話型体験が必要な場合は、セッション内で `/learn` を使用してください。
+
 検出されるパターン：
 - **言語**: TypeScript、JavaScript、Python、Rust、Go
 - **フレームワーク**: React、Next.js、Vue、Express、Flask、Django
@@ -1176,7 +1201,7 @@ Autohandは `~/.autohand/`（または `$AUTOHAND_HOME`）にデータを保存
 | `--permissions` | 現在の権限設定を表示して終了 |
 | `--patch` | 変更を適用せずにgitパッチを生成 |
 | `--output <file>` | パッチの出力ファイル（--patchと併用） |
-| `--auto-skill` | プロジェクト分析に基づいてスキルを自動生成 |
+| `--auto-skill` | プロジェクト分析に基づいてスキルを自動生成（対話型は `/learn` を参照） |
 | `-c, --auto-commit` | タスク完了後に変更を自動コミット |
 | `--login` | Autohandアカウントにサインイン |
 | `--logout` | Autohandアカウントからサインアウト |