Agent skill

Fix Upstream

by nateberkopec in nateberkopec/dotfiles

Reproduce, report, and work around bugs in upstream software managed by these dotfiles.

No licenceAuto-check passed

Install Fix Upstream

skills CLI
$ npx skills add nateberkopec/dotfiles --skill fix-upstream -a claude-code

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

GitHub CLI
$ gh skill install nateberkopec/dotfiles fix-upstream --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/nateberkopec/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/fix-upstream .claude/skills/fix-upstream && 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
fix-upstream
GitHub stars
147
Token cost
~998 tokens
SKILL.md length
533 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Reproduce, report, and work around bugs in upstream software managed by these dotfiles.

  • A managed dependency is broken
  • SKILL.md covers Goal and authority, Boundaries, Upstream report and Completion
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • An upstream fix is needed

What it does

Fix Upstream is an agent skill from nateberkopec/dotfiles. Reproduce, report, and work around bugs in upstream software managed by these dotfiles. Use when a managed dependency is broken, an upstream fix is needed, or dotfiles must temporarily use a patched fork.

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

The repository describes itself as: yup we're doin the thing.

When your agent uses it

  • A managed dependency is broken
  • An upstream fix is needed
  • Dotfiles must temporarily use a patched fork

Example prompts

  • “/fix-upstream”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Fix Upstream loads about 998 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 533 words of instructions outside code blocks.

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

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 533 words (~998 tokens).

“Restore reliable behavior in dotfiles when an upstream dependency is broken, and make returning to upstream straightforward. Use your judgment and initiative to carry the work through to completion within the boundaries below. Choose the implementation and sequence of work…”

— opening of SKILL.md by nateberkopec
name
fix-upstream

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/fix-upstream of nateberkopec/dotfiles.

Open the folder on GitHubat commit 6afb80d

Compare with similar skills

Fix Upstream 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.

Fix Upstream compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fix Upstream this skillnateberkopec/dotfiles147—~998Automated safety check: PassNone
Reproduce Bugudecode/plate17k—~2kAutomated safety check: NotesCustom licence
Bug ReproducePrismer-AI/PrismerCloud1.6k—~1.7kAutomated safety check: NotesMIT
Warp GUI Bug Reproductionwarpdotdev/warp65k1 repos~1.4kAutomated safety check: PassAGPL-3.0
Secrets Managementdavila7/claude-code-templates32k12 repos~2kAutomated safety check: PassMIT
Reproduce Frontend BugQoderAI/better-harness2.4k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Reproduce Bug

    udecode/plate

    Systematically reproduce and investigate a bug from a GitHub issue.

    17k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Bug Reproduce

    Prismer-AI/PrismerCloud

    Turn a known bug into a tight, red-capable reproducer, then prove the reproducer locks that bug with a reversal negative control (reintroduce the bug → reproducer must go red again).

    1.6k GitHub stars~1.7k tokensUpdated 9 days ago
    DevelopmentAuto-check: notes
  • Warp-specific guidance for reproducing bugs in the logged-out desktop GUI, using the reporter's exact version and channel instead of building from source.

    65k GitHub starsUsed in 1 repo~1.4k tokens
    Testing & QAAuto-check passed
  • Secrets Management

    davila7/claude-code-templates

    Secure secrets management practices for CI/CD pipelines using Vault, AWS Secrets Manager, and other tools.

    32k GitHub starsUsed in 12 repos~2k tokens
    DevOps & CloudAuto-check passed
  • Reproduce Frontend Bug

    QoderAI/better-harness

    Build a bounded, replayable browser or UI bug reproduction from GitHub Issues, Jira, Aone, user-provided exports, screenshots, videos, comments, or attachments.

    2.4k GitHub stars~1.3k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Project Manager

    RightNow-AI/openfang

    Project management expert for Agile, estimation, risk management, and stakeholder communication

    18k GitHub stars~960 tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed

More from nateberkopec/dotfiles

  • Dev Env Setup

    nateberkopec/dotfiles

    Set up or audit Nate's standard dev environment in a project directory.

    147 GitHub stars~671 tokensUpdated today
    Auto-check: notes
  • Deep Research

    nateberkopec/dotfiles

    Produce an in-depth, source-grounded research report. An agent skill from nateberkopec/dotfiles.

    147 GitHub stars~738 tokensUpdated today
    Auto-check passed
  • Handouts

    nateberkopec/dotfiles

    Compose and typeset polished PDFs for personal reading on paper.

    147 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Printing

    nateberkopec/dotfiles

    Print files or selected pages, check printer status, or troubleshoot printing problems.

    147 GitHub stars~434 tokensUpdated today
    Auto-check passed

Questions about Fix Upstream

What does Fix Upstream do?

Reproduce, report, and work around bugs in upstream software managed by these dotfiles. Fix Upstream is an agent skill from nateberkopec/dotfiles. Reproduce, report, and work around bugs in upstream software managed by these dotfiles.

When should I use Fix Upstream?

Fix Upstream fits situations like: A managed dependency is broken; an upstream fix is needed; dotfiles must temporarily use a patched fork.

How do I install Fix Upstream in Claude Code?

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

How do I install Fix Upstream in Codex?

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

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

What does Fix Upstream need to run?

SKILL.md names no scripts, command-line tools or credentials: Fix Upstream is instructions for the agent only.

Does Fix Upstream access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fix Upstream 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 Fix Upstream use?

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

How many tokens does Fix Upstream use?

About 998 tokens (SKILL.md is roughly 4k 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 Fix Upstream?

Skills that share tags, products or a category with Fix Upstream: Reproduce Bug (udecode/plate, 17k stars), Bug Reproduce (Prismer-AI/PrismerCloud, 1.6k stars), Warp GUI Bug Reproduction (warpdotdev/warp, 65k stars) and Secrets Management (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fix Upstream?

nateberkopec (a GitHub user) maintains it in nateberkopec/dotfiles, which has 147 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 9, 2026.

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