validate

Validate insight descriptions, schema compliance, and knowledge graph health.

6|2|Updated Nov 2, 2022
One-click install
npx skills add https://github.com/arolariu/arolariu.ro --skill validate-arolariu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate
Source: https://github.com/arolariu/arolariu.ro/tree/main/.claude/skills/validate
Command: npx skills add https://github.com/arolariu/arolariu.ro --skill validate-arolariu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill acts as a quality gate for your insights, ensuring they are well-described, schema-compliant, and integrated into the knowledge graph before being considered complete.

Core Features & Use Cases

  • Description Quality: Assesses if the title and description accurately predict the insight's content through a "cold-read" test.
  • Schema Compliance: Verifies that all required fields are present and correctly formatted according to the relevant template.
  • Health Checks: Reviews link resolution, domain map connection, and identifies potential issues like sparse or stale content.
  • Use Case: After creating a new insight about a complex technical concept, run /validate to ensure its description is clear, all necessary fields are filled, and it's properly linked within your documentation.

Quick Start

Use the validate skill to check the quality and health of the insight named 'agentic-ai-overview'.

Frequently Asked Questions about validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate documentation quality and schema compliance for insights?

Insight validation checks description quality via cold-read prediction, audits schema compliance, and verifies link resolution and domain map integration to ensure documentation is well-described and properly connected to the knowledge graph.

What is a cold-read prediction test for documentation quality assurance?

A cold-read prediction test evaluates description quality by checking if an insight's title and description accurately predict its content, ensuring semantic search discoverability and graph integrity.

Do I need semantic search tools to run schema compliance and health checks?

Yes, validation requires access to semantic search tools like MCP or qmd CLI and file manipulation capabilities to verify schema compliance, resolve links, and apply potential auto-fixes to insights.

How do I fix broken links and domain map integration issues in a knowledge graph?

Health checks review link resolution and domain map integration to identify graph integrity issues, using file manipulation capabilities to verify connections and apply potential auto-fixes to insights.

When should I run quality assurance validation on my technical documentation?

Run validation after creating a new insight about a complex technical concept to ensure its description is clear, schema fields are correctly formatted, and links are properly resolved within the knowledge graph.

What are the limitations of automated insight validation for discoverability?

Validation identifies sparse or stale content and schema non-compliance but requires semantic search tools and file manipulation capabilities, limiting its use in restricted environments without MCP or qmd CLI access.