Skip to content

FasterApiWeb/skill-orchestrator

skill-orchestrator

Enterprise-oriented toolkit for discovering, installing, chaining, and monitoring AI agent skills across Claude, VS Code, Cursor, Codex, Windsurf, Replit, and related environments.

Features

  • Offline-first registry backed by SQLite (better-sqlite3) with versioned migrations.
  • Zod validation for every external payload (manifests, config files, remote search results).
  • Structured logging via pino.
  • Multi-source discovery (GitHub, npm, PyPI, extensible sources).
  • Platform adapters that write to the correct paths for each host environment.
  • Workflow engine for ordered skill chains with optional deadlines.
  • MkDocs documentation site and Playwright smoke tests.

Quick start

npm ci
npm run build
npx skill-orchestrator --help

Common commands

npx skill-orchestrator search "pdf workflow"
npx skill-orchestrator install my-skill --adapter cursor
npx skill-orchestrator list
npx skill-orchestrator platforms
npx skill-orchestrator chain "pdf-read,slide-gen,pdf-export"
npx skill-orchestrator help topics

Monorepo layout

Path Purpose
packages/core Domain logic only — no UI frameworks.
packages/cli commander + chalk CLI (skill-orchestrator binary).
packages/skill Bundled agent skill (SKILL.md).
docs/ MkDocs sources (mkdocs.yml, docs/docs/).
e2e/ Playwright tests.

Configuration

Merge order:

  1. ~/.skill-orchestrator/config.json
  2. ./.skill-orchestrator.json (workspace; cannot override secrets)
  3. SKILL_ORCHESTRATOR_* environment variables

Native dependencies

better-sqlite3 ships prebuilt binaries for common Node versions on macOS, Linux, and Windows. If compilation is required, install the platform toolchain (Xcode CLT on macOS, build-essential on Debian/Ubuntu, Visual Studio Build Tools on Windows).

License

Apache-2.0 — see LICENSE.

About

No description, website, or topics provided.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors