Tooluck logoTooluck
SKILL.md

skillshare-cli-e2e-test

Agent skill fromrunkids/skillshare

Run isolated E2E tests in devcontainer from ai_docs/tests runbooks. Use this skill whenever the user asks to: run an E2E test, execute a test runbook, validate a feature end-to-end, create a new runbook, or test CLI behavior in isolation. If you need to run a multi-step CLI validation sequence (init → install → sync → verify), this is the skill — it handles ssenv isolation, flag verification, and structured reporting. Prefer this over ad-hoc docker exec sequences for any test that follows a runbook or needs reproducible isolation.

How to install skillshare-cli-e2e-test

install skillshare-cli-e2e-test
# install the skillshare pack with the skills CLI
npx skills add runkids/skillshare

# or add only this skill to Claude Code: copy the folder

.skillshare/skills/skillshare-cli-e2e-test/

# into

~/.claude/skills/skillshare-cli-e2e-test/ (all projects)

.claude/skills/skillshare-cli-e2e-test/ (one project)

.skillshare/skills/skillshare-cli-e2e-test/SKILL.md

MITFull file
1Run isolated E2E tests in devcontainer. $ARGUMENTS specifies runbook name or "new".
2
3Before acting, run `python3 scripts/ai-context.py testing`. The topic is the source of truth for isolation, runbook quality and reporting rules; this skill retains the execution flow and mdproof recipes.
4
5## Flow
6
7### Phase 0: Environment Check
8
91. Confirm devcontainer is running and get container ID:
10 ```bash
11 CONTAINER=$(docker compose -f .devcontainer/docker-compose.yml ps -q skillshare-devcontainer)
12 ```
13 - If empty → prompt user: `docker compose -f .devcontainer/docker-compose.yml up -d`
14 - Ensure `CONTAINER` is set for all subsequent `docker exec` calls.
15
162. Confirm Linux binary is available:
17 ```bash
18 docker exec $CONTAINER bash -c \
19 '/workspace/.devcontainer/ensure-skillshare-linux-binary.sh && ss version'
20 ```
21
223. Confirm mdproof is installed:
23 ```bash
24 docker exec $CONTAINER /workspace/.devcontainer/ensure-mdproof.sh
25 ```
26 This auto-installs from GitHub release, or falls back to `/workspace/bin/mdproof` (local dev binary).
27
284. Check for lessons learned from previous runs:
29 ```bash
30 test -f /workspace/.mdproof/lessons-learned.md && cat /workspace/.mdproof/lessons-learned.md
31 ```
32 If the file exists, read it before writing or debugging runbooks — it contains known gotchas and assertion patterns.
33
34### Phase 1: Detect Scope
35
361. Preview all available runbooks via the container:
37 ```bash
38…

Excerpt shown under the repository's MIT license.

More skills in skillshare

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates