gruckion/marathon-ralph
marathon-ralph/skills/marathon-ralph/SKILL.md
Autonomous long-running development from specifications. Use when user wants to build an application from a spec file, run continuous development, or automate feature implementation. Triggers on phrases like "marathon this", "build from spec", "autonomous development", "keep coding until done".
development
Updated Apr 5, 2026
$ install --global
skillsauthnpx skillsauth add gruckion/chief-wiggum-anthropic-agent-harness marathon-ralphInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 5, 2026, 3:32 PM5.8s1 file scanned
SKILL.md
- name:
- marathon-ralph
- description:
- Autonomous long-running development from specifications. Use when user wants to build an application from a spec file, run continuous development, or automate feature implementation. Triggers on phrases like "marathon this", "build from spec", "autonomous development", "keep coding until done".
Marathon Ralph - Autonomous Development
This skill enables autonomous, long-running development sessions that:
- Create Linear projects from specification files
- Work through issues systematically with verification
- Continue across multiple sessions via Stop hook
- Produce fully tested applications
Triggers
Activate this skill when the user:
- Wants to build an application from a specification
- Says "marathon this [spec]" or "build from [spec]"
- Asks for autonomous/continuous development
- Wants to "keep coding until done"
- Provides a spec file and wants it implemented
- Mentions "marathon development" or "marathon session"
- Wants to implement multiple features from a spec without stopping
Usage
Resume Existing Marathon
/marathon-ralph:run
Or naturally: "Continue the marathon" or "Keep going"
Start New Marathon
/marathon-ralph:run path/to/spec.md
Or naturally: "Marathon this spec.md until complete"
Check Progress
/marathon-ralph:status
Or naturally: "How's the marathon going?"
Cancel
/marathon-ralph:cancel
Or naturally: "Stop the marathon"
Prerequisites
User must have Linear MCP configured:
claude mcp add --transport http linear https://mcp.linear.app/mcp/mcp- Select Linear and authenticate via OAuth
How It Works
- Setup: Verifies Linear MCP connection is active
- Init: Creates Linear project and issues from the spec file
- Loop: For each issue in priority order:
- Verify (tests, lint, types) - ensures codebase is healthy
- Plan implementation - creates detailed implementation strategy
- Code the feature - implements according to plan
- Write tests - unit and integration tests
- Write E2E tests - for web projects only
- Commit and mark Done in Linear
- Continue: Stop hook automatically restarts for next issue until all complete
Example Workflows
Starting a New Project
User: "Marathon this todo-app-spec.md until it's done"
- Skill triggers on "marathon" + spec file reference
- Runs
/marathon-ralph:run --spec-file todo-app-spec.md - Creates Linear project with issues from spec
- Begins autonomous coding loop
Checking Progress
User: "How far along is the marathon?"
- Skill triggers on marathon progress query
- Runs
/marathon-ralph:status - Reports current phase, issue, and completion percentage
Stopping Early
User: "Stop the marathon, I need to change the spec"
- Skill triggers on stop/cancel request
- Runs
/marathon-ralph:cancel - Confirms with user and cleanly stops
- Linear project preserved for later
State Management
Marathon state is stored in .claude/marathon-ralph.json in the project root. This tracks:
- Current phase (setup, init, coding, complete)
- Linear project and issue information
- Progress statistics
- Timestamps for tracking
The Stop hook reads this state to determine whether to continue autonomous operation or allow exit.
Related Skills
gruckion/skills/database/sqlite
tools
VerifiedTrustedCommunity
# SQLite Skill for better-t-stack ## Overview SQLite database implementation using LibSQL client and Drizzle ORM. This skill covers local development, Turso cloud, and Cloudflare D1 deployments. --- ## CRITICAL WARNING **NEVER use `bun:sqlite` with Next.js applications.** Next.js runs on Node.js, not Bun runtime. Using `bun:sqlite` causes: ``` Cannot find module 'bun:sqlite' ``` **Always use `@libsql/client`** - it works in both Node.js and Bun environments. --- ## Library Stack | Pack
SKILL.mdUpdated Apr 5, 2026
gruckion/write-playwright-test
tools
VerifiedTrustedCommunity
Write Playwright E2E tests using fixtures and best practices. Use when creating E2E tests, writing browser automation tests, or testing user flows.
SKILL.mdUpdated Apr 5, 2026
gruckion/visual-verification
development
VerifiedTrustedCommunity
Visually verify implemented features work correctly before marking complete. Use when testing UI changes, verifying web features, or checking user flows work in the browser.
SKILL.mdUpdated Apr 5, 2026
gruckion/update-state
tools
VerifiedTrustedCommunity
Programmatically update marathon-ralph state file using deterministic jq commands. Use this instead of manually editing the JSON file.
SKILL.mdUpdated Apr 5, 2026