Geb and Spock Browser Tests

What it does

When your agent uses it

• Writing a new Geb spec for a web page
• Reviewing Geb tests for brittle selectors or sleeps
• Creating Page Objects and Modules in a Groovy project
• Fixing a flaky Geb test

Example prompts

• “Write a Geb spec for the login page using a Page Object.”
• “Review this Geb test for brittle selectors and Thread.sleep calls.”
• “Create a Module for the navigation bar and use it in the dashboard spec.”

Requirements

• A Groovy project with Geb and Spock set up, such as through Gradle

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

1. 1Always use Page Objects — never inline selectors in specs.
2. 2Use at checkers — every Page Object must declare static at.
3. 3Prefer CSS selectors over XPath; avoid brittle nth-child selectors.
4. 4Use waitFor explicitly for dynamic content; never Thread.sleep.
5. 5Use GebReportingSpec (not GebSpec) so screenshots are captured on failure.
6. 6Keep specs in given/when/then blocks — one behaviour per feature method.
7. 7Use Modules for repeated UI components (nav bars, modals, form rows).
8. 8Avoid writing flaky tests by stress-testing your Geb spec before committing

What it can do on your machine

Read from SKILL.md and the folder at commit e433962. 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

  No scripts in the folder and no shell commands in SKILL.md (its code samples are groovy).

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

• Network

  Links to these hosts (documentation or services it may open):

  • groovy.apache.org
  • spockframework.org

  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

Geb and Spock Browser Tests loads about 2.4k tokens when it runs. Until then it costs about 124 tokens; SKILL.md has 712 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~124

When it runs · the whole SKILL.md, loaded when a task matches

~2.4k

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from apache/groovy-geb at commit e433962, republished under its Apache-2.0 licence (© apache). 712 words, ~2,363 tokens.

name

geb-spock

description

Write Geb browser automation tests using the Spock framework with best practices. Use this skill whenever the user asks to write, generate, fix, or review Geb test specs, mentions Geb, GebSpec, GebReportingSpec, or asks about browser automation with Groovy/Spock. Also trigger for requests involving Page Objects in a Groovy/Gradle project, `at` checkers, Geb content DSL, or `waitFor` usage. Even if the user just says "write me a Geb test" or "help me test this page", use this skill.

license

Apache-2.0

<!--
SPDX-License-Identifier: Apache-2.0

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.
-->

package com.example.specs

import geb.spock.GebReportingSpec
import com.example.pages.LoginPage
import com.example.pages.DashboardPage
import spock.lang.Stepwise   // only when steps truly depend on each other

@Stepwise                    // omit if steps are independent
class LoginSpec extends GebReportingSpec {

    def "successful login redirects to dashboard"() {
        given: "user is on the login page"
        to LoginPage

        when: "valid credentials are submitted"
        loginForm.username = "user@example.com"
        loginForm.password = "secret"
        loginForm.submit()

        then: "the dashboard is displayed"
        at DashboardPage
        welcomeMessage.text() == "Welcome, user@example.com"
    }

    def "login fails with invalid credentials"() {
        given:
        to LoginPage

        when:
        loginForm.username = "bad@example.com"
        loginForm.password = "wrong"
        loginForm.submit()

        then:
        at LoginPage
        errorMessage.displayed
        errorMessage.text().contains("Invalid credentials")
    }
}

package com.example.pages

import geb.Page
import com.example.modules.LoginFormModule

class LoginPage extends Page {

    // `at` checker — verified when `to` or `at` is called
    static at = { title == "Login | MyApp" }

    // URL for `to LoginPage`
    static url = "/login"

    static content = {
        // Lazy by default; set required: false for optional elements
        loginForm    { module(LoginFormModule) }
        errorMessage(required: false) { $(".alert-error") }
    }
}

class DashboardPage extends Page {
    static at = { $("h1.dashboard-title").displayed }
    static url = "/dashboard"

    static content = {
        welcomeMessage { $(".welcome-msg") }
        navBar         { module(NavBarModule) }
    }
}

package com.example.modules

import geb.Module

class LoginFormModule extends Module {

    static content = {
        username { $("input[name='username']") }
        password { $("input[name='password']") }
        submitBtn { $("button[type='submit']") }
    }

    void submit() {
        submitBtn.click()
    }
}

// Wait for element to appear (default timeout from GebConfig)
waitFor { $(".spinner").not(".active") }

// Wait with custom timeout (seconds)
waitFor(10) { successBanner.displayed }

// Wait and return the element
def result = waitFor { $(".result-row") }

// Use in content DSL for elements that load dynamically
static content = {
    // Wait for this element every time it's accessed
    asyncTable(wait: true) { $("table.results") }
}

def rows = 
rows.size() == 3
rows[0].find("td.name").text() == "Alice"

$("input[name='firstName']").value("Jane")
$("select[name='country']").value("US")
$("input[type='checkbox'][name='agree']").value(true)

// For custom JS dropdowns (not <select>)
$(".dropdown-trigger").click()
waitFor { $(".dropdown-menu").displayed }
$(".dropdown-menu li", text: "Option B").click()

// Checks URL and `at` checker
at ConfirmationPage
currentUrl.contains("/confirmation")

def networkLatency = java.time.Duration.ofMillis(500)
browser.networkLatency = networkLatency

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

Files

Just SKILL.md in .agents/skills/geb-spock of apache/groovy-geb.

Open the folder on GitHubat commit e433962