Flutter testing skills for AI coding agents.
Show case E2E and SRS report:
Run the package CLI:
npx shipflutter-skills list
The npm package ships the skill files and a small listing command. Use the open skills CLI below to install skills into AI agents.
Publish with an npm token:
NODE_AUTH_TOKEN='<npm-token>' npm run publish:npm
The token must have publish permission. If your npm account uses 2FA, use a granular token with bypass 2FA enabled or publish manually with --otp.
List available skills:
npx skills add shipflutter/skills --list
Install all skills for Claude Code in the current project:
npx skills add shipflutter/skills --skill '*' -a claude-code --copy
Install all skills globally for Claude Code:
npx skills add shipflutter/skills --skill '*' -a claude-code -g --copy
Install one skill:
npx skills add shipflutter/skills --skill add-feat -a claude-code --copy
npx skills add shipflutter/skills --skill add-srs -a claude-code --copy
npx skills add shipflutter/skills --skill flutter-integration-test -a claude-code --copy
npx skills add shipflutter/skills --skill flutter-driver-screenshot-test -a claude-code --copy
npx skills add shipflutter/skills --skill flutter-unit-test-coverage -a claude-code --copy
npx skills add shipflutter/skills --skill privacy-safe-device-referral-attributes -a claude-code --copy
| Skill | Description | Example prompt |
|---|---|---|
add-feat |
Creates feature user-story and technical-design docs, including gen-tdd source scanning. |
Run add-feat gen-tdd auth EP01 and create the feature docs. |
add-srs |
Generates or updates SRS packages from user-story and technical-design docs. | Generate the SRS from the current user-story and technical-design docs. |
flutter-integration-test |
Adds Flutter integration_test coverage that runs on emulator/simulator without saving screenshot images. |
Add Flutter integration tests for the main app flow without saving screenshots. |
flutter-driver-screenshot-test |
Adds Flutter driver screenshot tests that save PNG files through the host driver process. | Add e2e screenshot tests for the main screens and save PNG files to screenshots/. |
flutter-unit-test-coverage |
Adds Flutter unit/widget coverage reporting with flutter test --coverage and optional HTML reports. |
Add a run_test.sh script that generates Flutter unit test coverage and an HTML report. |
privacy-safe-device-referral-attributes |
Adds privacy-safe Flutter Android, iOS, Web, and static Web device/referral attribute demos. | Add a transparent device referral attributes screen without third-party IP lookup or invasive fingerprinting. |
skills/
├── add-feat/
│ ├── SKILL.md
│ ├── assets/templates/
│ ├── references/
│ └── scripts/add_feat.sh
├── add-srs/
│ └── SKILL.md
├── flutter-integration-test/
│ ├── SKILL.md
│ └── scripts/
│ └── integration_test.sh
├── flutter-driver-screenshot-test/
│ ├── SKILL.md
│ └── scripts/
│ └── e2e.sh
├── flutter-unit-test-coverage/
│ ├── SKILL.md
│ └── scripts/
│ └── run_test.sh
└── privacy-safe-device-referral-attributes/
├── SKILL.md
├── examples/
│ └── prompts.md
└── reference/
└── attribute-contract.md
Use add-feat gen-tdd to derive user-story and technical-design docs from a Flutter feature source tree:
scripts/add_feat.sh gen-tdd auth EP01
The command creates:
resources/user-story/ep01-auth.mdresources/technial-design/ep01-auth.mdUse add-srs after that to compile the generated docs into resources/srs.md and render srs-index.html through resources/srs.sh using the standard two-column Mermaid SRS template.
The repository includes examples/flutter-poc-fingerprint as a runnable reference for privacy-safe device/referral attributes.
flowchart TD
A[User opens device page or POC] --> B{Runtime}
B -->|Android| C[Load safe Android attributes]
B -->|iOS| D[Load safe iOS attributes]
B -->|Flutter Web| E[Load browser attributes]
B -->|Static Web| F[Run device.html JavaScript]
C --> G[Normalize allowed device fields]
D --> G
E --> G
F --> G
A --> H[Parse allowlisted referral params]
H --> I[Generate local SHA-256 hash]
G --> I
I --> J[Render transparent JSON report]
Implemented attributes include platform, OS/browser version, model/manufacturer where available, locale, timezone, screen size, device pixel ratio, referrer, and allowlisted referral params. Public IP is documented as unavailable without a same-origin backend endpoint.
The repository includes examples/flutter-poc-auth as a runnable reference for the add-feat and add-srs workflows.
It demonstrates:
resources/.cd examples/flutter-poc-auth
../../scripts/add_feat.sh gen-tdd auth EP01
./resources/srs.sh
flutter pub get
flutter test
shipflutter/skills because the GitHub repository is https://github.com/shipflutter/skills.shipflutter-skills.SKILL.md format with name and description frontmatter.