npx skills add ...
npx skills add el-feo/ai-context --skill cucumber-gherkin
BDD testing with Cucumber and Gherkin for Ruby and Rails applications. Use when writing feature files (.feature), step definitions, hooks, or implementing Behaviour-Driven Development in Ruby/Rails projects. Covers Gherkin keywords (Feature, Scenario, Given/When/Then, Background, Scenario Outline, Rule), Ruby step definition patterns, Cucumber Expressions, hooks (Before/After/BeforeAll/AfterAll), tags, data tables, doc strings, World modules, and Capybara integration. Triggers on cucumber, gherkin, BDD, feature files, step definitions, acceptance testing, executable specifications.
npx skills add el-feo/ai-context --skill cucumber-gherkin
BDD testing framework with plain-text executable specifications and Ruby step definitions.
Step keywords: Given (setup), When (action), Then (assertion), And/But (continuation), * (bullet)
Data tables:
Doc strings:
Tags: @smoke @critical on Feature/Rule/Scenario/Examples. Expressions: @smoke and not @slow, (@smoke or @critical) and not @wip
Cucumber Expressions: {int}, {float}, {word}, {string}, {} (anonymous). Optional: cucumber(s). Alternatives: color/colour.
State sharing: Use instance variables (@user) or World modules:
Order: BeforeAll > (Before > Background > Steps > After) per scenario > AfterAll
Declarative over imperative:
For comprehensive details:
references/gherkin-syntax.md — Complete Gherkin language reference (keywords, data tables, tags, i18n)references/step-definitions.md — Ruby step definition patterns (data tables, doc strings, custom parameter types, World context, organization)references/hooks-config.md — Hooks, cucumber.yml configuration, reporters, Capybara integrationreferences/best-practices.md — Anti-patterns, naming conventions, collaboration patterns, refactoringGiven the following users exist:
| name | email | role |
| Alice | alice@example.com | admin |Given a blog post with content:
"""markdown
# My Post Title
Content here.
"""# Cucumber Expressions (preferred)
Given('I have {int} cucumbers in my belly') do |count|
@belly = Belly.new
@belly.eat(count)
end
When('I wait {int} hour(s)') do |hours|
@belly.wait(hours)
end
Then('my belly should growl') do
expect(@belly.growling?).to be true
end
# Data table
Given('the following users exist:') do |table|
table.hashes.each { |row| User.create!(row) }
end
# Doc string
Given('a JSON payload:') do |json|
@payload = JSON.parse(json)
endmodule MyWorld
def current_user
@current_user ||= create(:user)
end
end
World(MyWorld)Before do |scenario|
@browser = Browser.new
end
After do |scenario|
save_screenshot("failure.png") if scenario.failed?
end
Before('@database') do
DatabaseCleaner.start
end
After('@database') do
DatabaseCleaner.clean
end
BeforeAll do
# once before any scenario
end
AfterAll do
# once after all scenarios
endbundle exec cucumber
cucumber --tags "@smoke and not @wip"
cucumber features/login.feature:10
cucumber --dry-run
cucumber --format html --out report.html
bundle exec parallel_cucumber features/# Good # Avoid
When "Bob" logs in When I visit "/login"
Then he sees his dashboard And I enter "bob" in "username"
And I click "Login"