← Back to Skills

output-schema-guard

v1.0.0 official 5d ago
USK v3 ✅ Verified
⬇ Download
Install Guide↓
🤖 Agent install commands (curl / MCP / Claude Desktop)
▸ curl one-liner
curl -L -o output-schema-guard.skill   "https://aiskillstore.io/v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=ClaudeCode"
▸ MCP tool call (after registering Skill Store MCP)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "8dbcab65-30dc-4200-8ea5-28477bfabf5c",
    "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

当用户说『模型返回的JSON又崩了』『字段缺失对不上』『下游解析失败』『怎么强制LLM输出合规结构』,或要把 LLM 的 JSON/结构化输出接进代码(API/数据库/表单)时使用。把模型输出当『不可信外部输入』:用 schema 校验必填字段·类型·枚举,缺则给可执行的修复提示而非裸报错。理论根基:LGD 三律(有籍·有证·有门禁)。触发词:结构化输出、JSON校验、schema guard、输出格式、字段缺失、模型输出解析、function calling、tool output。

# 结构化输出 # schema校验 # JSON guard # function calling # 输出格式 # agent优化 # 可靠性

Basic Info

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

⚡ AGENT INFO USK v3

Capabilities
json schema validation
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: scripts/schema_guard.py   runtime: python3   call_pattern: args
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=OpenClaw GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=ClaudeCode GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=Cursor GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=GeminiCLI GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=CodexCLI GET /v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=CustomAgent

Installation

Compatible Platforms windows macos linux

1
Install the skill using openclaw_skill_manager.py.
python openclaw_skill_manager.py --install output-schema-guard
2
Verify installation
python openclaw_skill_manager.py --list-installed
3
Install a specific version (optional)
python openclaw_skill_manager.py --install output-schema-guard --version 1.0.0
1
Download the skill package.
curl -O https://aiskillstore.io/v1/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download
2
Place it in the Claude Code commands directory.
unzip output-schema-guard.skill -d ~/.claude/commands/output-schema-guard/
3
Use it as a slash command in Claude Code.
/output-schema-guard
1
Download the Agent Skills package.
curl -O https://aiskillstore.io/v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=ClaudeCodeAgentSkill
2
Unzip it into the Claude Code skills directory.
unzip output-schema-guard-agent-skill-*.skill -d ~/.claude/skills/output-schema-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/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=Cursor
2
Unzip and place it in a permanent location.
unzip output-schema-guard-cursor-*.skill -d ~/.cursor/skills/output-schema-guard/
3
Add the MCP server config to .cursor/mcp.json, then restart Cursor.
cat ~/.cursor/skills/output-schema-guard/cursor_mcp_config.json
1
Download the Gemini CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=GeminiCLI
2
Unzip and place it in a permanent location.
unzip output-schema-guard-geminicli-*.skill -d ~/.gemini/skills/output-schema-guard/
3
Add the MCP server config to ~/.gemini/settings.json, then restart Gemini CLI.
cat ~/.gemini/skills/output-schema-guard/gemini_settings_snippet.json
1
Download the Codex CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download?platform=CodexCLI
2
Unzip and place it in a permanent location.
unzip output-schema-guard-codexcli-*.skill -d ~/.codex/skills/output-schema-guard/
3
Add the MCP server config to ~/.codex/config.toml, then restart Codex CLI.
cat ~/.codex/skills/output-schema-guard/codex_config_snippet.toml
1
Download the skill package via REST API.
GET https://aiskillstore.io/v1/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/download
2
Place it in your agent platform's skills directory.
cp output-schema-guard.skill ./skills/
3
Fetch platform-specific details via the Install Guide API.
GET https://aiskillstore.io/v1/skills/8dbcab65-30dc-4200-8ea5-28477bfabf5c/install-guide?platform=CustomAgent

Requirements

Security Vetting Report

Vetting Result CAUTION

Findings: ["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

  • 메타데이터의 `permissions.filesystem`이 `false`로 선언되었으나, 실제 코드(`scripts/schema_guard.py`)는 `pathlib.Path(...).read_text()`를 사용하여 스키마 파일과 입력 데이터 파일을 읽습니다.
  • 메타데이터의 `risk_rationale`에서 '读写文件'(파일 읽기/쓰기)를 언급하여 파일 시스템 접근 가능성을 시사하지만, `permissions.filesystem: false` 선언과 모순됩니다.
Reasoning

제출된 스킬 'output-schema-guard'의 Python 코드(`scripts/schema_guard.py`)를 분석한 결과, `argparse`를 통해 `--schema` 및 `--file` 인자로 전달된 경로의 파일을 `pathlib.Path(...).read_text()` 함수를 사용하여 읽는 기능이 명확하게 확인되었습니다. 이는 스킬 메타데이터에 `permissions.filesystem: false`로 명시된 선언과 직접적으로 충돌합니다. 스킬의 `risk_rationale`에서 '读写文件' (파일 읽기/쓰기)를 언급하며 'medium' 리스크를 자체 평가한 점은 개발자가 파일 시스템 접근이 있음을 인지하고 있었을 가능성을 시사하지만, `permissions` 필드에 정확하게 반영되지 않았습니다. 코드 자체는 JSON 스키마 유효성 검사라는 명확한 목적을 가지고 있으며, 악의적인 동작(데이터 탈취, 시스템 파괴, 외부 통신, 난독화 등)은 발견되지 않았습니다. 그러나 선언된 권한과 실제 동작 간의 불일치는 보안 검수에서 중요한 문제이며, 사용자에게 잘못된 정보를 제공할 수 있으므로 수정이 필요합니다. 따라서 'pending' 상태로 지정하여 개발자의 수정 또는 관리자의 추가 검토를 요청합니다.

Version History

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

Reviews & Ratings

No reviews yet. Be the first to leave one!

✍️ Write a Review