Document registry config and add cache TTL

Author: majiayu000

README.md

@@ -2,7 +2,7 @@
 
 <p align="center">
   <a href="https://github.com/majiayu000/caude-skill-manager/releases"><img src="https://img.shields.io/github/v/release/majiayu000/caude-skill-manager?style=flat-square" alt="Release"></a>
-  <img src="https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat-square&logo=go" alt="Go">
+  <img src="https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat-square&logo=go" alt="Go">
   <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License">
   <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome">
 </p>
@@ -20,7 +20,7 @@
 ## Why sk?
 
 - 🚀 **One-command install** — `sk install user/repo`
-- 🔄 **Batch update** — `sk update` to update all skills
+- 🔄 **Batch update** — `sk update` (coming soon)
 - 🔍 **Smart search** — `sk search testing`
 - 🩺 **Health check** — `sk doctor` to find issues
 - 🎨 **Beautiful TUI** — Built with [Charm](https://charm.sh)
@@ -55,6 +55,9 @@ sk install anthropics/skills/docx
 sk install obra/superpowers
 sk install https://github.com/user/repo
 
+# Install a skill by registry name
+sk install docx
+
 # List installed skills
 sk list
 
@@ -120,6 +123,9 @@ Anthropic Official (anthropics/skills)
 ## Supported Sources
 
 ```bash
+# From registry by name
+sk install docx
+
 # Short format
 sk install owner/repo              # Entire repo
 sk install owner/repo/path         # Subdirectory (monorepo)
@@ -152,10 +158,14 @@ Config file: `~/.skrc`
 ```json
 {
   "skills_dir": "~/.claude/skills",
-  "registry": "github"
+  "registry": "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main"
 }
 ```
 
+Registry cache:
+- Location: `~/.cache/sk/registry.json`
+- TTL: 24 hours (cache is ignored after expiry)
+
 ## Built With
 
 - [Cobra](https://github.com/spf13/cobra) — CLI framework

internal/registry/registry.go

@@ -15,6 +15,7 @@ import (
 const (
 	// DefaultRegistryURL is the base URL for the skill registry
 	DefaultRegistryURL = "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main"
+	registryCacheTTL   = 24 * time.Hour
 )
 
 // Registry represents the skill registry
@@ -234,6 +235,14 @@ func ResolveInstall(name string) (string, RegistrySource, error) {
 
 func loadRegistryCache() (*Registry, error) {
 	path := config.RegistryCachePath()
+	info, err := os.Stat(path)
+	if err != nil {
+		return nil, err
+	}
+	if time.Since(info.ModTime()) > registryCacheTTL {
+		return nil, fmt.Errorf("registry cache expired")
+	}
+
 	data, err := os.ReadFile(path)
 	if err != nil {
 		return nil, err