ralph SKILL.md skillA

ralph from jellydn/my-ai-tools is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jellydn/my-ai-tools/ralph@git:20260709.42d5cb9

Pins git:20260709.42d5cb9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jellydn/my-ai-tools
Path
skills/ralph/SKILL.md
Versions recorded
5
Latest version
git:20260709.42d5cb9, committed Jul 9, 2026
First version recorded
Apr 5, 2026
Size
7,355 bytes
Repository stars
123
License
MIT

Convert PRDs to prd.json format for the Ralph autonomous agent system.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Ralph PRD Converter

Converts existing PRDs to the prd.json format that Ralph uses for autonomous execution.

---

## The Job

Take a PRD (markdown file or text) and convert it to `prd.json` in your ralph directory.

---

## Output Format

```json
{
	"project": "[Project Name]",
	"branchName": "ralph/[feature-name-kebab-case]",
	"description": "[Feature description from PRD title/intro]",
	"userStories": [
		{
			"id": "US-001",
			"title": "[Story title]",
			"description": "As a [user], I want [feature] so that [benefit]",
			"acceptanceCriteria": ["Criterion 1", "Criterion 2", "Typecheck passes"],
			"priority": 1,
			"passes": false,
			"notes": ""
		}
	]
}
```

---

## Story Size: The Number One Rule

**Each story must be completable in ONE Ralph iteration (one context window).**

Ralph spawns a fresh Amp instance per iteration with no memory of previous work. If a story is too big, the LLM runs out of context before finishing and produces broken code.

### Right-sized stories:

- Add a database column and migration
- Add a UI component to an existing page
- Update a server action with new logic
- Add a filter dropdown to a list

### Too big (split these):
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jellydn/my-ai-tools/ralph@sha256:f6b5a9f15d21a34a

The line at the top of this page pins the label git:20260709.42d5cb9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fbt3rde7tqh5woph.svg)](https://markdownregistry.com/a/art_fbt3rde7tqh5woph)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Apr 5, 2026 and Jul 9, 2026, about one every 24 days.

versioncommittedcommitsizeaudit
git:20260709.42d5cb9 latest2026-07-09 42d5cb9 7,355 BA view · diff
git:20260708.83bb5092026-07-08 83bb509 7,324 BA view · diff
git:20260629.a5d98dc2026-06-29 a5d98dc 7,505 BA view · diff
git:20260510.4e868482026-05-10 4e86848 7,498 BA view · diff
git:20260405.08fada92026-04-05 08fada9 7,715 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7355 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jellydn/my-ai-tools · 123 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fbt3rde7tqh5woph
GET https://markdownregistry.com/api/v1/resolve?ref=jellydn/my-ai-tools/ralph
GET https://markdownregistry.com/api/v1/blob/f6b5a9f15d21a34a4f5af2d42241d72c0556c8ded66913a99282471eaa9b2b22

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jellydn/my-ai-tools

AGENTS.md AGENTS.md file
jellydn/my-ai-tools · AGENTS.md
git:20261018.b82a81f · audit A · 123 stars
AGENTS.md@configs/amp AGENTS.md file
jellydn/my-ai-tools · configs/amp/AGENTS.md
git:20260913.e2e25be · audit A · 123 stars
accountable-engineering SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/accountable-engineering/SKILL.md · Use explicit human checkpoints for architecture, security, rollout, or operational decisions.
git:20260913.e2e25be · audit A · 123 stars
adr SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/adr/SKILL.md · Record architecture decisions with ADRs — captures why, alternatives considered, and consequences
git:20260814.d1987f5 · audit A · 123 stars
babysit-pr SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/babysit-pr/SKILL.md · Use when monitoring an open GitHub PR for CI failures, review feedback, mergeability, and safe retries or fixes.
v1.0.0 · audit A · 123 stars
blindspot-pass SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/blindspot-pass/SKILL.md · Inspect history and architecture for hidden constraints before risky cross-cutting changes.
git:20261007.163951e · audit A · 123 stars
capability-experiments SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/capability-experiments/SKILL.md · Build an interactive report or experiment when the user asks to explore model capabilities.
git:20260913.e2e25be · audit B · 123 stars
code-quality-review SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/code-quality-review/SKILL.md · Audit a diff for structural maintainability and unnecessary complexity.
git:20260913.e2e25be · audit A · 123 stars
code-review SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/code-review/SKILL.md · Review a branch, PR, or worktree diff for repository conventions and stated intent.
git:20261006.f663cbc · audit A · 123 stars
codemap SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/codemap/SKILL.md · Create a seven-document architecture map when the user asks to map a codebase.
git:20261007.a4a976f · audit B · 123 stars
commit-atomic SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/commit-atomic/SKILL.md · Group staged changes into atomic commits with commitizen convention
git:20260814.d1987f5 · audit A · 123 stars
context-discovery SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/context-discovery/SKILL.md · Use MCP tools to trace behavior that spans multiple modules or history sources.
git:20260913.e2e25be · audit A · 123 stars

Every file in jellydn/my-ai-tools

Other files named ralph

ralph SKILL.md skill
yeachan-heo/oh-my-claudecode · skills/ralph/SKILL.md · Self-referential loop until task completion with configurable verification reviewer
git:20261013.8508733 · audit A · 40,148 stars
ralph SKILL.md skill
zereight/gitlab-mcp · .github/skills/ralph/SKILL.md · PRD-driven persistence loop until task completion with verification. Activate when user says: ralph, don't stop, must…
git:20260412.9d9ce51 · audit A · 2,059 stars
ralph SKILL.md skill
jmagly/aiwg · agentic/code/addons/agent-loop/skills/ralph/SKILL.md · Execute iterative task loop until completion criteria are met - iteration beats perfection
git:20260726.1961464 · audit A · 225 stars
ralph SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/ralph/SKILL.md · Convert PRDs to prd.json format for the Ralph autonomous agent system
git:20260814.d1987f5 · audit A · 123 stars
ralph SKILL.md skill
chainlesschain/chainlesschain · desktop-app-vue/src/main/ai-engine/cowork/skills/builtin/ralph/SKILL.md · Drive an approved plan to completion as a single persistent owner. Third step of the canonical coding workflow.
v1.0.0 · audit A · 11 stars
ralph SKILL.md skill
naimkatiman/continuous-improvement · third-party/oh-my-claudecode/skills/ralph/SKILL.md · Self-referential loop until task completion with configurable verification reviewer
git:20260906.bface5c · audit A · 9 stars
ralph SKILL.md skill
naimkatiman/continuous-improvement · plugins/continuous-improvement/skills/ralph/SKILL.md · Enforces Law 6 (Iterate Means One Thing) of the 7 Laws of AI Agent Discipline at PRD scale. Ralph is an autonomous AI…
git:20260517.966ce51 · audit A · 9 stars

Browse by kind, by grade A, or by owner.