Skip to content
Back to search

ralph-wiggum-marketer

MarketplaceWorks with Claude CodeGitHub

A Claude Code Plugin that provides an autonomous AI copywriter.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/muratcankoylan-ralph-wiggum-marketer/badge.svg)](/listings/muratcankoylan-ralph-wiggum-marketer)

HTML

<a href="/listings/muratcankoylan-ralph-wiggum-marketer"><img src="/api/listings/muratcankoylan-ralph-wiggum-marketer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option 1: Add as Marketplace (Recommended)

# In Claude Code, add the repo as a marketplace:
/plugin marketplace add muratcankoylan/ralph-wiggum-marketer

# Then install the plugin:
/plugin install ralph-wiggum-marketer@muratcankoylan-ralph-wiggum-marketer

Option 2: Test Locally (For Development)

# Clone the repo
git clone https://github.com/muratcankoylan/ralph-wiggum-marketer.git

# Run Claude Code with the plugin directory
claude --plugin-dir ./ralph-wiggum-marketer

Option 3: Interactive Plugin Manager

# Open the plugin manager:
/plugin

# Browse, search, and install from the interactive UI

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "ralph-wiggum-marketer",
  3. "owner": {
  4. "name": "Muratcan Koylan",
  5. "email": "muratcankoylan@gmail.com"
  6. },
  7. "metadata": {
  8. "description": "Autonomous AI copywriter that learns your voice and iterates until the content is actually good",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "ralph-wiggum-marketer",
  14. "source": "./",
  15. "description": "Quality-focused AI copywriter using the Ralph Wiggum pattern",
  16. "version": "1.0.0",
  17. "author": {
  18. "name": "Muratcan Koylan"
  19. },
  20. "license": "MIT",
  21. "keywords": ["copywriting", "content-marketing", "ralph-wiggum", "voice-cloning"],
  22. "category": "productivity"
  23. }
  24. ]
  25. }
README.md · README · 248 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Ralph Marketer
  2. A **Claude Code Plugin** that provides an autonomous AI copywriter for SaaS content marketing.
  3. [DeepWiki: Learn more here](https://deepwiki.com/muratcankoylan/ralph-wiggum-marketer/1-overview)
  4. Uses the [Ralph Wiggum pattern](https://ghuntley.com/ralph/) - an iterative AI loop that ships content while you sleep.
  5. ## Installation
  6. ### Option 1: Add as Marketplace (Recommended)
  7. ```bash
  8. # In Claude Code, add the repo as a marketplace:
  9. /plugin marketplace add muratcankoylan/ralph-wiggum-marketer
  10. # Then install the plugin:
  11. /plugin install ralph-wiggum-marketer@muratcankoylan-ralph-wiggum-marketer
  12. ```
  13. ### Option 2: Test Locally (For Development)
  14. ```bash
  15. # Clone the repo
  16. git clone https://github.com/muratcankoylan/ralph-wiggum-marketer.git
  17. # Run Claude Code with the plugin directory
  18. claude --plugin-dir ./ralph-wiggum-marketer
  19. ```
  20. ### Option 3: Interactive Plugin Manager
  21. ```bash
  22. # Open the plugin manager:
  23. /plugin
  24. # Browse, search, and install from the interactive UI
  25. ```
  26. ## Quick Start
  27. ```bash
  28. # 1. Initialize a new content project
  29. /ralph-init
  30. # 2. Check progress anytime
  31. /ralph-status
  32. # 3. Cancel if needed
  33. /ralph-cancel
  34. ```
  35. ## Commands
  36. | Command | Description |
  37. |---------|-------------|
  38. | `/ralph-init` | Initialize a new content project in current directory |
  39. | `/ralph-marketer` | Start the autonomous copywriter loop |
  40. | `/ralph-status` | Check content pipeline and progress |
  41. | `/ralph-cancel` | Cancel the active loop |
  42. ## How It Works
  43. ```
  44. ┌──────────────────────────────────────────────────────────────────┐
  45. │ MULTI-AGENT ECOSYSTEM │
  46. ├──────────────────────────────────────────────────────────────────┤
  47. │ │
  48. │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
  49. │ │ TrendScout │ │ Research │ │ Product/ │ │
  50. │ │ Agent │ │ Agent │ │ Marketing │ │
  51. │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
  52. │ │ │ │ │
  53. │ ▼ ▼ ▼ │
  54. │ ┌────────────────────────────────────────────────────┐ │
  55. │ │ SQLite Content Database │ │
  56. │ │ • trends • research • communications │ │
  57. │ └────────────────────────┬───────────────────────────┘ │
  58. │ │ │
  59. │ ▼ │
  60. │ ┌────────────────────────────────────────────────────┐ │
  61. │ │ RALPH THE COPYWRITER │ │
  62. │ │ │ │
  63. │ │ Reads inputs → Plans content → Writes drafts │ │
  64. │ │ → Reviews & iterates → Publishes │ │
  65. │ │ │ │
  66. │ │ Memory: git commits + progress.txt + prd.json │ │
  67. │ └────────────────────────────────────────────────────┘ │
  68. │ │ │
  69. │ ▼ │
  70. │ Published Content │
  71. │ (blogs, case studies, social, newsletters) │
  72. └──────────────────────────────────────────────────────────────────┘
  73. ```
  74. ### The Ralph Loop
  75. 1. **Read PRD**: Check `scripts/ralph/prd.json` for tasks
  76. 2. **Check Progress**: Read `scripts/ralph/progress.txt` for learnings
  77. 3. **Pick Task**: Find highest priority story where `passes: false`
  78. 4. **Execute**: Complete the task following acceptance criteria
  79. 5. **Verify**: Run tests to ensure quality
  80. 6. **Commit**: Save progress to git
  81. 7. **Update**: Mark task done, log learnings
  82. 8. **Repeat**: Loop until all tasks complete
  83. Each iteration is a fresh context window. Memory persists through files.
  84. ## Plugin Structure
  85. ```
  86. ralph-wiggum-marketer/
  87. ├── .claude-plugin/
  88. │ └── plugin.json # Plugin manifest
  89. ├── commands/
  90. │ ├── ralph-marketer.md # Main loop command
  91. │ ├── ralph-init.md # Project initialization
  92. │ ├── ralph-status.md # Status check
  93. │ └── ralph-cancel.md # Cancel loop
  94. ├── skills/
  95. │ └── copywriter/
  96. │ └── SKILL.md # Copywriter skill
  97. ├── hooks/
  98. │ ├── hooks.json # Hook configuration
  99. │ └── stop-hook.sh # Loop continuation hook
  100. ├── scripts/
  101. │ └── src/ # Database & utility scripts
  102. ├── templates/
  103. │ ├── prd.json # Task template
  104. │ ├── progress.txt # Progress log template
  105. │ ├── prompt.md # Agent instructions template
  106. │ └── package.json # Project package.json template
  107. └── README.md
  108. ```
  109. ## Database Schema
  110. ### Input Tables (from other agents)
  111. ```sql
  112. -- Trends from TrendScout
  113. trends (topic, description, source, relevance_score, status)
  114. -- Research from Research Agent
  115. research (title, summary, key_findings, data_points, category, status)
  116. -- Communications from Product/Marketing
  117. communications (type, title, details, key_messages, target_audience, priority, status)
  118. ```
  119. ### Ralph's Workspace
  120. ```sql
  121. -- Content planning
  122. content_plan (content_type, title, brief, target_keywords, status)
  123. -- Work in progress
  124. drafts (plan_id, version, content, word_count, feedback)
  125. -- Final content
  126. published (plan_id, final_content, meta_description)
  127. -- Activity tracking
  128. agent_log (action, details, created_at)
  129. ```
  130. ## Customizing
  131. ### Add Your Own Content Sources
  132. Edit `src/db/seed.js`:
  133. ```javascript
  134. // Add a trend
  135. insertTrend.run(
  136. 'Your Trend Topic',
  137. 'Description of the trend',
  138. 'Source',
  139. 85 // relevance score
  140. );
  141. // Add a communication
  142. insertComm.run(
  143. 'product_update',
  144. 'Your Product Launch',
  145. 'Details about what it does',
  146. JSON.stringify(['Key message 1', 'Key message 2']),
  147. 'Target audience',
  148. 1 // priority
  149. );
  150. ```
  151. ### Add Your Own Tasks
  152. Edit `scripts/ralph/prd.json`:
  153. ```json
  154. {
  155. "id": "WRITE-004",
  156. "title": "Write your custom blog",
  157. "acceptanceCriteria": [
  158. "At least 1000 words",
  159. "Includes 3 data points",
  160. "Has compelling CTA"
  161. ],
  162. "priority": 5,
  163. "passes": false
  164. }
  165. ```
  166. ## Sample Tasks
  167. The default PRD includes 12 stories:
  168. 1. **SETUP-001**: Initialize database
  169. 2. **PLAN-001**: Plan product launch blog
  170. 3. **WRITE-001**: Write launch blog draft
  171. 4. **PLAN-002**: Plan thought leadership blog
  172. 5. **WRITE-002**: Write data-driven blog
  173. 6. **REVIEW-001**: Review and improve draft
  174. 7. **PUBLISH-001**: Publish launch blog
  175. 8. **PLAN-003**: Plan case study
  176. 9. **WRITE-003**: Write case study
  177. 10. **SOCIAL-001**: Create social posts
  178. 11. **NEWSLETTER-001**: Draft newsletter
  179. 12. **METRICS-001**: Log final metrics
  180. ## The Ralph Philosophy
  181. > "Ralph is a Bash loop. Memory persists only through git history and text files. Each iteration is a fresh context window."
  182. Key principles:
  183. - **Small stories** - Must complete in one iteration
  184. - **Explicit criteria** - No ambiguity
  185. - **Fast feedback** - Tests every iteration
  186. - **Compound learnings** - Patterns accumulate
  187. - **Persistence wins** - Keep iterating
  188. ## Credits
  189. - Original Ralph concept: [@GeoffreyHuntley](https://ghuntley.com/ralph/)
  190. - Official Ralph plugin: [claude-plugins-official](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/ralph-loop)
  191. - Video walkthrough: [@mattpocockuk](https://twitter.com/mattpocockuk)
  192. ## License
  193. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.