site-e2e

Stars11

Forks1

UpdatedJune 10, 2026 at 21:02

Build the mdsmith.dev Hugo site, serve it locally, and run the Playwright end-to-end suite or drive it interactively. The same `serve.sh` entrypoint is used by Playwright's webServer, the CI job, and this skill, so the site rendered here is byte-identical to what CI and production render. Trigger when the user asks to "test the site", "run playwright", "drive the install picker", "screenshot the homepage", "check the Windows command swap", or "run the e2e suite".

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

jeduden

jeduden/mdsmith

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations·SOC 15-1253

SKILL.md

readonly

name	site-e2e
description	Build the mdsmith.dev Hugo site, serve it locally, and run the Playwright end-to-end suite or drive it interactively. The same `serve.sh` entrypoint is used by Playwright's webServer, the CI job, and this skill, so the site rendered here is byte-identical to what CI and production render. Trigger when the user asks to "test the site", "run playwright", "drive the install picker", "screenshot the homepage", "check the Windows command swap", or "run the e2e suite".
user-invocable	true
argument-hint	[test \| screenshot <url> \| serve]
allowed-tools	Bash(git rev-parse:), Bash(cd website/e2e && npm ci), Bash(npx playwright install:), Bash(cd website/e2e && npx playwright:), Bash(bash website/e2e/scripts/serve.sh:)

site-e2e

Build the mdsmith.dev Hugo site and serve it locally. Run the Playwright end-to-end suite. Or drive the live site interactively using the Playwright MCP server bundled with this plugin.

Prerequisites

Node 22+ with npm and npx on $PATH
Go 1.25+ (the repo already requires this)
The @playwright/test package installed: cd website/e2e && npm ci
Chromium browser: cd website/e2e && npx playwright install chromium

Steps

Run the full suite

Locate the repository root:
```
git rev-parse --show-toplevel
```
Run every subsequent command from that path.

Install dependencies if needed:

cd website/e2e && npm ci
npx playwright install chromium

Run the Playwright suite:
```
cd website/e2e && npx playwright test
```
Playwright's webServer config invokes website/e2e/scripts/serve.sh, which:

Runs go run ./cmd/mdsmith-release build-website to sync docs/ → website/content/docs/.
Renders the site with the pinned Hugo version.
Serves website/public/ on port 3001 (or the PORT env var).

If tests fail, open the HTML report:
```
cd website/e2e && npx playwright show-report
```
Traces and screenshots are in test-results/. In CI the report is uploaded as a job artifact.

Screenshot a page

Use the Playwright MCP server bundled with this plugin to navigate and screenshot a page without writing a test file.

Start the site server in one terminal:
```
bash website/e2e/scripts/serve.sh
```
Ask the agent to screenshot a URL: "Screenshot http://localhost:3001/"

The Playwright MCP server handles the browser session. It works headless with no display.

Serve only

To start the site and leave it running (useful for manual inspection or MCP interaction):

bash website/e2e/scripts/serve.sh

Architecture note

All three entry points — npx playwright test, the CI job (.github/workflows/e2e.yml), and this skill — call the same website/e2e/scripts/serve.sh. A change to the build or Hugo render path updates one file and all three callers stay in sync.

Reproducing a CI failure

The CI job sets CI=true, which enables retries and forbids test.only. Reproduce locally with:

CI=true npx playwright test

Traces are written on the first retry so a CI failure with a trace can be reproduced by adding --trace on locally.

More from this repository

same repository

docs-author

jeduden/mdsmith

Write Markdown documentation that picks the right Diátaxis type (tutorial, how-to, reference, background), derives matching title and summary fragments, and passes a global-English and anti-slop polish. Trigger when the user asks to "draft a doc", "write a how-to", "draft a reference", "write a background page", "rewrite this in the house voice", "summary for this page", "title for this page", "polish for non-native readers", "this reads like AI", "remove AI tells / slop", "what type of doc is this", or "polish the README or landing page". Skip this skill for content-rule fixes (line length, heading hygiene, readability) — those are enforced by `mdsmith check`.

2026-07-0111

mdsmith-security-review

jeduden/mdsmith

Security-review methodology specialized for mdsmith - the Go Markdown linter/formatter and its surfaces (CLI binary, the mdsmith lsp language server, the VS Code extension, the Obsidian plugin, the npm/PyPI/Homebrew/Flatpak distribution wrappers, and the Git merge-driver/pre-merge-commit hooks). Use this skill whenever the user asks for a security review, threat assessment, vulnerability audit, or PR security sign-off on mdsmith or any of its components - even when they name only one surface (e.g. review the VS Code extension, audit the LSP server, check this PR for security problems). Also use when reviewing code that parses untrusted Markdown, resolves the include and catalog path directives, statically lints the build recipe directive, or wires mdsmith into an editor or CI pipeline. Prefer this over a generic code review for anything mdsmith-related: it encodes the project's attack surface and current defenses so reviews stay consistent and accurate.

2026-07-0111

gh-pr-fixup

jeduden/mdsmith

Push changes, monitor CI, and address review comments until the PR is clean. Run after creating or updating a PR, or when CI fails or reviewers leave comments.

2026-06-1011

pick-plan

jeduden/mdsmith

Pick the next plan to start work on. Reads PLAN.md from origin/main, cross-references open PRs and existing branches, reads each non-completed plan's `depends-on:` frontmatter, filters out plans whose dependencies are not yet completed, splits the rest into "structurally important" (other plans depend on them) and "quick wins" (smaller-model plans), presents the top 4, then creates a branch, opens a draft PR, and dispatches an implementation Agent at the model the plan declares. Use when asked to "pick a plan", "start the next plan", "what plan should I work on", "begin a new plan", or "open a draft PR for plan N".

2026-06-1011

merge-queue

jeduden/mdsmith

Enqueue a PR into the merge queue after CI is green and reviews are resolved.

2026-06-0611

mdsmith-check

jeduden/mdsmith

Run `mdsmith check` on Markdown files in the current workspace and surface lint diagnostics. Useful without the `mdsmith-lsp` plugin — gives the same findings in a text report. Trigger when the user asks to "check my markdown", "run mdsmith check", "lint these files", or "show lint errors".

2026-05-1811

name	site-e2e
description	Build the mdsmith.dev Hugo site, serve it locally, and run the Playwright end-to-end suite or drive it interactively. The same `serve.sh` entrypoint is used by Playwright's webServer, the CI job, and this skill, so the site rendered here is byte-identical to what CI and production render. Trigger when the user asks to "test the site", "run playwright", "drive the install picker", "screenshot the homepage", "check the Windows command swap", or "run the e2e suite".
user-invocable	true
argument-hint	[test \| screenshot <url> \| serve]
allowed-tools	Bash(git rev-parse:), Bash(cd website/e2e && npm ci), Bash(npx playwright install:), Bash(cd website/e2e && npx playwright:), Bash(bash website/e2e/scripts/serve.sh:)

site-e2e

Build the mdsmith.dev Hugo site and serve it locally. Run the Playwright end-to-end suite. Or drive the live site interactively using the Playwright MCP server bundled with this plugin.

Prerequisites

Node 22+ with npm and npx on $PATH
Go 1.25+ (the repo already requires this)
The @playwright/test package installed: cd website/e2e && npm ci
Chromium browser: cd website/e2e && npx playwright install chromium

Steps

Run the full suite

Locate the repository root:
```
git rev-parse --show-toplevel
```
Run every subsequent command from that path.

Install dependencies if needed:

cd website/e2e && npm ci
npx playwright install chromium

Run the Playwright suite:
```
cd website/e2e && npx playwright test
```
Playwright's webServer config invokes website/e2e/scripts/serve.sh, which:

Runs go run ./cmd/mdsmith-release build-website to sync docs/ → website/content/docs/.
Renders the site with the pinned Hugo version.
Serves website/public/ on port 3001 (or the PORT env var).

If tests fail, open the HTML report:
```
cd website/e2e && npx playwright show-report
```
Traces and screenshots are in test-results/. In CI the report is uploaded as a job artifact.

Screenshot a page

Use the Playwright MCP server bundled with this plugin to navigate and screenshot a page without writing a test file.

Start the site server in one terminal:
```
bash website/e2e/scripts/serve.sh
```
Ask the agent to screenshot a URL: "Screenshot http://localhost:3001/"

The Playwright MCP server handles the browser session. It works headless with no display.

Serve only

To start the site and leave it running (useful for manual inspection or MCP interaction):

bash website/e2e/scripts/serve.sh

Architecture note

Reproducing a CI failure

The CI job sets CI=true, which enables retries and forbids test.only. Reproduce locally with:

CI=true npx playwright test

Traces are written on the first retry so a CI failure with a trace can be reproduced by adding --trace on locally.