ralph-opencode-free-loop
Run an autonomous Open Ralph Wiggum coding loop using OpenCode Zen with free models and automatic fallback.
What this skill does
## What this skill does This skill runs an autonomous **Ralph Wiggum** coding loop using the `ralph` CLI with OpenCode as the agent provider. It repeatedly executes the same coding prompt until: - The success criteria are met, OR - The completion promise is printed, OR - Max iterations are reached The loop is optimized for **free OpenCode Zen models** and includes a fallback chain in case models are rate-limited, disabled, or removed. --- ## When to use Use this skill when you want autonomous coding execution such as: - Fixing failing tests - Implementing scoped features - Refactoring codebases - Resolving lint/type errors - Running build-fix loops - Multi-iteration debugging You MUST be inside a git repository before running Ralph. --- ## Free model fallback order Always attempt models in this order: 1. `opencode/kimi-k2.5-free` ← Best coding performance (limited time free) 2. `opencode/minimax-m2.1-free` 3. `opencode/glm-4.7-free` 4. `opencode/big-pickle` ← Free stealth model fallback If a model fails due to availability or quota, immediately retry using the next model without changing the prompt or loop parameters. ### Failure triggers for fallback Fallback if you encounter errors like: - model disabled - model not found - insufficient quota - quota exceeded - payment required - rate limit - provider unavailable --- ## How to run the loop ### Attempt #1 (primary model) Run: ralph "<TASK PROMPT> Success criteria: - <list verifiable checks> - Build passes - Tests pass Completion promise: <promise>COMPLETE</promise>" \ --agent opencode \ --model opencode/kimi-k2.5-free \ --completion-promise "COMPLETE" \ --max-iterations 20 --- ### Attempt #2 (fallback) If attempt #1 fails due to model issues, rerun with: --model opencode/minimax-m2.1-free --- ### Attempt #3 (fallback) If attempt #2 fails: --model opencode/glm-4.7-free --- ### Attempt #4 (final fallback) If attempt #3 fails: --model opencode/big-pickle --- ## Tasks mode (for large projects) For multi-step execution: ralph "<BIG TASK PROMPT>" \ --agent opencode \ --model opencode/kimi-k2.5-free \ --tasks \ --max-iterations 50 Fallback model order still applies. --- ## Plugin troubleshooting If OpenCode plugins interfere with loop execution, rerun with: --no-plugins --- ## Sanity check available Zen models If free model availability changes, check: https://opencode.ai/zen/v1/models Update fallback order if needed. --- ## Safety notes - Always run inside a git repo - Set iteration limits to avoid runaway loops - Ensure prompts contain verifiable success criteria - Review diffs before merging autonomous changes --- ## Example usage Fix failing TypeScript errors: ralph "Fix all TypeScript errors in the repo. Success criteria: - tsc passes - Build succeeds Completion promise: <promise>COMPLETE</promise>" \ --agent opencode \ --model opencode/kimi-k2.5-free \ --completion-promise "COMPLETE" \ --max-iterations 20
Related in General
modeling-omnistudio-epc-catalog
IncludedSalesforce Industries CME EPC product-modeling skill for Product2-based catalog creation. Use when creating EPC products, configuring product attributes, building offer bundles with Product Child Items, or reviewing EPC DataPack JSON metadata for product catalog changes. TRIGGER when: user creates or updates Product2 EPC records, AttributeAssignment payloads, AttributeMetadata/AttributeDefaultValues, Offer bundles, or ProductChildItem relationships. DO NOT TRIGGER when: designing OmniScripts/FlexCards/Integration Procedures (use building-omnistudio-omniscript, building-omnistudio-flexcard, or building-omnistudio-integration-procedure), implementing Apex business logic (use generating-apex), or troubleshooting deployment pipelines (use deploying-metadata).
relationship-science-coach
IncludedUse this skill for direct, practical adult relationship coaching: couples conflict, repair, trust, marriage, dating, flirting, attachment patterns, emotional connection, sex, desire differences, eroticism, kink negotiation, affection, love languages, breakups, and long-term passion. Draw on Gottman, EFT and Hold Me Tight, attachment science, modern sex research, Perel, Nagoski, Kerner, Schnarch, Love and Stosny, and flexible love-language tools. Be concrete and low-hedge. Redirect only for imminent danger, abuse, coercive control, minors, non-consent, self-harm, stalking, or medical/legal/psychiatric decisions.
building-sf-integrations
IncludedSalesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use configuring-connected-apps), Apex-only logic (use generating-apex), or data import/export (use handling-sf-data).
venue-templates
IncludedAccess comprehensive LaTeX templates, formatting requirements, and submission guidelines for major scientific publication venues (Nature, Science, PLOS, IEEE, ACM), academic conferences (NeurIPS, ICML, CVPR, CHI), research posters, and grant proposals (NSF, NIH, DOE, DARPA). This skill should be used when preparing manuscripts for journal submission, conference papers, research posters, or grant proposals and need venue-specific formatting requirements and templates.
let-fate-decide
IncludedDraws the 12 Houses of the Zodiac Tarot spread to inject entropy into planning when prompts are vague, ambiguous, or casually delegated. Interprets the spread to guide next steps. Use when the user says 'let fate decide', 'YOLO', 'whatever', 'idk', or other nonchalant phrases, makes Yu-Gi-Oh references, or when you are about to arbitrarily pick between multiple reasonable approaches. Prefer over ask-questions-if-underspecified when the user's tone is casual or playful rather than precision-seeking.
net-ops
IncludedCross-platform network troubleshooting (Windows, macOS, Linux) via local or remote shell. Use for: DNS broken, can't resolve hostnames, nslookup/dig works but apps fail, NRPT, WFP, scutil, /etc/resolver, systemd-resolved, /etc/resolv.conf, NetworkManager, VPN DNS leak residue (ProtonVPN/Mullvad/WireGuard/AnyConnect), AV/firewall blocking DNS or DoH, Tailscale DNS interaction, intermittent connectivity, remote diagnostics over SSH.