feat: add Claude Code slash commands for ctx operations

Create ctx skills as embedded templates that `ctx init` installs to
.claude/commands/:

- /ctx-save: Save context to session file
- /ctx-status: Show context summary
- /ctx-add-learning: Add a learning
- /ctx-add-decision: Add a decision
- /ctx-add-task: Add a task
- /ctx-agent: Load full context packet
- /ctx-archive: Archive completed tasks

Skills use the standard Claude Code command format with YAML frontmatter.

Also fix make install to work with sudo (build first, then sudo install).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: josealekhine

.context/LEARNINGS.md

@@ -277,3 +277,5 @@ Manual file reading is better for exploratory/memory questions:
 **Application**: No need to mandate one approach. Agents naturally pick appropriately:
 - "Do you remember?" → parallel file reads (need history)
 - "What should I work on?" → `ctx agent` (need tasks)
+
+- **[2026-01-23]** Claude Code skills are markdown files in .claude/commands/ with YAML frontmatter (description, argument-hint, allowed-tools). Body is the prompt. Use code blocks with ! prefix for shell execution. $ARGUMENTS passes command args.

.context/TASKS.md

@@ -62,16 +62,16 @@
 - [x] Update CONSTITUTION.md: archival is allowed, deletion is not
 
 ### Phase 9: Claude Slash Commands (Skills) `#priority:medium` `#area:cli`
-- [ ] Research how existing skills are registered (check ralph-loop pattern)
-- [ ] Create `/ctx-save` skill — calls `ctx session save`
-- [ ] Create `/ctx-status` skill — calls `ctx status`
-- [ ] Create `/ctx-add-learning` skill — calls `ctx add learning`
-- [ ] Create `/ctx-add-decision` skill — calls `ctx add decision`
-- [ ] Create `/ctx-add-task` skill — calls `ctx add task`
-- [ ] Create `/ctx-agent` skill — calls `ctx agent` (manual context load)
-- [ ] Create `/ctx-archive` skill — calls `ctx tasks archive`
+- [x] Research how existing skills are registered (check ralph-loop pattern)
+- [x] Create `/ctx-save` skill — calls `ctx session save`
+- [x] Create `/ctx-status` skill — calls `ctx status`
+- [x] Create `/ctx-add-learning` skill — calls `ctx add learning`
+- [x] Create `/ctx-add-decision` skill — calls `ctx add decision`
+- [x] Create `/ctx-add-task` skill — calls `ctx add task`
+- [x] Create `/ctx-agent` skill — calls `ctx agent` (manual context load)
+- [x] Create `/ctx-archive` skill — calls `ctx tasks archive`
 - [ ] Create `/ctx-loop` skill — calls `ctx loop` (generate Ralph loop script)
-- [ ] Update `ctx init` to create skill definitions in `.claude/commands/`
+- [x] Update `ctx init` to create skill definitions in `.claude/commands/`
 
 ### Phase 9b: Ralph Loop Integration `#priority:medium` `#area:cli`
 - [ ] Implement `ctx loop` command — generate a ready-to-use loop.sh script

Makefile

@@ -101,9 +101,11 @@ dogfood:
 	@test -n "$(TARGET)" || (echo "Usage: make dogfood TARGET=~/WORKSPACE/ctx-dogfood" && exit 1)
 	./hack/start-dogfood.sh $(TARGET)
 
-## install: Install to /usr/local/bin
-install: build
-	sudo cp $(BINARY) /usr/local/bin/$(BINARY)
+## install: Install to /usr/local/bin (run as: make build && sudo make install)
+install:
+	@test -f $(BINARY) || (echo "Binary not found. Run 'make build' first, then 'sudo make install'" && exit 1)
+	cp $(BINARY) /usr/local/bin/$(BINARY)
+	@echo "Installed ctx to /usr/local/bin/ctx"
 
 ## help: Show this help
 help:

internal/claude/embed.go

@@ -12,7 +12,7 @@ import (
 	"fmt"
 )
 
-//go:embed tpl/auto-save-session.sh tpl/block-non-path-ctx.sh
+//go:embed tpl/auto-save-session.sh tpl/block-non-path-ctx.sh tpl/commands/*.md
 var FS embed.FS
 
 // GetAutoSaveScript returns the auto-save session script.
@@ -33,6 +33,31 @@ func GetBlockNonPathCtxScript() ([]byte, error) {
 	return content, nil
 }
 
+// ListCommands returns the list of embedded command file names.
+func ListCommands() ([]string, error) {
+	entries, err := FS.ReadDir("tpl/commands")
+	if err != nil {
+		return nil, fmt.Errorf("failed to read commands directory: %w", err)
+	}
+
+	var names []string
+	for _, entry := range entries {
+		if !entry.IsDir() {
+			names = append(names, entry.Name())
+		}
+	}
+	return names, nil
+}
+
+// GetCommand returns the content of a command file.
+func GetCommand(name string) ([]byte, error) {
+	content, err := FS.ReadFile("tpl/commands/" + name)
+	if err != nil {
+		return nil, fmt.Errorf("failed to read command %s: %w", name, err)
+	}
+	return content, nil
+}
+
 // SettingsHooks represents the hooks section of settings.local.json
 type SettingsHooks struct {
 	PreToolUse []HookMatcher `json:"PreToolUse,omitempty"`

internal/claude/tpl/commands/ctx-add-decision.md

@@ -0,0 +1,12 @@
+---
+description: "Add a decision to DECISIONS.md"
+argument-hint: "\"decision text\""
+---
+
+Add a new decision to the context.
+
+```!
+ctx add decision $ARGUMENTS
+```
+
+Confirm the decision was added.

internal/claude/tpl/commands/ctx-add-learning.md

@@ -0,0 +1,12 @@
+---
+description: "Add a learning to LEARNINGS.md"
+argument-hint: "\"learning text\""
+---
+
+Add a new learning to the context.
+
+```!
+ctx add learning $ARGUMENTS
+```
+
+Confirm the learning was added.

internal/claude/tpl/commands/ctx-add-task.md

@@ -0,0 +1,12 @@
+---
+description: "Add a task to TASKS.md"
+argument-hint: "\"task text\""
+---
+
+Add a new task to the context.
+
+```!
+ctx add task $ARGUMENTS
+```
+
+Confirm the task was added.

internal/claude/tpl/commands/ctx-agent.md

@@ -0,0 +1,12 @@
+---
+description: "Get AI-ready context packet"
+argument-hint: "[--budget N]"
+---
+
+Load the full context packet for AI consumption.
+
+```!
+ctx agent $ARGUMENTS
+```
+
+This provides the complete context state optimized for AI assistants.

internal/claude/tpl/commands/ctx-archive.md

@@ -0,0 +1,12 @@
+---
+description: "Archive completed tasks"
+argument-hint: "[--dry-run]"
+---
+
+Move completed tasks from TASKS.md to the archive.
+
+```!
+ctx tasks archive $ARGUMENTS
+```
+
+Report how many tasks were archived.

internal/claude/tpl/commands/ctx-save.md

@@ -0,0 +1,12 @@
+---
+description: "Save current context to a session file"
+argument-hint: "[topic]"
+---
+
+Save the current context state to `.context/sessions/`.
+
+```!
+ctx session save $ARGUMENTS
+```
+
+Report the saved session file path to the user.