dx-toolchain

Lint, format, and diff Markdown system declarations with a Go-based CLI.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/dewitt/dx --skill dx-toolchain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dx-toolchain
Source: https://github.com/dewitt/dx/tree/main/skills/dx-toolchain
Command: npx skills add https://github.com/dewitt/dx --skill dx-toolchain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates ambiguity in software development by providing a deterministic toolchain to validate, format, and audit declarative Markdown specifications, ensuring that architectural decisions remain consistent across the entire development lifecycle.

Core Features & Use Cases

  • Structural Validation: Automatically enforces the schema rules for dx declarations, ensuring every spec is machine-readable and structurally sound.
  • Semantic Ledger: Generates a clear diff of architectural changes, allowing teams to track how assumptions are promoted to invariants over time.
  • Use Case: Use this toolchain in your CI pipeline to ensure that every pull request contains a valid, linted declaration before any code is generated or modified.

Quick Start

Run the dx lint command on your system specification file to verify that it adheres to all structural requirements.

Frequently Asked Questions about dx-toolchain

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

FAQPage Schema
How do I validate declarative software specifications in a CI pipeline?

You can lint Markdown-based system declarations by running a deterministic CLI command that performs AST-level operations, enforcing schema rules and ensuring structural integrity for machine readability.

What is a semantic ledger for architectural changes?

A semantic ledger is a generated diff that tracks architectural changes in declarative software specifications over time, allowing teams to monitor how architectural assumptions are promoted to invariants across the development lifecycle.

Do I need a Go-based toolchain to lint Markdown system declarations?

Yes, linting and formatting Markdown system declarations requires a Go-based toolchain to execute AST-level operations, validate structural requirements, and generate the semantic ledgers used for human and agent review.

Can I use this for semantic diffing of architectural decisions?

Yes, the CLI provides deterministic semantic diffing for declarative software specs, generating a clear ledger of architectural changes so teams can audit how assumptions evolve into invariants across development workflows.

What's the best way to enforce structural consistency in declarative Markdown specs?

The best way to enforce structural consistency in declarative Markdown specs is to use a deterministic CLI toolchain that automatically validates schema rules and audits architectural decisions to eliminate ambiguity throughout the development lifecycle.

Why does structural validation fail for declarative software specifications?

Structural validation fails for declarative software specifications when Markdown system declarations do not adhere to required schema rules, meaning the spec is not machine-readable and must be formatted and linted before proceeding.