Skip to content

fix: update skills install paths to align with agent defaults #3617

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wsehl wants to merge 1 commit into
base: main
Choose a base branch
from
+22 −6
Open

fix: update skills install paths to align with agent defaults #3617

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 22 additions & 6 deletions cmd/hatchet-cli/cli/skills.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,10 @@ var skillsInstallCmd = &cobra.Command{
Short: "Install the Hatchet CLI agent skill package into your project",
Long: `Install Hatchet CLI agent skills into your project.

Creates the skill directory structure under {dir}/skills/hatchet-cli/ and
appends a reference section to the project AGENTS.md file.`,
Example: ` # Install to current directory (creates ./skills/hatchet-cli/)
Creates the skill directory structure under {dir}/.agents/skills/hatchet-cli/,
creates {dir}/.claude/skills/hatchet-cli as a symlink, and appends a reference
section to the project AGENTS.md file.`,
Example: ` # Install to current directory
hatchet skills install

# Install to a custom base directory
Expand All @@ -67,7 +68,7 @@ func init() {
rootCmd.AddCommand(skillsCmd)
skillsCmd.AddCommand(skillsInstallCmd)

skillsInstallCmd.Flags().StringVarP(&skillsInstallDir, "dir", "d", ".", "Target base directory (skill installs under {dir}/skills/hatchet-cli/)")
skillsInstallCmd.Flags().StringVarP(&skillsInstallDir, "dir", "d", ".", "Target base directory (creates .agents/skills/hatchet-cli, .claude/skills/hatchet-cli, and AGENTS.md)")
skillsInstallCmd.Flags().BoolVarP(&skillsInstallForce, "force", "f", false, "Skip confirmation prompts")
}

Expand All @@ -82,7 +83,8 @@ func runSkillsInstall() {
cli.Logger.Fatalf("could not resolve directory: %v", err)
}

skillDir := filepath.Join(baseDir, "skills", "hatchet-cli")
skillDir := filepath.Join(baseDir, ".agents", "skills", "hatchet-cli")
claudeSkillDir := filepath.Join(baseDir, ".claude", "skills", "hatchet-cli")
agentsFile := filepath.Join(baseDir, "AGENTS.md")

// 2. Print header and summary
Expand All @@ -98,6 +100,7 @@ func runSkillsInstall() {
fmt.Printf(" %s\n", skillDir+"/references/trigger-and-watch.md")
fmt.Printf(" %s\n", skillDir+"/references/debug-run.md")
fmt.Printf(" %s\n", skillDir+"/references/replay-run.md")
fmt.Printf(" %s (symlink → %s)\n", claudeSkillDir, skillDir)
fmt.Println()
fmt.Printf(" %s (appended)\n", agentsFile)
fmt.Println()
Expand Down Expand Up @@ -229,6 +232,19 @@ func runSkillsInstall() {
fmt.Printf(" ⚠ Could not create CLAUDE.md symlink: %v\n", symlinkErr)
}

if mkdirErr := os.MkdirAll(filepath.Dir(claudeSkillDir), 0o755); mkdirErr != nil {
cli.Logger.Fatalf("could not create .claude skills directory: %v", mkdirErr)
}

claudeTarget, relErr := filepath.Rel(filepath.Dir(claudeSkillDir), skillDir)
if relErr != nil {
claudeTarget = skillDir
}
_ = os.Remove(claudeSkillDir)
if symlinkErr := os.Symlink(claudeTarget, claudeSkillDir); symlinkErr != nil {
fmt.Printf(" ⚠ Could not create .claude skill symlink: %v\n", symlinkErr)
}

fmt.Println(styles.SuccessMessage("Skill installed to " + skillDir))

// 7. Append to project AGENTS.md
Expand Down Expand Up @@ -270,7 +286,7 @@ func runSkillsInstall() {
fmt.Println(styles.Section("Next steps"))
fmt.Println()
fmt.Println(" • Run " + styles.Code.Render("hatchet docs install") + " to add the Hatchet MCP server to your AI editor")
fmt.Println(" • Commit " + styles.Code.Render("skills/") + " and " + styles.Code.Render("AGENTS.md") + " to version control")
fmt.Println(" • Commit " + styles.Code.Render(".agents/") + ", " + styles.Code.Render(".claude/") + ", and " + styles.Code.Render("AGENTS.md") + " to version control")
fmt.Println()
}

Expand Down
Loading