cortex-lab-test

To verify Cortex skill discovery, use a read-only smoke test that confirms the agent runtime can see and cite skills from a specified directory. This validates that SKILL.md entries with proper frontmatter are successfully resolved during local development.

You can test withSkills resolution by adding a validation skill to the apps/cortex/.agents/skills directory. Ask the agent to load skills from that path and confirm whether the skill is listed and accessible, ensuring correct builder integration.

A SKILL.md file requires specific frontmatter containing the skill name and description at the skill root. This metadata allows the Cortex runtime to properly discover and activate the skill entries within the configured skills directory.

Yes, you can run an intentionally read-only and non-destructive smoke test to check Cortex Studio wiring. This safe validation method confirms skill activation and discovery without altering your local development environment or configuration files.

If skill discovery fails, ensure each skill root contains a valid SKILL.md file with the required name and description frontmatter. The agent runtime needs these entries to properly resolve withSkills paths during local Cortex Lab debugging.

A Cortex skill smoke test works effectively for both local development and CI checks. It provides a minimal validation layer that confirms skill discovery and activation without side effects, making it suitable for automated integration workflows.