Executes defined work items by performing edits, staging, committing, and running CI checks.

Install

mkdir -p .claude/skills/do-whilp && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15994" && unzip -o skill.zip -d .claude/skills/do-whilp && rm skill.zip

Installs to .claude/skills/do-whilp

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Execute a work plan. Make changes, run validation, commit.
58 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Execute a work plan by making code changes
  • Run validation checks after each step
  • Commit changes with descriptive messages for each step
  • Address feedback from previous attempts or reviews
  • Maintain a running list of modified files
  • Run format and lint checks and amend commits

How it works

The skill reads a work plan, applies changes step-by-step, validates them, and commits each step, addressing any prior feedback.

Inputs & outputs

You give it
A work plan in `o/plan/plan.md` and optional feedback in `o/do/feedback.md`
You get back
Code changes in the target repository, committed step-by-step, with a `o/do/do.md` report

When to use do

  • Implementing a new feature from a plan
  • Addressing code review feedback
  • Resolving CI failures
  • Automating repo-specific refactoring tasks

About this skill

Do

You are executing a work item. Follow the plan.

Environment

  • The target repository is at o/repo/. Make all changes there.
  • The feature branch is already checked out.
  • The work item JSON follows this prompt after ---.
  • If type is "pr", you are addressing review feedback on an existing PR.
  • If type is "issue", you are implementing new work.
  • Build dependencies are pre-fetched under o/repo/o/. You can run make ci (or individual targets like make test, make check-types, make lint) inside the sandbox. Read o/build/log.txt for the initial CI output and o/build/log.txt.exit for the exit code.

Setup

Read o/repo/AGENTS.md if it exists. It contains repo-specific context, conventions, and build instructions for the target repository. Follow its guidance.

Read o/plan/plan.md for the full plan.

Read o/do/feedback.md — if non-empty, it contains notes from a previous attempt. This may be review feedback from a check phase, or timeout notes from a timed-out do attempt (with errors encountered, key observations, and uncommitted changes). Address those issues first, then continue with any remaining plan steps.

Instructions

  1. Read the plan and every file you intend to modify before editing.
  2. If feedback.md is non-empty, fix those issues first.
  3. Maintain a running list of files you modify.
  4. For each remaining step in the plan: a. Make the changes for that step. b. Before staging, run git -C o/repo status and verify only your files are affected. c. Stage the specific files changed (not git add -A). d. Commit with a descriptive message for that step.
  5. Run format and lint checks from o/repo/AGENTS.md (e.g. make check-format, make format). Fix any issues and amend the last commit.
  6. Run cd o/repo && make ci to validate all changes. Use a 300s bash timeout ("timeout": 300000) — some repos take over 2 minutes for a full CI run. Fix any failures and amend.
  7. If validation requires fixes, stage and commit them.

Forbidden

Do not use destructive git commands: git reset --hard, git checkout ., git clean -fd, git stash, git commit --no-verify.

Output

Write o/do/do.md:

# Do: <title>

## Changes
<list of files changed>

## Commit
<SHA or "none">

## Status
<success|partial|failed>

## Notes
<issues encountered>

Follow the plan. Do not add unrequested changes.

When not to use it

  • When the work plan is not clearly defined
  • When destructive git commands are required
  • When the target repository is not at `o/repo/`

Limitations

  • Requires the target repository to be at `o/repo/`
  • Forbidden from using destructive git commands
  • Requires `o/plan/plan.md` for the full plan

How it compares

This workflow provides a structured, step-by-step execution of a work plan with integrated validation and commit management, ensuring adherence to the plan and addressing feedback systematically, unlike manual code changes.

Compared to similar skills

do side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
do (this skill)05moNo flagsIntermediate
github-workflow-automation112moReviewAdvanced
github-actions-templates73moNo flagsIntermediate
hooks-automation34moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry