How do I install the Approve skill?

Run npx skillmds@latest add tomevault-io/approve in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Approve safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Approve?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Approve free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Approve?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Approve by tomevault-io — Agent Skill

Name: Approve
Author: tomevault-io

File contents

/approve

Approve a review-status issue after IDE review. Merges the branch, removes the worktree, and marks the card done.

CLI only (no direct viban.json access)

Input: $ARGUMENTS (required: issue ID)

Output Rules

Do NOT output any preamble.
Start executing Step 1 immediately.

Step 1: Validate

viban get $ID

Confirm the issue is in review status. If not, tell the user and exit.

BRANCH="issue-$ID"
WT_DIR="$PWD/.viban/worktrees/$ID"

Step 2: Return to Main

Detached HEAD from /viban:review — branch is intact, just switch back:

git checkout main

Step 3: Merge

If PR exists

PR_NUM=$(gh pr list --head "$BRANCH" --json number --jq '.[0].number' 2>/dev/null)

If PR found:

gh pr merge "$PR_NUM" --squash --delete-branch
git pull origin main

If no PR (branch only)

git merge "$BRANCH" --no-ff -m "Merge issue-$ID: <title>"
git branch -d "$BRANCH"

If merge conflicts: help user resolve.

If no branch (main-direct work)

Nothing to merge. Proceed to Step 4.

Step 4: Cleanup Worktree

[ -d "$WT_DIR" ] && git worktree remove "$WT_DIR" --force 2>/dev/null

Step 5: Complete

viban done $ID

Step 6: Restore User State

Check for stash:

STASH=$(git stash list | grep "viban-review: before #$ID" | head -1 | cut -d: -f1)
[ -n "$STASH" ] && git stash pop "$STASH"

Check for temp commit:

TEMP=$(git log --oneline -1 | grep "viban-review: temp commit before #$ID")
[ -n "$TEMP" ] && git reset HEAD~1

Report: "Issue #$ID approved and merged."

CLI Reference

Command	Description
`viban get <id>`	View issue details
`viban done <id>`	Mark issue as done

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: approvedescription: Approve a reviewed issue — merge branch, cleanup worktree, mark done Use when this capability is needed.---# /approveApprove a review-status issue after IDE review. Merges the branch, removes the worktree, and marks the card done.> **CLI only** (no direct viban.json access)**Input**: `$ARGUMENTS` (required: issue ID)---## Output Rules- **Do NOT output any preamble.**- Start executing Step 1 immediately.---## Step 1: Validate```bashviban get $ID```Confirm the issue is in `review` status. If not, tell the user and exit.```bashBRANCH="issue-$ID"WT_DIR="$PWD/.viban/worktrees/$ID"```---## Step 2: Return to MainDetached HEAD from `/viban:review` — branch is intact, just switch back:```bashgit checkout main```---## Step 3: Merge### If PR exists```bashPR_NUM=$(gh pr list --head "$BRANCH" --json number --jq '.[0].number' 2>/dev/null)```If PR found:```bashgh pr merge "$PR_NUM" --squash --delete-branchgit pull origin main```### If no PR (branch only)```bashgit merge "$BRANCH" --no-ff -m "Merge issue-$ID: <title>"git branch -d "$BRANCH"```If merge conflicts: help user resolve.### If no branch (main-direct work)Nothing to merge. Proceed to Step 4.---## Step 4: Cleanup Worktree```bash[ -d "$WT_DIR" ] && git worktree remove "$WT_DIR" --force 2>/dev/null```---## Step 5: Complete```bashviban done $ID```---## Step 6: Restore User StateCheck for stash:```bashSTASH=$(git stash list | grep "viban-review: before #$ID" | head -1 | cut -d: -f1)[ -n "$STASH" ] && git stash pop "$STASH"```Check for temp commit:```bashTEMP=$(git log --oneline -1 | grep "viban-review: temp commit before #$ID")[ -n "$TEMP" ] && git reset HEAD~1```Report: "Issue #$ID approved and merged."## CLI Reference| Command | Description ||---------|-------------|| `viban get <id>` | View issue details || `viban done <id>` | Mark issue as done |---> Converted and distributed by [TomeVault](https://tomevault.io/claim/happy-nut) — claim your Tome and manage your conversions.

Frequently asked questions

Approve