Agent Skills › yifanfeng97/Hyper-Extract › yaml-validator

yaml-validator

GitHub

验证 Hyper-Extract YAML 模板的语法、结构及字段配置，确保符合类型规范与标识符要求，提供多级错误反馈。

hyperextract-skills/yaml-validator/SKILL.md yifanfeng97/Hyper-Extract

Trigger Scenarios

validate template check YAML fix errors validate syntax

Install

npx skills add yifanfeng97/Hyper-Extract --skill yaml-validator -g -y

More Options

Non-standard path

npx skills add https://github.com/yifanfeng97/Hyper-Extract/tree/main/hyperextract-skills/yaml-validator -g -y

Use without installing

npx skills use yifanfeng97/Hyper-Extract@yaml-validator

指定 Agent (Claude Code)

npx skills add yifanfeng97/Hyper-Extract --skill yaml-validator -a claude-code -g -y

安装 repo 全部 skill

npx skills add yifanfeng97/Hyper-Extract --all -g -y

预览 repo 内 skill

npx skills add yifanfeng97/Hyper-Extract --list

SKILL.md

Frontmatter

{
    "name": "yaml-validator",
    "description": "Validate Hyper-Extract YAML templates for syntax and structure errors.\nUse when user says: \"validate template\", \"check YAML\", \"fix errors\", \"validate syntax\".\nTrigger: User wants to verify their YAML configuration is correct.\nSkip: User wants to design a new template (use record-designer or graph-designer instead)."
}

YAML Validator

Validation Workflow

Syntax check: YAML is valid
Required fields: All required fields present
Type check: Valid AutoType value
Identifiers check: Proper configuration for type
Field validation: Types and descriptions present

Quick Validation Checklist

All Types

- [ ] language: zh/en
- [ ] name: PascalCase
- [ ] type: valid AutoType
- [ ] tags: lowercase array
- [ ] description: non-empty
- [ ] output: exists
- [ ] guideline: exists

Graph Types

- [ ] output.entities: exists
- [ ] output.relations: exists
- [ ] identifiers.entity_id: exists
- [ ] identifiers.relation_id: exists
- [ ] identifiers.relation_members: configured

Hypergraph

- [ ] relation_members is string OR list
- [ ] If list: all fields are type: list

Temporal/Spatial

- [ ] identifiers.time_field: configured (temporal)
- [ ] identifiers.location_field: configured (spatial)

Validation Levels

Level	Meaning	Action
ERROR	Must fix	Won't work without fix
WARNING	Should fix	May affect quality
INFO	Reference	Recommended to follow

Reference Files

Important: Check these files only when needed during validation process.

Topic	When to Check
references/rules-syntax.md	Always (first step)
references/rules-types.md	Type-specific validation
references/rules-identifiers.md	Identifier configuration check
references/rules-errors.md	When errors are found

Validation Order

Recommended order: Follow this sequence for efficient validation:

Syntax → rules-syntax.md - Check YAML validity first
Structure → rules-types.md - Validate based on type
Identifiers → rules-identifiers.md - Check identifier config
Errors → rules-errors.md - Look up fixes if needed

Error Message Format

## Validation Results

### Syntax Validation
✅ PASSED

### Structure Validation
✅ PASSED
- language: ✅
- name: ✅
- type: ✅
- tags: ✅
- description: ✅
- output: ✅

### Semantic Validation
⚠️ 2 warnings
- WARNING: [message]
- WARNING: [message]

### Overall Assessment
✅ Configuration valid