Added post-install automated skill installation

Author: edumansky

README.md

@@ -297,37 +297,38 @@ prompt-tools completion fish > ~/.config/fish/completions/prompt-tools.fish
 
 ## Coding Agent Skill
 
-A skill file is included at `skill/SKILL.md` that teaches AI coding agents how to use the CLI. Install it for your agent of choice:
+A skill file is included at `skill/SKILL.md` that teaches AI coding agents how to use the CLI.
 
-**Claude Code (macOS/Linux):**
+### Automatic Setup
+
+The installer and `prompt-tools post-install` command will offer to install the skill for detected agents (Claude Code, Claude Cowork, OpenAI Codex, Cursor) via an interactive menu. Skills are also kept up to date when you run `prompt-tools update`.
+
+### Manual Setup
+
+If you prefer to install manually:
+
+**Claude Code:**
 ```bash
 mkdir -p ~/.claude/skills/prompt-tools
 curl -fsSL https://raw.githubusercontent.com/Cloverhound/prompt-tools-cli/main/skill/SKILL.md \
   -o ~/.claude/skills/prompt-tools/SKILL.md
 ```
 
-**Claude Code (Windows PowerShell):**
-```powershell
-New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\prompt-tools"
-Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Cloverhound/prompt-tools-cli/main/skill/SKILL.md" `
-  -OutFile "$env:USERPROFILE\.claude\skills\prompt-tools\SKILL.md"
-```
-
-**OpenAI Codex (macOS/Linux):**
+**OpenAI Codex:**
 ```bash
-mkdir -p ~/.agents/skills/prompt-tools
+mkdir -p ~/.codex/skills/prompt-tools
 curl -fsSL https://raw.githubusercontent.com/Cloverhound/prompt-tools-cli/main/skill/SKILL.md \
-  -o ~/.agents/skills/prompt-tools/SKILL.md
+  -o ~/.codex/skills/prompt-tools/SKILL.md
 ```
 
-**Cursor (macOS/Linux):**
+**Cursor:**
 ```bash
 mkdir -p ~/.cursor/skills/prompt-tools
 curl -fsSL https://raw.githubusercontent.com/Cloverhound/prompt-tools-cli/main/skill/SKILL.md \
   -o ~/.cursor/skills/prompt-tools/SKILL.md
 ```
 
-If the `prompt-tools` binary isn't in your PATH, update the binary path inside the installed skill file.
+**Claude Cowork:** Run `prompt-tools post-install` to generate the ZIP, then upload at: Claude Desktop → Cowork tab → Customize → Skills → + → Upload a skill.
 
 For project-specific installation, place the skill file in your project directory instead of the user-level folder.
 

cmd/postinstall.go

@@ -0,0 +1,319 @@
+package cmd
+
+import (
+	"archive/zip"
+	"bytes"
+	"fmt"
+	"io"
+	"net/http"
+	"os"
+	"path/filepath"
+	"runtime"
+	"strings"
+
+	"github.com/charmbracelet/huh"
+	"github.com/charmbracelet/lipgloss"
+	"github.com/spf13/cobra"
+)
+
+const skillURL = "https://raw.githubusercontent.com/Cloverhound/prompt-tools-cli/main/skill/SKILL.md"
+
+const coworkName = "Claude Cowork"
+
+type agentPlatform struct {
+	Name     string
+	SkillDir string // relative to home dir
+}
+
+var agentPlatforms = []agentPlatform{
+	{"Claude Code", filepath.Join(".claude", "skills", "prompt-tools")},
+	{coworkName, ""}, // Cowork requires ZIP upload via web UI
+	{"OpenAI Codex", filepath.Join(".codex", "skills", "prompt-tools")},
+	{"Cursor", filepath.Join(".cursor", "skills", "prompt-tools")},
+}
+
+var postInstallCmd = &cobra.Command{
+	Use:   "post-install",
+	Short: "Run post-installation setup (PATH, agent skills)",
+	RunE: func(cmd *cobra.Command, args []string) error {
+		execPath, err := os.Executable()
+		if err != nil {
+			return fmt.Errorf("detecting executable path: %w", err)
+		}
+		installDir := filepath.Dir(execPath)
+
+		// Step 1: PATH setup
+		if !dirInPath(installDir) {
+			if runtime.GOOS == "windows" {
+				if err := setupWindowsPath(installDir); err != nil {
+					return err
+				}
+			} else {
+				if err := setupUnixPath(installDir); err != nil {
+					return err
+				}
+			}
+			fmt.Println()
+		}
+
+		// Step 2: Agent skill installation
+		if err := setupAgentSkills(); err != nil {
+			return err
+		}
+
+		return nil
+	},
+}
+
+func dirInPath(dir string) bool {
+	for _, p := range filepath.SplitList(os.Getenv("PATH")) {
+		if p == dir {
+			return true
+		}
+	}
+	return false
+}
+
+func setupUnixPath(installDir string) error {
+	shell := filepath.Base(os.Getenv("SHELL"))
+	var rcFile string
+	switch shell {
+	case "zsh":
+		rcFile = filepath.Join(os.Getenv("HOME"), ".zshrc")
+	case "bash":
+		rcFile = filepath.Join(os.Getenv("HOME"), ".bashrc")
+	default:
+		rcFile = filepath.Join(os.Getenv("HOME"), ".profile")
+	}
+
+	exportLine := fmt.Sprintf(`export PATH="%s:$PATH"`, installDir)
+
+	if data, err := os.ReadFile(rcFile); err == nil {
+		if strings.Contains(string(data), installDir) {
+			fmt.Printf("%s already references %s — restart your terminal or run: source %s\n", rcFile, installDir, rcFile)
+			return nil
+		}
+	}
+
+	var choice string
+	form := huh.NewForm(
+		huh.NewGroup(
+			huh.NewSelect[string]().
+				Title(fmt.Sprintf("%s is not in your PATH", installDir)).
+				Description(
+					fmt.Sprintf(
+						"The prompt-tools binary was installed to %s, but your shell\n"+
+							"can't find it yet. Adding it to %s will make the\n"+
+							"\"prompt-tools\" command available in all new terminal sessions.",
+						installDir, filepath.Base(rcFile),
+					),
+				).
+				Options(
+					huh.NewOption(fmt.Sprintf("Yes — add to %s", filepath.Base(rcFile)), "yes"),
+					huh.NewOption("No — I'll do it myself", "no"),
+				).
+				Value(&choice),
+		),
+	)
+
+	if err := form.Run(); err != nil {
+		return nil
+	}
+
+	if choice == "yes" {
+		f, err := os.OpenFile(rcFile, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
+		if err != nil {
+			return fmt.Errorf("opening %s: %w", rcFile, err)
+		}
+		defer f.Close()
+
+		if data, err := os.ReadFile(rcFile); err == nil && len(data) > 0 && data[len(data)-1] != '\n' {
+			f.WriteString("\n")
+		}
+		f.WriteString(exportLine + "\n")
+
+		fmt.Printf("Added to %s. Restart your terminal or run: source %s\n", rcFile, rcFile)
+	} else {
+		fmt.Println()
+		fmt.Println("To add it manually, run:")
+		fmt.Println()
+		fmt.Printf("  echo '%s' >> %s && source %s\n", exportLine, rcFile, rcFile)
+		fmt.Println()
+	}
+
+	return nil
+}
+
+func setupWindowsPath(installDir string) error {
+	fmt.Printf("Add %s to your system PATH to use the \"prompt-tools\" command.\n", installDir)
+	return nil
+}
+
+func setupAgentSkills() error {
+	home, err := os.UserHomeDir()
+	if err != nil {
+		return fmt.Errorf("detecting home directory: %w", err)
+	}
+
+	var options []huh.Option[string]
+	for _, p := range agentPlatforms {
+		label := p.Name
+		if p.Name == coworkName {
+			label += "  (saves ZIP to ~/Downloads for manual upload)"
+		}
+		opt := huh.NewOption(label, p.Name)
+		if agentDetected(home, p) {
+			opt = opt.Selected(true)
+		}
+		options = append(options, opt)
+	}
+
+	var selected []string
+	form := huh.NewForm(
+		huh.NewGroup(
+			huh.NewMultiSelect[string]().
+				Title("Install Prompt Tools skill for AI coding agents?").
+				Description(
+					"The Prompt Tools skill lets AI coding agents (Claude Code, Codex, Cursor)\n"+
+						"generate audio prompts and transcribe recordings using natural language.\n"+
+						"Detected agents are pre-selected.",
+				).
+				Options(options...).
+				Value(&selected),
+		),
+	)
+
+	if err := form.Run(); err != nil {
+		return nil
+	}
+
+	if len(selected) == 0 {
+		return nil
+	}
+
+	fmt.Print("Downloading Prompt Tools skill...")
+	skillContent, err := downloadSkill()
+	if err != nil {
+		fmt.Println(" failed")
+		return fmt.Errorf("downloading skill: %w", err)
+	}
+	fmt.Println(" ok")
+
+	for _, name := range selected {
+		for _, p := range agentPlatforms {
+			if p.Name != name {
+				continue
+			}
+			if p.Name == coworkName {
+				zipPath := filepath.Join(home, "Downloads", "prompt-tools-skill.zip")
+				if err := buildSkillZip(zipPath, "prompt-tools", skillContent); err != nil {
+					fmt.Printf("  %s: failed (%v)\n", p.Name, err)
+				} else {
+					fmt.Printf("  %s: saved to %s\n", p.Name, zipPath)
+					printCoworkInstructions(zipPath)
+				}
+			} else {
+				dest := filepath.Join(home, p.SkillDir, "SKILL.md")
+				if err := installSkill(dest, skillContent); err != nil {
+					fmt.Printf("  %s: failed (%v)\n", p.Name, err)
+				} else {
+					fmt.Printf("  %s: installed to %s\n", p.Name, dest)
+				}
+			}
+		}
+	}
+
+	return nil
+}
+
+func agentDetected(home string, p agentPlatform) bool {
+	if p.Name == coworkName {
+		switch runtime.GOOS {
+		case "darwin":
+			_, err := os.Stat("/Applications/Claude.app")
+			return err == nil
+		case "windows":
+			_, err := os.Stat(filepath.Join(os.Getenv("LOCALAPPDATA"), "AnthropicClaude"))
+			return err == nil
+		}
+		return false
+	}
+	topDir := filepath.Join(home, strings.SplitN(p.SkillDir, string(filepath.Separator), 2)[0])
+	info, err := os.Stat(topDir)
+	return err == nil && info.IsDir()
+}
+
+func downloadSkill() ([]byte, error) {
+	resp, err := http.Get(skillURL)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("HTTP %d", resp.StatusCode)
+	}
+
+	return io.ReadAll(resp.Body)
+}
+
+func printCoworkInstructions(zipPath string) {
+	box := lipgloss.NewStyle().
+		Border(lipgloss.RoundedBorder()).
+		BorderForeground(lipgloss.Color("212")).
+		Padding(1, 2).
+		MarginLeft(2)
+
+	heading := lipgloss.NewStyle().
+		Bold(true).
+		Foreground(lipgloss.Color("212"))
+
+	step := lipgloss.NewStyle().
+		Foreground(lipgloss.Color("252"))
+
+	sub := lipgloss.NewStyle().
+		Foreground(lipgloss.Color("245")).
+		Italic(true)
+
+	content := heading.Render("⚠ Action required: Upload skill to Claude Cowork") + "\n" +
+		sub.Render("Unlike Claude Code, Cowork skills must be manually uploaded to the Claude Desktop app.") + "\n\n" +
+		step.Render("1. Open Claude Desktop and switch to the Cowork tab") + "\n" +
+		step.Render("2. Click Customize (left sidebar) → Skills → + → Upload a skill") + "\n" +
+		step.Render("3. Select: "+zipPath)
+
+	fmt.Println(box.Render(content))
+}
+
+func buildSkillZip(dest, skillName string, skillContent []byte) error {
+	var buf bytes.Buffer
+	w := zip.NewWriter(&buf)
+
+	f, err := w.Create(skillName + "/SKILL.md")
+	if err != nil {
+		return fmt.Errorf("creating zip entry: %w", err)
+	}
+	if _, err := f.Write(skillContent); err != nil {
+		return fmt.Errorf("writing zip entry: %w", err)
+	}
+	if err := w.Close(); err != nil {
+		return fmt.Errorf("closing zip: %w", err)
+	}
+
+	dir := filepath.Dir(dest)
+	if err := os.MkdirAll(dir, 0755); err != nil {
+		return fmt.Errorf("creating directory: %w", err)
+	}
+	return os.WriteFile(dest, buf.Bytes(), 0644)
+}
+
+func installSkill(dest string, content []byte) error {
+	dir := filepath.Dir(dest)
+	if err := os.MkdirAll(dir, 0755); err != nil {
+		return fmt.Errorf("creating directory: %w", err)
+	}
+	return os.WriteFile(dest, content, 0644)
+}
+
+func init() {
+	rootCmd.AddCommand(postInstallCmd)
+}