SkillAgentSearch skills...

ralph-specum-tasks

This skill should be used only when the user explicitly asks to use `$ralph-specum-tasks`, or explicitly asks Ralph Specum in Codex to run the tasks phase.

Install / Use

npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

81/100

Category

Legal

Supported Platforms

OpenAI Codex

Tags

Our assessment of ralph-specum-tasks

ralph-specum-tasks scores 81/100 on our quality scale, 184th of 210 Legal skills we index.

Its SKILL.md is 6.3 KB long, split into 6 sections and no code examples: a thorough specification that gives an agent plenty to work with.

It has 550 GitHub stars, a meaningful sign that others use it.

Substance
29/30
Structure
11/20
Description
15/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so ralph-specum-tasks is actively maintained.
  • Our last check on 2026-11-08 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

ralph-specum-tasks compared with similar skills

All 4 of these similar skills score higher than ralph-specum-tasks; compare them before choosing.

SkillScoreStarsUpdatedFormat
ralph-specum-tasks (this skill)by tzachbon815502mo agoSKILL.md
algorithmic-artby anthropics100177.9k57d agoSKILL.md
pptxby anthropics100177.9k57d agoSKILL.md
prospectingby coreyhaines3110060.1k7d agoSKILL.md
ad-creativeby coreyhaines3110060.1k7d agoSKILL.md

Frequently asked questions

How do I install ralph-specum-tasks?
Run npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks. The install tabs above show the steps for each supported agent.
Which AI agents does ralph-specum-tasks work with?
It is written for OpenAI Codex, as a SKILL.md file. Other agents that read the same format can often use it too.
Is ralph-specum-tasks safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is ralph-specum-tasks still maintained?
The repository was last updated about 2 months ago, so ralph-specum-tasks is actively maintained.

name: ralph-specum-tasks description: This skill should be used only when the user explicitly asks to use $ralph-specum-tasks, or explicitly asks Ralph Specum in Codex to run the tasks phase. metadata: surface: helper action: tasks

Ralph Specum Tasks

You are a coordinator, not a task planner -- delegate ALL work to a task-planner sub-agent.

Derive RALPH_CODEX_PLUGIN_ROOT from this loaded skill by resolving two parent directories from the SKILL.md directory. Never derive it from the project working directory.

Contract

  • Resolve the active spec by explicit path, exact name, or .current-spec
  • Require requirements.md and design.md
  • Merge state fields only
  • Keep the Ralph disk contract unchanged

Action

  1. Resolve the active spec. If none exists, stop.
  2. Require requirements.md and design.md. Read research.md when present, .progress.md, and current state.
  3. Run phase_gate.py mode through "$RALPH_CODEX_PLUGIN_ROOT/scripts/phase_gate.py" with STATE and exact --quick, exact --interactive, or no flag. Reject both, -q, variants, and natural-language substitutes.
  4. In interactive mode, require artifact approval for the current design.md before starting tasks. Exact quick mode continues with the validated artifact.
  5. Run prototype record selection with the resolved basePath before generation:
    python3 "$RALPH_CODEX_PLUGIN_ROOT/scripts/prototype_records.py" select-downstream --base-path "$BASE_PATH" --state "$BASE_PATH/.ralph-state.json"
    
  6. Include only affected, valid, gateApproved: true, non-superseded records returned by the selector. Exclude malformed, superseded, skipped, failed, inconclusive, cancelled, and normal-mode excluded records.
  7. Stop before generation when selection reports an activePrototypes blocker for tasks. Name the active ID and route resume through $ralph-specum-prototype. Allow proven unrelated prototypes when the selector reports no task dependency.
  8. Stop when selection reports stale design.md, stale task indexes, or a stale upstream artifact that design depends on. Route to the earliest stale phase and do not plan from stale design.
  9. Clear any prior approval gate by merging awaitingApproval: false before generation.
  10. Respect granularity from state. Allow --tasks-size fine|coarse to override it. Treat task sizing as administration, not an interview question. In exact quick mode, default unset granularity to fine.
  11. When research.md exists, require skill discovery pass 2 against the goal plus final research. When it is absent, require pass 1 against the goal alone. Run the applicable pass when the state lacks its revision. Select explicitly named skills and record harness-shadowed duplicates.
  12. Load "$RALPH_CODEX_PLUGIN_ROOT/skills/interview-framework-codex/SKILL.md", its required algorithm and domain-modeling references, and all selected domain contracts in both interactive and quick mode. In interactive mode, follow the algorithm for critical delivery slicing, dependency order, rollout risk, and verification thresholds. Inspect commands, file layout, and existing test tools instead of asking.
  13. In interactive mode, require explicit approve and delegate; in exact quick mode, record bypassed_quick. In both modes, run phase_gate.py check-delegation with the current loaded-manifest identity before creating the child. Apply the shared hard-transition invariant before task-planner dispatch. A failed check-delegation in either mode ends this invocation before phase transition, child dispatch, or target-artifact write; after a normal-mode failure, the next explicit invocation creates a fresh manifest/interview identity and does not create an alternate quick bypass. After an exact --quick delegation failure, the next explicit invocation reruns discovery, records a fresh phaseSkillLoad and interview identity, and does not reuse a terminal bypassed_quick interview or its discovery revision. Only a matching in-progress collecting or awaiting_confirmation interview is resumable.
  14. Delegate task planning to a task-planner sub-agent. Pass the absolute helper path, state path, identity tuple, unique teammate dispatch identity, verbatim manifest, requirements, design, research, selected prototype evidence, the clean blocker/stale-gate result, and interview context. The child reloads and records the manifest, passes check-agent-write with that unique identity, and writes tasks.md. Do NOT write tasks.md yourself.
  15. Read the sub-agent's output and validate it exists.
  16. Count tasks and merge state with:
  • phase: "tasks"
  • awaitingApproval: true (or false when --quick is active)
  • taskIndex: first incomplete or totalTasks
  • totalTasks: counted tasks
  1. Update .progress.md with the phase breakdown, next milestone, blockers, next step, chosen granularity, skill discovery, and verification strategy.
  2. If spec commits are enabled, commit only the spec artifacts.

Stop Behavior

  • Without --quick: STOP HERE. Display the walkthrough summary and approval prompt. Do NOT continue to implementation. Wait for the user to explicitly approve and request the next phase.
  • With exact --quick: Record the quick bypass, review, then continue directly into implementation.

Output Shape

Use atomic tasks with exact file targets, explicit success criteria, verification commands, and commit messages. Preserve POC-first ordering. Support [P] markers for safe parallel work, [VERIFY] checkpoints, and VE tasks when end-to-end verification is part of the plan.

Response Handoff

  • After writing tasks.md, name tasks.md and summarize the task plan briefly.
  • When normalized quickMode is false, end with exactly one explicit choice prompt:
    • approve current artifact
    • request changes
    • continue to implementation
  • Treat continue to implementation as approval of tasks.md.
  • With exact --quick, do not show this prompt; continue directly to implementation after the gates succeed.
  • During artifact review, apply the changes immediately delegates already-recorded feedback through a new unique dispatch, redisplays the artifact, and stays at this approval gate. Ask one focused change question only when no feedback is pending. Control-only continue, proceed, and go ahead approve nothing.

Related Skills

View on GitHub
GitHub Stars550
CategoryLegal
Updated2mo ago
Forks48

Languages

Shell

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions