mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
3.4 KiB
3.4 KiB
CLI E2E Runbook: First-Time ss User
This is a human-readable execution flow (not a .sh script) to simulate a first-time ss user end-to-end.
Scope
- Global mode first setup
initcreates config successfully- First skill sync to targets
- Per-target mode tuning (
target --mode) - Basic health check (
doctor)
Environment
Run inside devcontainer by default.
Optional: use ssenv for isolated HOME switching
Create and switch into a named isolated environment:
ssenv create first-use-demo
eval "$(ssenv --eval use first-use-demo)"
ssenv status
Or use no-eval shortcuts:
ssnew first-use-demo # create + enter isolated shell
ssuse first-use-demo # enter existing isolated shell
ssback # leave isolated context helper
Reset back to your normal shell environment:
eval "$(ssenv --eval reset)"
Delete isolated environment:
ssenv delete first-use-demo --force
Step 0: Verify command entrypoint
echo "HOME=$HOME"
which ss
which skillshare
ss version
Expected:
ss versionruns successfully- No
Exec format error
If you see Cannot run macOS (Mach-O) executable in Docker, run:
/workspace/.devcontainer/ensure-skillshare-linux-binary.sh
Step 1: Create isolated first-use HOME
export E2E_HOME="/tmp/ss-e2e-first-$(date +%s)"
rm -rf "$E2E_HOME"
mkdir -p "$E2E_HOME"
echo "E2E_HOME=$E2E_HOME"
Step 2: First init (non-interactive)
HOME="$E2E_HOME" ss init --no-copy --targets claude,cursor --mode merge --no-git --no-skill
Expected:
- Output contains
Initialized successfully - Output contains
Config: $E2E_HOME/.config/skillshare/config.yaml
Step 3: Verify config was created
test -f "$E2E_HOME/.config/skillshare/config.yaml" && echo "config_created=yes"
cat "$E2E_HOME/.config/skillshare/config.yaml"
Expected:
config_created=yes- YAML includes:
source: $E2E_HOME/.config/skillshare/skillsmode: mergetargets:withclaudeandcursor
Step 4: Add one demo skill to source
mkdir -p "$E2E_HOME/.config/skillshare/skills/hello-world"
cat > "$E2E_HOME/.config/skillshare/skills/hello-world/SKILL.md" <<'EOF'
# hello-world
This is an E2E demo skill.
EOF
Step 5: First sync
HOME="$E2E_HOME" ss sync
Expected:
- Sync output includes both targets:
claude: ...cursor: ...
Step 6: Verify skill reached both targets
test -f "$E2E_HOME/.claude/skills/hello-world/SKILL.md" && echo "claude_ok=yes"
test -f "$E2E_HOME/.cursor/skills/hello-world/SKILL.md" && echo "cursor_ok=yes"
Expected:
claude_ok=yescursor_ok=yes
Step 7: Simulate per-target compatibility tuning
Change only cursor to copy mode (leave global/default as-is).
HOME="$E2E_HOME" ss target cursor --mode copy
HOME="$E2E_HOME" ss sync
grep -n "mode: copy" "$E2E_HOME/.config/skillshare/config.yaml"
Expected:
- Command succeeds
- Config now contains
mode: copyunder cursor target override
Step 8: Run doctor
HOME="$E2E_HOME" ss doctor
Expected:
- Doctor completes without fatal errors
Pass/Fail Criteria
Pass when all are true:
initcreatesconfig.yaml- first
syncdelivershello-worldto both targets target cursor --mode copyis persisted and re-sync succeedsdoctorsucceeds
Fail if any step errors or expected files are missing.