Skills

Skillshare Devcontainer

Run CLI commands, tests, and debugging inside the skillshare devcontainer.

Install

npx skills add runkids/skillshare --skill skillshare-devcontainer -g -a claude-code -y
Repository
runkids/skillshare2.9k
Category
Design
Updated
3d ago
License
MIT
Context cost
Mediumabout 1,836 tokens
Runs scripts
No, instructions only

What it does

Run CLI commands, tests, and debugging inside the skillshare devcontainer. Use this skill whenever you need to: execute skillshare CLI commands for verification, run Go tests (unit or integration), reproduce bugs, test new features, start the web UI, or perform any operation that requires a Linux environment. All CLI execution MUST happen inside the devcontainer, never run skillshare commands on the host. If you are about to use Bash to run `ss`, `skillshare`, `go test`, or `make test`, stop and use this skill first to ensure correct container execution.

Execute CLI commands and tests inside the devcontainer. The host machine is macOS but the project binary is Linux, running CLI commands on the host will silently produce wrong results or fail. This skill prevents that mistake.

Before acting, run python3 scripts/ai-context.py testing and follow that topic. The topic is the source of truth for repository execution boundaries and test rules; this skill retains the interactive workflow and command recipes.

When to Use This

  • Running ss / skillshare commands for verification
  • Running go test, make test, make check
  • Reproducing a bug report
  • Testing a feature you just implemented
  • Starting the web UI dashboard
  • Any command that needs the skillshare binary or Go toolchain

When NOT to Use This

  • Editing source code (do that on host via Read/Edit tools)
  • Running git commands (git works on host)
  • Running make fmt, make lint (host-safe Go toolchain commands; no container needed)
  • E2E test runbooks → use cli-e2e-test skill instead (it handles ssenv isolation)

Architecture: Two Layers of Isolation

Host (macOS)
  └─ Devcontainer (Linux, Debian-based)
       ├─ Default HOME: /home/developer (persistent volume)
       ├─ Source: /workspace (bind-mount of repo root)
       └─ ssenv environments: ~/.ss-envs/<name>/ (isolated HOME dirs)

Devcontainer = Linux environment with Go, git, pnpm, air (hot-reload). Source code is at /workspace (bind-mount of the host repo). The ss / skillshare wrapper auto-builds from source on every invocation, no manual make build needed. Edit code on the host, then immediately docker exec to run it; the change is picked up automatically.

ssenv = Isolated HOME directories within the devcontainer. Each env gets its own ~/.config/skillshare/, ~/.claude/, etc. Use ssenv when you need a clean state (testing init, install, sync) without polluting the container's default HOME.

Zero-Rebuild Workflow

Read the whole SKILL.md on GitHub

More in Design