Agent skill

Dotfiles Operations

by wcygan in wcygan/dotfiles

Operate, maintain, upgrade, troubleshoot, and review this dotfiles repository.

No licenceAuto-check passedDevOps & Cloud

Install Dotfiles Operations

skills CLI
$ npx skills add wcygan/dotfiles --skill dotfiles-operations -a claude-code

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

GitHub CLI
$ gh skill install wcygan/dotfiles dotfiles-operations --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/wcygan/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/dotfiles-operations .claude/skills/dotfiles-operations && 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
dotfiles-operations
GitHub stars
196
Token cost
~1.4k tokens
SKILL.md length
634 words
Files
4 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
None found

At a glance

Operate, maintain, upgrade, troubleshoot, and review this dotfiles repository.

  • Works in 6 steps: Read the nearest AGENTS.md and inspect… → Read references/architecture.md for… → Read the relevant section of → …
  • Architecture questions
  • SKILL.md covers Outcome, Start Here, Operating Rules and Request Routing, plus 2 more sections
  • Calls git and nix

What it does

Dotfiles Operations is an agent skill from wcygan/dotfiles. Operate, maintain, upgrade, troubleshoot, and review this dotfiles repository. Use for architecture questions, installation and verification, interrupted setup recovery, Nix/profile maintenance, managed links, Rust pins, CI workflows, Docker or macOS acceptance, documentation operations, and repository-wide setup changes.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/architecture.md`, `references/migrations.md` and `references/operations.md`).

It sits in DevOps & Cloud. It works with Docker, Rust and macOS. The repository describes itself as: Configuration for Development Environments.

When your agent uses it

  • Architecture questions
  • Installation and verification
  • Interrupted setup recovery
  • Nix/profile maintenance

Example prompts

  • “/dotfiles-operations”

Requirements

  • Docker

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Read the nearest AGENTS.md and inspect git status --short.
  2. Read references/architecture.md for component
  3. Read the relevant section of
  4. Read references/migrations.md before changing a
  5. For reusable-skill source, pin, installation, verification, collision, or
  6. Recheck current repository files and live state. The references describe the

What it can do on your machine

Read from SKILL.md and the folder at commit b385ffa. 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:

    • git
    • nix

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Dotfiles Operations loads about 1.4k tokens when it runs, and up to ~7.2k if it reads all its reference files. Until then it costs about 86 tokens; SKILL.md has 634 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.2k

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 passed

The automated check found no risky patterns in SKILL.md.

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 634 words (~1,436 tokens).

“Keep this repository's Nix-backed setup path reproducible, recoverable, and portable while preserving the repo-driven configuration model.”

— opening of SKILL.md by wcygan
name
dotfiles-operations

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in .agents/skills/dotfiles-operations of wcygan/dotfiles.

  • SKILL.md
  • references/architecture.md
  • references/migrations.md
  • references/operations.md

Open the folder on GitHubat commit b385ffa

Compare with similar skills

Dotfiles Operations 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.

Dotfiles Operations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dotfiles Operations this skillwcygan/dotfiles196—~1.4kAutomated safety check: PassNone
Vuiovuiodev/vuio172—~1.3kAutomated safety check: PassApache-2.0
Frb Dev Envfzyzcjy/flutter_rust_bridge5.4k—~5.5kAutomated safety check: PassMIT
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0
GitHub Actions CreatorFNOSP/FlyNarwhal4961 repos~2.4kAutomated safety check: PassAGPL-3.0
.NET Crash Dump Collectiondotnet/skills5.6k2 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Vuio

    vuiodev/vuio

    Browse, search and cast a VuIO media library, build playlists, and control DLNA, Chromecast and AirPlay devices on the local network.

    172 GitHub stars~1.3k tokensUpdated 15 days ago
    DevOps & CloudAuto-check passed
  • Frb Dev Env

    fzyzcjy/flutter_rust_bridge

    A skill your agent uses when the user wants Docker-based FRB development or Tart-based iOS Simulator validation.

    5.4k GitHub stars~5.5k tokensUpdated yesterday
    MobileAuto-check passed
  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • GitHub Actions Creator

    FNOSP/FlyNarwhal

    A skill your agent uses when the user wants to create, generate, or set up a GitHub Actions workflow.

    496 GitHub starsUsed in 1 repo~2.4k tokens
    DevOps & CloudAuto-check passed
  • Official

    Configures automatic crash dumps or captures dumps from running processes for modern .NET apps on Linux, macOS and Windows, including Docker and Kubernetes.

    5.6k GitHub starsUsed in 2 repos~1.1k tokens
    DevOps & CloudAuto-check passed
  • Fungi

    enbop/fungi

    Install, configure, and operate the Fungi CLI across devices.

    132 GitHub stars~2.9k tokensUpdated 5 days ago
    DevOps & CloudAuto-check passed

More from wcygan/dotfiles

All 19 skills in this repo
  • Fish Shell Config

    wcygan/dotfiles

    Expert Fish shell configuration including config files, functions, abbreviations, prompts, environment variables, and scripting.

    196 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Lazygit Config

    wcygan/dotfiles

    Configure lazygit TUI including config.yml setup, custom pagers (especially delta integration), themes, keybindings, and custom commands.

    196 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Nix Manager

    wcygan/dotfiles

    Manage Nix package, profile, flake, and diagnostic work in this dotfiles repository.

    196 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Nvim Config

    wcygan/dotfiles

    Configure Neovim editor with init.lua, plugin management, LSP setup, keymaps, and options.

    196 GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Starship Config

    wcygan/dotfiles

    Configure and optimize Starship cross-shell prompt with presets, custom modules, and performance tuning.

    196 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Prime Agent

    wcygan/dotfiles

    A skill your agent uses when learning, configuring, or troubleshooting Prime Agent (PrimeIntellect-ai/prime-agent), including installation, providers, custom OpenAI-compatible models, local…

    196 GitHub stars~1.8k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Dotfiles Operations

What does Dotfiles Operations do?

Operate, maintain, upgrade, troubleshoot, and review this dotfiles repository. Dotfiles Operations is an agent skill from wcygan/dotfiles. Operate, maintain, upgrade, troubleshoot, and review this dotfiles repository.

When should I use Dotfiles Operations?

Dotfiles Operations fits situations like: architecture questions; installation and verification; interrupted setup recovery; nix/profile maintenance.

How do I install Dotfiles Operations in Claude Code?

Run `npx skills add wcygan/dotfiles --skill dotfiles-operations -a claude-code`. Or copy the skill folder (.agents/skills/dotfiles-operations in wcygan/dotfiles) into .claude/skills/dotfiles-operations in your project. Claude Code loads it when a task matches its description.

How do I install Dotfiles Operations in Codex?

Run `npx skills add wcygan/dotfiles --skill dotfiles-operations -a codex`. Or copy the skill folder (.agents/skills/dotfiles-operations in wcygan/dotfiles) into .agents/skills/dotfiles-operations in your project. Codex loads it when a task matches its description.

Can I use Dotfiles Operations 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 wcygan/dotfiles --skill dotfiles-operations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dotfiles-operations, .gemini/skills/dotfiles-operations, .github/skills/dotfiles-operations and .opencode/skills/dotfiles-operations in your project.

What does Dotfiles Operations need to run?

Going by SKILL.md and its folder, Dotfiles Operations needs the command-line tools its instructions call (git and nix). Our summary lists: Docker.

Does Dotfiles Operations access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Dotfiles Operations safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dotfiles Operations use?

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

How many tokens does Dotfiles Operations use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.8k tokens, read only when the agent opens those files.

What are the alternatives to Dotfiles Operations?

Skills that share tags, products or a category with Dotfiles Operations: Vuio (vuiodev/vuio, 172 stars), Frb Dev Env (fzyzcjy/flutter_rust_bridge, 5.4k stars), GreptimeDB Dev Docker Image (GreptimeTeam/greptimedb, 6.7k stars) and GitHub Actions Creator (FNOSP/FlyNarwhal, 496 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dotfiles Operations?

wcygan (a GitHub user) maintains it in wcygan/dotfiles, which has 196 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

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