Back to Skills

implementation-plan

verified

This skill should be used when working with IMPLEMENTATION_PLAN.md files, parsing markdown checklists, reading verification commands from AGENTS.md, or tracking task completion status. Essential for agents like Ralph that follow structured implementation plans.

View on GitHub

Marketplace

ralph-agent-marketplace

tmdgusya/roach-loop

Plugin

ralph-agent

Repository

tmdgusya/roach-loop

ralph-agent/skills/implementation-plan/SKILL.md

Last Verified

January 23, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/tmdgusya/roach-loop/blob/main/ralph-agent/skills/implementation-plan/SKILL.md -a claude-code --skill implementation-plan

Installation paths:

Claude
.claude/skills/implementation-plan/
Powered by add-skill CLI

Instructions

# Implementation Plan Skill

This skill provides knowledge for working with structured implementation plans that use markdown checklist format and verification-based task completion.

## Purpose

Implementation plans organize work into trackable tasks with verification gates. This skill covers:

- Parsing markdown checklist format (`- [ ]` for incomplete, `- [x]` for complete)
- Reading verification commands from AGENTS.md
- Updating task completion status
- Handling continuous execution workflows

## Implementation Plan Format

IMPLEMENTATION_PLAN.md uses standard markdown checklist syntax:

```markdown
# Implementation Plan

## Description
Brief description of the plan objectives.

## Prerequisites
- [ ] Dependency or setup step
- [ ] Another prerequisite

## Tasks
- [ ] Task 1: First task description
- [ ] Task 2: Second task description
- [x] Task 3: Already completed task

## Verification
Commands that verify implementation (also in AGENTS.md):
- `pytest tests/`
- `npm run test`

## Notes
Additional context or reminders.
```

## Parsing Task Lists

To find the next unchecked task:

1. Read IMPLEMENTATION_PLAN.md using the Read tool
2. Search for lines starting with `- [ ]` (unchecked tasks)
3. The first unchecked task is the next task to complete
4. Lines starting with `- [x]` are already complete

**Grep pattern for unchecked tasks:**
```bash
grep '^\- \[ \]' IMPLEMENTATION_PLAN.md
```

**Grep pattern for completed tasks:**
```bash
grep '^\- \[x\]' IMPLEMENTATION_PLAN.md
```

## Marking Tasks Complete

When a task is verified, update the checklist:

**Before:**
```markdown
- [ ] Task 1: Implement feature
```

**After:**
```markdown
- [x] Task 1: Implement feature
```

Use the Edit tool to make this change, replacing `- [ ]` with `- [x]` for the specific task line.

## Verification Commands

AGENTS.md contains verification commands used to validate work:

```markdown
# Verification Commands

## General
- `pytest tests/` - Run all tests
- `npm test` - Run test s

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4659 chars