Sdk

Skill SDK

This is not a user-facing skill - it's a utility SDK that provides infrastructure for the skill system.

Purpose

The SDK directory contains core utilities that power the skill system:

1. skill-loader.mjs: Loads skill instructions and metadata with intelligent caching
2. skill-registry.mjs: Registers skills and integrates with Anthropic Agent SDK patterns

Components

skill-loader.mjs

Provides functions for loading and caching skill instructions:

• loadSkillInstructions(skillName, useCache): Load skill instructions from SKILL.md
• loadSkillMetadata(skillName): Extract YAML frontmatter metadata
• getAllSkillNames(): Get list of all available skills
• autoSelectSkills(query, maxResults): Intelligently select skills based on query
• clearCache(): Clear skill cache
• getCacheStats(): Get cache statistics

Caching: Skills are cached in .claude/context/cache/skill-cache.json for performance.

skill-registry.mjs

Integrates skills with Anthropic Agent SDK patterns:

• registerSkill(skillName): Register a skill and parse its metadata
• getAllSkills(): Get all registered skills
• getSkill(skillName): Retrieve a registered skill
• registerSkillWithSDK(skillName): Create SDK-compatible skill object
• initializeSkills(): Initialize all skills on startup
• invokeSkill(skillName, input, context): Invoke a skill with context
• createSDKSkill(skillConfig): Create SDK skill instance

Usage

These utilities are used internally by the skill system and skill-manager. They are not invoked directly by users.

Example (internal use):

import { loadSkillInstructions, autoSelectSkills } from '.claude/skills/sdk/skill-loader.mjs';

// Load specific skill
const instructions = await loadSkillInstructions('rule-auditor');

// Auto-select relevant skills
const skills = await autoSelectSkills('audit code for violations', 3);
// Returns: ['rule-auditor', 'code-style-validator', 'fixing-rule-violations']

Skill Format

All skills must follow this format in their SKILL.md:

---
name: skill-name
description: Brief description
allowed-tools: tool1, tool2
version: 1.0.0
---

# Skill Instructions

Detailed instructions for the skill...

Auto-Selection Algorithm

The auto-selection algorithm scores skills based on:

1. Name match (10 points): Skill name contains query words
2. Description match (5 points per word): Description contains query words
3. Tool match (3 points per word): Allowed tools contain query words

Top N skills by score are returned.

Cache Management

• Cache Location: .claude/context/cache/skill-cache.json
• Cache Contents: Skill instructions and metadata
• Cache Invalidation: Manual via clearCache() or by deleting cache file
• Performance: 90%+ reduction in disk I/O for repeated skill loads

Integration Points

The SDK is used by:

• skill-manager: Managing and validating all skills
• Skill tool invocations: Loading skill instructions when invoked
• Auto-selection: Finding relevant skills for user queries
• Workflow execution: Loading skills for workflow steps

Notes

• This is infrastructure code, not a user-facing skill
• Do not invoke this skill directly
• Do not create prompts or commands that reference this skill
• This directory should contain only utility modules for the skill system