58 lines
1.4 KiB
YAML
58 lines
1.4 KiB
YAML
name: docs.validate.skilldocs
|
|
version: 0.1.0
|
|
description: Validate SKILL.md documentation files against their skill.yaml manifests to ensure completeness and consistency
|
|
|
|
inputs:
|
|
- name: skill_path
|
|
type: string
|
|
required: true
|
|
description: Path to skill directory containing skill.yaml and SKILL.md
|
|
|
|
- name: summary
|
|
type: boolean
|
|
required: false
|
|
default: false
|
|
description: Print a short summary table of validation results instead of full JSON output
|
|
|
|
- name: check_headers
|
|
type: boolean
|
|
required: false
|
|
default: true
|
|
description: Validate that SKILL.md contains required section headers
|
|
|
|
- name: check_manifest_parity
|
|
type: boolean
|
|
required: false
|
|
default: true
|
|
description: Validate that SKILL.md documentation matches skill.yaml manifest fields
|
|
|
|
outputs:
|
|
- name: valid
|
|
type: boolean
|
|
description: Whether the skill documentation is valid
|
|
|
|
- name: validation_report
|
|
type: object
|
|
description: Detailed validation results including errors and warnings
|
|
|
|
- name: errors
|
|
type: array
|
|
description: List of validation errors found
|
|
|
|
- name: warnings
|
|
type: array
|
|
description: List of validation warnings found
|
|
|
|
dependencies:
|
|
- context.schema
|
|
|
|
entrypoints:
|
|
- command: /docs/validate/skill-docs
|
|
handler: skill_docs_validate.py
|
|
runtime: python
|
|
permissions:
|
|
- filesystem:read
|
|
|
|
status: active
|
|
tags: [documentation, validation, quality-assurance, skill-management]
|