Skip to main content
affpapa.org
RU EN
skill CX Codex

dotfile-audit — Claude Code skill: what it does, how to install

Inspects and repairs pipeline DOT files before execution. It spots missing retry routes, non-standard node parameters, and gaps against project specifications.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add harperreed/dotfiles --skill dot-file-audit -a claude-code
Open on GitHub

What dotfile-audit does

This skill inspects DOT files used by automated coding pipelines. It examines the core graph topology, checking for single start nodes with shape=Mdiamond and single exit nodes with shape=Msquare. Graph blocks receive checks for required settings such as goal or retry_target. If the graph includes invented keys like join_policy or error_policy, the skill strips them out. Unsupported attributes break the parser.

When provided with a design document, the skill reconciles pipeline stages against written requirements. It confirms that every listed component contains implementation, testing, and Git commit steps. Once edits finish, it runs dotfile validate <file>.dot in a loop. Pipelines with validation errors will not execute. The process repeats until the checker reports zero warnings.

What it helps with

  • fix structural errors and missing exits in pipeline DOT graphs
  • attach failure handling paths to code generation steps
  • verify that pipeline phases cover the project requirements document
  • clear all warnings from dotfile validate

Example prompts for the agent

  • Audit pipeline.dot and correct any syntax or structural mistakes
  • Reconcile workflow.dot against spec.md to verify every component has tests
  • Inspect build.dot and supply missing retry targets for failing nodes

How to install dotfile-audit

1Skills CLI (Vercel)

npx skills add harperreed/dotfiles --skill dot-file-audit -a claude-code

2Manually: put the files in place

~/.claude/skills/dot-file-audit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/dot-file-audit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about dotfile-audit

How do I install dotfile-audit in Claude Code?

Run npx skills add harperreed/dotfiles --skill dot-file-audit -a claude-code. The skill file is placed in ~/.claude/skills/dot-file-audit/SKILL.md.

What does dotfile-audit do?

It reviews pipeline DOT graphs before they run, catching broken logic and unhandled failure branches. It also ensures that all components defined in design documents are reflected in the pipeline steps.

Why does the skill remove invented node attributes?

Custom properties such as join_policy or max_parallel are not supported by the pipeline execution engine. The audit removes invalid attributes so the graph conforms to the engine specification.

Similar skills

All skills for Agent setup: memory, context, orchestration →
setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set26

marketing-audit Diagnoses product messaging, offers, funnels, and content across five sequential stages. Helps find drop-offs and builds a 30-day task list. CX Codex +1 ★ 336repo stars granola-to-obsidian Moves Granola meetings into an Obsidian vault while following the vault’s note format. Use it to add notes for a chosen date range. CX Codex +1 ★ 336repo stars fleet-manager A skill that reads every claude-code pane in tmux, labels what each agent is doing, and sends replies or new instructions back into the pane. CX Codex +1 ★ 336repo stars dotfile-hone Refines pipeline DOT files against original specs to fix graph bottlenecks and prevent prompt information loss. Useful right after structural validation. CX Codex +1 ★ 336repo stars dotfile-from-spec Turn a project spec or plan into a validated Graphviz pipeline for autonomous builds. The skill is useful when you want development phases and dependencies captured as a graph. CX Codex +1 ★ 336repo stars dotfile-brainstorm Turns a vague project idea into a design doc with a Pipeline Configuration section. The doc then feeds dotfile-from-spec, which produces the pipeline DOT file. CX Codex +1 ★ 336repo stars content-creator-launchpad Plan a content brand from niche research through early publishing materials, with platform-specific guidance for formats such as YouTube, newsletters, and blogs. CX Codex +1 ★ 336repo stars agent-business-canvas Walks an AI agent product through seven dimensions of its business model and returns a structured canvas. Built for founders and investors. CX Codex +1 ★ 336repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor