TSConfig Validator for Openclaw

A specialized linting and validation tool designed to identify conflicting compiler options and strictness gaps in TypeScript configuration files.

charlie-morrison
v1.0.1
May 1, 2026
0
798
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install tsconfig-validator

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install tsconfig-validator using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is TSConfig Validator?

TSConfig Validator is a robust utility within the Openclaw Skills ecosystem that ensures your TypeScript configurations are performant, secure, and logically sound. It goes beyond simple JSON schema validation by analyzing 22 specific rules across categories like compiler compatibility, strictness, and organizational best practices.

By integrating this skill, developers can automatically catch common mistakes like module resolution mismatches, missing out-dirs, or forgotten strict-mode flags. It serves as a vital safeguard for maintaining high-quality codebases and ensuring that the TypeScript compiler behaves predictably across different environments.

TSConfig Validator Use Cases

  • Auditing existing TypeScript projects for strictness gaps and missing compiler flags.
  • Validating structural integrity and JSON syntax of tsconfig.json files during CI/CD pipelines.
  • Checking for compatibility issues between the target ECMAScript version and selected module systems.
  • Improving build performance by identifying missing incremental compilation or source map misconfigurations.

How TSConfig Validator Works

  1. The skill parses the target tsconfig.json file to verify valid JSON syntax and structural integrity.
  2. It runs a suite of 22 predefined rules covering four core domains: structure, strictness, compatibility, and best practices.
  3. The validator identifies specific issues such as conflicting include/exclude patterns or outdated build targets.
  4. It generates a detailed report in the requested format (Text, JSON, or Markdown) providing actionable suggestions for resolution.
  5. Depending on the configuration, it returns specific exit codes to signal success or identify critical configuration errors.

TSConfig Validator Setup

To use this tool from the Openclaw Skills library, ensure you have Python 3 installed and run the scripts directly against your configuration files:

# Lint a configuration file with default settings
python3 scripts/tsconfig_validator.py lint tsconfig.json

# Run a strictness-specific audit
python3 scripts/tsconfig_validator.py strict tsconfig.json

# Perform structural validation only
python3 scripts/tsconfig_validator.py validate tsconfig.json

TSConfig Validator Data Schema & Taxonomy

The skill organizes its findings into a clear severity-based taxonomy. Results can be exported for programmatic use or documentation:

Level Description
Error Critical issues like invalid JSON or missing base URLs for paths that will break the build.
Warning Potential runtime issues, conflicting options, or missed strictness flags.
Info Suggestions for best practices, such as enabling incremental builds or source maps.

Supported output formats include --format text, --format json, and --format markdown.

TSConfig Validator Advanced Features

  • Multi-format reporting (JSON/Markdown) for seamless integration into automated dev workflows.
  • Strict mode enforcement via the --strict flag which elevates warnings to exit-code failures.
  • Specialized compatibility checks for JSX, React, and Node.js module resolution strategies.
  • Comprehensive audit of 22 distinct rules to ensure industry-standard TypeScript configuration.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*