flame-harness-evaluator

Validate Flutter and Flame game builds against a predefined contract.

54|5|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/tjdrhs90/flutter-flame-harness --skill flame-harness-evaluator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flame-harness-evaluator
Source: https://github.com/tjdrhs90/flutter-flame-harness/tree/main/skills/flame-harness-evaluator
Command: npx skills add https://github.com/tjdrhs90/flutter-flame-harness --skill flame-harness-evaluator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents the deployment of low-quality or broken games by enforcing a rigorous, contract-based QA process that requires actual gameplay verification rather than just code review.

Core Features & Use Cases

  • Automated Hard Gate Validation: Automatically checks for critical failures like missing assets, l10n errors, and non-compliant native configurations.
  • Simulator-Based Verification: Mandates launching the game on a simulator to capture screenshots and verify the core loop, preventing "silent" failures.
  • Strict Quality Scoring: Provides an optional strict mode that evaluates game feel, originality, and performance through specialized agent teams.

Quick Start

Run the flame-harness-evaluator skill to perform a functional check against the current contract and generate a QA verdict.

Frequently Asked Questions about flame-harness-evaluator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate QA testing for a Flutter Flame game in CI/CD?

Automate Flutter Flame game QA by enforcing a contract-based validation process that runs static analysis, executes tests, and performs simulator-based visual verification. This prevents deploying broken games by requiring actual gameplay verification rather than just code review.

What does simulator-based visual verification do for game builds?

Simulator-based visual verification mandates launching the game on a simulator to capture screenshots and verify the core gameplay loop. This mechanism prevents silent failures where code passes review but the game breaks visually or functionally.

How do I validate game assets and native configurations before deployment?

Validate game assets and native configurations through automated hard gate checks that detect critical failures like missing assets, l10n errors, and non-compliant native settings. These gates act as a strict quality barrier before deployment.

Do I need a specific environment setup to run automated game testing gates?

Yes, you need a structured harness environment with defined configuration, state, and contract files. This setup is required to execute the mandatory hard gates and edge-case sweeps that validate the game build.

Can I evaluate game feel and performance beyond basic functional tests?

Yes, you can evaluate game feel, originality, and performance by enabling a strict quality scoring mode. This mode uses specialized agent teams to assess subjective and performance metrics beyond standard functional checks.

Best way to check Flutter game builds against a predefined contract?

The best way is running an automated evaluator that validates builds against a predefined contract through static analysis, test execution, and simulator verification, generating a definitive QA verdict before deployment.