Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

docs(skills): tighten CLAUDE.md skills list, sharpen writing-user-outputs description (#2629)

Maximilian Roos2fbbbc229be6
diff --git a/.claude/skills/writing-user-outputs/SKILL.md b/.claude/skills/writing-user-outputs/SKILL.md
index 208e19417..afc7d9563 100644
--- a/.claude/skills/writing-user-outputs/SKILL.md
+++ b/.claude/skills/writing-user-outputs/SKILL.md
@@ -1,6 +1,6 @@
---
name: writing-user-outputs
-description: CLI output formatting standards for worktrunk. Use when writing user-facing messages, error handling, progress output, hints, warnings, or working with the output system.
+description: CLI output formatting standards for worktrunk. Load before editing any code that calls warning_message, hint_message, error_message, info_message, eprintln, or println, or that produces strings the user will see (CLI help, progress UI, snapshot text). Documents ANSI color nesting rules, message patterns, and output system architecture.
metadata:
internal: true
---
diff --git a/CLAUDE.md b/CLAUDE.md
index 5d2284050..7aca227e7 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -36,11 +36,13 @@ Use consistent terminology in documentation, help text, and code comments:
## Skills
-Check `.claude/skills/` for available skills and load those relevant to your task.
+**Load relevant skills before starting work, and reload when scope changes mid-session.**
-Key skills:
+Project-local skills in `.claude/skills/`:
-- **`writing-user-outputs`** — Required when modifying user-facing messages, hints, warnings, errors, or any terminal output formatting. Documents ANSI color nesting rules, message patterns, and output system architecture.
+- `writing-user-outputs` — load before editing any code that calls `warning_message`, `hint_message`, `error_message`, `info_message`, `eprintln`, or `println`, or that produces strings the user sees (CLI help, progress UI, snapshot text).
+- `running-tend` — operating in CI or writing tend workflows.
+- `release` — cutting a release.
## Testing