Claude-project-skills-template setup

Project setup for ci-core-e2e-runner. Use when onboarding, setting up the repo, or troubleshooting setup issues.

install
source · Clone the upstream repo
git clone https://github.com/dohernandez/claude-project-skills-template
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/dohernandez/claude-project-skills-template "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/setup" ~/.claude/skills/dohernandez-claude-project-skills-template-setup && rm -rf "$T"
manifest: .claude/skills/setup/SKILL.md
source content

Setup

Purpose

Guide setup of the ci-core-e2e-runner project for local development and contribution. This is a shell/YAML project with GitHub Actions workflows and shell scripts -- no Node.js, no npm, no task runner.

Prerequisites

ToolVersionInstallVerify
GitAny
brew install git
git --version
GitHub CLIAny
brew install gh
gh --version
Bash4+(pre-installed on macOS/Linux)
bash --version

Optional (for VM provisioning work)

ToolVersionInstallVerify
DockerAny
brew install --cask docker
docker --version
shellcheckAny
brew install shellcheck
shellcheck --version

Setup Procedure

Step 0: (If new) Clone repository
        git clone git@github.com:genlayerlabs/ci-core-e2e-runner.git
        cd ci-core-e2e-runner
        (Skip if you already have the repo)

Step 1: Verify GitHub CLI authentication
        gh auth status
        (If not authenticated: gh auth login)

Step 2: Review project documentation
        Read CLAUDE.md for project overview, architecture, and commands

Step 3: Verify repository structure
        ls .github/workflows/    # Should contain run-e2e.yml
        ls scripts/              # Should contain setup-runner.sh, run-e2e.sh

Quick setup for existing clone:

gh auth status && cat CLAUDE.md

Project Structure

This is a minimal project:

DirectoryContents
.github/workflows/
GitHub Actions workflow files (run-e2e.yml)
scripts/
Shell scripts for VM provisioning and E2E orchestration
.claude/skills/
Claude Code skill definitions
CLAUDE.md
Project documentation and Claude instructions

What This Project Does

ci-core-e2e-runner receives

repository_dispatch
events from target repos (e.g., genlayer-node) and runs the full E2E test pipeline on a self-hosted VM:

  1. Clone target repo at the PR branch
  2. Deploy network, start WebDriver, run tests
  3. Post signed report back to the PR
  4. Signal pass/fail via reaction on the trigger comment

Troubleshooting

"gh: command not found"

Install GitHub CLI:

brew install gh

"gh auth status" shows not logged in

Authenticate with GitHub:

gh auth login

Scripts not executable

chmod +x scripts/*.sh

Automation

See

skill.yaml
for patterns and procedure. See
sharp-edges.yaml
for common pitfalls.