How do I install the Direct Tests skill?

Run npx skillmds@latest add genlayerlabs/direct-tests in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Direct Tests skill do?

Write and run fast direct-mode pytest tests for this repo's GenLayer intelligent contracts. It is listed under Coding & Dev Tools on SkillMD.

Is Direct Tests safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Direct Tests?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Direct Tests free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Direct Tests?

genlayerlabs (@genlayerlabs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Direct Tests by genlayerlabs — Agent Skill

Name: Direct Tests
Author: genlayerlabs

File contents

Direct Mode Tests

Use this skill for fast contract logic checks that do not need a live GenLayer network.

This repo keeps Python contract tests in test/, not tests/direct/. The tests use the genlayer-test pytest plugin fixtures plus helpers in test/tools/.

Setup

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r test/requirements.txt -q

test/requirements.txt includes genlayer-test, which provides the direct_* pytest fixtures.

Running Tests

Run all Python contract tests:

python -m pytest test/ -v

Run one file or one scenario:

python -m pytest test/test_football_prediction_market_with_evidence_success.py -v
python -m pytest test/test_football_prediction_market_with_evidence_success.py::test_name -v

Always lint contracts first when contract files changed:

genvm-lint check intelligent-contracts/*.py

Repo Fixtures And Helpers

Existing tests use direct-mode fixtures such as:

def test_example(direct_vm, direct_deploy, direct_alice, tmp_path):
    ...

Common fixtures include direct_vm, direct_deploy, direct_alice, direct_bob, direct_charlie, direct_owner, and direct_accounts.

Use test/tools/contracts.py for repo-specific helpers:

ORACLE_CONTRACT_PATH
deploy_oracle_direct(...)
mock_oracle_resolution(...)
read_contract_source(...)

deploy_oracle_direct(...) rewrites the contract header to py-genlayer-multi:test for direct-mode compatibility. Prefer using that helper instead of duplicating deploy setup.

Mocking External Inputs

For gl.nondet.web.get():

direct_vm.mock_web(r".*", {"status": 200, "body": b"<html>result</html>"})

For gl.nondet.exec_prompt():

direct_vm.mock_llm(
    r".*",
    json.dumps(
        {
            "valid_source": "true",
            "event_has_occurred": "true",
            "reasoning": "mocked direct-mode resolution",
            "outcome": "Bayern Munich",
        }
    ),
)

Reset mocks between scenarios when needed:

direct_vm.clear_mocks()

What To Test Here

Constructor validation for required fields, unique outcomes, and source mode exclusivity.
Evidence URL domain checks.
Resolution success, UNDETERMINED, ERROR, and revert paths.
Public view output shape consumed by the Next explorer.
Factory deployment behavior when it creates oracle contracts.

Direct mode runs the leader path only. Use integration tests or a live Studio smoke test when validator consensus behavior is the thing being verified.

---name: direct-testsdescription: Write and run fast direct-mode pytest tests for this repo's GenLayer intelligent contracts.---# Direct Mode TestsUse this skill for fast contract logic checks that do not need a live GenLayer network.This repo keeps Python contract tests in `test/`, not `tests/direct/`. The tests use the `genlayer-test` pytest plugin fixtures plus helpers in `test/tools/`.## Setup```bashpython3 -m venv .venv. .venv/bin/activatepython -m pip install -r test/requirements.txt -q````test/requirements.txt` includes `genlayer-test`, which provides the `direct_*` pytest fixtures.## Running TestsRun all Python contract tests:```bashpython -m pytest test/ -v```Run one file or one scenario:```bashpython -m pytest test/test_football_prediction_market_with_evidence_success.py -vpython -m pytest test/test_football_prediction_market_with_evidence_success.py::test_name -v```Always lint contracts first when contract files changed:```bashgenvm-lint check intelligent-contracts/*.py```## Repo Fixtures And HelpersExisting tests use direct-mode fixtures such as:```pythondef test_example(direct_vm, direct_deploy, direct_alice, tmp_path): ...```Common fixtures include `direct_vm`, `direct_deploy`, `direct_alice`, `direct_bob`, `direct_charlie`, `direct_owner`, and `direct_accounts`.Use `test/tools/contracts.py` for repo-specific helpers:- `ORACLE_CONTRACT_PATH`- `deploy_oracle_direct(...)`- `mock_oracle_resolution(...)`- `read_contract_source(...)``deploy_oracle_direct(...)` rewrites the contract header to `py-genlayer-multi:test` for direct-mode compatibility. Prefer using that helper instead of duplicating deploy setup.## Mocking External InputsFor `gl.nondet.web.get()`:```pythondirect_vm.mock_web(r".*", {"status": 200, "body": b"<html>result</html>"})```For `gl.nondet.exec_prompt()`:```pythondirect_vm.mock_llm( r".*", json.dumps( { "valid_source": "true", "event_has_occurred": "true", "reasoning": "mocked direct-mode resolution", "outcome": "Bayern Munich", } ),)```Reset mocks between scenarios when needed:```pythondirect_vm.clear_mocks()```## What To Test Here- Constructor validation for required fields, unique outcomes, and source mode exclusivity.- Evidence URL domain checks.- Resolution success, `UNDETERMINED`, `ERROR`, and revert paths.- Public view output shape consumed by the Next explorer.- Factory deployment behavior when it creates oracle contracts.Direct mode runs the leader path only. Use integration tests or a live Studio smoke test when validator consensus behavior is the thing being verified.

Frequently asked questions

Direct Tests