Skillex

This is the Course Studio fork of skillex, created by Jeremy (atheory.ai) — credited permanently in the package name @course-studio/skillex-by-jeremy. The fork optimizes for Claude Code as the first-class agent harness. Changes from upstream are listed in CHANGELOG.md (Apache-2.0, section 4(b) change notice). The CLI command remains skillex.

Skill management for AI agents in Node.js projects.

Skillex helps agents load the right guidance for the code they are working on without dumping an entire repo's docs into context. It indexes repo skills, package skills, scope rules, and installed package versions, then answers targeted queries in microseconds.

What Skillex does

• Resolves the right skills for a file path, package, topic, or tag
• Handles monorepos and multiple installed versions of the same package
• Separates public consumer skills from private maintainer skills
• Exposes the index through both MCP and a CLI fallback
• Generates AGENTS.md instructions for agents that cannot use MCP directly

Install

npm install --save-dev @course-studio/skillex-by-jeremy

The wrapper package installs the correct native binary for your platform through npm optionalDependencies.

Quick start

Initialize Skillex in your repository:

skillex init

Rebuild the local skill index:

skillex refresh

Query the skills that apply to a file:

skillex query --path packages/app-a/src/auth.ts

Query by topic, tag, or package:

skillex query --topic auth
skillex query --tags migration,breaking-change
skillex query --package @acme/foo

Return full skill content for an agent:

skillex query --path packages/app-a/** --format content

Example workflow

1. Add repo skills in skills/ and configure scopes in skillex.json
2. Run skillex refresh to rebuild .skillex/index.db
3. Let your agent query only the skills relevant to its current task

Why this exists

Without scoped skill retrieval, agents either get too little context or far too much of it. Skillex moves scope resolution into deterministic indexing so the model receives the small, correct slice of guidance for the current path and dependency boundary.

Repository

• Source: https://github.com/course-studio/skillex
• Documentation: https://github.com/course-studio/skillex/blob/main/README.md