fix(skills): polish agent picks useful Quick Start commands, not just working ones

afcd3bd61852c6e922b43a8115dd8f4895a464c9 · 2026-04-04 15:59:34 -0700 · Trevin Chow

Quick Start should show commands someone will actually use daily that
also demonstrate why the CLI exists — not just the first promoted
command that doesn't error. Guide: doctor → sync → transcendence
command (today, health) → search. Avoid raw list dumps.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Files touched

M agents/polish-worker.md

Diff

commit afcd3bd61852c6e922b43a8115dd8f4895a464c9
Author: Trevin Chow <trevin@trevinchow.com>
Date:   Sat Apr 4 15:59:34 2026 -0700

    fix(skills): polish agent picks useful Quick Start commands, not just working ones
    
    Quick Start should show commands someone will actually use daily that
    also demonstrate why the CLI exists — not just the first promoted
    command that doesn't error. Guide: doctor → sync → transcendence
    command (today, health) → search. Avoid raw list dumps.
    
    Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 agents/polish-worker.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/agents/polish-worker.md b/agents/polish-worker.md
index 6ed3be54..ad16f71d 100644
--- a/agents/polish-worker.md
+++ b/agents/polish-worker.md
@@ -111,7 +111,12 @@ If README uses template placeholders or generic examples, rewrite with:
 - Title matching CLI name
 - One-line description matching root Short
 - Install section
-- Quick start with 3-5 real usage examples
+- Quick Start with the commands someone will actually use first. Pick
+  commands that are both **most useful** (what you'd run daily) and
+  **show the CLI's value** (why install this over curl). Usually:
+  `doctor` → `sync` → a transcendence command like `today` or `health`
+  → `search`. Avoid raw list commands as the first example — they dump
+  data without demonstrating why the CLI exists.
 - Command list by category
 - Output format section

← c4befa79 fix(skills): polish agent reports skipped findings with reas · back to Cli Printing Press · fix(skills): comprehensive README requirements for polish ag 6e2e1b3c →