Root skill should win.

Select the root SKILL.md entry point and exclude nested skill definitions.

1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/vh2224/forge-executor --skill root-skill-should-win
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Root skill should win.
Source: https://github.com/vh2224/forge-executor/tree/main/packages/pi-coding-agent/test/fixtures/skills/root-skill-preferred
Command: npx skills add https://github.com/vh2224/forge-executor --skill root-skill-should-win

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill demonstrates how to identify the correct Skill unit when both a root-level and a nested SKILL.md exist, ensuring the top-level entry point is selected for activation.

Core Features & Use Cases

  • Root-level precedence: Uses the SKILL.md at the directory root as the authoritative Skill entry point.
  • Nested skill exclusion: Ignores child SKILL.md files when a valid root Skill is present.
  • Use Case: Helpful for repositories that contain fixture trees or multiple skill-like directories and need deterministic Skill discovery behavior.

Quick Start

Ask the assistant to activate the root skill and confirm that it ignores any nested SKILL.md files.

Frequently Asked Questions about Root skill should win.

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

FAQPage Schema
How do I ensure root skill discovery takes precedence over nested SKILL.md files?

Root skill discovery takes precedence by selecting the root-level SKILL.md as the authoritative entry point and ignoring nested child skill definitions. This enforces deterministic directory traversal behavior in repositories with multiple skill-like directories.

What does frontmatter recognition do during fixture validation in nested directories?

Frontmatter recognition during fixture validation identifies the root-level entry point in a repository and excludes nested SKILL.md files. This enforces precedence rules to ensure only the top-level skill is activated.

Can I use directory traversal to ignore child SKILL.md files when a root skill exists?

Yes, directory traversal can ignore child SKILL.md files when a valid root skill is present. The system applies root precedence rules to exclude nested skill definitions and select only the root-level frontmatter entry point.

Why does skill discovery select the root-level frontmatter entry point instead of nested skills?

Skill discovery selects the root-level frontmatter entry point to ensure deterministic behavior in repositories containing fixture trees or multiple skill-like directories. This root precedence mechanism ignores nested SKILL.md files to avoid conflicts.

What's the best way to handle multiple SKILL.md files in a repository during skill activation?

The best way to handle multiple SKILL.md files is to enforce root precedence by activating the root-level SKILL.md and excluding nested skill definitions. This approach ensures deterministic skill discovery and avoids ambiguity in directory traversal.

When do I need root precedence rules for skill discovery?

You need root precedence rules for skill discovery when a repository contains both root and nested SKILL.md files, such as in fixture trees or directories with multiple skill-like structures. This ensures the correct top-level entry point is selected.