SmartSkills.Core 0.1.0-preview2

SmartSkills.Core

Core SDK library for SmartSkills — scan project dependencies, match them against skill registries, and install agent skills automatically.

Installation

dotnet add package SmartSkills.Core

Getting Started

Register all SmartSkills services with a single extension method:

using Microsoft.Extensions.DependencyInjection;
using SmartSkills.Core;

var services = new ServiceCollection();
services.AddSmartSkills();

This registers scanning, matching, installation, caching, and provider services as singletons.

Key Services

Scanning

var scanner = serviceProvider.GetRequiredService<ILibraryScanner>();

// Scan a single project
var packages = await scanner.ScanProjectAsync("path/to/MyProject.csproj");

// Scan a solution
var packages = await scanner.ScanSolutionAsync("path/to/MySolution.sln");

// Auto-detect and scan all projects in a directory
var packages = await scanner.ScanDirectoryAsync("path/to/repo");

// Recursive scan with depth control
var packages = await scanner.ScanDirectoryAsync("path/to/repo", new ProjectDetectionOptions
{
    Recursive = true,
    MaxDepth = 3
});

Supported Ecosystems

Registry & Matching

using SmartSkills.Core.Registry;

// Load only the built-in embedded registry
var entries = RegistryIndexParser.LoadEmbedded();

// Merge built-in + custom registries
var entries = RegistryIndexParser.LoadMerged(new[]
{
    "path/to/my-team-skills.json",
    "path/to/project-skills.json"
});

// Match packages against registry
var matcher = serviceProvider.GetRequiredService<ISkillMatcher>();
var matched = matcher.Match(resolvedPackages, registryEntries);

Package patterns support exact match and glob syntax:

• Azure.Identity — matches exactly
• Azure.Identity.* — matches any package starting with Azure.Identity.

Installation Workflow

var installer = serviceProvider.GetRequiredService<ISkillInstaller>();

// Install skills for a project
var result = await installer.InstallAsync(new InstallOptions
{
    ProjectPath = "path/to/project",
    DryRun = false,
    Force = false
});

// result.Installed, result.Updated, result.SkippedUpToDate, result.Failed

// Restore skills from lock file
await installer.RestoreAsync("path/to/project");

// Remove a skill
await installer.UninstallAsync("skill-name", "path/to/project");

Skill Providers

Skills are fetched from remote repositories. The provider is auto-detected from the URL:

Configuration

Further Reading

• SmartSkills repository — full documentation, CLI tool, and MSBuild integration
• Agent Skills specification