galasa-user

name	galasa-user
description	Documentation with references to what Galasa is, how to use the Galasa CLI tool (galasactl), and how to create Galasa test projects. Use this skill when you are asked to do anything using Galasa.

Galasa User Skill

When to use this skill

Use this skill when you are asked to create or do anything using Galasa.

What this skill contains

This skill contains individual skill references that explain how the various aspects of the Galasa testing framework work.

Context Optimization Strategy

IMPORTANT: To minimize token usage, load files selectively based on task type:

Always Load First

1. This file (SKILL.md)
2. Quick Reference - Common commands, patterns, and configurations

Load Based on Task Type

Understanding Galasa (what is Galasa, why use it):

• Galasa overview - What Galasa is, key features, use cases
• Galasa architecture - Framework components, managers, test runner
• Galasa ecosystem - Running at scale, stores, services

CLI Operations (creating projects, running tests, viewing results):

• Galasa CLI tool - Detailed command syntax and flags

Test Development (writing test classes, configuring environments):

• Writing Galasa tests - Test structure, build commands, CPS/credentials
• Test development best practices - Design principles for scalable tests
• Galasa CLI tool - For project creation context

Manager Setup (adding dependencies, injecting managers):

• Using Galasa managers - Manager dependencies and injection patterns
• Load terminal reference ONLY if user mentions screens/fields/timing

Terminal Interaction (working with 3270 screens):

• Terminal Interaction Reference - Detailed timing, navigation, data extraction
• Load ONLY when user explicitly works with terminal screens or mentions timing issues
• For basic terminal patterns, use quick reference instead

Troubleshooting (errors, build failures, test failures):

• Troubleshooting Galasa - Load only when errors occur

Critical Rules

1. Never load all files at once - This wastes tokens
2. Start with quick reference - Covers 80% of common tasks
3. Load terminal reference last - Only when explicitly needed (200+ lines)
4. Avoid redundant loading - If quick reference answers the question, stop there
5. Load conceptual docs only when asked - Architecture, ecosystem, best practices

Skill References

Quick Start

• Quick Reference - START HERE - Common commands, patterns, configurations

Understanding Galasa

• Galasa overview - What Galasa is, key features, and use cases
• Galasa architecture - Framework components, managers, and test runner
• Galasa ecosystem - Running tests at scale, stores, and services

Working with Galasa

• Galasa CLI tool - CLI command details and project structure
• Writing Galasa tests - Test structure, build commands, environment configuration
• Test development best practices - Design principles for scalable, maintainable tests
• Using Galasa managers - Manager dependencies, injection patterns, basic terminal usage

Advanced Topics

• Terminal Interaction Reference - Load only when needed - Detailed terminal timing and navigation

Troubleshooting

• Troubleshooting Galasa - Error resolution guidance