pr-chore
Skill5 starsChanged 44 days agoMITView on GitHub
User-invoked only. Raise a small no-ticket chore PR from a worktree without touching your feature branch
- Installs packages
- Commits and pushes
In this repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- assign-epicSkill
- briefingSkill
- bump-versionSkill
- captureSkill
- consultantSkill
- dependabot-reviewSkill
- fix-cicdSkill
- log-timeSkill
- morlockSkill
- morningSkill
- multi-repoSkill
- nightly-checkSkill
- pickupSkill
- pr-action-review-mine-loopSkill
- pr-action-reviewSkill
- pr-review-loopSkill
- prSkill
- pushSkill
- qa-review-actionSkill
- refineSkill
- runSkill
- syncSkill
- wrap-upSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 9 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 9
The current branch must not be touched: All work happens in a temporary git worktree so the active feature branch (and any other agent …
- Distinctive: line 38
Create any intermediate directories as needed.
- Distinctive: line 50
Only proceed to Step 4 once you have verified the files are present in the worktree.
- Distinctive: line 80
If any Step 1 file was already committed on the feature branch (not just an uncommitted edit), leave it and note this to the user — do not …
- Distinctive: line 82
Only ever touch the exact files from Step 1: Never run git restore ., git checkout ., or any blanket reset — the branch may hold unrelated …
- Very specific: line 88
Skip this step entirely: if every file in Step 1 is non-code (e.g.
- Very specific: line 90
Run the full suite: only when at least one Step 1 file is a source file (.ts, .tsx, .js, .jsx, .css, or anything compiled/tested):
- Distinctive: line 96
If it fails, fix the issues inside the worktree.
- Distinctive: line 100
Before committing, remove PROGRESS.md if it exists in the worktree — it must never be committed:
- Distinctive: line 149
If there are 🔴 Must fix findings: fix them in the worktree, push a follow-up commit, note as "Fixed prior to this comment."
- Distinctive: line 159
If any step fails, stop and explain.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Raise a PR for a specific set of files discussed in the current session — tooling fixes, skill updates, config changes. No Jira ticket required.
The current branch must not be touched. All work happens in a temporary git worktree so the active feature branch (and any other agent working on it) is completely unaffected.
No PROGRESS.md needed. Chore PRs are small and self-contained — do not create or update PROGRESS.md for them.
Step 1 — Identify the files
List the exact files to include in this PR. These come from the discussion — do not infer or add extra files. Confirm with the user if unsure.
Step 2 — Create a temporary worktree
From the repo root:
CHORE_BRANCH="chore/<short-description>"
git worktree add -b "$CHORE_BRANCH" /tmp/chore-pr origin/mainThis creates a new branch from main in a temporary directory with a full checkout. The current branch is never checked out or modified.
Step 3 — Copy the files into the worktree
For each file identified in Step 1, copy it from the current working tree into the worktree at the same relative path:
cp <file> /tmp/chore-pr/<file>Create any intermediate directories as needed.
Confirm the copy succeeded before doing anything else — every Step 1 file must be present in the worktree. git status is not sufficient: a copied file that happens to match origin/main exactly will not appear in status, so check each file's existence explicitly:
for f in <file1> <file2> ...; do
test -f "/tmp/chore-pr/$f" && echo "present: $f" || echo "MISSING: $f"
doneOptionally also run git -C /tmp/chore-pr status --short to see which copied files differ from main.
Only proceed to Step 4 once you have verified the files are present in the worktree. Do not restore the current branch until this is confirmed, or the work could be lost.
Step 4 — Restore the current branch immediately
Now that the files are safely in the worktree, restore the current branch so it returns to a clean state at once — do not wait until after verification. Only act on the files identified in Step 1.
Run every command in this step from the original working tree (the repo root on the currently checked-out branch) — not from /tmp/chore-pr. Restoring or deleting inside the worktree would undo the copy you just made.
First, from the Step 1 list, separate the files by git state (use git status --short):
- Tracked files with uncommitted modifications (staged, unstaged, or both) → restore from HEAD. Use
--staged --worktreeso both the index and the working tree are reset; a baregit restore <file>rewrites only the working tree from the index, leaving any staged modification in place and the branch not actually clean:
git restore --staged --worktree <modified-files>- Newly-created (untracked) files → delete them (
git restorewill not remove untracked files):
rm -f <new-files>Then confirm the current branch no longer shows any of the Step 1 files:
git status --shortThe only entries remaining should be pre-existing, unrelated changes belonging to the branch — leave those untouched.
If any Step 1 file was already committed on the feature branch (not just an uncommitted edit), leave it and note this to the user — do not rewrite history.
Only ever touch the exact files from Step 1. Never run git restore ., git checkout ., or any blanket reset — the branch may hold unrelated in-progress work from other agents.
Do not delete PROGRESS.md unless it is one of the Step 1 chore files. A PROGRESS.md on the branch normally belongs to the active feature session — leave it alone. (It is untracked and off main, so it never enters the chore worktree regardless.)
Step 5 — Run verification from the worktree
Skip this step entirely if every file in Step 1 is non-code (e.g. only .md, .yml, .json config, skill/command files, or other documentation). These changes cannot break TypeScript, lint, or tests — running the full suite wastes significant time and tokens for no benefit.
Run the full suite only when at least one Step 1 file is a source file (.ts, .tsx, .js, .jsx, .css, or anything compiled/tested):
cd /tmp/chore-pr && npm install && bash scripts/verify.shIf it fails, fix the issues inside the worktree. The original copies are already gone from the current branch (Step 4), so all fixes happen in the worktree — there are no original working-tree copies to edit. Re-run until it passes.
Step 6 — Commit and push from the worktree
Before committing, remove PROGRESS.md if it exists in the worktree — it must never be committed:
cd /tmp/chore-pr
rm -f PROGRESS.md
git add <files>
git commit -m "chore: <description>"
git push -u origin "$CHORE_BRANCH"Step 7 — Raise the PR
gh pr create \
--base main \
--head "$CHORE_BRANCH" \
--title "chore: <description>" \
--body "..."PR body should cover: what changed, why, and any risk/rollback notes.
Output the PR URL, then open it: gh pr view <number> --web.
Step 8 — Self-review
Fetch the diff: gh pr diff <number>
Review against: correctness, TypeScript strictness, security, conventions, docs sync. Classify findings: 🔴 Must fix | 🟡 Should fix | 🔵 Consider.
Post a comment via gh pr comment <number>:
## AI Pre-Review
Self-review completed.
### Findings
<list findings with classification emoji, file:line, one-sentence description>
_or_ ✅ No findings — all lenses clear.
### Summary
<1–2 sentence overall assessment>If there are 🔴 Must fix findings: fix them in the worktree, push a follow-up commit, note as "Fixed prior to this comment."
Step 9 — Clean up the worktree
git worktree remove --force /tmp/chore-pr--force is required on Windows — node_modules makes the directory non-empty, which causes a plain git worktree remove to fail.
If any step fails, stop and explain. Do not force or skip gates. Do not touch the current branch beyond Step 4's targeted restore.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

