flutter-finishing
vp-k/flutter-craft · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por vp-k/flutter-craft no skills.sh. Instale com: npx skills add vp-k/flutter-craft@flutter-finishing
Details
- Kind
- Agent skills
- Publisher
- vp-k
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 13
- Forks
- 6
- Last push
- 2026-08-10T03:26:22Z
- Repository state
- ativo
- Language
- Shell
- Added
- 2026-10-07 06:34:45
- Updated
- 2026-10-07 06:34:45
- Origin id
vp-k/flutter-craft/flutter-finishing
README
# Flutter-Craft
[English](https://github.com/vp-k/flutter-craft/blob/HEAD/README.md) | [한국어](https://github.com/vp-k/flutter-craft/blob/HEAD/README.ko.md)
Flutter development skills for Claude Code - Feature-Driven Development with Clean Architecture.
## Overview
Flutter-Craft provides a comprehensive set of skills for Flutter development, following:
- **Feature-Driven Development** (FDD) workflow
- **Clean Architecture** (Domain → Data → Presentation)
- **Priority-based Testing** (Repository → State → Widget)
## Installation
```bash
# Step 1: Add marketplace
/plugin marketplace add https://github.com/vp-k/flutter-craft.git
# Step 2: Install plugin
/plugin install flutter-craft@vp-k/flutter-craft
```
## Skills
### Project Setup Skills
| Skill | Description |
|-------|-------------|
| `flutter-project-init` | Create new Flutter project with Clean Architecture and domain patterns |
### Core Workflow Skills
| Skill | Description |
|-------|-------------|
| `start-flutter-craft` | Skill system gatekeeper (auto-injected on session start) |
| `flutter-brainstorming` | Feature design with Clean Architecture |
| `flutter-planning` | Implementation plan with layer-ordered tasks |
| `flutter-executing` | Batch execution with verification checkpoints |
| `flutter-verification` | Evidence-based completion verification |
| `flutter-debugging` | Systematic debugging with Flutter DevTools |
### Testing & Review Skills
| Skill | Description |
|-------|-------------|
| `flutter-testing` | Priority-based test writing (Repository → State → Widget) |
| `flutter-review-request` | Request code review with Flutter checklist |
| `flutter-review-receive` | Process review feedback technically |
### Utility Skills
| Skill | Description |
|-------|-------------|
| `flutter-subagent-dev` | Per-task subagent with 2-stage review |
| `flutter-parallel-agents` | Parallel execution for independent tasks |
| `flutter-worktrees` | Isolated workspace with Flutter setup |
| `flutter-finishing` | Completion workflow (merge/PR/keep/discard) |
| `flutter-writing-skills` | Create new flutter-craft skills |
## Commands
| Command | Description |
|---------|-------------|
| `/init` | Create a new Flutter project with Clean Architecture |
| `/brainstorm` | Start feature design |
| `/plan` | Create implementation plan |
| `/execute` | Execute plan in batches |
| `/test` | Write priority-based tests |
| `/verify` | Evidence-based completion verification |
| `/debug` | Systematic debugging |
| `/finish` | Final verification + merge/PR/keep/discard |
## Clean Architecture
Flutter-Craft enforces Clean Architecture layer order:
```
lib/features/<feature>/
├── domain/ # First: Entities, Repository interfaces, UseCases
├── data/ # Second: Models, DataSources, Repository implementations
└── presentation/ # Third: State Management, Widgets, Screens
```
## Test Priority
1. **Priority 1:** Repository & DataSource unit tests (business logic)
2. **Priority 2:** State Management unit tests (BLoC/Provider/Riverpod)
3. **Priority 3:** Widget tests (optional, for complex UI)
## Example Workflow
```
1. User: "Add login feature"
2. Claude: Uses flutter-brainstorming
- Explores requirements
- Designs Clean Architecture structure
- Saves to docs/plans/YYYY-MM-DD-auth-design.md
3. Claude: Uses flutter-planning
- Creates task list following layer order
- Saves to docs/plans/YYYY-MM-DD-auth-plan.md
4. Claude: Uses flutter-executing
- Executes 3 tasks at a time
- Runs flutter analyze after each batch
- Reports progress
5. Claude: Uses flutter-verification
- Runs flutter analyze, flutter test
- Verifies build
6. Claude: Uses flutter-finishing
- Presents 4 options (merge/PR/keep/discard)
- Executes chosen option
```
## State Management Support
Flutter-Craft supports multiple state management patterns:
- **Riverpod + Freezed** (Recommended for new projects)
- BLoC / Cubit
- Provider
The chosen pattern should be consistent within a project.
## Recommended Packages
```bash
# State Management (choose one)
flutter pub add flutter_riverpod # Recommended
flutter pub add flutter_bloc # Alternative
# Immutable States & Code Generation
flutter pub add freezed_annotation
flutter pub add dev:freezed
flutter pub add dev:build_runner
# Routing
flutter pub add go_router
# Network
flutter pub add dio
# DI
flutter pub add get_it
flutter pub add injectable
flutter pub add dev:injectable_generator
# Riverpod Code Generation (if using Riverpod)
flutter pub add dev:riverpod_generator
# Testing
flutter pub add dev:mocktail
flutter pub add dev:bloc_test
```
## Directory Structure
```
flutter-craft/
├── .claude-plugin/
│ └── plugin.json
├── agents/
│ ├── flutter-code-reviewer.md
│ └── flutter-dart-specialist.md
├── commands/
│ ├── init.md
│ ├── brainstorm.md
│ ├── plan.md
│ ├── execute.md
│ ├── test.md
│ ├── verify.md
│ ├── debug.md
│ └── finish.md
├── hooks/
│ ├── hooks.json
│ ├── run-hook.cmd
│ └── session-start.sh
└── skills/
├── start-flutter-craft/
├── flutter-project-init/
├── flutter-brainstorming/
├── flutter-planning/
├── flutter-executing/
├── flutter-verification/
├── flutter-debugging/
├── flutter-testing/
├── flutter-review-request/
├── flutter-review-receive/
├── flutter-subagent-dev/
├── flutter-parallel-agents/
├── flutter-worktrees/
├── flutter-finishing/
└── flutter-writing-skills/
```
## License
MIT