Agent skill

E2E Session Test

by st0012 in st0012/cctop

A skill your agent uses when smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel.

MITAuto-check passedTesting & QA

Install E2E Session Test

skills CLI
$ npx skills add st0012/cctop --skill e2e-session-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install st0012/cctop e2e-session-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/st0012/cctop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/e2e-session-test .claude/skills/e2e-session-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
e2e-session-test
GitHub stars
154
Token cost
~727 tokens
SKILL.md length
273 words
Files
4 (incl. scripts, references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel.

  • Smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel
  • SKILL.md covers Capabilities, not tools, Create the session with a CLI…, Steps (run from the repo root) and PASS
  • Runs Shell scripts from its folder
  • Smoke test sessions

What it does

E2E Session Test is an agent skill from st0012/cctop. Use when smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel. Trigger on "smoke test sessions", "verify session tracking", "test the hook pipeline", "check cctop picks up a claude/codex/opencode/pi session", or "run the e2e test", even without the word "skill". Creates a real CLI agent session in a terminal, confirms cctop tracks it, opens the panel programmatically, and captures screenshot proof.

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/troubleshooting.md`, `scripts/cctop-sessions.sh` and `scripts/launch-cli-session.sh`).

It sits in Testing & QA, covering End-to-end testing and QA and bug reports. It works with macOS. The repository describes itself as: A keyboard-first menubar app to monitor and jump between AI coding sessions — minimum setup required. The licence is MIT.

When your agent uses it

  • Smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel
  • Smoke test sessions
  • Verify session tracking
  • Test the hook pipeline

Example prompts

  • “smoke test sessions”
  • “verify session tracking”
  • “test the hook pipeline”
  • “/e2e-session-test”

Requirements

  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 4ee2258. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

E2E Session Test loads about 727 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 273 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~118
When it runs · the whole SKILL.md, loaded when a task matches
~727
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from st0012/cctop at commit 4ee2258, republished under its MIT licence (© st0012). 273 words, ~727 tokens.

Download SKILL.mdSave it as .claude/skills/e2e-session-test/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
e2e-session-test
description
Use when smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel. Trigger on "smoke test sessions", "verify session tracking", "test the hook pipeline", "check cctop picks up a claude/codex/opencode/pi session", or "run the e2e test", even without the word "skill". Creates a real CLI agent session in a terminal, confirms cctop tracks it, opens the panel programmatically, and captures screenshot proof.

cctop end-to-end session test

Verify a real session flows all the way through:

agent in a terminal → cctop hooks → ~/.cctop/sessions/<pid>.json → panel card

A good smoke test after touching hooks, the session schema, or the panel.

Capabilities, not tools

Harness-agnostic — it needs three generic capabilities. Use your environment's equivalent; don't assume a specific tool:

  • run shell commands
  • capture a screenshot of the screen (or fall back to the screencapture CLI)
  • view an image you captured

Create the session with a CLI agent in a terminal

Drive a CLI agent (claude / codex / opencode / pi) in a terminal window — it's a real session and one shell command starts it. Don't try to puppet a desktop agent's GUI: if it's the app hosting you, screen capture hides its window and you can't confirm input landed (see references/troubleshooting.md). Requires a cctop build with the cctop:// URL scheme (ships with this skill).

Steps (run from the repo root)

bash
# 1. Baseline — note the PIDs
.claude/skills/e2e-session-test/scripts/cctop-sessions.sh

# 2. Create a session — opens a terminal running the agent, waits for it to register
.claude/skills/e2e-session-test/scripts/launch-cli-session.sh claude ~/projects/cctop

# 3. Verify — a new PID entry with the right source (cc/codex/opencode/pi) appears
.claude/skills/e2e-session-test/scripts/cctop-sessions.sh

# 4. Summon the panel
open cctop://toggle

Then capture a screenshot and confirm the new session's card is in the panel (right status, source, project). Run open cctop://toggle again to close it — a clean closed/open pair if you want before/after proof. For a shareable record, write a small HTML log embedding the screenshots.

Two details the launcher handles, because they otherwise make this fail silently: a login shell (so the agent's PATH, e.g. ~/.local/bin, resolves) and a trusted directory (so the agent doesn't stall at a folder-trust prompt). open cctop://toggle is used instead of a menu-bar click or hotkey because those need extra OS permissions under automation.

PASS

  • New tracked session within ~5s, correct source.
  • open cctop://toggle opens and closes the panel.
  • A screenshot shows the card.

On failure, grab the relevant ~/.cctop/logs/<session>.log entry and see references/troubleshooting.md.

© st0012, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in .claude/skills/e2e-session-test of st0012/cctop.

  • SKILL.md
  • references/troubleshooting.md
  • scripts/cctop-sessions.sh
  • scripts/launch-cli-session.sh

Open the folder on GitHubat commit 4ee2258

Compare with similar skills

E2E Session Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

E2E Session Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
E2E Session Test this skillst0012/cctop154—~727Automated safety check: PassMIT
Openclaw Parallels SmokeSafeAI-Lab-X/ClawKeeper1k—~1.1kAutomated safety check: PassNone
CodexBar Live QAsteipete/CodexBar22k—~1.2kAutomated safety check: PassMIT
Acceptance Evidence for Deliverieslobehub/lobehub83k—~9.7kAutomated safety check: PassApache-2.0
Senior QAnicepkg/auto-company1923 repos~1.1kAutomated safety check: NotesNone
Cherry Studio Regression TestsCherryHQ/cherry-studio52k—~1.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Openclaw Parallels Smoke

    SafeAI-Lab-X/ClawKeeper

    End-to-end Parallels smoke, upgrade, and rerun workflow for OpenClaw across macOS, Windows, and Linux guests.

    1k GitHub stars~1.1k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Testing & QAAuto-check passed
  • Senior QA

    nicepkg/auto-company

    Comprehensive QA and testing skill for quality assurance, test automation, and testing strategies for ReactJS, NextJS, NodeJS applications.

    192 GitHub starsUsed in 3 repos~1.1k tokens
    Testing & QAAuto-check: notes
  • Cherry Studio Regression Tests

    CherryHQ/cherry-studio

    Runs Cherry Studio's critical-path regression suite as deterministic Playwright E2E tests through a GitHub workflow on macOS and Windows runners.

    52k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Testing & QAAuto-check passed

More from st0012/cctop

  • Video Assets

    st0012/cctop

    A skill your agent uses when publishing, replacing, auditing, or linking cctop promo/demo video assets through GitHub Releases, especially the non-latest media-assets release.

    154 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed
  • Release

    st0012/cctop

    A skill your agent uses when cutting or preparing a cctop release - "cut a release", "release vX.Y.Z", "prepare a release", "bump the version and tag", "ship a new version".

    154 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed
  • Swiftui Debugging

    st0012/cctop

    A skill your agent uses when debugging SwiftUI issues in this macOS app — views not updating, layout problems, unnecessary re-renders, state ownership bugs, Preview crashes, or NSHostingView/NSPanel…

    154 GitHub stars~2k tokensUpdated 6 days ago
    Auto-check passed
  • Video Storyboard

    st0012/cctop

    A skill your agent uses when designing, scripting, or storyboarding a short demo, launch, explainer, or marketing video (especially for a developer tool, app, or SaaS), OR when auditing, critiquing…

    154 GitHub stars~3.4k tokensUpdated 6 days ago
    Auto-check passed
  • Cctop Setup

    st0012/cctop

    A skill your agent uses when cctop-hook command fails or is not found.

    154 GitHub stars~335 tokensUpdated 6 days ago
    Auto-check passed
  • Cctop Restart

    st0012/cctop

    Restart cctop for local development and testing. An agent skill from st0012/cctop.

    154 GitHub stars~395 tokensUpdated 6 days ago
    Auto-check passed

Works with

Categories

Questions about E2E Session Test

What does E2E Session Test do?

A skill your agent uses when smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel. E2E Session Test is an agent skill from st0012/cctop. Use when smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel.

When should I use E2E Session Test?

E2E Session Test fits situations like: smoke-testing cctop end to end — verifying a real coding-agent session is tracked and shows in the panel; smoke test sessions; verify session tracking; test the hook pipeline.

How do I install E2E Session Test in Claude Code?

Run `npx skills add st0012/cctop --skill e2e-session-test -a claude-code`. Or copy the skill folder (.claude/skills/e2e-session-test in st0012/cctop) into .claude/skills/e2e-session-test in your project. Claude Code loads it when a task matches its description.

How do I install E2E Session Test in Codex?

Run `npx skills add st0012/cctop --skill e2e-session-test -a codex`. Or copy the skill folder (.claude/skills/e2e-session-test in st0012/cctop) into .agents/skills/e2e-session-test in your project. Codex loads it when a task matches its description.

Can I use E2E Session Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add st0012/cctop --skill e2e-session-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/e2e-session-test, .gemini/skills/e2e-session-test, .github/skills/e2e-session-test and .opencode/skills/e2e-session-test in your project.

What does E2E Session Test need to run?

Going by SKILL.md and its folder, E2E Session Test needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does E2E Session Test access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is E2E Session Test safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does E2E Session Test use?

E2E Session Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does E2E Session Test use?

About 727 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 864 tokens, read only when the agent opens those files.

What are the alternatives to E2E Session Test?

Skills that share tags, products or a category with E2E Session Test: Openclaw Parallels Smoke (SafeAI-Lab-X/ClawKeeper, 1k stars), CodexBar Live QA (steipete/CodexBar, 22k stars), Acceptance Evidence for Deliveries (lobehub/lobehub, 83k stars) and Senior QA (nicepkg/auto-company, 192 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains E2E Session Test?

st0012 (a GitHub user) maintains it in st0012/cctop, which has 154 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 1, 2026.

Source: st0012/cctop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.