dotfile-audit

Audit and repair DOT pipeline files until validation returns zero errors and warnings.

330|47|Updated Aug 30, 2020
One-click install
npx skills add https://github.com/harperreed/dotfiles --skill dotfile-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotfile-audit
Source: https://github.com/harperreed/dotfiles/tree/main/.claude/skills-archive/dot-file-audit
Command: npx skills add https://github.com/harperreed/dotfiles --skill dotfile-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you review and repair existing pipeline DOT files so they are structurally correct, fully cover the intended spec, and pass validation with no warnings before you run anything.

Core Features & Use Cases

  • Structural DOT audit: Checks required graph attributes, start/exit node counts, failure-path completeness, human-gate configuration, diamond edge conditions, and parallel fan-out/fan-in synchronization.
  • Spec reconciliation: Cross-references a design or spec document (when present) to confirm phases, components (implement + test/verify + commit), tech stack references, quality gates, testing frameworks, models/styles, and requested gates match expectations.
  • Validation-driven fixes: Runs dotfile validate <file>.dot, fixes all reported errors and warnings, and re-validates until the pipeline is clean.

Quick Start

Use this skill to audit and repair a pipeline DOT file so that dotfile validate <file>.dot returns zero errors and zero warnings.

Frequently Asked Questions about dotfile-audit

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

FAQPage Schema
How do I fix DOT pipeline validation warnings and errors?

To fix DOT pipeline validation warnings, audit the graph structure for required attributes, complete failure paths, and correct human-gate wiring. Run validation iteratively, applying fixes to edges and parallel fan-out/fan-in synchronization until zero warnings remain.

What does a structural DOT graph audit check for?

A structural DOT graph audit checks required graph attributes, start and exit node counts, failure-path completeness, human-gate configuration, diamond edge conditions, and parallel fan-out/fan-in synchronization to ensure clean validation output.

How do I reconcile a spec document with a DOT pipeline file?

To reconcile a spec with a DOT pipeline, cross-reference the design document to confirm phases, implement and test components, tech stack references, quality gates, testing frameworks, and requested human gates match the expected pipeline structure.

Can I validate hand-written DOT pipeline files for execution readiness?

Yes, you can validate hand-written DOT pipeline files for execution readiness by checking full spec coverage, confirming correct edge conditions, and running repeated validation checks until the graph reports zero errors and zero warnings.

Why does my CI linting fail on third-party generated DOT files?

CI linting fails on third-party DOT files due to missing graph attributes, incomplete failure paths, or incorrect parallel fan-out/fan-in synchronization, requiring a structural audit and repeated validation runs to achieve clean output.