Files
skillshare/ai_docs/tests/atomgit_install_runbook.md
Willie 2657974fbe feat(runbook): lifecycle hooks via --setup/--teardown and runbook.json
Add setup and teardown commands that run before/after each runbook.
Config file (runbook.json) provides persistent defaults; CLI flags
override. Setup env vars persist to all steps via session executor.
Setup failure skips all steps; teardown failure is informational only.

Removed Step 0 from atomgit runbook — init is now in runbook.json.
2026-03-11 04:53:08 +08:00

1.8 KiB

AtomGit Install E2E Test

Scope

Verify that skillshare can install skills from AtomGit (Chinese git platform) using full HTTPS URLs. This confirms the "any Git host" promise works for non-standard platforms.

Known Limitation

AtomGit's git protocol (clone/ls-remote) may return 403 for non-China IPs. If git clone is geo-blocked, Step 1 will fail with a clone error. The URL parsing layer is fully covered via unit tests (gitHTTPSPattern).

Environment

  • Devcontainer with ssenv isolation (or China-based machine)
  • Network access required (online test — clones from atomgit.com)
  • Binary: ss (skillshare)

Steps

Step 1: Install from AtomGit full HTTPS URL

ss install https://atomgit.com/Cangjie-SIG/cangjie-docs-mcp --all

Expected:

  • exit_code: 0
  • Installed
  • cangjie-docs

Step 2: Verify skill appears in list

ss list --no-tui

Expected:

  • exit_code: 0
  • cangjie-docs-navigator

Step 3: Verify skill files exist on disk

find ~/.config/skillshare/skills/ -name "SKILL.md" -path "*cangjie*" | head -1

Expected:

  • exit_code: 0
  • regex: cangjie.*SKILL.md

Step 4: Verify sync distributes to targets

ss sync

Expected:

  • exit_code: 0
  • Sync complete
  • regex: \d+ linked
ls ~/.claude/skills/ | grep cangjie

Expected:

  • exit_code: 0
  • cangjie

Step 6: Uninstall the skill

ss uninstall cangjie-docs-navigator --force

Expected:

  • exit_code: 0
  • Moved to trash

Step 7: Verify cleanup

ss list --no-tui

Expected:

  • exit_code: 0
  • Not cangjie-docs-navigator

Pass Criteria

All 7 steps pass. The full install → list → sync → uninstall lifecycle works for an AtomGit-hosted repository.