feat: use git clone for skill discovery to avoid API rate limits (v0.7.6)

Author: yeasy

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.6] - 2026-01-19
+
+### Changed
+- **Skill Discovery**: Now uses `git clone` for skill discovery from configured repositories, eliminating the need for GitHub tokens for public repositories and avoiding API rate limits.
+
 ## [0.7.5] - 2026-01-19
 
 ### Added

cmd/install.go

@@ -119,11 +119,27 @@ If no agent is specified, skills are installed to .agent/skills/ by default.`,
 
 			if targetRepo != nil {
 				fmt.Printf("Fetching skills from repo '%s'...\n", input)
-				repos, err := repository.FetchSkills(*targetRepo)
-				if err != nil {
-					fmt.Printf("Failed to fetch skills from repo '%s': %v\n", input, err)
-					failed = append(failed, input)
-					continue
+
+				var repos []github.Repository
+				var err error
+
+				// Try git-based discovery first for 'dir' type repos (avoids API rate limits)
+				if targetRepo.Type == "dir" {
+					repos, err = repository.FetchSkillsViaGit(*targetRepo)
+				}
+
+				// If git discovery failed or wasn't applicable, fall back to API
+				if err != nil || targetRepo.Type != "dir" {
+					if err != nil && targetRepo.Type == "dir" {
+						// Optional: log or print why git failed if verbose
+						// fmt.Printf("Git discovery failed: %v. Falling back to API...\n", err)
+					}
+					repos, err = repository.FetchSkills(*targetRepo)
+					if err != nil {
+						fmt.Printf("Failed to fetch skills from repo '%s': %v\n", input, err)
+						failed = append(failed, input)
+						continue
+					}
 				}
 
 				if len(repos) == 0 {

cmd/root.go

@@ -45,7 +45,7 @@ the Agent ecosystem.`,
 	// Uncomment the following line if your bare application
 	// has an action associated with it:
 	// Run: func(cmd *cobra.Command, args []string) { },
-	Version: "0.7.5",
+	Version: "0.7.6",
 }
 
 // Execute adds all child commands to the root command and sets flags appropriately.

internal/repository/fetch.go

@@ -2,10 +2,14 @@ package repository
 
 import (
 	"fmt"
+	"os"
+	"path/filepath"
 	"strings"
 
 	"github.com/yeasy/ask/internal/config"
+	"github.com/yeasy/ask/internal/git"
 	"github.com/yeasy/ask/internal/github"
+	"github.com/yeasy/ask/internal/skill"
 )
 
 // FetchSkills returns a list of skills available in the given repository
@@ -28,4 +32,84 @@ func FetchSkills(repo config.Repo) ([]github.Repository, error) {
 	default:
 		return nil, fmt.Errorf("unknown repository type: %s", repo.Type)
 	}
+	}
+}
+
+// FetchSkillsViaGit clones a repo and discovers skills locally (no API needed)
+func FetchSkillsViaGit(repo config.Repo) ([]github.Repository, error) {
+	if repo.Type != "dir" {
+		return nil, fmt.Errorf("git fetch only supports 'dir' type repos")
+	}
+
+	parts := strings.Split(repo.URL, "/")
+	if len(parts) < 2 {
+		return nil, fmt.Errorf("invalid repository URL format: %s", repo.URL)
+	}
+
+	owner := parts[0]
+	repoName := parts[1]
+	subPath := ""
+	if len(parts) > 2 {
+		subPath = strings.Join(parts[2:], "/")
+	}
+
+	cloneURL := fmt.Sprintf("https://github.com/%s/%s.git", owner, repoName)
+
+	// Create temp dir
+	tempDir, err := os.MkdirTemp("", "ask-discovery-*")
+	if err != nil {
+		return nil, fmt.Errorf("failed to create temp dir: %w", err)
+	}
+	defer func() { _ = os.RemoveAll(tempDir) }()
+
+	// Clone repo
+	// Using generic Clone (depth 1)
+	if err := git.Clone(cloneURL, tempDir); err != nil {
+		return nil, fmt.Errorf("failed to clone repo: %w", err)
+	}
+
+	// Scan for skills
+	searchPath := tempDir
+	if subPath != "" {
+		searchPath = filepath.Join(tempDir, subPath)
+	}
+
+	entries, err := os.ReadDir(searchPath)
+	if err != nil {
+		return nil, fmt.Errorf("failed to read skills directory: %w", err)
+	}
+
+	var skills []github.Repository
+
+	for _, entry := range entries {
+		if !entry.IsDir() {
+			continue
+		}
+
+		skillDir := filepath.Join(searchPath, entry.Name())
+		if skill.FindSkillMD(skillDir) {
+			// Found a skill, extract metadata
+			var desc string
+			if meta, err := skill.ParseSkillMD(skillDir); err == nil && meta != nil {
+				desc = meta.Description
+			}
+
+			// Construct installation argument (owner/repo/path/to/skill)
+			skillRelPath := subPath
+			if skillRelPath != "" {
+				skillRelPath = skillRelPath + "/" + entry.Name()
+			} else {
+				skillRelPath = entry.Name()
+			}
+			installArg := fmt.Sprintf("%s/%s/%s", owner, repoName, skillRelPath)
+
+			skills = append(skills, github.Repository{
+				Name:        entry.Name(),
+				Description: desc,
+				HTMLURL:     installArg, // Passing the install arg string
+			})
+		}
+	}
+
+	return skills, nil
 }