← 2.1.6 Test inconclusive · runtime-test

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.

Primary source
⎘ 2.1.6/tests/01-nested-skills/TEST-RESULTS.mdverbatim from the corpus

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:

  1. Skill discovery happens based on working directory context
  2. Would need to start new session inside nested directory
  3. Or invoke skill while "working with files" in that subdirectory

Manual Test Steps

  1. cd 2.1.6/tests/01-nested-skills/
  2. Start claude
  3. Check /context or try to invoke nested-test skill
  4. Skill should be available despite being in deeply nested .claude/skills

Use Cases

  1. Monorepo packages - Each package can have its own skills
  2. Project submodules - Git submodules with their own claude config
  3. Workspace organization - Different skills for different project areas
  4. 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)

Evidence & receipt
◇ ed25519 receipt
idtest_419de4effe4248ff9946af08
alged25519
pubkey9b87705613b1e2fd064d57fa75a6b679d2856ceafad6b1daa8f982493871b6dd
sigccd57edb5a8629198b26c23682c401f3ffaa76e93b810ac6e10de07a71bb6947b97512acc2ccef0df73b282ed7ce480088853a1cf2a85d21b90efc252fec280e

Signed 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.

Connected