Skip to content

feat: add background-task skill and worktree shell helpers#77

Merged
michaelfarrell76 merged 3 commits intomainfrom
michaelfarrell76/background-task-skill
Apr 9, 2026
Merged

feat: add background-task skill and worktree shell helpers#77
michaelfarrell76 merged 3 commits intomainfrom
michaelfarrell76/background-task-skill

Conversation

@michaelfarrell76
Copy link
Copy Markdown
Member

@michaelfarrell76 michaelfarrell76 commented Apr 9, 2026

This allows for running /background-task "description of change to make" -- and it will automatically create a new worktree and use worktree-* commands that can be auto-approved without worrying about them overwriting your current active branch not on a worktree

Summary

  • Adds a background-task skill (.cursor/skills/background-task/SKILL.md) that documents the full worktree workflow for making changes on other branches without affecting the user's working directory — adapted from the main repo's skill for pnpm, main branch, and the tools repo's hook-based function loading.
  • Adds three shell helper functions auto-loaded via the existing preToolUse hook:
    • worktree-git — safe git wrapper that only runs inside .worktrees/ directories
    • worktree-rm — safe rm wrapper that only operates on .worktrees/ paths (handles both full worktree removal and files within worktrees)
    • gempty-branches — re-triggers CI on branches via empty commits using temporary worktrees
  • Updates .cursor/rules/commit-and-push.mdc to document worktree commands alongside existing tools-git/tools-rm
  • Adds .worktrees to .gitignore

Made with Cursor

Add a background-task skill for parallel worktree workflows, along with
safe shell helper functions (worktree-git, worktree-rm, gempty-branches)
that are auto-loaded via the existing preToolUse hook. Update the
commit-and-push rule to document worktree commands and add .worktrees
to .gitignore.
@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new bot commented Apr 9, 2026

Open in StackBlitz

@transcend-io/cli

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/cli@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/cli@77.tgz

@transcend-io/privacy-types

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/privacy-types@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/privacy-types@77.tgz

@transcend-io/sdk

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/sdk@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/sdk@77.tgz

@transcend-io/utils

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/utils@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/utils@77.tgz

@transcend-io/mcp-server

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server@77.tgz

@transcend-io/mcp-server-admin

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-admin@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-admin@77.tgz

@transcend-io/mcp-server-assessments

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-assessments@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-assessments@77.tgz

@transcend-io/mcp-server-consent

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-consent@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-consent@77.tgz

@transcend-io/mcp-server-core

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-core@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-core@77.tgz

@transcend-io/mcp-server-discovery

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-discovery@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-discovery@77.tgz

@transcend-io/mcp-server-dsr

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-dsr@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-dsr@77.tgz

@transcend-io/mcp-server-inventory

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-inventory@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-inventory@77.tgz

@transcend-io/mcp-server-preferences

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-preferences@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-preferences@77.tgz

@transcend-io/mcp-server-workflows

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-workflows@77
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-workflows@77.tgz

commit: 902d9a1

Not needed for this repo. Remove the shell function and all references
from the skill and commit-and-push rule.
@michaelfarrell76 michaelfarrell76 requested a review from a team April 9, 2026 23:34
@michaelfarrell76 michaelfarrell76 added this pull request to the merge queue Apr 9, 2026
@michaelfarrell76 michaelfarrell76 removed this pull request from the merge queue due to a manual request Apr 9, 2026
@michaelfarrell76 michaelfarrell76 merged commit db5a4e7 into main Apr 9, 2026
4 checks passed
@michaelfarrell76 michaelfarrell76 deleted the michaelfarrell76/background-task-skill branch April 9, 2026 23:55
michaelfarrell76 added a commit that referenced this pull request Apr 10, 2026
* feat: add background-task skill and worktree shell helpers

Add a background-task skill for parallel worktree workflows, along with
safe shell helper functions (worktree-git, worktree-rm, gempty-branches)
that are auto-loaded via the existing preToolUse hook. Update the
commit-and-push rule to document worktree commands and add .worktrees
to .gitignore.

* chore: remove gempty-branches helper

Not needed for this repo. Remove the shell function and all references
from the skill and commit-and-push rule.

* style: format SKILL.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants