docs: add portable LLM workflow skill

skills/llm-project-workflow/templates/merge-pr.md

@@ -0,0 +1,43 @@
+# Merge PR Prompt
+
+You are the merge operator for PR `<pr-number>` in `<repo-name>`.
+
+Hard gate:
+
+- Verify authenticated identity before reviewing or merging.
+- Verify PR author.
+- If authenticated user matches the PR author, stop immediately.
+- Merge only if assigned merge duty and reviewer-eligible.
+
+Workflow:
+
+1. Confirm PR `<pr-number>` is open and targets `<default-branch>`.
+2. Confirm the PR head is still `<reviewed-commit>` or includes it.
+3. Confirm changed files still match the reviewed file list.
+4. Confirm previous validation still applies or rerun required checks.
+5. Merge through the gated project merge workflow.
+6. Confirm remote `<default-branch>` contains the merge.
+7. Close or release linked issue `<issue-number>` according to project policy.
+8. Remove `status:in-progress` if applicable.
+9. Delete the merged remote branch if policy allows.
+10. Remove local PR branch and branch worktree only after merge is confirmed.
+11. Fetch/prune.
+12. Confirm main checkout is clean/current.
+
+Stop if:
+
+- authenticated user is the PR author
+- PR head changed after review
+- PR is closed but not merged
+- tests/checks fail
+- cleanup would delete unmerged work
+
+Report:
+
+- authenticated user
+- PR author
+- eligibility result
+- merge commit/hash
+- issue final state
+- branch/worktree cleanup result
+- final PR URL

skills/llm-project-workflow/templates/recover-dirty-worktree.md

@@ -0,0 +1,31 @@
+# Recover Dirty Worktree Prompt
+
+You are recovering repository state in `<repo-name>`.
+
+Rules:
+
+- Do not reset, delete, clean, or overwrite work unless explicitly instructed.
+- Do not edit another issue's worktree unless assigned to that issue.
+- Preserve ambiguous work before any destructive operation.
+
+Workflow:
+
+1. Run `git status --short --branch`.
+2. Identify whether dirty files belong to the current issue, another issue, or
+   unknown work.
+3. If dirty work belongs to another issue, leave it alone and use a separate
+   worktree for the current task.
+4. If an unauthorized untracked file was created, stop and report its exact path.
+5. Remove unauthorized files only when explicitly instructed.
+6. If local `<default-branch>` is ahead of `<remote>/<default-branch>`, stop and
+   report both commit hashes.
+7. If cleanup is requested, verify the branch is merged or explicitly abandoned
+   before deleting any branch or worktree.
+
+Report:
+
+- current branch
+- dirty files
+- ownership assessment
+- actions taken
+- remaining blockers

skills/llm-project-workflow/templates/review-pr.md

@@ -0,0 +1,34 @@
+# Review PR Prompt
+
+You are independently reviewing PR `<pr-number>` in `<repo-name>`.
+
+Hard gate:
+
+- Verify authenticated identity.
+- Verify PR author.
+- If authenticated user matches the PR author, stop immediately.
+- Do not approve or merge unless reviewer-eligible.
+
+Workflow:
+
+1. Create or use a separate review worktree.
+2. Fetch/prune.
+3. Confirm PR `<pr-number>` is open and targets `<default-branch>`.
+4. Confirm the PR head is `<expected-commit>` or includes it.
+5. Confirm changed files match the issue scope.
+6. Inspect the diff for correctness, secrets, unrelated behavior, and forbidden
+   changes.
+7. Run `<required-checks>`.
+8. If anything fails, leave exact blockers and do not approve.
+9. If everything passes, approve only if reviewer-eligible.
+
+Report:
+
+- authenticated user
+- PR author
+- eligibility result
+- commit reviewed
+- files changed
+- checks run and results
+- blockers or risks
+- final PR URL

skills/llm-project-workflow/templates/start-issue.md

@@ -0,0 +1,34 @@
+# Start Issue Prompt
+
+You are implementing issue `<issue-number>` in `<repo-name>`.
+
+Rules:
+
+- No repository changes unless the issue exists and is claimed.
+- Use an isolated branch worktree under `branches/`.
+- Branch from latest `<remote>/<default-branch>`.
+- Keep the change limited to issue `<issue-number>`.
+- Do not self-review or self-merge.
+
+Workflow:
+
+1. Verify the issue exists and is open.
+2. Claim it with the project in-progress label.
+3. Fetch/prune and confirm local `<default-branch>` matches
+   `<remote>/<default-branch>`.
+4. Create branch `<branch-name>` in `branches/<safe-folder-name>`.
+5. Implement only the scoped change.
+6. Run `<required-checks>`.
+7. Inspect for secrets and unrelated files.
+8. Commit, push, and open a PR.
+9. Stop before review or merge.
+
+Final handoff:
+
+- issue number/title
+- branch name
+- isolated worktree path
+- files changed
+- checks run and results
+- PR URL
+- reviewer/merge instructions