test-expert

Provides authoritative reference guidance for writing and debugging tests in the Cogni template monorepo.

4|5|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/cogni-dao/cogni --skill test-expert-cogni-dao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-expert
Source: https://github.com/cogni-dao/cogni/tree/main/.claude/skills/test-expert
Command: npx skills add https://github.com/cogni-dao/cogni --skill test-expert-cogni-dao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authoritative guidance for writing and debugging tests in the Cogni template monorepo, consolidating rules, patterns, and gotchas so teammates can quickly diagnose failures and align on best practices.

Core Features & Use Cases

  • Authoritative reference on test layers (unit, component, stack, external, and env e2e) and how they fit in the Cogni CI/CD.
  • Practical guidance on common pitfalls (dotenv loading, testcontainers usage, skip-gates, and per-env GitHub/DoltHub org boundaries) to reduce flaky tests.

Quick Start

Consult this skill whenever you write or debug tests in the Cogni monorepo to decide the proper testing layer, apply best practices, and avoid common gotchas.

Frequently Asked Questions about test-expert

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

FAQPage Schema
How do I structure vitest tests across different layers in a monorepo?

Testing layers in a monorepo include unit, component, stack, external, and env e2e tests. Each layer fits specific CI/CD boundaries to ensure proper isolation, coverage tracking, and consistent validation across the stack.

Why does my testcontainers setup fail to load environment variables correctly?

Testcontainers and dotenv loading failures often stem from misconfigured env files or improper initialization sequences. Consulting test guidance helps diagnose these common gotchas to reduce flaky tests and ensure correct environment loading.

Does vitest work with CI gate rules for per-env GitHub and DoltHub org boundaries?

Vitest integrates with CI gate rules by enforcing per-env GitHub and DoltHub org boundaries. This ensures tests respect infrastructure prerequisites and organizational constraints during agent run executions.

What is the best way to debug flaky tests in a Cogni template monorepo?

The best way to debug flaky tests is consulting authoritative test guidance for the Cogni template monorepo. It consolidates rules, patterns, and common pitfalls like skip-gates and testcontainers usage to quickly diagnose failures.

When should I use external versus env e2e testing lanes?

External testing lanes validate integrations outside the monorepo, while env e2e lanes test full environment flows. Use external for third-party boundaries and env e2e for comprehensive end-to-end validation within CI.