ralph-advisor

Audit repositories for Ralph methodology conformance and spec violations.

2|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/gjkeller/doctor-ralph --skill ralph-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-advisor
Source: https://github.com/gjkeller/doctor-ralph/tree/main/.cursor/skills/ralph-advisor
Command: npx skills add https://github.com/gjkeller/doctor-ralph --skill ralph-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill helps ensure that a repository adheres to the Ralph methodology by auditing its structure, documentation, and execution infrastructure.

Core Features & Use Cases

  • Automated Auditing: Checks for the presence and quality of essential Ralph components like loop.sh, PROMPT.md, AGENTS.md, and documentation structure.
  • Conformance Reporting: Provides a clear summary of the repository's conformance level (Not Runnable, Not Started, Partial, Good, Excellent).
  • Actionable Feedback: Identifies specific issues and offers prioritized recommendations for improvement.
  • Use Case: A team adopting Ralph can use this Skill to audit their new project's setup before starting development, ensuring they are following best practices from the outset.

Quick Start

Audit the current repository for Ralph conformance.

Frequently Asked Questions about ralph-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my repository for autonomous agent workflow compliance?

Auditing a repository for autonomous agent workflow compliance involves checking its execution infrastructure, document structure, and content quality against a specification. This Skill scans for essential components like `loop.sh`, `PROMPT.md`, and `AGENTS.md` to identify missing files and spec violations.

What is the Ralph methodology for autonomous agents?

The Ralph methodology is an autonomous agent specification that defines required execution infrastructure and documentation structures. Adherence requires specific files like `loop.sh`, `PROMPT.md`, and `AGENTS.md` to ensure proper agent execution and operational conformance within a repository.

How do I check if my project setup follows devops agent workflow best practices?

Checking devops agent workflow best practices involves running an automated audit on your project setup. This Skill analyzes your repository's structure and documentation, providing a conformance report that identifies missing components and offers prioritized recommendations for improvement.

Can I use a code review audit to measure repository conformance levels?

Yes, a code review audit can measure repository conformance levels by evaluating execution infrastructure and documentation. This Skill assesses your repository and categorizes conformance as Not Runnable, Not Started, Partial, Good, or Excellent based on the Ralph specification.

What components are required to pass a Ralph methodology compliance audit?

To pass a Ralph methodology compliance audit, a repository needs essential execution infrastructure and documentation components. The audit specifically checks for the presence and quality of `loop.sh`, `PROMPT.md`, `AGENTS.md`, and the overall documentation structure.

Why does my repository audit report a Not Runnable conformance level?

A repository audit reports a Not Runnable conformance level when critical execution infrastructure is missing or severely non-compliant. This indicates that essential components like `loop.sh` or required documentation files are absent, preventing the autonomous agent from operating according to the Ralph specification.