flutter-skill

flutter-skill

Dale ojos y manos a cualquier agente de IA dentro de cualquier aplicación en ejecución.
10 plataformas. Cero código de prueba. Un servidor MCP.

Demo • Inicio rápido • Plataformas de IA • Plataformas • vs Otros • Documentación

🚀 Cero configuración. Cero código de prueba. Solo habla con tu IA.

_{Si esto te ahorra tiempo, considera dar una estrella al repositorio ⭐ — ¡ayuda a que otros lo encuentren!}

Demo de 30 segundos

https://github.com/user-attachments/assets/d4617c73-043f-424c-9a9a-1a61d4c2d3c6

Un solo prompt. 28 acciones impulsadas por IA. Cero código de prueba. La IA explora un clon de TikTok, navega pestañas, desplaza feeds, prueba la búsqueda, rellena formularios — todo de forma autónoma.

Por qué existe esto

Escribir pruebas E2E es doloroso. Mantenerlas es peor. flutter-skill adopta un enfoque diferente:

• 🔌 Conecta cualquier agente de IA (Claude, Cursor, Windsurf, Copilot, OpenClaw) directamente a tu aplicación en ejecución mediante MCP
• 👀 El agente ve tu pantalla — toca botones, escribe texto, desplaza, navega — como un probador humano que nunca duerme
• ✅ Cero código de prueba — sin Page Objects, sin XPath, sin selectores frágiles. Solo inglés sencillo
• ⚡ Cero configuración — 2 líneas de código, funciona en las 10 plataformas

You: "Test the checkout flow with an empty cart, then add 3 items and complete purchase"

Your AI agent handles the rest — screenshots, taps, text entry, assertions, navigation.
No Page Objects. No XPath. No brittle selectors. Just plain English.

Inicio rápido

1. Instala (30 segundos)

npm install -g flutter-skill

2. Añádelo a tu IA (copia y pega en la configuración de MCP)

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

Funciona con Claude Desktop, Cursor, Windsurf, Copilot, Cline, OpenClaw — cualquier agente compatible con MCP.

3. Añádelo a tu aplicación (2 líneas para Flutter)

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

4. Prueba — solo habla con tu IA:

"Lanza mi aplicación, explora cada pantalla y reporta cualquier error"

Eso es todo. Cero configuración. Cero código de prueba. Funciona en menos de 60 segundos.

Uso con plataformas de IA

Modo servidor MCP (integración con IDE)

Funciona con cualquier herramienta de IA compatible con MCP. Una línea de configuración:

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

Modo servidor HTTP (CLI y automatización)

Para automatización de navegador independiente, pipelines de CI/CD o acceso remoto:

# Start server
flutter-skill serve https://your-app.com

# Use CLI client commands
flutter-skill nav https://google.com
flutter-skill snap                    # Accessibility tree (99% fewer tokens)
flutter-skill screenshot /tmp/ss.jpg
flutter-skill tap "Login"
flutter-skill type "hello@example.com"
flutter-skill eval "document.title"
flutter-skill tools                   # List all available tools

Admite las banderas --port=N, --host=H y las variables de entorno FS_PORT/FS_HOST.

Comparación de los dos modos

Referencia completa del cliente CLI: docs/CLI_CLIENT.md

10 plataformas, una herramienta

La mayoría de las herramientas de prueba funcionan en 1-2 plataformas. flutter-skill funciona en 10.

Total: 656/664 pruebas aprobadas (98.8%) — cada plataforma probada contra una aplicación compleja de redes sociales con más de 50 elementos.

⚡ Rendimiento

Puntos de referencia reales de ejecuciones de pruebas automatizadas contra una aplicación compleja de redes sociales:

Eficiencia de tokens: snapshot() devuelve un árbol de elementos estructurado en lugar de una imagen — 87–99% menos tokens que enviar capturas de pantalla a tu agente de IA.

¿Qué tan rápido es? Un tap toma 1–2 ms de principio a fin. Las herramientas de automatización de navegador como Playwright y Selenium suelen tardar 50–100 ms para la misma operación. Eso es 50–100× más rápido, porque flutter-skill habla directamente con el runtime de la aplicación en lugar de pasar por la indirección de WebDriver o CDP.

Sitios con DOM pesado (mundo real)

Se probaron 15 herramientas MCP contra sitios web de producción — 75/75 aprobadas, cero tiempos de espera:

El tiempo total incluye la carga de la página. La ejecución de herramientas es consistentemente inferior a 100 ms incluso en sitios con DOM pesado.

¿Por qué no Playwright / Appium / Detox?

| Comprensión de página por IA | ✅ Árbol AX | ❌ Capturas de pantalla | ❌ | ❌ | | Pruebas de límites/seguridad | ✅ 13 payloads | ❌ | ❌ | ❌ | | Acciones por lotes | ✅ 5+/llamada | 1/llamada | 1/llamada | 1/llamada |

flutter-skill es la única herramienta de pruebas E2E nativa para IA que funciona en móvil, web y escritorio — con 7× más herramientas que el competidor más cercano.

Comandos CLI

# 🤖 AI autonomous exploration — finds bugs automatically
flutter-skill explore https://my-app.com --depth=3

# 🐒 Monkey/fuzz testing — random actions, crash detection
flutter-skill monkey https://my-app.com --actions=100 --seed=42

# 🚀 Parallel multi-platform testing
flutter-skill test --url https://my-app.com --platforms web,electron,android

# 🌐 Zero-config WebMCP server — any website becomes testable
flutter-skill serve https://my-app.com

🧠 Nativo para IA: 95% menos tokens

La mayoría de las herramientas de prueba con IA envían capturas de pantalla al LLM — cada una cuesta ~4,000 tokens.

flutter-skill usa el Árbol de Accesibilidad de Chrome para dar a tu IA un resumen semántico compacto de cualquier página:

// page_summary → ~200 tokens (vs ~4,000 for a screenshot)
{
  "title": "Shopping Cart",
  "nav": ["Home", "Products", "Cart", "Account"],
  "forms": [{"input:Coupon Code": "text"}],
  "buttons": ["Apply", "Checkout", "Continue Shopping"],
  "features": {"search": true, "pagination": true},
  "links": 47, "inputs": 3
}

Luego agrupa múltiples acciones en una sola llamada:

// explore_actions → 5 actions per call (vs 5 separate tool calls)
{"actions": [
  {"type": "fill", "target": "input:Coupon Code", "value": "SAVE20"},
  {"type": "tap", "target": "button:Apply"},
  {"type": "tap", "target": "button:Checkout"},
  {"type": "fill", "target": "input:Email", "value": "test@example.com"},
  {"type": "tap", "target": "button:Continue"}
]}

Resultado: Tu agente de IA prueba más rápido, cuesta menos y comprende las páginas mejor que las herramientas basadas en capturas de pantalla.

Qué puede hacer

Configuración de Plataforma

dependencies:
  flutter_skill: ^0.9.37

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

npm install flutter-skill-react-native

import FlutterSkill from 'flutter-skill-react-native';
FlutterSkill.start();

npm install flutter-skill-electron

const { FlutterSkillBridge } = require('flutter-skill-electron');
FlutterSkillBridge.start(mainWindow);

// Swift Package Manager: FlutterSkillSDK
import FlutterSkill
FlutterSkillBridge.shared.start()

Text("Hello").flutterSkillId("greeting")

implementation("com.flutterskill:flutter-skill:0.8.0")

FlutterSkillBridge.start(this)

[dependencies]
flutter-skill-tauri = "0.8.0"

Ejemplos de Prompts

Solo dile a tu IA qué probar:

Contribuciones

Consulta CONTRIBUTING.md para las pautas.

git clone https://github.com/ai-dashboad/flutter-skill
cd flutter-skill
dart pub get
dart run bin/flutter_skill.dart server  # Start MCP server

Enlaces

⭐ Si flutter-skill te ahorra tiempo, ¡dale una estrella para que otros también lo encuentren!

Licencia MIT © 2025