cli-ai-skills 1.7.1 → 1.7.3

package/README.md

@@ -1,10 +1,10 @@
-# cli-ai-skills v1.7.1
+# cli-ai-skills v1.7.2
 
 🚀 **NPX Installer for AI Skills**
 
 Install reusable skills for GitHub Copilot CLI, Claude Code, OpenAI Codex, OpenCode, and Gemini CLI in one command.
 
-![Version](https://img.shields.io/badge/version-1.7.1-blue.svg)
+![Version](https://img.shields.io/badge/version-1.7.2-blue.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 ![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)
 

package/bin/cli.js

@@ -12,11 +12,15 @@ const { listBundles, validateBundle } = require('../lib/bundles');
 const { searchSkills } = require('../lib/search');
 const { displayToolsTable } = require('../lib/ui/table');
 const { checkInstalledVersion, isUpdateAvailable } = require('../lib/version-checker');
+const { getSkillVersion } = require('../lib/utils/skill-versions');
+const { getSkillsBasePath } = require('../lib/utils/path-resolver');
 const chalk = require('chalk');
 const inquirer = require('inquirer');
 const path = require('path');
 
-const VERSION = '1.6.0';
+// Read version dynamically from package.json
+const packageJson = require('../package.json');
+const VERSION = packageJson.version;
 
 // Command aliases
 const commandAliases = {
@@ -120,7 +124,7 @@ async function main() {
       process.exit(0);
     }
     
-    const repoPath = path.resolve(__dirname, '../..');
+    const repoPath = getSkillsBasePath(__dirname);
     const quiet = args.includes('-q') || args.includes('--quiet');
     
     if (!quiet) {
@@ -238,7 +242,7 @@ async function main() {
     
     console.log(chalk.cyan(`\n📦 Instalando skills para: ${platforms.join(', ')}\n`));
     
-    const repoPath = path.resolve(__dirname, '../..');
+    const repoPath = getSkillsBasePath(__dirname);
     const quiet = args.includes('-q') || args.includes('--quiet');
     
     // Install for selected platforms
@@ -261,11 +265,6 @@ async function main() {
     if (platforms.includes('gemini')) {
       installGeminiSkills(repoPath, null, quiet);
     }
-    }
-    
-    if (platforms.includes('codex')) {
-      installCodexSkills(repoPath, null, quiet);
-    }
     
     if (!quiet) {
       console.log(chalk.green(`\n✅ Instalação concluída com sucesso!\n`));
@@ -277,10 +276,16 @@ async function main() {
   switch(command) {
     case 'list':
       console.log('📋 Installed Skills:\n');
-      console.log('  • skill-creator (v1.3.0)');
-      console.log('  • prompt-engineer (v1.1.0)');
-      console.log('  • youtube-summarizer (v1.2.0)');
-      console.log('  • audio-transcriber (v1.2.0)\n');
+
+      // Get repo path (works both in npm package and git repo)
+      const repoPath = getSkillsBasePath(__dirname);
+      const skills = ['skill-creator', 'prompt-engineer', 'youtube-summarizer', 'audio-transcriber'];
+
+      skills.forEach(skill => {
+        const version = getSkillVersion(skill, repoPath);
+        console.log(`  • ${skill} (v${version})`);
+      });
+      console.log();
       break;
       
     case 'update':

package/lib/claude.js

@@ -1,10 +1,11 @@
 const fs = require('fs-extra');
 const path = require('path');
 const os = require('os');
+const { getSkillsSourcePath, getUserSkillsPath } = require('./utils/path-resolver');
 
 function installClaudeSkills(repoPath) {
-  const skillsSource = path.join(repoPath, '.claude', 'skills');
-  const skillsTarget = path.join(os.homedir(), '.claude', 'skills');
+  const skillsSource = getSkillsSourcePath(repoPath, 'claude');
+  const skillsTarget = getUserSkillsPath('claude');
   
   console.log('🔧 Installing Claude Code skills...');
   

package/lib/codex.js

@@ -1,8 +1,9 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { getSkillsSourcePath, getUserSkillsPath } = require('./utils/path-resolver');
 
-const CODEX_SKILLS_DIR = path.join(os.homedir(), '.codex', 'skills');
+const CODEX_SKILLS_DIR = getUserSkillsPath('codex');
 
 /**
  * Instala skills para OpenAI Codex
@@ -10,8 +11,8 @@ const CODEX_SKILLS_DIR = path.join(os.homedir(), '.codex', 'skills');
  */
 function install(repoPath) {
   console.log('\n📦 Instalando skills para OpenAI Codex...');
-  
-  const skillsSource = path.join(repoPath, '.codex', 'skills');
+
+  const skillsSource = getSkillsSourcePath(repoPath, 'codex');
   
   if (!fs.existsSync(skillsSource)) {
     console.error('❌ Erro: .codex/skills/ não encontrado no repositório');

package/lib/commands/install.js

@@ -9,8 +9,11 @@ const InstallationPrompts = require('../ui/prompts');
 const ProgressGauge = require('../ui/progress-gauge');
 const path = require('path');
 
+// Read version dynamically from package.json
+const packageJson = require('../../package.json');
+
 async function installCommand(skillNames, options) {
-  console.log(chalk.cyan.bold('\n🤖 CLI AI Skills Installer v1.0.0\n'));
+  console.log(chalk.cyan.bold(`\n🤖 CLI AI Skills Installer v${packageJson.version}\n`));
 
   // Initialize progress gauge (5 main steps)
   const gauge = new ProgressGauge(5);

package/lib/copilot.js

@@ -1,10 +1,11 @@
 const fs = require('fs-extra');
 const path = require('path');
 const os = require('os');
+const { getSkillsSourcePath, getUserSkillsPath } = require('./utils/path-resolver');
 
 function installCopilotSkills(repoPath) {
-  const skillsSource = path.join(repoPath, '.github', 'skills');
-  const skillsTarget = path.join(os.homedir(), '.github', 'skills');
+  const skillsSource = getSkillsSourcePath(repoPath, 'copilot');
+  const skillsTarget = getUserSkillsPath('copilot');
   
   console.log('🔧 Installing GitHub Copilot CLI skills...');
   

package/lib/gemini.js

@@ -2,6 +2,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
 const os = require('os');
+const { getSkillsSourcePath, getUserSkillsPath } = require('./utils/path-resolver');
 
 /**
  * Install skills for Gemini CLI
@@ -10,13 +11,12 @@ const os = require('os');
  * @param {boolean} quiet - Suppress output
  */
 function install(repoPath, skills = null, quiet = false) {
-  const homeDir = os.homedir();
-  const targetDir = path.join(homeDir, '.gemini', 'skills');
-  
+  const targetDir = getUserSkillsPath('gemini');
+
   // Criar diretório se não existir
   fs.ensureDirSync(targetDir);
-  
-  const sourceDir = path.join(repoPath, '.gemini', 'skills');
+
+  const sourceDir = getSkillsSourcePath(repoPath, 'gemini');
   
   if (!fs.existsSync(sourceDir)) {
     if (!quiet) {

package/lib/opencode.js

@@ -2,6 +2,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
 const os = require('os');
+const { getSkillsSourcePath, getUserSkillsPath } = require('./utils/path-resolver');
 
 /**
  * Install skills for OpenCode
@@ -10,13 +11,12 @@ const os = require('os');
  * @param {boolean} quiet - Suppress output
  */
 function install(repoPath, skills = null, quiet = false) {
-  const homeDir = os.homedir();
-  const targetDir = path.join(homeDir, '.opencode', 'skills');
-  
+  const targetDir = getUserSkillsPath('opencode');
+
   // Criar diretório se não existir
   fs.ensureDirSync(targetDir);
-  
-  const sourceDir = path.join(repoPath, '.opencode', 'skills');
+
+  const sourceDir = getSkillsSourcePath(repoPath, 'opencode');
   
   if (!fs.existsSync(sourceDir)) {
     if (!quiet) {

package/lib/utils/path-resolver.js

@@ -0,0 +1,87 @@
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Determine if running from npm package or git repository
+ * @param {string} dirname - __dirname from calling file
+ * @returns {string} Base path for skills
+ */
+function getSkillsBasePath(dirname) {
+  // For npm package: cli-ai-skills/bin/cli.js -> cli-ai-skills/
+  // For git repo: cli-ai-skills/cli-installer/bin/cli.js -> cli-ai-skills/
+
+  const packageSkillsPath = path.resolve(dirname, '..');
+  const repoSkillsPath = path.resolve(dirname, '../..');
+
+  // Check if we're in an npm package (skills/ exists as sibling to bin/)
+  if (fs.existsSync(path.join(packageSkillsPath, 'skills'))) {
+    // npm package structure: cli-ai-skills/skills/
+    return packageSkillsPath;
+  } else if (fs.existsSync(path.join(repoSkillsPath, 'skills'))) {
+    // git repo structure: cli-ai-skills/cli-installer/../skills/
+    return repoSkillsPath;
+  } else {
+    // Fallback to repo root
+    return repoSkillsPath;
+  }
+}
+
+/**
+ * Get skills source path for a specific platform
+ * Tries npm package structure first, then falls back to git repo structure
+ * @param {string} basePath - Base path from getSkillsBasePath()
+ * @param {string} platform - Platform name (copilot, claude, codex, opencode, gemini)
+ * @returns {string} Path to skills directory for the platform
+ */
+function getSkillsSourcePath(basePath, platform) {
+  // Platform directory mappings
+  const platformDirs = {
+    'copilot': '.github',
+    'claude': '.claude',
+    'codex': '.codex',
+    'opencode': '.opencode',
+    'gemini': '.gemini'
+  };
+
+  // For npm package: basePath/skills/{platform}/
+  const npmPath = path.join(basePath, 'skills', platform);
+
+  // For git repo: basePath/{.platform}/skills/
+  const platformDir = platformDirs[platform] || `.${platform}`;
+  const gitPath = path.join(basePath, platformDir, 'skills');
+
+  // Try npm structure first, then git repo structure
+  if (fs.existsSync(npmPath)) {
+    return npmPath;
+  } else if (fs.existsSync(gitPath)) {
+    return gitPath;
+  } else {
+    // Return npm path as default (will be created during build)
+    return npmPath;
+  }
+}
+
+/**
+ * Get user home directory skills path for a platform
+ * @param {string} platform - Platform name
+ * @returns {string} Path to user's skills directory
+ */
+function getUserSkillsPath(platform) {
+  const home = process.env.HOME || process.env.USERPROFILE;
+
+  const platformDirs = {
+    'copilot': path.join(home, '.github', 'skills'),
+    'claude': path.join(home, '.claude', 'skills'),
+    'codex': path.join(home, '.codex', 'skills'),
+    'opencode': path.join(home, '.opencode', 'skills'),
+    'gemini': path.join(home, '.gemini', 'skills')
+  };
+
+  return platformDirs[platform] || path.join(home, `.${platform}`, 'skills');
+}
+
+module.exports = {
+  getSkillsBasePath,
+  getSkillsSourcePath,
+  getUserSkillsPath
+};

package/lib/utils/skill-versions.js

@@ -0,0 +1,63 @@
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+
+/**
+ * Extract version from SKILL.md frontmatter
+ * @param {string} skillName - Name of the skill
+ * @param {string} basePath - Base path where skills are located
+ * @returns {string} Version string or 'unknown'
+ */
+function getSkillVersion(skillName, basePath) {
+  try {
+    // Try multiple possible paths
+    const possiblePaths = [
+      // Git repo structure
+      path.join(basePath, 'skills', skillName, 'SKILL.md'),
+      path.join(basePath, '.github', 'skills', skillName, 'SKILL.md'),
+      path.join(basePath, '.claude', 'skills', skillName, 'SKILL.md'),
+      // NPM package structure (one level deeper with platform subdirs)
+      path.join(basePath, 'skills', 'copilot', skillName, 'SKILL.md'),
+      path.join(basePath, 'skills', 'claude', skillName, 'SKILL.md')
+    ];
+
+    for (const skillPath of possiblePaths) {
+      if (fs.existsSync(skillPath)) {
+        const content = fs.readFileSync(skillPath, 'utf8');
+
+        // Extract YAML frontmatter
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (match) {
+          const frontmatter = yaml.load(match[1]);
+          if (frontmatter && frontmatter.version) {
+            return frontmatter.version;
+          }
+        }
+      }
+    }
+
+    return 'unknown';
+  } catch (err) {
+    console.error(`Error reading version for ${skillName}:`, err.message);
+    return 'unknown';
+  }
+}
+
+/**
+ * Get versions for all available skills
+ * @param {string[]} skillNames - Array of skill names
+ * @param {string} basePath - Base path where skills are located
+ * @returns {Object} Object with skillName: version pairs
+ */
+function getAllSkillVersions(skillNames, basePath) {
+  const versions = {};
+  for (const skillName of skillNames) {
+    versions[skillName] = getSkillVersion(skillName, basePath);
+  }
+  return versions;
+}
+
+module.exports = {
+  getSkillVersion,
+  getAllSkillVersions
+};

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "cli-ai-skills",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "Install AI skills for GitHub Copilot CLI, Claude Code, and OpenAI Codex",
   "main": "lib/index.js",
   "bin": {
     "cli-ai-skills": "bin/cli.js"
   },
   "scripts": {
-    "test": "echo '✅ cli-ai-skills v1.5.0 - test passed'",
+    "test": "echo '✅ cli-ai-skills - test passed'",
     "build": "cd .. && ./scripts/build-skills.sh",
     "prebuild": "cd .. && ./scripts/build-skills.sh",
     "link": "npm link",
@@ -39,7 +39,8 @@
   "files": [
     "bin/",
     "lib/",
-    "README.md"
+    "README.md",
+    "skills/"
   ],
   "dependencies": {
     "axios": "^1.6.5",

package/skills/claude/audio-transcriber/CHANGELOG.md

@@ -0,0 +1,169 @@
+# Changelog - audio-transcriber
+
+All notable changes to the audio-transcriber skill will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.2.1] - 2026-02-04
+
+### 🔒 Security
+
+- **CRITICAL: Removed unsafe file deletion** in `cleanup_temp_files()`
+  - **Issue:** Function was deleting files with fixed names (`metadata.json`, `transcription.json`) from user's output directory without verifying the script created them
+  - **Risk:** Could accidentally delete unrelated user files with the same names
+  - **Root Cause:** Script doesn't actually create these JSON files, cleanup was attempting to delete non-existent files (and would delete user files if they existed)
+  - **Solution:** Removed `cleanup_temp_files()` function entirely
+  - **Impact:** Script now only creates and manages files it's supposed to:
+    - `transcript-TIMESTAMP.md` (always created)
+    - `ata-TIMESTAMP.md` (optional, if LLM processing succeeds)
+
+### 🗑️ Removed
+
+- `cleanup_temp_files()` function (26 lines removed)
+- `--keep-temp` CLI argument (no longer needed)
+- All calls to `cleanup_temp_files()` (3 locations)
+
+### 📝 Notes
+
+- **Breaking Change:** `--keep-temp` flag removed (was non-functional anyway)
+- **Backward Compatibility:** All other functionality unchanged
+- **Migration:** Remove `--keep-temp` from scripts if used
+
+### 🔗 Related
+
+- Identified by Codex automated review in antigravity-awesome-skills PR #62
+- Also fixed in antigravity-awesome-skills fork (commit eb49312)
+
+---
+
+## [1.1.0] - 2026-02-03
+
+### ✨ Added
+
+- **Intelligent Prompt Workflow** (Step 3b) - Complete integration with prompt-engineer skill
+  - **Scenario A**: User-provided prompts are automatically improved with prompt-engineer
+    - Displays both original and improved versions side-by-side
+    - Single confirmation: "Usar versão melhorada? [s/n]"
+  - **Scenario B**: Auto-generation when no prompt provided
+    - Analyzes transcript and suggests document type (ata, resumo, notas)
+    - Shows suggestion and asks confirmation
+    - Generates complete structured prompt (RISEN/RODES/STAR)
+    - Shows preview and asks final confirmation
+    - Falls back to DEFAULT_MEETING_PROMPT if declined
+
+- **LLM Integration** - Process transcripts with Claude CLI or GitHub Copilot CLI
+  - Priority: Claude > GitHub Copilot > None (transcript-only mode)
+  - Step 0b: CLI detection logic documented
+  - Timeout handling (5 minutes default)
+  - Graceful fallback if CLI unavailable
+
+- **Progress Indicators** - Visual feedback during long operations
+  - `tqdm` progress bar for Whisper transcription segments
+  - `rich` spinner for LLM processing
+  - Clear status messages at each step
+
+- **Timestamp-based File Naming** - Avoid overwriting previous transcriptions
+  - Format: `transcript-YYYYMMDD-HHMMSS.md`
+  - Format: `ata-YYYYMMDD-HHMMSS.md`
+  - Prevents data loss from repeated runs
+
+- **Automatic Cleanup** - Remove temporary files after processing
+  - Deletes `metadata.json` and `transcription.json` automatically
+  - `--keep-temp` flag to preserve if needed
+  - Clean output directory
+
+- **Rich Terminal UI** - Beautiful output with `rich` library
+  - Formatted panels for prompt previews
+  - Color-coded status messages (green=success, yellow=warning, red=error)
+  - Spinner animations for long-running tasks
+
+- **Dual Output Support** - Generate both transcript and processed ata
+  - `transcript-*.md` - Raw transcription with timestamps
+  - `ata-*.md` - Intelligent summary/meeting minutes (if LLM available)
+  - User can decline LLM processing to get transcript-only
+
+### 🔧 Changed
+
+- **SKILL.md** - Major documentation updates
+  - Added Step 0b (CLI Detection)
+  - Updated Step 2 (Progress Indicators)
+  - Added Step 3b (Intelligent Prompt Workflow with 150+ lines)
+  - Updated version to 1.1.0
+  - Added detailed workflow diagrams for both scenarios
+
+- **install-requirements.sh** - Added UI libraries
+  - Now installs `tqdm` and `rich` packages
+  - Graceful fallback if installation fails
+  - Updated success messages
+
+- **Python Implementation** - Complete refactor
+  - Created `scripts/transcribe.py` (516 lines)
+  - Functions: `detect_cli_tool()`, `invoke_prompt_engineer()`, `handle_prompt_workflow()`, `process_with_llm()`, `transcribe_audio()`, `save_outputs()`, `cleanup_temp_files()`
+  - Command-line arguments: `--prompt`, `--model`, `--output-dir`, `--keep-temp`
+  - Auto-installs `rich` and `tqdm` if missing
+
+### 🐛 Fixed
+
+- **User prompts no longer ignored** - v1.0.0 completely ignored custom prompts
+  - Now processes all prompts (custom or auto-generated) with LLM
+  - Improves simple prompts into structured frameworks
+
+- **Temporary files cleanup** - v1.0.0 left `metadata.json` and `transcription.json` as trash
+  - Now automatically removed after processing
+  - Clean output directory
+
+- **File overwriting** - v1.0.0 used same filename (e.g., `meeting.md`) every time
+  - Now uses timestamp to prevent data loss
+  - Each run creates unique files
+
+- **Missing ata/summary** - v1.0.0 only generated raw transcript
+  - Now generates intelligent ata/resumo using LLM
+  - Respects user's prompt instructions
+
+- **No progress feedback** - v1.0.0 had silent processing (users didn't know if it froze)
+  - Now shows progress bar for transcription
+  - Shows spinner for LLM processing
+  - Clear status messages throughout
+
+### 📝 Notes
+
+- **Backward Compatibility:** Fully compatible with v1.0.0 workflows
+- **Requires:** Python 3.8+, faster-whisper OR whisper, tqdm, rich
+- **Optional:** Claude CLI or GitHub Copilot CLI for intelligent processing
+- **Optional:** prompt-engineer skill for automatic prompt generation
+
+### 🔗 Related Issues
+
+- Fixes #1: Prompt do usuário RISEN ignorado
+- Fixes #2: Arquivos temporários (metadata.json, transcription.json) deixados como lixo
+- Fixes #3: Output incompleto (apenas transcript RAW, sem ata)
+- Fixes #4: Falta de indicador de progresso visual
+- Fixes #5: Formato de saída sem timestamp
+
+---
+
+## [1.0.0] - 2026-02-02
+
+### ✨ Initial Release
+
+- Audio transcription using Faster-Whisper or OpenAI Whisper
+- Automatic language detection
+- Speaker diarization (basic)
+- Voice Activity Detection (VAD)
+- Markdown output with metadata table
+- Installation script for dependencies
+- Example scripts for basic transcription
+- Support for multiple audio formats (MP3, WAV, M4A, OGG, FLAC, WEBM)
+- FFmpeg integration for format conversion
+- Zero-configuration philosophy
+
+### 📝 Known Limitations (Fixed in v1.1.0)
+
+- User prompts ignored (no LLM integration)
+- Only raw transcript generated (no ata/summary)
+- Temporary files not cleaned up
+- No progress indicators
+- Files overwritten on repeated runs