nested-example_skill

Overview

This skill demonstrates a flat organization pattern placed inside a nested category to show how both structures can coexist. It serves as a minimal, concrete example for agent systems that support hierarchical categories with immediate skills. The skill highlights placement and naming conventions for clarity when mixing flat and nested layouts.

How this skill works

The skill provides a simple implementation illustrating a skill file located within a second-level category. It does not depend on external services; instead, it shows how to register and reference a skill that lives under a nested directory while behaving like an immediate category entry. Use it as a template to verify that your agent framework recognizes flat entries at deeper category levels.

When to use it

• When you need an example of mixing flat and nested category structures.
• When testing agent directory parsing for second-level category entries.
• When organizing skills by topic but keeping some entries immediately accessible.
• When onboarding contributors to a multi-level skill taxonomy.
• When validating naming and placement conventions for skills in nested folders.

Best practices

• Keep the skill minimal and focused so it clearly demonstrates the organizational pattern.
• Name files and categories consistently to avoid ambiguity in lookups and references.
• Document the intended category depth and any special behavior in a short header.
• Use this pattern sparingly to avoid confusing users who expect uniform structure.
• Test agent discovery and indexing after adding flat entries in nested folders.

Example use cases

• Provide a template for adding immediate skills under an otherwise nested category.
• Verify that agent loaders correctly surface second-level skills in UI lists.
• Teach new contributors how to place skills when some topics need flat entries.
• Compare behavior between purely nested categories and mixed-structure categories.
• Create quick-access tools inside a deep topic area without adding another top-level category.