schema-lint

Validate Terraform vars.tf against ORM schemas to prevent drift.

3|2|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/oci-ai-incubations/ai-accelerator-starter-packs --skill schema-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-lint
Source: https://github.com/oci-ai-incubations/ai-accelerator-starter-packs/tree/main/.claude/skills/schema-lint
Command: npx skills add https://github.com/oci-ai-incubations/ai-accelerator-starter-packs --skill schema-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Validate ORM schemas for variable visibility bugs, missing hidden variables, and schema/vars.tf drift. This skill helps ensure that Terraform variable definitions are kept in sync with the ORM UI, preventing leaking or hidden fields.

Core Features & Use Cases

  • Unhidden Variable Detection: flags variables in vars.tf that are not in common_schema.yaml with visible: false, preventing unintended exposure.
  • Schema Drift Checks: ensures consistency between vars.tf, common_schema.yaml, and category-specific schemas, catching drift during PR reviews and deployments.
  • Regeneration & Tests: supports regenerating final schemas and running tests to verify schema integrity before zipping and deployment.

Quick Start

Run the lint against your Terraform and ORM schema files to surface and fix issues before zipping.

Frequently Asked Questions about schema-lint

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

FAQPage Schema
How do I prevent Terraform vars.tf schema drift with ORM schemas?

Prevent Terraform vars.tf schema drift by validating variables against common_schema.yaml and category schemas. This checks variable visibility, detects unhidden fields, and ensures Terraform definitions stay synced with your ORM UI to avoid unintended data exposure.

Why are hidden variables missing in my ORM UI after updating Terraform variables?

Missing hidden variables in your ORM UI occur when vars.tf definitions fall out of sync with common_schema.yaml. Schema linting detects this drift by cross-checking variable visibility, ensuring hidden fields are properly registered and preventing unexpected UI behavior.

How do I lint Terraform variables to detect unhidden fields before deployment?

Lint Terraform variables to detect unhidden fields by validating vars.tf against common_schema.yaml. This process flags variables missing visible: false attributes, regenerates the final schema, runs tests, and fixes visibility issues before zipping and deploying.

Can I run schema validation checks on PRs when Terraform variables are modified?

You can run schema validation checks on PRs when Terraform variables are added or modified. The lint process cross-checks vars.tf against common_schema.yaml and category schemas, catching drift and verifying schema integrity before deployment.

What is the best way to ensure end-to-end ORM schema integrity during deployment?

Ensure end-to-end ORM schema integrity by validating variable visibility, regenerating final schemas, and running tests before deployment. This approach cross-checks vars.tf against common_schema.yaml and category schemas to prevent drift and unintended field exposure.

Does schema linting work with category-specific schemas and common_schema.yaml?

Schema linting works with both category-specific schemas and common_schema.yaml. It ensures consistency across these files and vars.tf, catching drift during PR reviews and deployments while verifying variable visibility and overall schema integrity.