# Rf Keyword Builder

> Generate Robot Framework user keywords from structured intent. Use when asked to create keywords, add arguments, documentation, tags, setup/teardown, or to apply embedded-argument style based on existing project conventions. Use when this capability is needed.

- Skill: `tomevault-io/rf-keyword-builder` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/rf-keyword-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/rf-keyword-builder/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/rf-keyword-builder

---


# Robot Framework Keyword Builder

Create user keywords in Robot Framework syntax from structured input. Output JSON only.

## Input (JSON)

Provide input via `--input` or stdin. Example:

```json
{
  "keyword_name": "Create User",
  "description": "Creates a new user via the UI.",
  "arguments": [
    {"name": "username", "type": "str"},
    {"name": "role", "default": "viewer"}
  ],
  "tags": ["ui", "smoke"],
  "setup": {"keyword": "Open Browser", "args": ["${URL}", "chromium"]},
  "teardown": {"keyword": "Close Browser"},
  "style": "simple",
  "steps": [
    {"keyword": "Click", "args": ["Add User"]},
    {"keyword": "Input Text", "args": ["Username", "${username}"]},
    {"keyword": "Click", "args": ["Save"]}
  ]
}
```

## Command

```bash
python scripts/keyword_builder.py --input keyword.json
```

Detect embedded-argument style from an existing project:

```bash
python scripts/keyword_builder.py --input keyword.json --project-root . --detect-embedded
```

## Return values

Use `"return_value"` to add a `RETURN` statement at the end of the keyword:

```json
{
  "keyword_name": "Get Full Name",
  "arguments": [{"name": "first"}, {"name": "last"}],
  "steps": [{"assign": ["${result}"], "keyword": "Catenate", "args": ["${first}", "${last}"]}],
  "return_value": "${result}"
}
```

Multiple return values:

```json
"return_value": ["${var1}", "${var2}"]
```

## Notes

- **RF 7+ type annotations**: Robot Framework 7 and later support type annotations
  in `[Arguments]` using `${name}: type` syntax (e.g. `${count}: int`). This builder
  does not yet generate that syntax; type information is recorded in `[Documentation]`
  only.

## Output (JSON)
- `artifact`: keyword block
- `warnings` and `suggestions`
- `meta`: any detected project conventions

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/manykarim) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->