feat(skill-loader): support nested skill directories

[LeekJay]

Summary

Add recursive directory scanning to discover skills in nested directories like superpowers (e.g., skills/superpowers/brainstorming/SKILL.md).

Problem

Currently, the skill loader only scans one level deep in ~/.config/opencode/skills/. When superpowers is installed following the official documentation:

ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers

The resulting structure is:

~/.config/opencode/skills/superpowers/
├── brainstorming/
│   └── SKILL.md
├── systematic-debugging/
│   └── SKILL.md
└── ...

The loader sees superpowers as a directory, looks for superpowers/SKILL.md (doesn't exist), and stops - never discovering the nested skills.

Solution

• Add namePrefix, depth, and maxDepth parameters to loadSkillsFromDir
• Recurse into subdirectories when no SKILL.md found at current level
• Construct hierarchical skill names (e.g., superpowers/brainstorming)
• Limit recursion depth to 2 levels to prevent infinite loops

Changes

• src/features/opencode-skill-loader/loader.ts: Add recursive scanning logic
• src/features/opencode-skill-loader/loader.test.ts: Add tests for nested skill discovery

Testing

All existing tests pass, plus 4 new tests for nested skill discovery:

• Discovers skills in nested directories (superpowers pattern)
• Discovers multiple skills in nested directories
• Respects max depth limit
• Flat skills still work alongside nested skills

bun test src/features/opencode-skill-loader/
# 66 pass, 0 fail

Related

• Enables compatibility with superpowers plugin
• Related to issue Compare, Contrast and (maybe) Integrate Superpowers #44 (Compare, Contrast and (maybe) Integrate Superpowers)

---

Summary by cubic

Adds recursive scanning to the skill loader to discover skills in nested directories. This enables compatibility with superpowers-installed skills and keeps flat skills working.

• New Features
  • Recursively scans subdirectories up to 2 levels when no SKILL.md is found at the current level.
  • Builds hierarchical skill names from directory paths (e.g., superpowers/brainstorming).
  • Adds namePrefix, depth, and maxDepth parameters; updates loadSkillFromPath; tests cover nested discovery and depth limits.

^{Written for commit 64b29ea. Summary will update on new commits.}

[github-actions]

All contributors have signed the CLA. Thank you! ✅
_{Posted by the CLA Assistant Lite bot.}

[cubic-dev-ai]

No issues found across 2 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

[LeekJay]

I have read the CLA Document and I hereby sign the CLA