internal/builtins/content/ralph/SKILL.md
Ralph methodology — Samuel's default iteration loop. Plan, edit, verify, reflect; repeat until quality checks pass or max iterations is reached. Use when the user asks Samuel to "drive" a task autonomously, run a TDD loop, or apply the default methodology body. Bodies arrive in Milestone 4 (PRD 0004); this placeholder exists so the embedded built-ins directory is non-empty after `samuel init`.
npx skillsauth add ar4mirez/samuel ralphInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Ralph is Samuel's default methodology — a small, opinionated loop that plans, edits, verifies, and reflects on each iteration until quality checks pass.
The full executable body lands with PRD 0004. This file is the manifest
the framework ships so samuel doctor reports a healthy built-in tree
after a fresh samuel init.
Stop when every task is done, every quality check passes, or
max_iterations is reached. Hand control back to the user otherwise.
Defaults live in samuel.toml [methodology.ralph]:
agent — coding assistant the loop drives (default: claude)max_iterations — safety brake (default: 25)quality_checks — commands the loop must pass before stoppingdevelopment
Zig language guardrails, patterns, and best practices for AI-assisted development. Use when working with Zig files (.zig), build.zig, or when the user mentions Zig. Provides comptime patterns, allocator conventions, C interop guidelines, and testing standards specific to this project's coding standards.
tools
WordPress framework guardrails, patterns, and best practices for AI-assisted development. Use when working with WordPress projects, or when the user mentions WordPress. Provides theme development, plugin architecture, REST API, blocks, and security guidelines.
tools
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Use when testing web apps, automating browser interactions, or debugging frontend issues.
tools
Suite of tools for creating elaborate, multi-component web applications using modern frontend technologies (React, Tailwind CSS, shadcn/ui). Use for complex projects requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX pages.