configs/skills/iloop/SKILL.md
In-session iterative loop — keeps Claude running in the current session until a task is done. Unlike /loop (which spawns background workers), /iloop stays in the current session and re-prompts each iteration via Stop hook. Use for: 'keep fixing until tests pass', 'iterate until this feature works', autonomous debugging. Triggers on: '/iloop', 'in-session loop', 'keep iterating', 'loop until done'.
npx skillsauth add shenxingy/claude-code-kit iloopInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Runs Claude in a self-contained loop within the current session — no background processes, no worktrees. Each iteration, Claude reads the last output, checks progress, makes changes, and verifies. The loop continues until the task is done or max iterations is reached.
User: /iloop "Fix all failing tests"
↓
Claude starts → works on task → tries to exit
↓
Stop hook detects .claude/iloop.local.md
↓
Feeds task prompt back → Claude continues
↓
Repeat until: <promise>DONE</promise> | <loop-abort> | max iterations
This is different from /loop (which uses background workers + worktrees). Use /iloop when:
/iloop "Fix all failing pytest tests"
/iloop "Implement the auth feature" --max-iterations 25
/iloop "Get CI green" --completion-promise "ALL TESTS PASSING" --max-iterations 30
| Signal | Effect |
|--------|--------|
| <loop-abort>reason</loop-abort> | Terminate immediately (e.g. impossible task, needs human decision) |
| <loop-pause>what needed</loop-pause> | Pause — state saved, resume by reopening session |
| <promise>TEXT</promise> | Signal completion (only when --completion-promise set and genuinely true) |
When /iloop is invoked:
Step 1: Run the setup script:
bash ~/.claude/scripts/setup-iloop.sh "$ARGUMENTS" --max-iterations 20 --completion-promise "LOOP_DONE"
Adjust --max-iterations and --completion-promise based on the task:
--completion-promise, use --max-iterationsStep 2: Tell the user:
▸ iloop started — iterating until done (max 20 iterations)
▸ Cancel: rm .claude/iloop.local.md
▸ Monitor: head -8 .claude/iloop.local.md
Step 3: Begin working on the task immediately. Per-iteration protocol:
<promise>LOOP_DONE</promise> when ALL criteria are genuinely metrm .claude/iloop.local.md # Immediate cancel
Or output <loop-abort>reason</loop-abort> from within the session.
| | /loop | /iloop |
|--|---------|----------|
| Execution | Background process, parallel workers | Current session, sequential |
| Worktrees | Yes, isolated per worker | No, works on main tree |
| Visibility | Progress via --status | Real-time in session |
| Use case | Large parallel improvements | Focused iterative fixing |
| Context | Each worker starts fresh | Same context across iterations |
testing
Test-suite diet — consolidate near-identical tests into table-driven cases, delete trivial/mock-only/brittle tests, and report every piece of coverage intentionally given up. Counterweight to AI test bloat that erodes loop clock speed.
development
Compose high-converting emails using proven copy frameworks (PAS, AIDA, BAB, FAB, 4Ps). Generates subject line variants with scores, responsive HTML templates with dark mode support, plain-text fallback, and preheader recommendations. Optimized for cold outreach, newsletters, product launches, promotions, and transactional emails. Adapts to user context from email-profile.md.
tools
Designs complete email automation sequences with timing, subject lines, copy, and conditional logic. Supports welcome series, nurture campaigns, re-engagement, abandoned cart, post-purchase, review requests, and custom sequences. Adapts sequence type, cadence, frameworks, and conditional branching to business context. Use when user wants to create an automated email series triggered by subscriber actions or time intervals.
development
Pre-send email quality review and scoring across 5 dimensions (subject line, copy quality, technical/HTML, deliverability, compliance). Analyzes subject lines, body copy, HTML structure, spam triggers, and CAN-SPAM compliance. Scores 0-100 with detailed recommendations for improvement. Use when user wants to review an email before sending, check email quality, or validate marketing email best practices.