Agent skill

Dotfile From Spec

by harperreed in harperreed/dotfiles

A skill your agent uses when you have a spec, design doc, structured plan, or promptplan and need to generate a pipeline Graphviz DOT file for headless autonomous building.

No licenceAuto-check: notesDevelopment

Install Dotfile From Spec

skills CLI
$ npx skills add harperreed/dotfiles --skill dotfile-from-spec -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install harperreed/dotfiles dotfile-from-spec --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/harperreed/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills-archive/dot-file-from-spec .claude/skills/dotfile-from-spec && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dotfile-from-spec
GitHub stars
334
Token cost
~8.6k tokens
SKILL.md length
2,424 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when you have a spec, design doc, structured plan, or promptplan and need to generate a pipeline Graphviz DOT file for headless autonomous building.

  • Works in 8 steps: Scope Gating (First Phase) → Per-Phase Verification Gates → Graduated Escalation Path → …
  • You have a spec
  • SKILL.md covers Checklist, DOT Runtime Reference, Prompt Engineering Guide and Pipeline Topology Guide, plus 5 more sections
  • Calls uv and git

What it does

Dotfile From Spec is an agent skill from harperreed/dotfiles. Use when you have a spec, design doc, structured plan, or promptplan and need to generate a pipeline Graphviz DOT file for headless autonomous building. The agent reads the spec, extracts build pipeline phases, determines tech stack, asks about human gates and model preferences, generates a validated DOT digraph with rich self-contained prompts, and saves it to the project root. Handles any language or framework.

Its SKILL.md is about 8.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Architecture decision records and CI/CD. The repository describes itself as: Dotfiles. Managed by YADM.

When your agent uses it

  • You have a spec
  • Structured plan
  • Promptplan and need to generate a pipeline Graphviz DOT file for headless autonomous building

Example prompts

  • “/dotfile-from-spec”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Scope Gating (First Phase)
  2. Per-Phase Verification Gates
  3. Graduated Escalation Path
  4. Budget Tracking (Prevent Infinite Loops)
  5. Plan Format Validation
  6. Review Nodes Must Read Code
  7. Language-Aware Build Validation
  8. Resume Support

What it can do on your machine

Read from SKILL.md and the folder at commit b78c10e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dotfile From Spec loads about 8.6k tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 2,424 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~109
When it runs · the whole SKILL.md, loaded when a task matches
~8.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:365
    ted files, node_modules, __pycache__, or .env files.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 2,424 words (~8,647 tokens).

“Generate validated pipeline DOT files from structured specs and design docs. Every node prompt is packed with enough context for fully autonomous headless execution. Incorporates proven patterns from the dotpowers pipeline family.”

— opening of SKILL.md by harperreed
name
dotfile-from-spec

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills-archive/dot-file-from-spec of harperreed/dotfiles.

Open the folder on GitHubat commit b78c10e

Compare with similar skills

Dotfile From Spec next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dotfile From Spec compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dotfile From Spec this skillharperreed/dotfiles334—~8.6kAutomated safety check: NotesNone
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0
Babysit PR To Pass CIsgl-project/sglang37k2 repos~3kAutomated safety check: PassApache-2.0
Worktrunk Tend CI Guidancemax-sixty/worktrunk9.1k—~6.4kAutomated safety check: PassCustom licence
Worktrunk Release Workflowmax-sixty/worktrunk9.1k—~6.9kAutomated safety check: PassCustom licence

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Babysit PR To Pass CI

    sgl-project/sglang

    Start and persistently pursue a goal to babysit an SGLang pull request until selected GitHub Actions workflows pass on the latest PR head.

    37k GitHub starsUsed in 2 repos~3k tokens
    DevelopmentAuto-check passed
  • Worktrunk Tend CI Guidance

    max-sixty/worktrunk

    Adds Worktrunk-specific rules to the tend CI workflows: Codecov polling, Rust test commands, labels and review criteria for pull requests handled in CI.

    9.1k GitHub stars~6.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Worktrunk Release Workflow

    max-sixty/worktrunk

    Walks a maintainer through cutting a Worktrunk release: sync the release branch, pass two test gates, review the changes, then publish.

    9.1k GitHub stars~6.9k tokensUpdated today
    DevelopmentAuto-check passed
  • werf conventions for branch names and commit messages. An agent skill from werf/werf.

    4.7k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from harperreed/dotfiles

All 32 skills in this repo
  • Swiftui Liquid Glass

    harperreed/dotfiles

    Implement, review, or improve SwiftUI features using the iOS 26+ Liquid Glass API.

    334 GitHub starsUsed in 8 repos~941 tokens
    Auto-check passed
  • Swiftui Performance Audit

    harperreed/dotfiles

    Audit and improve SwiftUI runtime performance from code review and architecture.

    334 GitHub starsUsed in 8 repos~1.4k tokens
    Auto-check passed
  • Skill Creator

    harperreed/dotfiles

    Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.

    334 GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed
  • Swiftui View Refactor

    harperreed/dotfiles

    Refactor and review SwiftUI view files for consistent structure, dependency injection, and Observation usage.

    334 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • App Store Changelog

    harperreed/dotfiles

    Create user-facing App Store release notes by collecting and summarizing all user-impacting changes since the last git tag (or a specified ref).

    334 GitHub starsUsed in 4 repos~465 tokens
    Auto-check passed
  • Nothing Design

    harperreed/dotfiles

    This skill should be used when the user explicitly says "Nothing style", "Nothing design", "/nothing-design", or directly asks to use/apply the Nothing design system.

    334 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed

Questions about Dotfile From Spec

What does Dotfile From Spec do?

A skill your agent uses when you have a spec, design doc, structured plan, or promptplan and need to generate a pipeline Graphviz DOT file for headless autonomous building. Dotfile From Spec is an agent skill from harperreed/dotfiles. Use when you have a spec, design doc, structured plan, or promptplan and need to generate a pipeline Graphviz DOT file for headless autonomous building.

When should I use Dotfile From Spec?

Dotfile From Spec fits situations like: you have a spec; structured plan; promptplan and need to generate a pipeline Graphviz DOT file for headless autonomous building.

How do I install Dotfile From Spec in Claude Code?

Run `npx skills add harperreed/dotfiles --skill dotfile-from-spec -a claude-code`. Or copy the skill folder (.claude/skills-archive/dot-file-from-spec in harperreed/dotfiles) into .claude/skills/dotfile-from-spec in your project. Claude Code loads it when a task matches its description.

How do I install Dotfile From Spec in Codex?

Run `npx skills add harperreed/dotfiles --skill dotfile-from-spec -a codex`. Or copy the skill folder (.claude/skills-archive/dot-file-from-spec in harperreed/dotfiles) into .agents/skills/dotfile-from-spec in your project. Codex loads it when a task matches its description.

Can I use Dotfile From Spec in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add harperreed/dotfiles --skill dotfile-from-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dotfile-from-spec, .gemini/skills/dotfile-from-spec, .github/skills/dotfile-from-spec and .opencode/skills/dotfile-from-spec in your project.

What does Dotfile From Spec need to run?

Going by SKILL.md and its folder, Dotfile From Spec needs the command-line tools its instructions call (uv and git).

Does Dotfile From Spec access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Dotfile From Spec safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Dotfile From Spec use?

No licence was found for Dotfile From Spec or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Dotfile From Spec use?

About 8.6k tokens (SKILL.md is roughly 35k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dotfile From Spec?

Skills that share tags, products or a category with Dotfile From Spec: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Mole CLI Release Flow (tw93/Mole, 70k stars), Babysit PR To Pass CI (sgl-project/sglang, 37k stars) and Worktrunk Tend CI Guidance (max-sixty/worktrunk, 9.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dotfile From Spec?

harperreed (a GitHub user) maintains it in harperreed/dotfiles, which has 334 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 3, 2026.

Source: harperreed/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.