Add forward-compat comments on --skills flag

Co-authored-by: Isaac

Author: simonfaltum

experimental/aitools/cmd/list.go

@@ -17,13 +17,15 @@ import (
 var listSkillsFn = defaultListSkills
 
 func newListCmd() *cobra.Command {
+	// --skills is accepted for forward-compat (future component types)
+	// but currently skills is the only component, so the output is the same.
 	var showSkills bool
 
 	cmd := &cobra.Command{
 		Use:   "list",
 		Short: "List installed AI tools components",
 		RunE: func(cmd *cobra.Command, args []string) error {
-			// Currently skills is the only component, so always show detailed view.
+			_ = showSkills
 			return listSkillsFn(cmd)
 		},
 	}

experimental/aitools/cmd/version.go

@@ -18,8 +18,8 @@ func newVersionCmd() *cobra.Command {
 		Use:   "version",
 		Short: "Show installed AI skills version",
 		RunE: func(cmd *cobra.Command, args []string) error {
-			// showSkills is accepted for forward-compat but currently
-			// skills is the only component, so the output is the same.
+			// --skills is accepted for forward-compat (future component types)
+			// but currently skills is the only component, so the output is the same.
 			_ = showSkills
 			ctx := cmd.Context()