Nested Skills Discovery — runtime test
Hands-on runtime battle-test of Nested Skills Discovery. Result: INCONCLUSIVE.
Nested Skills Discovery tests automatic availability of skills from subdirectory-scoped .claude/skills directories in Claude Code 2.1.6.
What the Feature Claims
The feature would enable skills defined in nested .claude/skills directories to be automatically discovered and made available when working with files in those subdirectories. Instead of skills being limited to the project root, each subdirectory—such as a monorepo package or workspace module—could host its own skill suite.
Test Setup and Status
The test created the required nested structure:
2.1.6/tests/01-nested-skills/
└── .claude/
└── skills/
└── nested-test/
└── SKILL.md
However, the test was not runtime verified. The test file candidly notes: "Cannot verify from current session because skill discovery happens based on working directory context. Would need to start new session inside nested directory or invoke skill while 'working with files' in that subdirectory."
Why This Matters
If working, nested skill discovery would unlock finer-grained tooling isolation in large projects. Monorepo packages, git submodules, and cross-team workspaces could each maintain independent skill configurations without polluting the global namespace.
Caveats
The hypothesis remains unproven. Runtime verification requires either starting a fresh Claude Code session from within the nested directory and checking /context, or invoking the nested-test skill from that context to confirm discovery. The test result is inconclusive—architectural assumption without empirical proof.
Test Results: Nested Skills Discovery
Feature: Automatic discovery of skills from nested .claude/skills directories when working with files in subdirectories
Tested: 2026-01-16 Version: 2.1.6 features on 2.1.9
Feature Description
When working with files in a subdirectory that has its own .claude/skills, those skills should be automatically discovered and available.
Test Setup
Created nested structure:
2.1.6/tests/01-nested-skills/
└── .claude/
└── skills/
└── nested-test/
└── SKILL.md
Test Result: NOT RUNTIME TESTED
Cannot verify from current session because:
- Skill discovery happens based on working directory context
- Would need to start new session inside nested directory
- Or invoke skill while "working with files" in that subdirectory
Manual Test Steps
cd 2.1.6/tests/01-nested-skills/- Start
claude - Check
/contextor try to invokenested-testskill - Skill should be available despite being in deeply nested .claude/skills
Use Cases
- Monorepo packages - Each package can have its own skills
- Project submodules - Git submodules with their own claude config
- Workspace organization - Different skills for different project areas
- Team isolation - Different teams/directories with different tooling
Notes
This enables more granular skill organization in large projects. Skills are no longer limited to root .claude/skills - they can be distributed throughout the project hierarchy.
Status: CODE REVIEW (needs manual verification)
test_419de4effe4248ff9946af08ed255199b87705613b1e2fd064d57fa75a6b679d2856ceafad6b1daa8f982493871b6ddccd57edb5a8629198b26c23682c401f3ffaa76e93b810ac6e10de07a71bb6947b97512acc2ccef0df73b282ed7ce480088853a1cf2a85d21b90efc252fec280eSigned with an ed25519 key held off the repo. Anyone can verify against the published public key; nobody without the secret key can forge it. Click verify: it recomputes the signature in your browser. The signature proves integrity and authorship of this exact content — not a third-party timestamp or that the underlying claim is objectively true. signedAt is when the @f3/attest pipeline ran, not when the work happened; the evidence refs carry the source dates.
- verifies Nested Skills Discovery Primitive