shenxingy/loop
mcp-package/skills/loop/SKILL.md
Clade goal-driven autonomous improvement loop (Blueprint architecture — deterministic pre/post phases + LLM supervisor/worker nodes, converges when goal met or max-iter hit). NOT the Claude Code built-in /loop (which polls a prompt on an interval like `/loop 5m /foo`) — if the user wants interval polling, route to the built-in.
$ install --global
skillsauthnpx skillsauth add shenxingy/claude-code-kit loopInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 7:10 AM37.5s2 files scanned
SKILL.md
- name:
- loop
- description:
- Clade goal-driven autonomous improvement loop (Blueprint architecture — deterministic pre/post phases + LLM supervisor/worker nodes, converges when goal met or max-iter hit). NOT the Claude Code built-in /loop (which polls a prompt on an interval like `/loop 5m /foo`) — if the user wants interval polling, route to the built-in.
- when_to_use:
- run loop with goal file, autonomous supervisor+worker loop, keep fixing until tests pass, iterate until converged, goal.md, Blueprint loop, 自动循环, run until converged — NOT for TODO.md tasks (use /batch-tasks), NOT for task decomposition (use /orchestrate), NOT for interval polling a prompt (that's the CC built-in /loop)
- argument-hint:
- GOAL_FILE [--model haiku|sonnet|opus] [--worker-model MODEL] [--max-iter N] [--max-workers N] [--dry-run] [--status] [--stop] [--resume]
- user_invocable:
- true
Loop Skill
Runs an autonomous improvement loop driven by a goal file (ideal end state description).
Architecture
You write: goal.md (what the system should do — NOT a task list)
↓
PRE (deterministic):
pre_flight — goal exists, no blockers
hydrate_context — git log + status
parse_todo — extract unchecked items from goal file
↓
LLM CORE:
Supervisor — plans 1–4 tasks (output: JSON task array)
Workers — execute ALL tasks IN PARALLEL
↓
POST (deterministic + conditional LLM):
syntax_check — validate all changed files
fix_syntax — [LLM] one attempt to fix failures
test_sample — run verify_cmd from CLAUDE.md
mid-iter fix — [LLM] if test fails → fix → re-test (Stripe pattern)
commit_changes — commit all worker output
↓
Deterministic convergence check:
- remaining unchecked items = 0 → CONVERGED
- max iterations hit → exit
- stuck (N× no-commits) → exit
↓
Repeat until CONVERGED or max iterations
What you write (goal.md)
# Goal: Improve orchestrator loop mode
## Requirements
- Oracle rejection re-queues task with rejection reason as context
- Worker context budget warning auto-injected at 80%
- Workers get AGENTS.md prepended automatically
## Success criteria
- python -m py_compile server.py passes
- Existing features unaffected
The supervisor does the task breakdown — not you.
Usage
/loop goal.md # Start loop (sonnet, max 10 iter, 4 parallel workers)
/loop goal.md --model haiku # Cheaper/faster supervisor+workers
/loop goal.md --max-iter 3 # Short run to test
/loop goal.md --max-workers 2 # Limit parallel workers
/loop goal.md --max-consecutive-failures 5 # Stop after 5 consecutive worker failures (default: 3)
/loop --status # Check current loop progress
/loop --stop # Stop loop after current iteration
/loop --dry-run goal.md # Preview without running
/loop --resume goal.md # Resume interrupted loop
After convergence
Run /commit to push any remaining uncommitted changes from workers.
Run /review to verify all behavior anchors still pass after autonomous changes.
Related Skills
shenxingy/blog-multilingual
testing
VerifiedTrustedCommunity
One-command multilingual blog creation. Writes a blog post, translates it into user-specified languages, applies cultural adaptation, and emits hreflang tags, sitemap entries, and a CMS-ready language map. The complete write-to-publish pipeline for international content. Orchestrates blog-write, blog-translate, blog-localize, and (optionally) seo-hreflang. Use when user says "multilingual blog", "blog multilingual", "write in multiple languages", "international blog", "mehrsprachiger Blog", "blog multilingue", "blog multilingue", "create blog in German and French".
7SKILL.mdUpdated May 28, 2026
shenxingy/blog-discourse
development
VerifiedTrustedCommunity
Research what people are actually saying about a topic in the last 30 days across Reddit, X / Twitter, YouTube, Hacker News, dev.to, Medium, and other public discourse platforms. API-free; uses WebSearch with platform-targeted site operators plus recency filters. Produces DISCOURSE.md (a structured brief) and JSON output the writer can consume. Complements blog-researcher (which focuses on authority sources) with a recency-and-engagement lens. Use when user says "blog discourse", "discourse research", "what are people saying about", "research what people are saying", "voice of customer", "social listening", "30-day research", "trend research", "what's the discussion on", "real-time research", "practitioner discourse", "/blog discourse".
7SKILL.mdUpdated May 28, 2026
shenxingy/blog-brand
documentation
VerifiedTrustedCommunity
Establish durable brand and voice context for cross-skill consumption. Generates BRAND.md (audience, positioning, do/don't editorial rules, taboo phrases, competitor differentiation) and VOICE.md (existing persona JSON re-expressed as readable prose), both written to the project root. When present, all blog sub-skills auto-load these files before writing or reviewing. Pairs with blog-persona, which manages the structured persona JSON. Use when user says "blog brand", "create brand context", "brand voice doc", "BRAND.md", "VOICE.md", "establish editorial brand", "brand guidelines for blog".
7SKILL.mdUpdated May 28, 2026
shenxingy/ads-server-side-tracking
development
VerifiedTrustedCommunity
Server-side tracking pipeline audit covering server-side Google Tag Manager (sGTM), Meta CAPI Gateway, Conversions API health, event deduplication via event_id, server-side hit ratio targets, pixel debugging, and PII hashing discipline. Use when user says server-side tracking, sGTM, server-side GTM, server-side tagging, CAPI, Conversions API, CAPI Gateway, Meta Conversions API, event deduplication, event_id, pixel debug, pixel health, Pixel/CAPI audit, first-party tracking, iOS 14.5 recovery, or server-side hit ratio.
7SKILL.mdUpdated May 28, 2026