Agent skill

Find Code Tasks

by mikeyobrien in mikeyobrien/ralph-orchestrator

Lists all code tasks in the repository with their status, dates, and metadata.

MITAuto-check passed

Install Find Code Tasks

skills CLI
$ npx skills add mikeyobrien/ralph-orchestrator --skill find-code-tasks -a claude-code

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

GitHub CLI
$ gh skill install mikeyobrien/ralph-orchestrator find-code-tasks --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/mikeyobrien/ralph-orchestrator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/find-code-tasks .claude/skills/find-code-tasks && 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
find-code-tasks
GitHub stars
3.2k
Token cost
~1.3k tokens
SKILL.md length
373 words
Files
2
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Lists all code tasks in the repository with their status, dates, and metadata.

  • Works in 3 steps: Run Task Status Script → Present Results → Suggest Next Actions
  • SKILL.md covers Overview, When to Use, Parameters and Usage Examples, plus 5 more sections
  • Runs Shell scripts from its folder

What it does

Find Code Tasks is an agent skill from mikeyobrien/ralph-orchestrator. Lists all code tasks in the repository with their status, dates, and metadata. Useful for getting an overview of pending work or finding specific tasks.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `task-status.sh`).

The repository describes itself as: An improved implementation of the Ralph Wiggum technique for autonomous AI agent orchestration. The licence is MIT.

Example prompts

  • “Use the find-code-tasks skill to list all code tasks in the repository with their status, dates, and metadata”
  • “/find-code-tasks”

Requirements

  • A Bash shell

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Run Task Status Script
  2. Present Results
  3. Suggest Next Actions

What it can do on your machine

Read from SKILL.md and the folder at commit edc2b32. 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

    Ships script files (Shell), which the agent can run.

    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

Find Code Tasks loads about 1.3k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 373 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

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 mikeyobrien/ralph-orchestrator at commit edc2b32, republished under its MIT licence (© mikeyobrien). 373 words, ~1,316 tokens.

Download SKILL.mdSave it as .claude/skills/find-code-tasks/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
find-code-tasks
description
Lists all code tasks in the repository with their status, dates, and metadata. Useful for getting an overview of pending work or finding specific tasks.
type
anthropic-skill
version
1.0
metadata.internal
true

Find Code Tasks

Overview

This skill finds and displays all code tasks (.code-task.md files) in the repository, showing their frontmatter status and metadata. Use it to get a quick overview of pending work, find tasks by status, or check the state of the task backlog.

When to Use

  • Starting a work session to see what tasks are available
  • Checking status of tasks before/after running code-assist
  • Finding tasks by status (pending, in_progress, completed)
  • Getting a summary of task backlog
  • Exporting task data for reporting

Parameters

  • filter (optional): Filter tasks by status

    • pending - Show only pending tasks
    • in_progress - Show only in-progress tasks
    • completed - Show only completed tasks
    • (none) - Show all tasks
  • format (optional, default: "table"): Output format

    • table - Human-readable table with status symbols
    • json - JSON array for programmatic use
    • summary - Counts by status only
  • tasks_dir (optional, default: ".ralph/tasks/"): Directory to search for tasks

Usage Examples

bash
# Show all tasks in table format
/find-code-tasks

# Show only pending tasks
/find-code-tasks filter:pending

# Get JSON output for tooling
/find-code-tasks format:json

# Quick summary of task counts
/find-code-tasks format:summary

# Search custom directory
/find-code-tasks tasks_dir:tools/

Steps

1. Run Task Status Script

The script is colocated with this skill at .claude/skills/find-code-tasks/task-status.sh.

Execute it with appropriate arguments:

bash
# Default: table format, all tasks
.claude/skills/find-code-tasks/task-status.sh

# With filter
.claude/skills/find-code-tasks/task-status.sh --pending
.claude/skills/find-code-tasks/task-status.sh --in_progress
.claude/skills/find-code-tasks/task-status.sh --completed

# With format
.claude/skills/find-code-tasks/task-status.sh --json
.claude/skills/find-code-tasks/task-status.sh --summary

# Custom tasks directory
TASKS_DIR=tools/ .claude/skills/find-code-tasks/task-status.sh
2. Present Results

Display the output to the user. For table format, the output includes:

SymbolStatus
○pending
●in_progress
✓completed
■blocked
3. Suggest Next Actions

Based on the results, suggest relevant actions:

  • If there are pending tasks: "Run /code-assist .ralph/tasks/<task-name>.code-task.md to start a task"
  • If there are in_progress tasks: "There are tasks already in progress - consider completing those first"
  • If all tasks are completed: "All tasks are done! Use /code-task-generator to create new tasks"
Show full SKILL.md (136 more words)Show less

Output Examples

Table Format (default)
TASKS STATUS
════════════════════════════════════════════════════════════════
    TASK                                     STATUS       DATE
────────────────────────────────────────────────────────────────
○ add-task-frontmatter-tracking            pending      2025-01-15
○ enhance-headless-tool-output             pending      -
● fix-ctrl-c-freeze                        in_progress  2025-01-14
✓ replay-backend                           completed    2025-01-13
────────────────────────────────────────────────────────────────
Total: 4 tasks
Summary Format
Task Summary
────────────
○ Pending:     10
● In Progress: 2
✓ Completed:   5
────────────
  Total:       17
JSON Format
json
[
  {"task": "add-task-frontmatter-tracking", "status": "pending", "created": "2025-01-15", "started": null, "completed": null},
  {"task": "fix-ctrl-c-freeze", "status": "in_progress", "created": "2025-01-14", "started": "2025-01-14", "completed": null}
]

Frontmatter Schema

Tasks with frontmatter tracking have this structure:

yaml
---
status: pending | in_progress | completed | blocked
created: YYYY-MM-DD    # Date task was created
started: YYYY-MM-DD    # Date work began (null if not started)
completed: YYYY-MM-DD  # Date work finished (null if not done)
---

Tasks without frontmatter are shown as pending with null dates.

Integration with Other Skills

  • code-task-generator: Creates new tasks with frontmatter
  • code-assist: Updates task status when starting/completing work
  • ralph-code-assist: Runs tasks through Ralph orchestrator

Troubleshooting

No Tasks Found

If no tasks are displayed:

  • Verify the tasks directory exists: ls .ralph/tasks/
  • Check file extension is .code-task.md
  • Try specifying directory: /find-code-tasks tasks_dir:./
Script Not Found

If the task-status.sh script is not found:

  • Ensure you're in the repository root
  • Check the script exists: ls .claude/skills/find-code-tasks/task-status.sh
  • Make it executable: chmod +x .claude/skills/find-code-tasks/task-status.sh
Frontmatter Not Parsed

If dates show as - for tasks with frontmatter:

  • Ensure frontmatter starts with --- on line 1
  • Check YAML syntax is valid
  • Verify field names match: status, created, started, completed

© mikeyobrien, 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 1 other file in .claude/skills/find-code-tasks of mikeyobrien/ralph-orchestrator.

  • SKILL.md
  • task-status.sh

Open the folder on GitHubat commit edc2b32

Compare with similar skills

Find Code Tasks 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.

Find Code Tasks compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Find Code Tasks this skillmikeyobrien/ralph-orchestrator3.2k—~1.3kAutomated safety check: PassMIT
Music Listruvnet/ruflo74k—~332Automated safety check: PassMIT
Semantic Liststhedaviddias/Front-End-Checklist74k—~504Automated safety check: PassMIT
List Structurethedaviddias/Front-End-Checklist74k—~438Automated safety check: PassMIT
Definition Listthedaviddias/Front-End-Checklist74k—~449Automated safety check: PassMIT
Content Dates Auditthedaviddias/Front-End-Checklist74k—~691Automated safety check: PassMIT

Similar skills

  • Music List

    ruvnet/ruflo

    List the account's saved music productions with metadata and audiourl

    74k GitHub stars~332 tokensUpdated today
    Auto-check passed
  • Semantic Lists

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use semantic list elements.

    74k GitHub stars~504 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • List Structure

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use correct list structure.

    74k GitHub stars~438 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Definition List

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use correct definition list structure.

    74k GitHub stars~449 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Content Dates Audit

    thedaviddias/Front-End-Checklist

    Audits article and blog pages for visible publish dates, Article JSON-LD with datePublished and dateModified, and Open Graph time tags, then fixes what is missing.

    74k GitHub stars~691 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Etsy Search Listings

    sickn33/agentic-awesome-skills

    Fetch live Etsy search listing rows for a keyword, market phrase, or category via Apify Actor publicrecords/etsy-search-scraper (MCP).

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Data & AnalyticsAuto-check passed

More from mikeyobrien/ralph-orchestrator

All 16 skills in this repo
  • Ralph Docs

    mikeyobrien/ralph-orchestrator

    Introspect, explain, and improve Ralph Orchestrator using its published llms.txt doc map.

    3.2k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Evaluate Presets

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when testing Ralph's hat collection presets, validating preset configurations, or auditing the preset library for bugs and UX issues.

    3.2k GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed
  • PR Demo

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when creating animated demos (GIFs) for pull requests or documentation.

    3.2k GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Release Bump

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when bumping ralph-orchestrator version for a new release, after fixes are committed and ready to publish

    3.2k GitHub stars~583 tokensUpdated 3 days ago
    Auto-check passed
  • Review PR

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when asked to review a PR, run a code review loop, or invoke the ralph reviewer against a pull request number or GitHub URL

    3.2k GitHub stars~589 tokensUpdated 3 days ago
    Auto-check passed
  • Tui Debug In Pane

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.

    3.2k GitHub stars~825 tokensUpdated 3 days ago
    Auto-check passed

Questions about Find Code Tasks

What does Find Code Tasks do?

Lists all code tasks in the repository with their status, dates, and metadata. Find Code Tasks is an agent skill from mikeyobrien/ralph-orchestrator. Lists all code tasks in the repository with their status, dates, and metadata.

How do I install Find Code Tasks in Claude Code?

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

How do I install Find Code Tasks in Codex?

Run `npx skills add mikeyobrien/ralph-orchestrator --skill find-code-tasks -a codex`. Or copy the skill folder (.claude/skills/find-code-tasks in mikeyobrien/ralph-orchestrator) into .agents/skills/find-code-tasks in your project. Codex loads it when a task matches its description.

Can I use Find Code Tasks 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 mikeyobrien/ralph-orchestrator --skill find-code-tasks -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/find-code-tasks, .gemini/skills/find-code-tasks, .github/skills/find-code-tasks and .opencode/skills/find-code-tasks in your project.

What does Find Code Tasks need to run?

Going by SKILL.md and its folder, Find Code Tasks needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Find Code Tasks 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 Find Code Tasks 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 Find Code Tasks use?

Find Code Tasks 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 Find Code Tasks use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Find Code Tasks?

Skills that share tags, products or a category with Find Code Tasks: Music List (ruvnet/ruflo, 74k stars), Semantic Lists (thedaviddias/Front-End-Checklist, 74k stars), List Structure (thedaviddias/Front-End-Checklist, 74k stars) and Definition List (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Find Code Tasks?

mikeyobrien (a GitHub user) maintains it in mikeyobrien/ralph-orchestrator, which has 3,167 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 5, 2026.

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