complex-test-skill

Validate directory-based skill discovery by locating SKILL.md files at skill roots.

3.1k|286|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill complex-test-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complex-test-skill
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/crates/ralph-core/tests/fixtures/skills/complex-test-skill
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill complex-test-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a lightweight, self-contained directory-based discovery test to verify that SKILL.md is present and correctly parsed at the root of skill units.

Core Features & Use Cases

  • Directory-based discovery validation: ensures a SKILL.md exists at each skill root and is loaded as the entry point.
  • Lightweight test harness: enables automated tests of the discovery pipeline without requiring external resources.
  • Use Case: validate that a nested directory containing SKILL.md is recognized as a valid skill unit by the orchestrator.

Quick Start

Place a SKILL.md with a valid frontmatter in a subdirectory and run the skill discovery process to confirm it is detected.

Frequently Asked Questions about complex-test-skill

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

FAQPage Schema
How do I validate directory-based skill discovery for SKILL.md files?

Validate directory-based skill discovery by locating SKILL.md files at skill roots and parsing their frontmatter and Markdown body to ensure they are recognized as valid skill units by the orchestrator.

What frontmatter is required in a SKILL.md file for skill discovery validation?

SKILL.md frontmatter must include name and description fields for skill discovery validation, and the Markdown body must provide operational instructions to pass the validation check.

How do I test that nested directories with SKILL.md are detected as valid skill units?

Place a SKILL.md with valid frontmatter in a subdirectory and run the skill discovery process to confirm the framework detects the nested directory as a valid skill unit.

Do I need external resources to run a directory-based skill discovery test?

No external resources are needed for directory-based skill discovery testing because the skill provides a lightweight, self-contained test harness for validating the discovery pipeline.

Why is my skill directory not being recognized during the discovery process?

Skill directory discovery fails when SKILL.md is missing from the skill root or its frontmatter lacks the required name and description fields needed by the orchestrator to parse it as a valid skill unit.