run

Launch and interact with project apps using skills or repository documentation.

5|Updated Apr 9, 2018
One-click install
npx skills add https://github.com/angusjfw/hbz --skill run-angusjfw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run
Source: https://github.com/angusjfw/hbz/tree/main/claude/skills/run
Command: npx skills add https://github.com/angusjfw/hbz --skill run-angusjfw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the process of launching and interacting with a project's app, ensuring that the desired functionality is accessible without unnecessary complexity or errors.

Core Features & Use Cases

  • Project Skill Check: First, the Skill searches for an existing project skill that already knows how to launch the app.
  • Repo Documentation Utilization: If no project skill exists, the Skill refers to the repository's README, Taskfile, Makefile, Procfile, docker-compose, or bin/dev to determine the launch instructions.
  • Pattern Matrix Fallback: If no documented launch path is found, the Skill applies the closest match from a pattern matrix that includes CLI tools, web servers, TUIs, Electron/GUI apps, and browser-driven apps.
  • Drive Interaction: The Skill provides commands to interact with the app, such as typing input, clicking elements, taking screenshots, and more.
  • Verify Functionality: After launching, the Skill verifies the app's functionality by driving it to a point where a user would see a result (e.g., CLI output, GUI state).

Quick Start

Use the run skill to launch the project's app and interact with it as needed.

Frequently Asked Questions about run

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

FAQPage Schema
How do I automatically launch and interact with different types of project apps?

To automatically launch and interact with project apps, this Skill checks for existing project skills or repository documentation like Makefile and docker-compose. It then applies a pattern matrix for CLI tools, web servers, TUIs, and GUI apps to execute the correct launch commands.

What is the best way to launch a project app when there is no documentation?

The best way to launch an undocumented project app is using a pattern matrix fallback. This mechanism matches the project type—such as CLI tools, web servers, TUIs, or Electron apps—to apply the closest corresponding launch instructions automatically.

Can I use this to automate GUI interaction and take screenshots of my app?

Yes, you can automate GUI interaction and take screenshots of your app. After launching the application, the Skill drives interaction by providing commands to type input, click elements, capture screenshots, and verify the resulting app state.

Does this Skill support launching web servers and browser-driven apps?

Yes, this Skill supports launching web servers and browser-driven apps. It identifies the project type through README files or pattern matching, then executes the necessary commands to start the server and verify functionality by driving browser interaction.

How to verify an app's functionality after launching it from the command line?

To verify an app's functionality after launching it from the command line, the Skill drives the application to a point where a user would see a result. It checks CLI output or GUI state by automatically typing input and clicking elements.

What launch configuration files does this Skill check before starting an app?

Before starting an app, the Skill checks launch configuration files including the repository's README, Taskfile, Makefile, Procfile, docker-compose, and bin/dev. It uses these files to determine the correct project environment execution instructions.