nested-root-skill

Locate SKILL.md files in nested directories and extract metadata into a catalog.

146|20|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/maxvaega/skillkit --skill nested-root-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nested-root-skill
Source: https://github.com/maxvaega/skillkit/tree/main/examples/skills/nested-example
Command: npx skills add https://github.com/maxvaega/skillkit --skill nested-root-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill demonstrates that skills can exist at any level of the hierarchy, enabling scalable organization.

Core Features & Use Cases

  • Hierarchical Organization: Supports depth up to several levels to group related skills.
  • Discoverability: Keeps skills discoverable regardless of nesting depth.

Quick Start

Discover skills in the nested-example root to observe the hierarchy.

Frequently Asked Questions about nested-root-skill

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

FAQPage Schema
How do I discover skills organized in nested directories?

Nested directory discovery locates skill definitions in SKILL.md files across multiple hierarchy levels. This skill traverses arbitrarily deep folder structures, parsing front matter and content to extract metadata like name, description, and depth, producing a structured catalog queryable by location and nesting level.

Can I organize skills across multiple nesting levels for better scalability?

Yes. Hierarchical organization supports up to five levels of nesting, grouping related skills while keeping each discoverable regardless of depth. Skills remain indexed and retrievable at root, mid-level, and deep positions within your directory structure.

What's the best way to index skills distributed across a deeply nested repository?

Directory traversal combined with depth-aware parsing indexes all skills at any nesting level. Extract metadata such as name, description, location, and depth from SKILL.md files, then build a query-ready catalog that maps each skill to its position in the hierarchy.

Does this approach work with both flat and multi-level skill organization?

Yes. The skill applies to repositories with flat single-level layouts and multi-level nesting up to five levels deep, automatically adapting discovery and indexing logic to match your chosen organizational structure.

Why structure skills hierarchically instead of keeping them all at the root?

Hierarchical nesting improves scalability and navigation as your skill collection grows. Grouping related skills by depth reduces clutter, enables logical organization, and maintains discoverability through depth-aware indexing that keeps all skills query-ready.