Fix Windows skill path, align docs, add CHANGELOG/CONTRIBUTING, v0.2.0#13
Merged
Conversation
- SKILL.md helper commands now resolve the venv Python on Windows (.venv/Scripts/python.exe) before falling back to python3/python; the previous POSIX-only path plus python3 fallback made the compile step fail on a plain Windows install. - allowed-tools aligned to 'Read, Write, Bash' in both SKILL.md and the slash command (three files previously declared three different scopes; all documented commands are bash-syntax and Git Bash ships with the required Git install). - SKILL.md flow-preview stop line now shows the token budget the real renderer emits; register-model example uses the quoted-invoke form. - README: complete emitted-file list, generic Windows paths instead of a personal username, and a new footprint + uninstall section documenting ~/.looper/models.json (previously written to the home directory without any mention in the docs). - agents/openai.yaml gets a header explaining what it is and that the Claude Code path never reads it. - Add CHANGELOG.md (0.1.0 history + 0.2.0 notes) and CONTRIBUTING.md (dev setup, safety invariants, spec-change rules); bump version to 0.2.0. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Verified on a real Windows install: 'python3' on PATH resolved to the Microsoft Store alias stub, which Get-Command/command -v find but which cannot run scripts (exit 49). The SKILL.md helper resolution and install.ps1 now execute '-c ""' on each candidate before accepting it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Remediation batch 3 of 3 from the 2026-07-04 audit — docs, packaging, and project hygiene.
Windows first-run fix
SKILL.md's helper commands hardcoded
${CLAUDE_SKILL_DIR}/.venv/bin/pythonwith apython3fallback.install.ps1creates the venv at.venv\Scripts\python.exe, and Windows has nopython3on PATH by default — so the compile step of a fresh Windows install fell through to a command that doesn't exist. Commands now resolvebin/python→Scripts/python.exe→python3→python, documented once in a new Helper Python section.Consistency
allowed-toolswas three different scopes across SKILL.md (Write Bash), commands/looper.md (Read, Write, Bash, PowerShell), and the spec. NowRead, Write, Bashin both shipped files.C:\Users\<you>\…instead of a personal username.agents/openai.yaml(flagged as orphaned in the audit) now carries a header explaining its purpose; the Claude Code path never reads it.Transparency & community
~/.looper/models.json, which was previously written with no mention anywhere in the docs — plus an Uninstall section for both platforms.CHANGELOG.md(0.1.0 history + 0.2.0 release notes) andCONTRIBUTING.md(dev setup, the scaffolder-not-orchestrator boundary, spec-change rules, safety invariants).🤖 Generated with Claude Code