Skip to main content

Auto-Skill v5.0: Proactive Skill Discovery

· 4 min read
MaTriXy
MaTriXy
Auto-Skill Maintainer

Auto-Skill v5.0 introduces Proactive Skill Discovery - transforming from a passive pattern recorder into an active learning companion that suggests community skills BEFORE you ask.

🎯 What's New​

Auto-Skill now proactively suggests community skills from 27,000+ external sources based on your workflow context.

Before (v4.0)​

User repeats workflow → Auto-Skill generates local skill

After (v5.0)​

User repeats workflow → Auto-Skill:
  1. Detects context (React + Testing)
  2. Searches skills.sh
  3. Finds "React Test Patterns" (1250 installs)
  4. Suggests: "Use this instead of generating new skill?"

✨ Key Features​

Search 27,000+ community skills from skills.sh in real-time:

import { createExternalSkillLoader } from '@matrixy/auto-skill';

const loader = createExternalSkillLoader();
await loader.start();

const response = await loader.search('react testing', { limit: 5 });
console.log(response.skills);
// Returns: [{ title, description, content, installCount, ... }]

await loader.stop();

2. Context-Aware Recommendations​

Automatically suggests skills based on detected patterns:

import { createProactiveDiscovery } from '@matrixy/auto-skill';

const discovery = createProactiveDiscovery(loader);
const recommendations = await discovery.discoverForPattern(pattern);
console.log(recommendations);
// Returns: [{ skill, reason, confidence, trigger }]

3. Smart Graduation​

Recommends upgrading local patterns to community skills at 70%+ confidence:

import { createSkillRecommendationEngine } from '@matrixy/auto-skill';

const engine = createSkillRecommendationEngine(loader, discovery);
const recs = await engine.recommendForPattern(pattern);
console.log(recs);
// Returns: [{ type: 'hybrid', action: 'graduate', confidence: 0.9 }]

🔧 What Was Built​

ComponentLinesPurpose
external-skill-loader.ts392Search & fetch from skills.sh + GitHub
proactive-discovery.ts225Context-aware recommendations
skill-recommendation-engine.ts149Unified local + external interface
Total New Code766Complete closed-loop system

MCP Integration​

Two new tools for Claude Code, Cursor, and other MCP clients:

  • search_skills - Manual skill search by query
  • discover_skills - Context-based proactive discovery

🎨 Architecture​

Pattern Detector (existing)
     ↓
Context Analyzer (NEW)
     ↓
Skill Recommendation Engine (NEW)
     ├─ Local: Generate custom skill
     ├─ External: Load community skill
     └─ Hybrid: Graduate to community skill

💡 Design Highlights​

  • Zero dependencies - Uses Node.js native fetch (Node 18+)
  • In-memory cache - 24-hour TTL with auto-cleanup
  • Rate limits - 60 req/hr (no token) → 5000 req/hr (with GitHub token)
  • Confidence scoring - Install count (50%) + Relevance (50%)
  • Graduation threshold - 70% default (configurable)

🚀 Getting Started​

Install the latest version:

npm install -g @matrixy/auto-skill@5.0.0

Quick example:

import {
  createExternalSkillLoader,
  createProactiveDiscovery,
  createSkillRecommendationEngine,
} from '@matrixy/auto-skill';

const loader = createExternalSkillLoader({
  githubToken: process.env.GITHUB_TOKEN, // Optional
});

const discovery = createProactiveDiscovery(loader);
const engine = createSkillRecommendationEngine(loader, discovery);

await loader.start();

// Get unified recommendations for a detected pattern
const recommendations = await engine.recommendForPattern(pattern);

console.log(recommendations);
// [
//   {
//     type: 'hybrid',
//     externalSkill: { title: 'React Test Patterns', installCount: 1250 },
//     reason: 'Your workflow matches "React Test Patterns". Use it instead?',
//     confidence: 0.9,
//     action: 'graduate'
//   }
// ]

await loader.stop();

📚 Documentation​

⚠️ Breaking Changes​

Removed: auto-skill search command​

Why: Skills CLI (npx skills find) provides a superior search experience with interactive fzf-style search, better filtering, and direct installation.

Migration:

# OLD (v4.x)
auto-skill search "react testing"

# NEW (v5.0)
npx skills find react testing

For programmatic access, use the MCP tools instead:

  • search_skills - For Auto-Skill's internal proactive discovery
  • discover_skills - For context-aware recommendations

This change clarifies Auto-Skill's role as a skill factory (generation + publishing) rather than duplicating Skills CLI's distribution capabilities.

🔮 What's Next (v5.1+)​

  • Semantic search with embeddings for better relevance
  • Usage analytics to track which external skills are most effective
  • Auto-loading of high-confidence skills into context
  • Local registry for offline skill access
  • Skill fusion - merge local patterns with external skills

🙏 Credits​

This release was inspired by Skyll.

Questions? Open an issue | Full Docs: auto-skill