Skip to main content
AI/MLakaszubski

semantic-validation

GenAI-powered semantic validation - detects outdated docs, version mismatches, and architectural drift

Stars
29
Source
akaszubski/autonomous-dev
Updated
2026-05-31
Slug
akaszubski--autonomous-dev--semantic-validation
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/akaszubski/autonomous-dev/HEAD/plugins/autonomous-dev/skills/archived/semantic-validation/SKILL.md -o .claude/skills/semantic-validation.md

Drops the SKILL.md into .claude/skills/semantic-validation.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Semantic Validation Skill

Purpose: Use GenAI to validate that documentation accurately reflects implementation, catching issues that structural validation misses.

When This Skill Activates

  • Keywords:

Core Concepts

Overview

This skill provides comprehensive guidance on semantic validation. For detailed patterns and implementation examples, see the documentation files in docs/.

Key Topics:

  • Detailed methodologies and best practices
  • Implementation patterns and examples
  • Common pitfalls and anti-patterns
  • Cross-references to related skills

See: Documentation files in docs/ directory for complete details


Quick Reference

Topic Details
Detailed Guide 1 docs/detailed-guide-1.md
Detailed Guide 2 docs/detailed-guide-2.md
Detailed Guide 3 docs/detailed-guide-3.md

Progressive Disclosure

This skill uses progressive disclosure to prevent context bloat:

  • Index (this file): High-level concepts and quick reference (<500 lines)
  • Detailed docs: docs/*.md files with implementation details (loaded on-demand)

Available Documentation:

  • docs/detailed-guide-1.md - Detailed implementation guide
  • docs/detailed-guide-2.md - Detailed implementation guide
  • docs/detailed-guide-3.md - Detailed implementation guide

Cross-References

Related Skills:

  • See PROJECT.md for complete skill dependencies

Related Tools:

  • See documentation files for tool-specific guidance

Key Takeaways

  1. Research existing patterns before implementing
  2. Follow established best practices
  3. Refer to detailed documentation for implementation specifics
  4. Cross-reference related skills for comprehensive understanding