← Back to Skills

agent-loop-guard

v1.0.0 official 6d ago
USK v3 ✅ Verified
⬇ Download
Install Guide↓
🤖 Agent install commands (curl / MCP / Claude Desktop)
▸ curl one-liner
curl -L -o agent-loop-guard.skill   "https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCode"
▸ MCP tool call (after registering Skill Store MCP)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "fc3882cd-507c-467d-9828-f639f0879e61",
    "platform": "ClaudeCode"
  }
}
▸ Claude Desktop / Cursor MCP config (one-time)
{
  "mcpServers": {
    "skill-store": {
      "url": "https://aiskillstore.io/mcp/"
    }
  }
}
📖 Full agent API guide: /llms.txt  ·  MCP server card

当用户说『agent卡死了』『一直在重复同样动作』『跑飞了烧光token』『怎么给agent设步数上限』,或 agent 出现无限循环/重复调用/原地打转时使用。把 agent 的运行当『受控进程』:监控步数上限·重复动作·状态无进展,触发即熔断并产出诊断。理论根基:LGD 三律(有籍·有证·有门禁)。触发词:agent卡死、无限循环、重复动作、跑飞、步数上限、loop guard、token烧光、失控循环。

# 失控循环 # loop guard # 步数上限 # agent监控 # token控制 # 熔断 # 可靠性 # AI工程

Basic Info

Owner 👤 Steven Zhao Category — Registered 2026-10-16 Last Updated 2026-10-17 Latest Version 1.0.0 Packaged At 2026-10-17 Vetting Status official Downloads 0 Checksum (SHA256) 590d13c0bcd547fac78673ad39bdb3d259564f1ae1ba932adf5e0c13845320f7

⚡ AGENT INFO USK v3

Capabilities
loop_detection trace_analysis safety
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: scripts/loop_guard.py   runtime: python3   call_pattern: args
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=OpenClaw GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCode GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=Cursor GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=GeminiCLI GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=CodexCLI GET /v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=CustomAgent

Installation

1
Install the skill using openclaw_skill_manager.py.
python openclaw_skill_manager.py --install agent-loop-guard
2
Verify installation
python openclaw_skill_manager.py --list-installed
3
Install a specific version (optional)
python openclaw_skill_manager.py --install agent-loop-guard --version 1.0.0
1
Download the skill package.
curl -O https://aiskillstore.io/v1/skills/fc3882cd-507c-467d-9828-f639f0879e61/download
2
Place it in the Claude Code commands directory.
unzip agent-loop-guard.skill -d ~/.claude/commands/agent-loop-guard/
3
Use it as a slash command in Claude Code.
/agent-loop-guard
1
Download the Agent Skills package.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=ClaudeCodeAgentSkill
2
Unzip it into the Claude Code skills directory.
unzip agent-loop-guard-agent-skill-*.skill -d ~/.claude/skills/agent-loop-guard/
3
Restart Claude Code — the skill is auto-loaded at session start. No slash command needed.
1
Download the Cursor-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=Cursor
2
Unzip and place it in a permanent location.
unzip agent-loop-guard-cursor-*.skill -d ~/.cursor/skills/agent-loop-guard/
3
Add the MCP server config to .cursor/mcp.json, then restart Cursor.
cat ~/.cursor/skills/agent-loop-guard/cursor_mcp_config.json
1
Download the Gemini CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=GeminiCLI
2
Unzip and place it in a permanent location.
unzip agent-loop-guard-geminicli-*.skill -d ~/.gemini/skills/agent-loop-guard/
3
Add the MCP server config to ~/.gemini/settings.json, then restart Gemini CLI.
cat ~/.gemini/skills/agent-loop-guard/gemini_settings_snippet.json
1
Download the Codex CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/fc3882cd-507c-467d-9828-f639f0879e61/download?platform=CodexCLI
2
Unzip and place it in a permanent location.
unzip agent-loop-guard-codexcli-*.skill -d ~/.codex/skills/agent-loop-guard/
3
Add the MCP server config to ~/.codex/config.toml, then restart Codex CLI.
cat ~/.codex/skills/agent-loop-guard/codex_config_snippet.toml
1
Download the skill package via REST API.
GET https://aiskillstore.io/v1/skills/fc3882cd-507c-467d-9828-f639f0879e61/download
2
Place it in your agent platform's skills directory.
cp agent-loop-guard.skill ./skills/
3
Fetch platform-specific details via the Install Guide API.
GET https://aiskillstore.io/v1/skills/fc3882cd-507c-467d-9828-f639f0879e61/install-guide?platform=CustomAgent

Requirements

Security Vetting Report

Vetting Result CAUTION

Findings: ["메타데이터 경고: 권장 필드 없음: 'platform_compatibility' (SKILL.md v2 권장)", "USK v3 경고: input_schema.type이 'object'가 아닙니다", "USK v3 경고: output_schema.type이 'object'가 아닙니다", 'USK v3 경고: 이 스킬은 자동 변환 조건을 충족하지 않아 manual_install로 처리됩니다']

✅ No security risks found.

AI Review Stage

Reviewer gemini Risk Level 🟡 Medium Review Summary 스킬이 파일 시스템 접근 권한이 없다고 선언했으나, 실제 코드에서 파일 읽기 작업을 수행하며 입력 스키마 설명과도 불일치합니다.

Issues Found

  • **권한 불일치 (Permission Mismatch):** 메타데이터의 `permissions.filesystem`이 `false`로 선언되었으나, `scripts/loop_guard.py` 코드에서 `pathlib.Path(p).read_text()`를 사용하여 파일 시스템에서 파일을 읽습니다. 이는 선언된 권한과 실제 동작이 일치하지 않습니다.
  • **입력 스키마 불일치 (Input Schema Discrepancy):** `input_schema.trace`는 '실행 궤적 텍스트 (인라인)'로 설명되어 있어 궤적 내용 자체가 입력으로 전달될 것으로 예상되지만, 실제 코드(`parse_trace` 함수)는 이 인자를 파일 경로로 해석하여 파일을 읽습니다. 이로 인해 사용자가 임의의 파일 경로를 입력할 경우, 에이전트가 접근 가능한 시스템 파일을 읽을 수 있는 잠재적인 '임의 파일 읽기(Arbitrary File Read)' 취약점이 발생할 수 있습니다.
Reasoning

스킬의 목적(에이전트 루프 감지)은 유용하고 코드 자체에 명백한 악의적인 의도는 보이지 않습니다. 또한, 네트워크 통신이나 서브프로세스 실행은 선언된 대로 이루어지지 않습니다. 그러나 `filesystem: false`로 명시적으로 선언했음에도 불구하고 파일 시스템에서 파일을 읽는 동작은 보안 정책 위반입니다. 특히, 입력 스키마 설명과 코드의 동작 방식이 달라, 사용자가 파일 경로를 입력할 경우 에이전트가 접근 가능한 임의의 파일을 읽을 수 있는 정보 유출 위험이 있습니다. 이는 'medium' 수준의 보안 위험으로 판단되며, 개발자의 수정 및 재검토가 필요합니다. 개발자는 코드를 수정하여 인라인 텍스트를 직접 처리하거나, 파일 시스템 접근 권한을 `true`로 변경하고 이에 대한 명확한 설명과 위험 완화 방안을 제시해야 합니다.

Version History

Version USK v3 Vetting Status Packaged At Downloads Changelog
v1.0.0 ✓ official 2026-10-17 ⬇ 0 1.0.0: initial upload (USK v3)
v1.0.0 — approved 2026-10-16 ⬇ 0 —

Reviews & Ratings

No reviews yet. Be the first to leave one!

✍️ Write a Review