Skill rendering

[JosXa]

Hey OpenCode, we should have the ability to expand entire skills using a <skill>jira</skill> or <skill name="nextjs" /> in the snippet body. Figure out a reliable way to load the skills using OpenCode's SDK, if possible. Should that not be possible, I'm okay finding them from both the project-specific and global configs (.opencode/skill[s]?/SKILL.md).

The skill bodies (excluding frontmatter) should be rendered verbatim.

This will be an experimental setting, as introduced in #19 (see conversation if PR is not ready yet).

[JosXa]

I've implemented skill rendering in PR #24.

Summary

The feature adds support for rendering OpenCode skills inline within snippets using two syntax options:

<skill>jira</skill>
<skill name="jira" />

How it works

1. Enable the feature (opt-in via experimental flag):

   {
     "experimental": {
       "skillRendering": true
     }
   }

2. Skills are loaded from standard OpenCode paths:

   • ~/.config/opencode/skill[s]/<name>/SKILL.md (global)
   • .opencode/skill[s]/<name>/SKILL.md (project)
   • .claude/skills/<name>/SKILL.md (Claude Code compatibility)

3. Processing order: Skills → Snippets → Shell commands

   • This means skills can contain hashtag references that will be expanded

4. Rendering is verbatim: The skill body (markdown content excluding frontmatter) is inserted directly

Example usage

Create a snippet like:

---
name: bug-report
---
Create a bug ticket for this issue.
<skill>jira</skill>

When you use #bug-report, the skill content from your jira skill will be included.

Files added/changed

• src/skill-loader.ts - Loads skills from OpenCode directories
• src/skill-renderer.ts - Expands <skill> tags
• src/skill-renderer.test.ts - Comprehensive test suite
• src/config.ts - Added experimental.skillRendering flag
• src/constants.ts - Skill tag regex patterns
• schema/config.schema.json - Updated config schema
• index.ts - Integration

All 204 tests pass.

[JosXa]

I've reviewed the implementation in PR #24 and everything looks good.

Summary

The skill rendering feature is now implemented as an experimental feature in PR #24. Here's what's included:

Implementation Details

• src/skill-loader.ts - Loads skills from:

  • Global paths: ~/.config/opencode/skill[s]/<name>/SKILL.md
  • Project paths: <projectDir>/.opencode/skill[s]/<name>/SKILL.md
  • Priority: project skills override global skills (same as snippets behavior)

• src/skill-renderer.ts - Expands skill tags in text:

  • Block format: <skill>jira</skill>
  • Self-closing format: <skill name="nextjs" />
  • Case-insensitive lookup
  • Unknown skill tags are left unchanged

• Integration - Skills are applied:

  • In processTextParts (user messages)
  • In tool.execute.after hook (specifically for skill tool output)
  • Processing order: skills → snippets → shell commands

Configuration

Enable with:

{
  "experimental": {
    "skillRendering": true
  }
}

Tests

All 204 tests pass, including comprehensive tests for the skill renderer covering edge cases, multiline content, and real-world scenarios.

The PR is ready for review!