output-contract-enforcer — скилл для Claude Code: проверка JSON-схем
Скилл output-contract-enforcer для Claude Code проверяет JSON-выход узлов DAG по схеме и выявляет несовместимость соседних узлов. Помогает найти причину неожиданных данных в следующем узле.
MIT 141 установок ★ 274 обновлён 2026-10-30
npx skills add curiositech/some_claude_skills --skill output-contract-enforcer -a claude-codeЧто делает output-contract-enforcer
Скилл проверяет, разбирается ли результат как JSON, содержит ли обязательные поля и совпадают ли типы, значения enum и заданные ограничения. Для связки узлов он сверяет выходную схему одного узла с обязательными полями и требованиями следующего, а при несовпадении указывает, чего не хватает или что нужно изменить.
По описанию узла скилл также составляет JSON Schema. В примерах разобраны базовый контракт DAG и структура с массивом рекомендаций. Для проверки можно передать JSON и схему; доступны инструменты Read, Write, Edit и Grep.
Скилл относится к контрактам внутри DAG: он проверяет структуру, а не качество или правильность содержимого. Для общей работы с JSON Schema вне DAG он не предназначен; оценку качества контента README предлагает поручить dag-quality.
Какие задачи решает
- проверить выход узла DAG по JSON Schema
- найти обязательные поля, которых не хватает
- обнаружить неверный тип или значение enum
- сверить выходную схему одного узла со входом следующего
- составить схему по описанию результата узла
Примеры запросов агенту
- Проверь этот JSON-выход узла DAG по приложенной схеме и перечисли ошибки.
- Составь JSON Schema для узла, который возвращает рекомендации с приоритетами.
- Сверь выход Node A со входом Node B и объясни, почему контракт несовместим.
Как установить output-contract-enforcer
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill output-contract-enforcer -a claude-code2Вручную: положить файлы
~/.claude/skills/output-contract-enforcer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/output-contract-enforcer/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill output-contract-enforcer -a codex2Вручную: положить файлы
.agents/skills/output-contract-enforcer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill output-contract-enforcer -a cursor2Вручную: положить файлы
.cursor/skills/output-contract-enforcer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/output-contract-enforcer2Вручную: положить файлы
.github/skills/output-contract-enforcer/SKILL.md1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill output-contract-enforcer -a gemini-cli2Командой платформы
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/output-contract-enforcerВручную: положить файлы
.devin/skills/output-contract-enforcer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill output-contract-enforcer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об output-contract-enforcer
Как установить output-contract-enforcer в Claude Code?
Выполните npx skills add curiositech/some_claude_skills --skill output-contract-enforcer -a claude-code. Файл скилла находится по пути ~/.claude/skills/output-contract-enforcer/SKILL.md.
Что делает output-contract-enforcer?
Проверяет JSON-выходы узлов DAG по схемам: обязательные поля, типы и ограничения. Также помогает сверить контракты связанных узлов.
Проверяет ли скилл качество содержимого JSON?
Нет, он проверяет соответствие структуры схеме. Для оценки качества содержимого README рекомендует dag-quality.
Исходный текст
SKILL.md · MIT
---
name: output-contract-enforcer
description: Validates that a DAG node's output matches its declared JSON schema before passing to downstream nodes. The glue that makes multi-agent DAGs reliable. Use when checking output contract compliance,
generating validation schemas from descriptions, or debugging contract mismatches between nodes. Activate on "validate output", "output contract", "schema validation", "contract mismatch", "output doesn't
match". NOT for content quality assessment (use dag-quality), skill grading (use skill-grader), or general JSON schema work outside DAG context.
allowed-tools: Read,Write,Edit,Grep
argument-hint: '[output-json] [schema]'
metadata:
tags:
- output
- contract
- enforcer
- validate-output
- output-contract
pairs-with:
- skill: task-decomposer
reason: Decomposed tasks define the output schemas that the enforcer validates between nodes
- skill: human-gate-designer
reason: Human gate inputs/outputs need the same schema validation as automated node outputs
- skill: typescript-advanced-patterns
reason: Branded types and Zod schemas implement runtime output contract validation in TypeScript
---
# Output Contract Enforcer
Validates that a DAG node's output matches its declared JSON schema before passing to downstream nodes. The glue that makes multi-agent DAGs reliable. Without this, downstream nodes receive unpredictable input and the DAG breaks.
---
## When to Use
✅ **Use for**:
- Validating a node's output against its declared schema
- Generating output schemas from natural-language output descriptions
- Debugging why a downstream node rejected its input
- Ensuring contract compatibility between connected nodes
❌ **NOT for**:
- Assessing content quality or correctness (use `dag-quality`)
- Grading skill quality (use `skill-grader`)
- General JSON schema work outside DAG context
---
## Validation Process
```mermaid
flowchart TD
O[Node output] --> P[Parse as JSON]
P -->|Parse error| E1[FAIL: Not valid JSON]
P -->|Valid JSON| S[Check against schema]
S --> R{Required fields?}
R -->|Missing| E2[FAIL: Missing required field X]
R -->|Present| T{Type check?}
T -->|Wrong type| E3[FAIL: Field X expected string, got number]
T -->|Correct| C{Constraints?}
C -->|Violated| E4[FAIL: Field X violates constraint Y]
C -->|Met| V[PASS: Contract satisfied]
```
### What Gets Checked
| Check | Example | Failure Message |
|-------|---------|----------------|
| JSON parseable | `{broken json` | "Output is not valid JSON" |
| Required fields | `status` missing | "Missing required field: status" |
| Field types | `status: 42` (expected string) | "Field 'status' expected string, got number" |
| Enum values | `status: "maybe"` | "Field 'status' must be one of: pass, warn, fail" |
| String constraints | `summary: ""` (minLength: 1) | "Field 'summary' must have minLength 1" |
| Number constraints | `score: 1.5` (maximum: 1.0) | "Field 'score' must be ≤ 1.0" |
| Array constraints | `items: []` (minItems: 1) | "Field 'items' must have at least 1 item" |
| Nested objects | Missing sub-field | "Field 'metadata.cost' is required" |
### The Standard Output Contract
Every DAG node should produce output matching this base schema (fields can be extended):
```json
{
"type": "object",
"required": ["status", "summary"],
"properties": {
"status": {
"type": "string",
"enum": ["pass", "warn", "fail"]
},
"summary": {
"type": "string",
"minLength": 1,
"description": "1-3 sentence description of what was produced"
},
"artifacts": {
"type": "array",
"items": { "type": "string" },
"description": "List of files created or modified"
},
"data": {
"type": "object",
"description": "Node-specific output data (schema varies per node)"
},
"risks": {
"type": "array",
"items": { "type": "string" },
"description": "Remaining risks or assumptions"
}
}
}
```
### Contract Compatibility Check
When connecting Node A's output to Node B's input, verify:
1. Every field B requires is present in A's output schema
2. Types match (A produces string, B expects string)
3. A's output constraints are compatible with B's input constraints
4. If A produces optional fields that B requires → incompatible
```
Node A output: { status: string, recommendations: string[] }
Node B input: { status: string, recommendations: string[], priority: number }
Result: INCOMPATIBLE — Node B requires 'priority' but Node A doesn't produce it.
Fix: Add 'priority' to Node A's output, or add a transformer node between A and B.
```
---
## Schema Generation
When a node description says "produces a list of recommendations with priorities," generate:
```json
{
"type": "object",
"required": ["status", "summary", "data"],
"properties": {
"status": { "type": "string", "enum": ["pass", "warn", "fail"] },
"summary": { "type": "string", "minLength": 1 },
"data": {
"type": "object",
"required": ["recommendations"],
"properties": {
"recommendations": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["text", "priority"],
"properties": {
"text": { "type": "string" },
"priority": { "type": "integer", "minimum": 1, "maximum": 5 }
}
}
}
}
}
}
}
```
---
## Anti-Patterns
### No Contract at All
**Wrong**: Nodes produce free-form text with no schema.
**Why**: Downstream nodes can't reliably parse the input. The DAG is fragile.
**Right**: Every node declares its output schema. Every output is validated before passing downstream.
### Overly Strict Contracts
**Wrong**: Requiring exact character counts, specific formatting, or field values that depend on runtime context.
**Right**: Constrain structure (types, required fields), not content. Let dag-quality handle content assessment.
### Ignoring Optional Fields
**Wrong**: Treating all fields as required.
**Right**: Use `required` only for fields that downstream nodes absolutely need. Mark everything else as optional.
© curiositech · MIT · curiositech/some_claude_skills