aidevops 2.72.0 → 2.74.0

package/README.md

@@ -453,16 +453,26 @@ aidevops includes curated skills imported from external repositories. Skills fro
 | **remotion** | [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation with React, animations, rendering |
 | **animejs** | [animejs.com](https://animejs.com) | JavaScript animation library patterns and API (via Context7) |
 
-**Skill Commands:**
+**CLI Commands:**
 
 ```bash
-/add-skill <owner/repo>        # Import a skill from GitHub
-/add-skill list                # List imported skills
-/add-skill check-updates       # Check for upstream updates
-/add-skill <owner/repo> --force  # Update an existing skill
+aidevops skill add <owner/repo>    # Import a skill from GitHub
+aidevops skill list                # List imported skills
+aidevops skill check               # Check for upstream updates
+aidevops skill update [name]       # Update specific or all skills
+aidevops skill remove <name>       # Remove an imported skill
 ```
 
-Skills are registered in `~/.aidevops/agents/configs/skill-sources.json` and checked for updates during `./setup.sh`.
+Skills are registered in `~/.aidevops/agents/configs/skill-sources.json` with upstream commit tracking for update detection. Telemetry is disabled - no data is sent to third parties.
+
+**Browse community skills:** [skills.sh](https://skills.sh) | **Specification:** [agentskills.io](https://agentskills.io)
+
+**Reference:**
+- [Agent Skills Specification](https://agentskills.io/specification) - The open format for SKILL.md files
+- [skills.sh Leaderboard](https://skills.sh) - Discover popular community skills
+- [vercel-labs/add-skill](https://github.com/vercel-labs/add-skill) - The upstream CLI tool (aidevops uses its own implementation)
+- [anthropics/skills](https://github.com/anthropics/skills) - Official Anthropic example skills
+- [agentskills/agentskills](https://github.com/agentskills/agentskills) - Specification source and reference library
 
 ## **Agent Design Patterns**
 
@@ -923,30 +933,43 @@ This installs the complete framework: 13 domain agents, 225+ subagents, and 130+
 
 ### Importing External Skills
 
-Import skills from any GitHub repository using `/add-skill`:
+Import skills from any GitHub repository using the `aidevops skill` CLI:
 
 ```bash
 # Import from GitHub (auto-detects format)
-/add-skill owner/repo
+aidevops skill add owner/repo
 
 # Examples
-/add-skill anthropics/courses           # SKILL.md format
-/add-skill PatrickJS/awesome-cursorrules # .cursorrules format
-/add-skill someone/agents-repo          # AGENTS.md format
+aidevops skill add anthropics/skills/pdf           # Specific skill from multi-skill repo
+aidevops skill add vercel-labs/agent-skills         # All skills from a repo
+aidevops skill add expo/skills --name expo-dev      # Custom name
+aidevops skill add owner/repo --dry-run             # Preview without changes
 ```
 
 **Supported formats:**
-- `SKILL.md` - Agent Skills standard (preferred)
+- `SKILL.md` - [Agent Skills standard](https://agentskills.io/specification) (preferred)
 - `AGENTS.md` - Claude Code agents format
-- `.cursorrules` - Cursor rules (auto-converted to SKILL.md)
+- `.cursorrules` - Cursor rules (auto-converted)
 
 **Features:**
-- Conflict detection with existing skills
-- Version tracking for updates (`/add-skill --check-updates`)
-- Symlinks created for Claude Code, Cursor, Amp, and other tools
+- Auto-detection of skill format and category placement
+- Conflict detection with merge/replace/rename options
+- Upstream commit tracking for update detection (`aidevops skill check`)
+- Conversion to aidevops subagent format with YAML frontmatter
 - Registry stored in `.agent/configs/skill-sources.json`
+- Telemetry disabled (no data sent to skills.sh or other services)
+
+**How it differs from `npx add-skill`:**
+
+| | `aidevops skill add` | `npx add-skill` |
+|---|---|---|
+| **Target** | Converts to aidevops format in `.agent/` | Copies SKILL.md to agent-specific dirs |
+| **Tracking** | Git commit-based upstream tracking | Lock file with content hashes |
+| **Telemetry** | Disabled | Sends anonymous install counts |
+| **Scope** | OpenCode-first | 22+ agents |
+| **Updates** | `aidevops skill check` (GitHub API) | `npx skills check` (Vercel API) |
 
-See `.agent/tools/build-agent/add-skill.md` for full documentation.
+See `.agent/scripts/add-skill-helper.sh` for implementation details.
 
 ## **AI Agents & Subagents**
 

package/VERSION

@@ -1 +1 @@
-2.72.0
+2.74.0

package/aidevops.sh

@@ -3,7 +3,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 2.72.0
+# Version: 2.74.0
 
 set -euo pipefail
 
@@ -1631,6 +1631,152 @@ cmd_detect() {
     return 0
 }
 
+# Skill command - manage agent skills
+cmd_skill() {
+    local action="${1:-help}"
+    shift || true
+
+    # Disable telemetry for any downstream tools (add-skill, skills CLI)
+    export DISABLE_TELEMETRY=1
+    export DO_NOT_TRACK=1
+    export SKILLS_NO_TELEMETRY=1
+
+    local add_skill_script="$AGENTS_DIR/scripts/add-skill-helper.sh"
+    local update_skill_script="$AGENTS_DIR/scripts/skill-update-helper.sh"
+
+    case "$action" in
+        add|a)
+            if [[ $# -lt 1 ]]; then
+                print_error "Source required (owner/repo or URL)"
+                echo ""
+                echo "Usage: aidevops skill add <source> [options]"
+                echo ""
+                echo "Examples:"
+                echo "  aidevops skill add vercel-labs/agent-skills"
+                echo "  aidevops skill add anthropics/skills/pdf"
+                echo "  aidevops skill add https://github.com/owner/repo"
+                echo ""
+                echo "Options:"
+                echo "  --name <name>   Override the skill name"
+                echo "  --force         Overwrite existing skill"
+                echo "  --dry-run       Preview without making changes"
+                echo ""
+                echo "Browse skills: https://skills.sh"
+                return 1
+            fi
+
+            if [[ ! -f "$add_skill_script" ]]; then
+                print_error "add-skill-helper.sh not found"
+                print_info "Run 'aidevops update' to get the latest scripts"
+                return 1
+            fi
+
+            bash "$add_skill_script" add "$@"
+            ;;
+        list|ls|l)
+            if [[ ! -f "$add_skill_script" ]]; then
+                print_error "add-skill-helper.sh not found"
+                return 1
+            fi
+            bash "$add_skill_script" list
+            ;;
+        check|c)
+            if [[ ! -f "$update_skill_script" ]]; then
+                print_error "skill-update-helper.sh not found"
+                return 1
+            fi
+            bash "$update_skill_script" check "$@"
+            ;;
+        update|u)
+            if [[ ! -f "$update_skill_script" ]]; then
+                print_error "skill-update-helper.sh not found"
+                return 1
+            fi
+            bash "$update_skill_script" update "$@"
+            ;;
+        remove|rm)
+            if [[ $# -lt 1 ]]; then
+                print_error "Skill name required"
+                echo "Usage: aidevops skill remove <name>"
+                return 1
+            fi
+            if [[ ! -f "$add_skill_script" ]]; then
+                print_error "add-skill-helper.sh not found"
+                return 1
+            fi
+            bash "$add_skill_script" remove "$@"
+            ;;
+        status|s)
+            if [[ ! -f "$update_skill_script" ]]; then
+                print_error "skill-update-helper.sh not found"
+                return 1
+            fi
+            bash "$update_skill_script" status "$@"
+            ;;
+        generate|gen|g)
+            local generate_script="$AGENTS_DIR/scripts/generate-skills.sh"
+            if [[ ! -f "$generate_script" ]]; then
+                print_error "generate-skills.sh not found"
+                print_info "Run 'aidevops update' to get the latest scripts"
+                return 1
+            fi
+            print_info "Generating SKILL.md stubs for cross-tool discovery..."
+            bash "$generate_script" "$@"
+            ;;
+        clean)
+            local generate_script="$AGENTS_DIR/scripts/generate-skills.sh"
+            if [[ ! -f "$generate_script" ]]; then
+                print_error "generate-skills.sh not found"
+                return 1
+            fi
+            bash "$generate_script" --clean "$@"
+            ;;
+        help|--help|-h)
+            print_header "Agent Skills Management"
+            echo ""
+            echo "Import and manage reusable AI agent skills from the community."
+            echo "Skills are converted to aidevops format with upstream tracking."
+            echo "Telemetry is disabled - no data sent to third parties."
+            echo ""
+            echo "Usage: aidevops skill <command> [options]"
+            echo ""
+            echo "Commands:"
+            echo "  add <source>     Import a skill from GitHub (saved as *-skill.md)"
+            echo "  list             List all imported skills"
+            echo "  check            Check for upstream updates"
+            echo "  update [name]    Update specific or all skills"
+            echo "  remove <name>    Remove an imported skill"
+            echo "  status           Show detailed skill status"
+            echo "  generate         Generate SKILL.md stubs for cross-tool discovery"
+            echo "  clean            Remove generated SKILL.md stubs"
+            echo ""
+            echo "Source formats:"
+            echo "  owner/repo                    GitHub shorthand"
+            echo "  owner/repo/path/to/skill      Specific skill in multi-skill repo"
+            echo "  https://github.com/owner/repo Full URL"
+            echo ""
+            echo "Examples:"
+            echo "  aidevops skill add vercel-labs/agent-skills"
+            echo "  aidevops skill add anthropics/skills/pdf"
+            echo "  aidevops skill add expo/skills --name expo-dev"
+            echo "  aidevops skill check"
+            echo "  aidevops skill update"
+            echo "  aidevops skill generate --dry-run"
+            echo ""
+            echo "Imported skills are saved with a -skill suffix to distinguish"
+            echo "from native aidevops subagents (e.g., playwright-skill.md vs playwright.md)."
+            echo ""
+            echo "Browse community skills: https://skills.sh"
+            echo "Agent Skills specification: https://agentskills.io"
+            ;;
+        *)
+            print_error "Unknown skill command: $action"
+            echo "Run 'aidevops skill help' for usage information."
+            return 1
+            ;;
+    esac
+}
+
 # Help command
 cmd_help() {
     local version
@@ -1644,6 +1790,7 @@ cmd_help() {
     echo "  init [features]    Initialize aidevops in current project"
     echo "  upgrade-planning   Upgrade TODO.md/PLANS.md to latest templates"
     echo "  features           List available features for init"
+    echo "  skill <cmd>        Manage agent skills (add/list/check/update/remove)"
     echo "  status             Check installation status of all components"
     echo "  update             Update aidevops to the latest version (alias: upgrade)"
     echo "  upgrade            Alias for update"
@@ -1668,6 +1815,13 @@ cmd_help() {
     echo "  aidevops update-tools -u     # Update all outdated tools"
     echo "  aidevops uninstall           # Remove aidevops"
     echo ""
+    echo "Skills:"
+    echo "  aidevops skill add <source>  # Import a skill from GitHub"
+    echo "  aidevops skill list          # List imported skills"
+    echo "  aidevops skill check         # Check for upstream updates"
+    echo "  aidevops skill update [name] # Update skills to latest"
+    echo "  aidevops skill remove <name> # Remove an imported skill"
+    echo ""
     echo "Installation:"
     echo "  npm install -g aidevops && aidevops update      # via npm"
     echo "  brew install marcusquinn/tap/aidevops && aidevops update  # via Homebrew"
@@ -1748,6 +1902,10 @@ main() {
             shift
             cmd_repos "$@"
             ;;
+        skill|skills)
+            shift
+            cmd_skill "$@"
+            ;;
         detect|scan)
             cmd_detect
             ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "2.72.0",
+  "version": "2.74.0",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "main": "index.js",

package/setup.sh

@@ -3,7 +3,7 @@
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 2.72.0
+# Version: 2.74.0
 #
 # Quick Install (one-liner):
 #   bash <(curl -fsSL https://aidevops.dev/install)