feat: release v0.9.5 - polished help text, add optional repos to README

Author: yeasy

README.md

@@ -128,14 +128,27 @@ ASK comes pre-configured with trusted sources:
 | Source | Description |
 | :--- | :--- |
 | **Anthropic** | Official [anthropics/skills](https://github.com/anthropics/skills) |
-| **Community** | Top-rated community skills (GitHub `agent-skill` topic) |
+| **Community** | Top-rated community skills (GitHub `agent-skill` and `agent-skills` topics) |
 | **Composio** | [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) collection |
-| **MATLAB** | Official [matlab/skills](https://github.com/matlab/skills) |
 | **OpenAI** | Official [openai/skills](https://github.com/openai/skills) |
-| **Superpowers** | [obra/superpowers](https://github.com/obra/superpowers) core library |
-| **SkillHub** | [SkillHub.club](https://www.skillhub.club) |
 | **Vercel** | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) AI SDK skills |
 
+### Optional Repositories
+
+For specific needs, you can add these additional sources:
+
+| Repository | Command to Add | Description |
+| :--- | :--- | :--- |
+| **SkillHub** | `ask repo add skillhub/skills` | [SkillHub.club](https://www.skillhub.club) index |
+| **Scientific** | `ask repo add K-Dense-AI/claude-scientific-skills` | Data science & research skills |
+| **MATLAB** | `ask repo add matlab/skills` | Official MATLAB integration |
+| **Superpowers** | `ask repo add obra/superpowers` | Full dev workflow with sub-agents |
+| **Planning** | `ask repo add OthmanAdi/planning-with-files` | File-based persistent planning |
+| **UI/UX Pro** | `ask repo add nextlevelbuilder/ui-ux-pro-max-skill` | 57 UI styles, 95 color schemes |
+| **NotebookLM** | `ask repo add PleasePrompto/notebooklm-skill` | Auto-upload to NotebookLM |
+| **AI DrawIO** | `ask repo add GBSOSS/ai-drawio` | Flowchart & diagram generation |
+| **PPT Skills** | `ask repo add op7418/NanoBanana-PPT-Skills` | Dynamic PPT generation |
+
 ## 📂 Installation Layout
 
 Default structure after installation:

README_zh.md

@@ -131,13 +131,27 @@ ASK 默认内置了以下受信源：
 | 来源 | 说明 |
 | :--- | :--- |
 | **Anthropic** | 官方库 [anthropics/skills](https://github.com/anthropics/skills) |
-| **Community** | GitHub 社区高分技能 (`agent-skill` topic) |
+| **Community** | GitHub 社区高分技能 (`agent-skill` 和 `agent-skills` topics) |
 | **Composio** | 精选集 [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) |
-| **MATLAB** | 官方库 [matlab/skills](https://github.com/matlab/skills) |
 | **OpenAI** | 官方库 [openai/skills](https://github.com/openai/skills) |
-| **Superpowers** | 核心库 [obra/superpowers](https://github.com/obra/superpowers) |
 | **Vercel** | AI SDK [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) |
 
+### 可选技能仓库
+
+如有特定需求，您可以添加以下额外来源：
+
+| 仓库 | 添加命令 | 说明 |
+| :--- | :--- | :--- |
+| **SkillHub** | `ask repo add skillhub/skills` | [SkillHub.club](https://www.skillhub.club) 索引 |
+| **Scientific** | `ask repo add K-Dense-AI/claude-scientific-skills` | 数据科学与研究技能 |
+| **MATLAB** | `ask repo add matlab/skills` | 官方 MATLAB 集成 |
+| **Superpowers** | `ask repo add obra/superpowers` | 全链路开发工作流 |
+| **Planning** | `ask repo add OthmanAdi/planning-with-files` | 文件持久化规划 |
+| **UI/UX Pro** | `ask repo add nextlevelbuilder/ui-ux-pro-max-skill` | 57种UI风格，95种配色 |
+| **NotebookLM** | `ask repo add PleasePrompto/notebooklm-skill` | 自动上传到NotebookLM |
+| **AI DrawIO** | `ask repo add GBSOSS/ai-drawio` | 流程图自动生成 |
+| **PPT Skills** | `ask repo add op7418/NanoBanana-PPT-Skills` | 动态PPT生成 |
+
 ## 📂 目录结构
 
 安装后的默认结构：

cmd/repo.go

@@ -9,8 +9,8 @@ import (
 	"text/tabwriter"
 
 	"github.com/spf13/cobra"
+	"github.com/yeasy/ask/internal/cache"
 	"github.com/yeasy/ask/internal/config"
-	"github.com/yeasy/ask/internal/github"
 	"github.com/yeasy/ask/internal/repository"
 	"github.com/yeasy/ask/internal/ui"
 )
@@ -147,6 +147,18 @@ Examples:
 				return
 			}
 
+			// Load cached star counts
+			starCache := make(map[string]int)
+			reposCache, err := cache.NewReposCache()
+			if err == nil {
+				repoInfos, err := reposCache.LoadIndex()
+				if err == nil {
+					for _, info := range repoInfos {
+						starCache[info.Name] = info.Stars
+					}
+				}
+			}
+
 			fmt.Println("Configured Repositories:")
 			fmt.Println()
 			w := tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0)
@@ -161,15 +173,10 @@ Examples:
 					stars = "-" // Topics don't have star counts
 				} else {
 					fullURL = fmt.Sprintf("https://github.com/%s", r.URL)
-					// Fetch star count for repo
-					parts := strings.Split(r.URL, "/")
-					if len(parts) >= 2 {
-						repoInfo, err := github.FetchRepoDetails(parts[0], parts[1])
-						if err == nil && repoInfo != nil {
-							stars = fmt.Sprintf("%d", repoInfo.StargazersCount)
-						} else {
-							stars = "-"
-						}
+					// Use cached star count
+					repoName := buildRepoName(r.URL)
+					if cachedStars, ok := starCache[repoName]; ok && cachedStars > 0 {
+						stars = fmt.Sprintf("%d", cachedStars)
 					} else {
 						stars = "-"
 					}
@@ -179,6 +186,7 @@ Examples:
 			_ = w.Flush()
 			fmt.Printf("\nTotal: %d repositories\n", len(cfg.Repos))
 			fmt.Println("\nUse 'ask repo list <name>' to view skills in a repository.")
+			fmt.Println("Run 'ask repo sync' to update star counts.")
 			return
 		}
 

cmd/root.go

@@ -12,7 +12,8 @@ import (
 var cfgFile string
 
 // Custom help template with subcommand details at the end
-const rootHelpTemplate = `{{with (or .Long .Short)}}{{. | trimTrailingWhitespaces}}
+const rootHelpTemplate = `{{with .Version}}ASK v{{.}}
+{{end}}{{with (or .Long .Short)}}{{. | trimTrailingWhitespaces}}
 
 {{end}}{{if or .Runnable .HasSubCommands}}{{.UsageString}}{{end}}
 Skill Commands (ask skill <command>):
@@ -37,16 +38,15 @@ Supported Agents: Claude, Cursor, Codex, OpenCode, Antigravity, Gemini CLI, GitH
 // rootCmd represents the base command when called without any subcommands
 var rootCmd = &cobra.Command{
 	Use:   "ask",
-	Short: "Agent Skills Kit - The Package Manager for Agent Skills",
-	Long: `ASK (Agent Skills Kit) is a CLI tool designed to help you discover, 
-install, and manage skills for your AI Agents. 
+	Short: "The package manager for AI Agent skills",
+	Long: `The package manager for AI Agent skills.
 
-It works similarly to package managers like Homebrew or npm, but specified for 
-the Agent ecosystem.`,
+Discover, install, and manage capabilities for your AI Agents (Claude, Cursor, 
+Codex, etc.) with a familiar CLI experience, just like Homebrew or npm.`,
 	// Uncomment the following line if your bare application
 	// has an action associated with it:
 	// Run: func(cmd *cobra.Command, args []string) { },
-	Version: "0.9.3",
+	Version: "0.9.5",
 }
 
 // Execute adds all child commands to the root command and sets flags appropriately.

cmd/search.go

@@ -39,6 +39,7 @@ Use --remote to force remote API search.`,
 
 		forceLocal, _ := cmd.Flags().GetBool("local")
 		forceRemote, _ := cmd.Flags().GetBool("remote")
+		minStars, _ := cmd.Flags().GetInt("min-stars")
 
 		// Load config or use default
 		cfg, err := config.LoadConfig()
@@ -80,7 +81,7 @@ Use --remote to force remote API search.`,
 
 					if len(allRepos) > 0 || forceLocal {
 						// Display results from local cache
-						displaySearchResults(allRepos, installedSkills, searchSource)
+						displaySearchResults(allRepos, installedSkills, searchSource, minStars)
 						if forceLocal && len(allRepos) == 0 {
 							fmt.Println("\nTip: Run 'ask repo sync' to populate local cache.")
 						}
@@ -117,10 +118,13 @@ Use --remote to force remote API search.`,
 					repos, err = github.SearchTopic(r.URL, keyword)
 				case "dir":
 					parts := strings.Split(r.URL, "/")
-					if len(parts) >= 3 {
+					if len(parts) >= 2 {
 						owner := parts[0]
 						repoName := parts[1]
-						path := strings.Join(parts[2:], "/")
+						path := ""
+						if len(parts) > 2 {
+							path = strings.Join(parts[2:], "/")
+						}
 						repos, err = github.SearchDir(owner, repoName, path)
 
 						// Filter client-side by keyword
@@ -166,14 +170,31 @@ Use --remote to force remote API search.`,
 			fmt.Println()
 		}
 
-		displaySearchResults(allRepos, installedSkills, searchSource)
+		// Filter by min-stars if specified
+		if minStars > 0 {
+			// Filtering is handled in displaySearchResults to ensure consistent counting
+		}
+
+		displaySearchResults(allRepos, installedSkills, searchSource, minStars)
 	},
 }
 
-func displaySearchResults(repos []github.Repository, installedSkills map[string]bool, source string) {
+func displaySearchResults(repos []github.Repository, installedSkills map[string]bool, source string, minStars int) {
+	// Filter repos if minStars > 0
+	var displayRepos []github.Repository
+	if minStars > 0 {
+		for _, repo := range repos {
+			if repo.StargazersCount >= minStars {
+				displayRepos = append(displayRepos, repo)
+			}
+		}
+	} else {
+		displayRepos = repos
+	}
+
 	w := tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0)
 	_, _ = fmt.Fprintln(w, "NAME\tSOURCE\tINSTALLED\tSTARS\tDESCRIPTION")
-	for _, repo := range repos {
+	for _, repo := range displayRepos {
 		// Truncate description if too long
 		desc := repo.Description
 		if len(desc) > 40 {
@@ -186,7 +207,7 @@ func displaySearchResults(repos []github.Repository, installedSkills map[string]
 			installed = "✓"
 		}
 
-		// Format stars (use "-" for local or dir-based)
+		// Format stars (use "-" for local or dir-based if actually 0, but dir-based now have stars)
 		stars := fmt.Sprintf("%d", repo.StargazersCount)
 		if repo.StargazersCount == 0 {
 			stars = "-"
@@ -196,7 +217,12 @@ func displaySearchResults(repos []github.Repository, installedSkills map[string]
 	}
 	_ = w.Flush()
 
-	fmt.Printf("\nFound %d skills.\n", len(repos))
+	fmt.Printf("\nFound %d skills", len(displayRepos))
+	if minStars > 0 {
+		fmt.Printf(" (filtered from %d results by stars >= %d)", len(repos), minStars)
+	}
+	fmt.Println(".")
+
 	if source == "local" {
 		fmt.Println("(from local cache - run 'ask repo sync' to update)")
 	}
@@ -206,4 +232,5 @@ func init() {
 	skillCmd.AddCommand(searchCmd)
 	searchCmd.Flags().Bool("local", false, "search only local cache (offline)")
 	searchCmd.Flags().Bool("remote", false, "force remote API search")
+	searchCmd.Flags().Int("min-stars", 0, "filter skills by minimum integer number of GitHub stars")
 }

cmd/sync.go

@@ -8,6 +8,7 @@ import (
 	"github.com/spf13/cobra"
 	"github.com/yeasy/ask/internal/cache"
 	"github.com/yeasy/ask/internal/config"
+	"github.com/yeasy/ask/internal/github"
 )
 
 // syncCmd represents the sync command
@@ -71,6 +72,7 @@ If no repo name is specified, syncs all configured repositories.`,
 		fmt.Printf("Syncing %d repositories to ~/.ask/repos/...\n\n", len(targetRepos))
 
 		successCount := 0
+		starCounts := make(map[string]int)
 		for _, repo := range targetRepos {
 			repoURL := buildRepoURL(repo.URL)
 			repoName := buildRepoName(repo.URL)
@@ -81,13 +83,22 @@ If no repo name is specified, syncs all configured repositories.`,
 			} else {
 				fmt.Printf("  ✓ Synced %s\n", repo.Name)
 				successCount++
+
+				// Fetch star count from GitHub API
+				parts := strings.Split(repo.URL, "/")
+				if len(parts) >= 2 {
+					repoDetails, err := github.FetchRepoDetails(parts[0], parts[1])
+					if err == nil {
+						starCounts[repoName] = repoDetails.StargazersCount
+					}
+				}
 			}
 		}
 
 		fmt.Printf("\nSynced %d/%d repositories.\n", successCount, len(targetRepos))
 
-		// Save index
-		if err := reposCache.SaveIndex(); err != nil {
+		// Save index with star counts
+		if err := reposCache.SaveIndexWithStars(starCounts); err != nil {
 			fmt.Printf("Warning: Failed to save index: %v\n", err)
 		}
 

cmd/version.go

@@ -0,0 +1,20 @@
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/spf13/cobra"
+)
+
+var versionCmd = &cobra.Command{
+	Use:   "version",
+	Short: "Print the version number of ask",
+	Long:  `All software has versions. This is ask's`,
+	Run: func(cmd *cobra.Command, args []string) {
+		fmt.Printf("ask version %s\n", rootCmd.Version)
+	},
+}
+
+func init() {
+	rootCmd.AddCommand(versionCmd)
+}

internal/cache/repos.go

@@ -21,6 +21,7 @@ type RepoInfo struct {
 	URL       string    `json:"url"`
 	LocalPath string    `json:"local_path"`
 	UpdatedAt time.Time `json:"updated_at"`
+	Stars     int       `json:"stars"`
 }
 
 // SkillEntry represents a skill found in local cache
@@ -205,19 +206,45 @@ func extractDescription(skillMDPath string) string {
 	return ""
 }
 
-// SaveIndex saves the current repo index to disk
+// SaveIndex saves the current repo index to disk (without stars)
 func (c *ReposCache) SaveIndex() error {
+	return c.SaveIndexWithStars(nil)
+}
+
+// SaveIndexWithStars saves the current repo index to disk with star counts
+func (c *ReposCache) SaveIndexWithStars(starCounts map[string]int) error {
 	indexPath := filepath.Join(c.baseDir, "index.json")
 	repos := c.GetCachedRepos()
 
+	// Load existing index to preserve stars for repos not synced in this run
+	existingStars := make(map[string]int)
+	existingInfos, _ := c.LoadIndex()
+	for _, info := range existingInfos {
+		existingStars[info.Name] = info.Stars
+	}
+
 	var repoInfos []RepoInfo
 	for _, repo := range repos {
 		repoPath := filepath.Join(c.baseDir, repo)
 		info, _ := os.Stat(repoPath)
+
+		// Use new star count if provided, otherwise use existing
+		stars := 0
+		if starCounts != nil {
+			if count, ok := starCounts[repo]; ok {
+				stars = count
+			} else if existingCount, ok := existingStars[repo]; ok {
+				stars = existingCount
+			}
+		} else if existingCount, ok := existingStars[repo]; ok {
+			stars = existingCount
+		}
+
 		repoInfos = append(repoInfos, RepoInfo{
 			Name:      repo,
 			LocalPath: repoPath,
 			UpdatedAt: info.ModTime(),
+			Stars:     stars,
 		})
 	}
 
@@ -227,3 +254,17 @@ func (c *ReposCache) SaveIndex() error {
 	}
 	return os.WriteFile(indexPath, data, 0644)
 }
+
+// LoadIndex loads the repo index from disk
+func (c *ReposCache) LoadIndex() ([]RepoInfo, error) {
+	indexPath := filepath.Join(c.baseDir, "index.json")
+	data, err := os.ReadFile(indexPath)
+	if err != nil {
+		return nil, err
+	}
+	var repoInfos []RepoInfo
+	if err := json.Unmarshal(data, &repoInfos); err != nil {
+		return nil, err
+	}
+	return repoInfos, nil
+}