Documentation Index
Fetch the complete documentation index at: https://mintlify.com/snarktank/ralph/llms.txt
Use this file to discover all available pages before exploring further.
Ralph skills can be installed globally to use across all your projects or added per-project. They work with both Amp and Claude Code.
Prerequisites
Install an AI Coding Tool
Choose and install one of these tools:Amp CLI (Recommended)# Visit https://ampcode.com for installation instructions
npm install -g @anthropic-ai/claude-code
Authenticate
Follow the tool’s authentication process:# For Amp
amp auth
# For Claude Code
claude-code auth
Verify Installation
Test that the tool works:# For Amp
amp --version
# For Claude Code
claude-code --version
Installation Methods
Choose the method that best fits your workflow:
Method 1: Claude Code Marketplace (Easiest)
This method only works for Claude Code. For Amp, use Method 2 or 3.
Add Ralph Marketplace
/plugin marketplace add snarktank/ralph
Install Skills
/plugin install ralph-skills@ralph-marketplace
Verify Installation
List installed skills:You should see:
/prd - Generate Product Requirements Documents/ralph - Convert PRDs to prd.json format
Method 2: Global Installation (Manual)
Install skills globally to use across all projects:
# Clone the Ralph repository
git clone https://github.com/snarktank/ralph.git
cd ralph
# Copy skills to Amp config directory
cp -r skills/prd ~/.config/amp/skills/
cp -r skills/ralph ~/.config/amp/skills/
# Verify installation
ls ~/.config/amp/skills/
Skills installed globally are available in all projects. The AI tool automatically discovers them.
Method 3: Per-Project Installation
Install skills for a specific project only:
Copy Ralph Files
# From your project root
mkdir -p scripts/ralph
cp /path/to/ralph/ralph.sh scripts/ralph/
chmod +x scripts/ralph/ralph.sh
Copy Prompt Template
Choose the template for your AI tool:# Copy Amp prompt template
cp /path/to/ralph/prompt.md scripts/ralph/prompt.md
Copy Skills (Optional)
If you want project-specific skills:mkdir -p .amp/skills # or .claude/skills
cp -r /path/to/ralph/skills/prd .amp/skills/
cp -r /path/to/ralph/skills/ralph .amp/skills/
Verify Skills Work
Test that skills are properly installed:
Test PRD Skill
Type this command:Load the prd skill and create a PRD for a simple counter feature
Test Ralph Skill
After generating a PRD, test the converter:Load the ralph skill and convert the PRD to prd.json
prd.json file in your project. Configuration
Amp Auto-Handoff (Recommended)
Enable automatic context handoff for large stories:
Open Amp Settings
Edit ~/.config/amp/settings.json
Add Auto-Handoff Config
{
"amp.experimental.autoHandoff": { "context": 90 }
}
Save and Restart
Save the file and restart Amp: Auto-handoff allows Ralph to handle large stories that exceed a single context window by seamlessly continuing work in a fresh context.
Customizing Skills
You can customize skills for your specific needs:
Customize PRD Template
Edit the PRD skill to match your team’s format:
# Edit global skill
code ~/.config/amp/skills/prd/SKILL.md
- Add company-specific sections
- Change acceptance criteria format
- Adjust story sizing guidelines
- Add required technical considerations
Customize Ralph Converter
Edit the converter skill for project-specific needs:
code ~/.config/amp/skills/ralph/SKILL.md
- Adjust story size thresholds
- Add project-specific validation rules
- Change branch naming conventions
- Add custom acceptance criteria
File Locations
Key configuration directories:
Amp Config
directory
default:"~/.config/amp/"
Amp configuration and globally installed skills
Amp Skills
directory
default:"~/.config/amp/skills/"
Global skills available in all Amp projects
Claude Config
directory
default:"~/.claude/"
Claude Code configuration and globally installed skills
Claude Skills
directory
default:"~/.claude/skills/"
Global skills available in all Claude Code projects
Project Skills (Amp)
directory
default:".amp/skills/"
Project-specific Amp skills (optional)
Project Skills (Claude)
directory
default:".claude/skills/"
Project-specific Claude Code skills (optional)
Troubleshooting
Skills Not Found
If the AI tool doesn’t recognize skills:
-
Check installation path
# For Amp
ls ~/.config/amp/skills/
# For Claude Code
ls ~/.claude/skills/
-
Verify SKILL.md exists
# Check PRD skill
cat ~/.config/amp/skills/prd/SKILL.md
# Check Ralph skill
cat ~/.config/amp/skills/ralph/SKILL.md
-
Restart the AI tool
# Exit and restart
exit
amp # or claude-code
Skills Not Auto-Invoking
If skills don’t trigger automatically:
-
Check trigger phrases - Use exact phrases from the skill description:
- PRD: “create a prd”, “write prd for”, “plan this feature”
- Ralph: “convert this prd”, “turn into ralph format”
-
Explicitly load skills
Load the prd skill and [your request]
-
Verify skill metadata - Check that
SKILL.md has proper frontmatter:
---
name: prd
description: "Generate a Product Requirements Document..."
user-invocable: true
---
Permission Issues
If you get permission errors:
# Fix permissions on Amp config
chmod -R 755 ~/.config/amp/
# Fix permissions on Claude config
chmod -R 755 ~/.claude/
# Make ralph.sh executable
chmod +x scripts/ralph/ralph.sh
Next Steps
Now that skills are installed:
- Learn the workflow - Read the Skills Overview
- Generate a PRD - See the PRD Generator guide
- Convert to JSON - See the Ralph Converter guide
- Run Ralph - Check the main Ralph documentation
Uninstalling
To remove Ralph skills:
# Remove global skills
rm -rf ~/.config/amp/skills/prd
rm -rf ~/.config/amp/skills/ralph
# Remove project files
rm -rf scripts/ralph/
