vp-k/flutter-craft/flutter-finishing

Name: flutter-finishing
Author: vp-k

Trust tier 3

community

Source check pending

Checking that the SKILL.md file is still in the repository.

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of Flutter development work by presenting structured options

Install

npx vskill@latest install vp-k/flutter-craft/flutter-finishing

SKILL.md

Finishing a Flutter Development Branch

Overview

Guide completion of Flutter development work by presenting clear options and handling chosen workflow.

Core principle: Verify tests → Present options → Execute choice → Clean up

Announce at start: "I'm using the flutter-finishing skill to complete this work."

The Process

Step 1: Verify Tests and Analysis

Before presenting options, verify everything passes:

bash

# Static analysis
flutter analyze
# Expected: No issues found!
 
# All tests
flutter test
# Expected: All tests passed!
 
# Build check — required once here, against the project's target platform
# (apk / ios / web / windows / macos / linux). Skip only if the platform
# toolchain is unavailable in this environment, and say so in the report.
flutter build <target> --debug
# Expected: Built successfully

If tests fail:

Flutter tests failing (N failures). Must fix before completing:
 
[Show failures]
 
Cannot proceed with merge/PR until tests pass.

STOP. Don't proceed to Step 2.

If tests pass: Continue to Step 2.

Step 2: Determine Base Branch

bash

# Find merge base
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null
 
# Or ask: "This branch split from main - is that correct?"

Step 3: Present Options

Present exactly these 4 options:

Implementation complete. All tests passing. What would you like to do?
 
1. Merge back to <base-branch> locally
2. Push and create a Pull Request
3. Keep the branch as-is (I'll handle it later)
4. Discard this work
 
Which option?

Don't add explanation - keep options concise.

Step 4: Execute Choice

Option 1: Merge Locally

bash

# Switch to base branch
git checkout <base-branch>
 
# Pull latest
git pull
 
# Merge feature branch
git merge <feature-branch>
 
# Verify tests on merged result
flutter analyze
flutter test
 
# If tests pass, delete feature branch
git branch -d <feature-branch>

Then: Cleanup worktree (Step 5)

Option 2: Push and Create PR

bash

# Push branch
git push -u origin <feature-branch>
 
# Create PR
gh pr create --title "<feature-title>" --body "$(cat <<'EOF'
## Summary
- Implemented [feature] following Clean Architecture
- Added [Layer] layer components
- [Test coverage details]
 
## Test Plan
- [ ] flutter analyze passes
- [ ] flutter test passes
- [ ] Manual testing of [scenarios]
 
## Flutter Version
- Flutter: X.X.X
- Dart: X.X.X
 
🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

Don't cleanup worktree - might need for PR review fixes.

Option 3: Keep As-Is

Report: "Keeping branch <name>. Worktree preserved at <path>."

Don't cleanup worktree.

Option 4: Discard

Confirm first:

This will permanently delete:
- Branch: <name>
- All commits: <commit-list>
- Worktree at: <path>
 
Type 'discard' to confirm.

Wait for exact confirmation.

If confirmed:

bash

git checkout <base-branch>
git branch -D <feature-branch>

Then: Cleanup worktree (Step 5)

Step 5: Cleanup Worktree

For Options 1, 2, 4:

Check if in worktree:

bash

git worktree list | grep $(git branch --show-current)

If yes:

bash

# Navigate to main repo
cd <main-repo-path>
 
# Remove worktree
git worktree remove <worktree-path>

For Option 3: Keep worktree.

Quick Reference

Option	Merge	Push	Keep Worktree	Cleanup Branch
1. Merge locally	✓	-	-	✓
2. Create PR	-	✓	✓	-
3. Keep as-is	-	-	✓	-
4. Discard	-	-	-	✓ (force)

Flutter-Specific Verification

Before allowing completion:

bash

# 1. Analysis must pass
flutter analyze
# Must show: No issues found!
 
# 2. Tests must pass
flutter test
# Must show: All tests passed!
 
# 3. Build verification — once, per project target platform (see Step 1)
flutter build <target> --debug
# Must show: Built successfully

Common Mistakes

Skipping test verification

Problem: Merge broken code, create failing PR
Fix: Always verify tests before offering options

Open-ended questions

Problem: "What should I do next?" → ambiguous
Fix: Present exactly 4 structured options

Automatic worktree cleanup

Problem: Remove worktree when might need it (Option 2, 3)
Fix: Only cleanup for Options 1 and 4

No confirmation for discard

Problem: Accidentally delete work
Fix: Require typed "discard" confirmation

Red Flags

Never:

Proceed with failing tests
Merge without verifying tests on result
Delete work without confirmation
Force-push without explicit request
Skip flutter analyze

Always:

Verify tests before offering options
Present exactly 4 options
Get typed confirmation for Option 4
Clean up worktree for Options 1 & 4 only

Integration

Called by:

flutter-subagent-dev (after all tasks complete)
flutter-executing (after all batches complete)

Pairs with:

flutter-worktrees - Cleans up worktree created by that skill

Security

Security scanPassed, 100 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/flutter-finishing/SKILL.md

Popularity

Repository stars: 6
Repository forks: 2
7-day trend score: 10

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 25 Apr 2026, 6 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/vp-k/flutter-craft/flutter-finishing/badge)](https://verified-skill.com/skills/vp-k/flutter-craft/flutter-finishing)

Something wrong with this skill or its page? Tell us.