JD.SemanticKernel.Extensions.Memory 0.1.10

JD.SemanticKernel.Extensions

Bridge Claude Code skills, plugins, and hooks into Microsoft Semantic Kernel applications. Load file-based SKILL.md definitions, lifecycle hooks, and plugin packages as native SK components.

Features

• 📝 Skills — Parse SKILL.md files (YAML frontmatter + markdown) into KernelFunction or PromptTemplate
• 🔗 Hooks — Map Claude Code lifecycle events (PreToolUse, PostToolUse, etc.) to SK's IFunctionInvocationFilter and IPromptRenderFilter
• 📦 Plugins — Load .claude-plugin/ directories with skills, hooks, and MCP configs
• 🎯 Fluent API — UseSkills(), UseHooks(), UsePlugins() extension methods on IKernelBuilder

Packages

Package	Description	NuGet
JD.SemanticKernel.Extensions.Skills	SKILL.md → KernelFunction/PromptTemplate
JD.SemanticKernel.Extensions.Hooks	Claude Code hooks → SK filters
JD.SemanticKernel.Extensions.Plugins	Plugin directory loader
JD.SemanticKernel.Extensions	Meta-package (all of the above)

Quick Start

dotnet add package JD.SemanticKernel.Extensions

Load Skills

using JD.SemanticKernel.Extensions.Skills;

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .UseSkills("./skills/")   // Scans for SKILL.md files
    .Build();

A SKILL.md file follows the Claude Code / AgentSkills.io format:

---
name: code-reviewer
description: Reviews code for quality issues
allowed-tools: [Read, Grep, Glob]
---
# Code Reviewer

Review the provided code for:
1. Bug risks
2. Security vulnerabilities
3. Performance issues

Input: $ARGUMENTS

Configure Hooks

using JD.SemanticKernel.Extensions.Hooks;

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .UseHooks(hooks =>
    {
        hooks.OnFunctionInvoking("Bash|Execute", async ctx =>
        {
            Console.WriteLine($"Validating: {ctx.Function.Name}");
        });
        hooks.OnFunctionInvoked("Write|Edit", async ctx =>
        {
            Console.WriteLine($"Post-edit hook: {ctx.Function.Name}");
        });
        hooks.OnPromptRendering(async ctx =>
        {
            Console.WriteLine("Prompt is about to render...");
        });
    })
    .Build();

Load Plugins

using JD.SemanticKernel.Extensions.Plugins;

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .UsePlugins("./my-plugin/")         // Single plugin directory
    .UseAllPlugins("./plugins/")        // All plugins in directory
    .Build();

Plugin directories follow the .claude-plugin/ convention:

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # Manifest
├── skills/
│   └── reviewer/SKILL.md    # Skills
├── hooks/
│   └── hooks.json           # Hooks
└── .mcp.json                # MCP servers (future)

Meta-Package (All-in-One)

using JD.SemanticKernel.Extensions;

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .AddClaudeCodeSkills("./skills/")
    .AddClaudeCodePlugin("./my-plugin/")
    .AddClaudeCodeHooks(hooks => hooks.OnFunctionInvoking(".*", _ => Task.CompletedTask))
    .Build();

Hook Event Mapping

Related Projects

Building

dotnet restore
dotnet build
dotnet test

License

MIT © JD