insites-unit-tests

Create Liquid unit tests for Insites components with contract assertions.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/insites-io/insites-logic-engine --skill insites-unit-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: insites-unit-tests
Source: https://github.com/insites-io/insites-logic-engine/tree/main/skills_examples/insites-unit-tests
Command: npx skills add https://github.com/insites-io/insites-logic-engine --skill insites-unit-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction and guesswork from writing Liquid unit tests for Insites applications, helping you produce consistent tests that follow the platform’s required testing contract and execution flow.

Core Features & Use Cases

  • Test planning for Insites components: Guides coverage for commands, validators, queries, authorization rules, helpers, and background jobs.
  • Assertion-driven validation: Maps requirements to the correct contract assertions such as equality, presence, validity, and boolean checks.
  • Execution and workflow discipline: Reinforces required test file placement, staging deployment, and repeatable run procedures.
  • Use case: When you need to verify a user creation command, the Skill helps you define success, failure, and edge-case scenarios and turn them into a compliant Liquid test file.

Quick Start

Ask the skill to plan and write a Liquid unit test for a specific Insites component, and it will generate a compliant test structure with the right assertions and file location.

Frequently Asked Questions about insites-unit-tests

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

FAQPage Schema
How do I write reliable Liquid unit tests for Insites applications?

To write reliable Liquid unit tests for Insites applications, you need to initialize and return the testing contract, place files under app/lib/test with an _test.liquid suffix, and use approved assertion functions for validation.

What components should I cover when writing unit tests for Insites?

Unit tests for Insites should cover commands, validators, queries, authorization rules, helpers, and background jobs, ensuring you test happy paths, validation failures, missing records, and edge cases.

How do I execute Liquid unit tests in an Insites staging environment?

To execute Liquid unit tests, you must deploy your application to the staging environment first, then run the tests using the platform's repeatable test execution procedures after ensuring correct file placement.

What assertion functions are available for Insites unit testing?

Insites unit testing supports assertion-driven validation functions that map requirements to equality, presence, validity, and boolean checks to verify contract compliance for your components.

Does Insites unit testing require a specific file naming convention?

Yes, Insites unit testing requires a specific file naming convention where test files must be placed under the app/lib/test directory and named with an _test.liquid suffix to be recognized.

Why do my Insites unit tests fail during execution?

Insites unit tests fail during execution if the testing contract is not properly initialized and returned, files are incorrectly named or placed, or the application has not been deployed to staging.