Agent skill

Cs Ralph Runner

by ChenShuo2004 in ChenShuo2004/cs-skills

将 Markdown 需求转换为 Ralph PRD,并在本地 Git 项目执行 overview 或有界 no-commit 构建。用户明确要求 Ralph 工作流时使用;不作为普通开发任务的默认循环器。

MITAuto-check passedProduct & Project Management

Install Cs Ralph Runner

skills CLI
$ npx skills add ChenShuo2004/cs-skills --skill cs-ralph-runner -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ChenShuo2004/cs-skills cs-ralph-runner --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ChenShuo2004/cs-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cs-ralph-runner .claude/skills/cs-ralph-runner && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cs-ralph-runner
GitHub stars
193
Token cost
~349 tokens
SKILL.md length
71 words
Files
5 (incl. references)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

将 Markdown 需求转换为 Ralph PRD,并在本地 Git 项目执行 overview 或有界 no-commit 构建。用户明确要求 Ralph 工作流时使用;不作为普通开发任务的默认循环器。

  • Tasks that involve PRD writing
  • SKILL.md covers 输入与模式, 执行 and 验收与恢复
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cs Ralph Runner is an agent skill from ChenShuo2004/cs-skills. 将 Markdown 需求转换为 Ralph PRD,并在本地 Git 项目执行 overview 或有界 no-commit 构建。用户明确要求 Ralph 工作流时使用;不作为普通开发任务的默认循环器。

Its SKILL.md is about 350 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `agents/openai.yaml`, `references/cli-workflow.md` and `references/projects.json`).

It sits in Product & Project Management, covering PRD writing. It works with Git. The repository describes itself as: 陈硕的 Codex Skills 与 AI 工作流手册:把产品、内容、调研与交付沉淀为可复用的智能工作流。 The licence is MIT.

When your agent uses it

  • Tasks that involve PRD writing

Example prompts

  • “/cs-ralph-runner”

What it can do on your machine

Read from SKILL.md and the folder at commit 6f5009d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cs Ralph Runner loads about 349 tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 30 tokens; SKILL.md has 71 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~349
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ChenShuo2004/cs-skills at commit 6f5009d, republished under its MIT licence (© ChenShuo2004). 71 words, ~349 tokens.

Download SKILL.mdSave it as .claude/skills/cs-ralph-runner/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
cs-ralph-runner
description
将 Markdown 需求转换为 Ralph PRD,并在本地 Git 项目执行 overview 或有界 no-commit 构建。用户明确要求 Ralph 工作流时使用;不作为普通开发任务的默认循环器。
<!-- CS Skills · 陈硕 | https://github.com/ChenShuo2004/cs-skills -->

CS Ralph Runner

保留用户指定的 Ralph 工作流,完成需求转 PRD、项目预检和要求的执行。更强的模型不需要把每个普通开发请求都改造成循环代理。

输入与模式

需要实际 Markdown 需求和目标 Git 仓库;用户明确提供的路径优先。文档未指定时先检查会话与当前项目中明确对应的需求;仅有多个无法区分的候选才询问。未指定项目时使用当前 Git 仓库。别名仅在使用别名时读取 projects。

执行前读取 run policy,保留本地约定:默认 1 次迭代、no-commit、缺工具不自动全局安装、执行预告不要求确认。

  • plan / dry-run:读取需求、生成独立 PRD 与 overview;不启动 build。不把 overview 失败时的猜测称作真实预览。
  • no-commit build:真实执行任务,可以修改代码;--no-commit 只禁止提交。
  • commit build:沿用当前会话对 Ralph 运行内提交的明确授权;不包含推送/部署。

只要必需输入与授权已具备就连续完成。用户说“运行并允许提交”本身已给提交授权,不重复询问。

执行

核对仓库、工作区、Ralph/Codex 版本和现有配置。按 CLI 工作流 生成有业务验收条件的 stories,按真实依赖划分,不为凑固定数量拆任务。

已有 PRD/配置先检查能否复用;生成新文件可用独立名称,不覆盖用户配置。工作区有改动时遵守 stopOnDirtyWorktree:不得在原脏目录直接运行构建。可创建隔离工作区;若任务依赖未提交内容,必须将其纳入隔离副本并核对,否则说明输入缺口。不要自动 stash/reset 用户工作。

保留宿主的审批、沙箱与工具策略,不写绕过它们的 AGENT_CMD。Windows 使用实际可用的 .cmd 和 Git Bash 路径;根据 help 核实当前参数,不猜安装路径。

运行前给简短预告:目标、模式、迭代数、命令和日志。执行日志保留完整文件,聊天只提供进展和重要失败;等待时保持用户可见进度。

验收与恢复

检查每次运行的 story、状态、产物、实际验证以及 Git 前后变化。no-commit 运行若产生提交,视为约束失败。overview、进程退出和代码验收分别记录,不等同。

达到本次迭代上限或关键条件失败时停止循环并交付诊断,不擅自增加迭代;恢复先检查已有运行 ID 与日志,避免重复执行完成的 story。报告 PRD、日志、修改与未通过的验收。

© ChenShuo2004, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in cs-ralph-runner of ChenShuo2004/cs-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/cli-workflow.md
  • references/projects.json
  • references/run-policy.json

Open the folder on GitHubat commit 6f5009d

Compare with similar skills

Cs Ralph Runner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cs Ralph Runner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cs Ralph Runner this skillChenShuo2004/cs-skills193—~349Automated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Reviewfossasia/eventyay-interpretation1.6k35 repos~996Automated safety check: PassApache-2.0
Graphsmallnest/goal-workflow289—~3.9kAutomated safety check: PassMIT
Pi Enshare-skills/pi108—~9.9kAutomated safety check: WarnApache-2.0
Req Change Workflowyunshu0909/yunshu_skillshub767—~1.4kAutomated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Review

    fossasia/eventyay-interpretation

    Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match…

    1.6k GitHub starsUsed in 35 repos~996 tokens
    Product & Project ManagementAuto-check passed
  • Graph

    smallnest/goal-workflow

    Graph engineering for parallel task execution: convert a task, PRD, SPEC, or issue set into a dependency graph (DAG), layer it into supersteps, then implement each independent node concurrently with…

    289 GitHub stars~3.9k tokensUpdated 25 days ago
    Product & Project ManagementAuto-check passed
  • Pi En

    share-skills/pi

    PI Cognitive AI. An agent skill from share-skills/pi.

    108 GitHub stars~9.9k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check: warnings
  • Req Change Workflow

    yunshu0909/yunshu_skillshub

    已有功能的需求变更闭环(门禁式七步)。触发硬条件:要改的功能已经实现并跑起来了。当用户说"改需求""需求变更""调整交互""改功能""重构流程",或改动容易散到多个文件、碰到鉴权/存储/配置/权限、需要可靠验证 + 回滚方案时使用。流程:锁 scope 写 change brief → 从代码确认当前行为(不靠记忆和假设)→ 影响面与风险评估 + 回滚计划 →…

    767 GitHub stars~1.4k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Build Mvp

    BuildGreatProducts/builder-os

    Use inside a product repository when the user wants the full MVP built from their BuilderOS spec documents.

    227 GitHub stars~1.2k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check: notes

More from ChenShuo2004/cs-skills

All 26 skills in this repo
  • Cs Checkpoint Version

    ChenShuo2004/cs-skills

    A skill your agent uses when the user asks to save the current repository version, create a rollback point, checkpoint dirty worktree changes, preserve staged/unstaged/untracked files before risky…

    193 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Cs Code Video

    ChenShuo2004/cs-skills

    用代码做动画视频:页面暴露 render(t),Playwright 逐帧截图 + FFmpeg 合成 mp4,可接合成配乐、出图和配音。通用模式先明确主题、规格、风格和声音,出风格卡、分镜与关键帧后逐镜制作;Vibe知识大赏模式额外查证来源、记录真实素材许可、先渲 10 秒样片。触发词包括…

    193 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Cs Knowledge Film

    ChenShuo2004/cs-skills

    制作明确要求暗夜星空、衬线双语字幕与金色光点风格的知识解说片,或用户显式调用 $cs-knowledge-film:从概念与画面隐喻设计,到口播、场景 spec、配音和 1080p 渲染。普通科普视频不默认套用这一视觉模板;网页产品演示、ChatCut 策划和电商视频复刻各用对应 skill。

    193 GitHub stars~806 tokensUpdated today
    Auto-check passed
  • Cs Auto Videl

    ChenShuo2004/cs-skills

    A skill your agent uses when the user types $cs-auto-videl or asks for Douyin/TikTok ecommerce video workflows, including competitor replication, strong-Hook nine-grid promptimage.md to image2…

    193 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 当用户要把产品事实、口播、数字人、产品界面和 CTA 制作成可验收的数字人产品介绍视频时使用:统一预检 ChatCut、FFmpeg、ComfyUI、Fish/TTS 与 Remotion,按 plan、sample、batch 三种模式编排,先完成可审批样片再批量或出成片。用于有明确产品包的横版/竖版产品视频流水线;不要用于通用自动剪辑、电商短视频复刻、纯视频选题策划或未经确认的批量生成与发布。

    193 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Cs Code Story Video

    ChenShuo2004/cs-skills

    把中文口播、角色和参考素材制作成可验收的 16:9 代码叙事视频:A-roll 角色讲述、全屏场景 B-roll、真实音频时码、Remotion 样片与成片、3:4/4:3 杂志风封面。仅用于代码驱动的叙事视频,不替代 ChatCut 剪辑、数字人产品片或电商复刻。

    193 GitHub stars~541 tokensUpdated today
    Auto-check passed

Works with

Questions about Cs Ralph Runner

What does Cs Ralph Runner do?

将 Markdown 需求转换为 Ralph PRD,并在本地 Git 项目执行 overview 或有界 no-commit 构建。用户明确要求 Ralph 工作流时使用;不作为普通开发任务的默认循环器。. Cs Ralph Runner is an agent skill from ChenShuo2004/cs-skills.

When should I use Cs Ralph Runner?

Cs Ralph Runner fits situations like: tasks that involve PRD writing.

How do I install Cs Ralph Runner in Claude Code?

Run `npx skills add ChenShuo2004/cs-skills --skill cs-ralph-runner -a claude-code`. Or copy the skill folder (cs-ralph-runner in ChenShuo2004/cs-skills) into .claude/skills/cs-ralph-runner in your project. Claude Code loads it when a task matches its description.

How do I install Cs Ralph Runner in Codex?

Run `npx skills add ChenShuo2004/cs-skills --skill cs-ralph-runner -a codex`. Or copy the skill folder (cs-ralph-runner in ChenShuo2004/cs-skills) into .agents/skills/cs-ralph-runner in your project. Codex loads it when a task matches its description.

Can I use Cs Ralph Runner in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ChenShuo2004/cs-skills --skill cs-ralph-runner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cs-ralph-runner, .gemini/skills/cs-ralph-runner, .github/skills/cs-ralph-runner and .opencode/skills/cs-ralph-runner in your project.

What does Cs Ralph Runner need to run?

SKILL.md names no scripts, command-line tools or credentials: Cs Ralph Runner is instructions for the agent only.

Does Cs Ralph Runner access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cs Ralph Runner safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cs Ralph Runner use?

Cs Ralph Runner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cs Ralph Runner use?

About 349 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Cs Ralph Runner?

Skills that share tags, products or a category with Cs Ralph Runner: CCPM Project Management (automazeio/ccpm, 8.4k stars), Review (fossasia/eventyay-interpretation, 1.6k stars), Graph (smallnest/goal-workflow, 289 stars) and Pi En (share-skills/pi, 108 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cs Ralph Runner?

ChenShuo2004 (a GitHub user) maintains it in ChenShuo2004/cs-skills, which has 193 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 8, 2026.

Source: ChenShuo2004/cs-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.