agents-js

Perform a fallback role by existing only in the alternate search path. Tests use this to assert that discovery walks every search path, not just the first one, when resolving names that do not appear in the primary path.

Perform the same role as the primary valid-skill fixture but live in an alternate search path so tests can assert precedence rules (first search path wins). The body text here is different from the primary fixture so a test can tell which copy was loaded.

A skill with a non-kebab-case name. The validator should reject this because the name format is used as an identifier across search paths and registries.

A skill whose body is empty. The tolerant validator should reject this since the body carries the actual instructions the orchestrator needs.

this file triggers a yaml parse error

Perform strict-mode checks on a skill whose body omits the When NOT to Use section. Everything else about the body is fine, the description is long enough, opens with an action verb, and includes a Not for anti-trigger. The one failure this fixture isolates is the missing When-NOT-to-Use heading which is the single most commonly skipped authoring convention.

Perform strict-mode checks against a skill that has plenty of content but no anti-trigger clause. This description is deliberately padded to cross the 300-character lower bound while leaving the Not-for segment absent so the validator focuses solely on the missing anti-trigger rule. It includes use-when triggers and enough substance to look convincing at first glance.

Perform strict-mode conformance checks against a well-formed skill by asserting description length, anti-triggers, action-verb opener, body length, When-NOT-to-Use section, and H1 title, then roll the findings into a single ValidationResult for downstream reporting. Use when asked to verify strict-mode parity, check authoring conventions, or gate a skill before publish. Not for tolerant-mode validation (use validateSkill), not for MCP integration, not for runtime execution (out of scope for this package).

Perform a thing. Not for other things.

This skill starts with a pronoun instead of an action verb, which strict-mode should flag. Despite the weak opener, the rest of the description still has enough content to cross the length floor and includes a Not for clause so only the opening-word check should fail in isolation. This padding keeps us comfortably in the target length band for the description.

Perform a representative operation on inputs, produce structured outputs, and serve as a fixture for parse and validate tests. Covers a full range of tolerant-mode checks. Use when asked to test validation against a well-formed skill, exercise the loader, or verify registry round-tripping. Not for strict-mode authoring-convention checks (use strict-mode-examples fixtures instead).