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

dotfile-from-spec — Claude Code skill for DOT pipelines

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.

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

What dotfile-from-spec does

The skill reads a spec or design document, identifies build phases and dependencies, and determines the project’s tech stack. It asks where people should approve work and which models to use, then writes a DOT graph with instructions for each node. The file goes in the project root.

The graph can include parallel branches and joins, conditional routes, retry paths, and human approval gates. The skill also checks the graph against the spec and runs dotfile validate <file>.dot. Each node runs in isolation, so its prompt needs to carry its own context.

For Claude Code, installation adds the skill at ~/.claude/skills/dot-file-from-spec/SKILL.md. The included guidance calls for tests before implementation, running a linter and formatter, and commits in conventional commit format.

What it helps with

  • turn a project spec into a build pipeline graph
  • map dependencies between tasks in a DOT file
  • mark points that need human approval
  • validate a pipeline DOT file before use

Example prompts for the agent

  • Create a DOT build pipeline from this spec and save it in the project root.
  • Break this plan into phases, map task dependencies, and mark where I should approve the work.
  • Validate the graph with dotfile validate pipeline.dot and fix any errors.

How to install dotfile-from-spec

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/dot-file-from-spec/SKILL.md

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

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

Questions about dotfile-from-spec

How do I install dotfile-from-spec in Claude Code?

Run npx skills add harperreed/dotfiles --skill dot-file-from-spec -a claude-code. The skill file is at ~/.claude/skills/dot-file-from-spec/SKILL.md.

What does dotfile-from-spec do?

It turns a spec or project plan into a Graphviz DOT build pipeline, adds instructions to its nodes, and saves the graph in the project root.

How are human approval gates represented?

The skill asks where people should review the pipeline. A gate needs both the hexagon shape and the attribute type="wait.human".

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-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 dotfile-audit Inspects and repairs pipeline DOT files before execution. It spots missing retry routes, non-standard node parameters, and gaps against project specifications. 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