Summary

skilld addresses AI agent knowledge gaps regarding NPM dependencies by automatically generating version-aware skills from existing package documentation, release notes, and GitHub issues. This empowers developers with local-first, context-rich skills, enhancing agent performance without requiring package maintainer opt-in or external server dependencies.

How It Works

The tool analyzes NPM dependencies, extracting relevant information from sources like docs, release notes, and issues. It generates SKILL.md files, which are local, version-specific skill definitions. Optionally, it leverages LLMs to enrich these skills with best practices and API changes, building a semantic search index. This approach ensures skills are context-aware, versioned, and locally executable.

Quick Start & Requirements

• Primary Install/Run: npx -y skilld for interactive setup. Global install via npm install -g skilld or pnpm add -g skilld. Supports running without a dedicated agent CLI.
• Prerequisites: Node.js 22.6.0 or higher.
• Links: Community support available via Discord.

Highlighted Details

• Any Source: Generates skills from any NPM dependency or GitHub source, auto-resolving documentation.
• Bleeding Edge Context: Utilizes the latest issues, discussions, and releases for up-to-date agent knowledge.
• Opt-in LLM Sections: Enhances skills with LLM-generated best practices, API changes, or custom prompts.
• Use Any Agent: Compatible with CLI agents (e.g., Claude Code, Cursor) or usable standalone via portable prompts.
• Semantic Search: Enables querying indexed docs across all skills using vector embeddings.
• Safe & Versioned: Features prompt injection sanitization, version-aware caching, and auto-updates.
• Ecosystem: Compatible with npx skills and skills-npm.

Maintenance & Community

The project is supported by a Sponsor Program and offers community assistance via Discord. The primary developer can be followed on Twitter at @harlan_zw. Telemetry is collected anonymously for skill discovery and ranking, disabled in CI environments.

Licensing & Compatibility

Licensed under the permissive MIT license, allowing for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

While skilld implements sanitization and treats data as untrusted, it sources information from GitHub issues, which could present a theoretical prompt injection risk if users interact with untrusted skills without caution. LLM enhancements are optional but significantly improve skill utility.