Skip to content
SkillMixed3,331 tokens in use

Windows Agent Shell

The Windows traps that break coding agents: Git Bash path rewriting, PowerShell quoting and encoding, CRLF, with a probe and a text checker.

680 stars on the repository MIT Licensephuryn/product-engineering · agent-harness/skills/windows-agent-shell
npx skills add phuryn/product-engineering
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Windows Agent Shell costs

39tokens idle
3,331tokens in use
6,572tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/check_text.py, scripts/probe_argv.py.

Touches

shelldetectednetworkdetectedwrites filesdetectedgitdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure19/25
  • Examples6/15
  • Output15/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/check_text.py, line 101
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/check_text.py, line 121

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity100
  • Maintenance100
  • Community44
  • Maturity4
  • Momentum40

Windows Agent Shell is for a coding agent on Windows when output comes back garbled or something works on one machine and breaks on another. It records how Git Bash, PowerShell and cmd each split arguments, convert paths and decode text, with the version and date of every observation.

It ships two Python scripts: one prints what a program really received, the other flags mojibake, BOMs, CRLF and invalid UTF-8 in files.

What You Get

  • Rules for slashes, drive letters and Git Bash rewriting of leading-slash arguments
  • PowerShell traps: split flags, empty environment variables, native stderr and Get-Content encoding damage
  • probe_argv.py, which prints the arguments, working directory and pipe encodings a program received
  • check_text.py, which flags mojibake, BOM, CRLF and invalid UTF-8 and can fix CRLF
  • A troubleshooting file with dated auto-mode workarounds

Common Use Cases

  • gh api calls that fail because Git Bash rewrote a leading slash
  • Accented or dash characters turning into garbage after a PowerShell edit
  • Tests that fail on Windows because of CRLF or a lowercase drive letter
  • Stopping a Windows background server by its process id or port

What Makes It Unique

The skill is built on measured behaviour. Each trap names the shell, the tool version and the date it was observed, and the agent probes the same arguments in the same shell to see what happened. It also covers the class where a third-party CLI differs on the target machine, such as branching on exit codes and encoding the older contract in test fakes.

Under The Hood

The skill is instructions, a troubleshooting reference and two standard-library Python scripts. The agent runs them in the shell: one only prints what it received, the other reads files and, with a fix flag, rewrites line endings in the files you name. The advice tells the agent to write commit and issue text to a file and pass it by path, to run long PowerShell scripts from the Bash tool, and to stop servers by process id or port. It does not fetch web pages.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers