Files
skillshare/ai_docs/tests/atomgit_install_runbook.md
T
Willie 631b3ef292 docs: add AtomGit and Gitee to supported platform listings
- Add AtomGit/Gitee HTTPS examples in url-formats.md
- Add AtomGit/Gitee column to Platform Support table
- Update intro.md and comparison.md platform lists
- Add AtomGit install E2E runbook (geo-restriction noted)
2026-02-26 22:27:23 +08:00

2.2 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) returns 403 for non-China IPs. The HTTPS web interface (curl) returns 200, but git clone is geo-blocked. This means this runbook can only run from a China-based machine or VPN. The devcontainer (US/EU) cannot complete Steps 1-7.

Verified via unit tests: gitHTTPSPattern correctly parses https://atomgit.com/owner/repo — the URL parsing layer is fully covered.

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:

  • Install completes without error
  • Output contains "Installed" or skill name
  • Exit code 0

Step 2: Verify skill appears in list

ss list --no-tui

Expected:

  • Output contains at least one skill name from the installed repo
  • Skills are listed under source directory

Step 3: Verify skill files exist on disk

ls ~/.config/skillshare/skills/

Expected:

  • At least one directory exists (skill from AtomGit repo)
  • Directory contains a SKILL.md or markdown files

Step 4: Verify sync distributes to targets

ss sync

Expected:

  • Sync completes without error
  • Exit code 0
ls -la ~/.claude/skills/

Expected:

  • Symlinks exist pointing to ~/.config/skillshare/skills/ source
  • At least one symlink from the AtomGit-installed skill

Step 6: Uninstall the skill

ss uninstall cangjie-docs-mcp --force

Expected:

  • Uninstall completes without error
  • Skill moved to trash
  • Exit code 0

Step 7: Verify cleanup

ss list --no-tui

Expected:

  • The uninstalled skill no longer appears in the list

Pass Criteria

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