Skip to content

TacoSkill/Skillbolt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Skillbolt

A universal skill ecosystem for AI agents.

Build once. Reuse everywhere. Run skills across Claude Code, Cursor, OpenClaw, and more.

๐ŸŽจ Works with any AI agent that supports skill/instruction files

Claude Code
Claude Code
Cursor
Cursor
Codex CLI
Codex CLI
Continue
Continue
OpenClaw
OpenClaw
+ Custom
Agents

๐Ÿ“– What is a Skill?

A Skill is a portable instruction file for AI agents. It defines triggers, workflows, and parameters:

---
name: git-commit-helper
description: Activate when user asks to "commit changes" or "create a commit"
triggers:
  - commit changes
  - create commit
---

## Workflow

1. Stage changes with `git add`
2. Generate commit message based on diff
3. Create commit with `git commit`

Skills are just markdown. Easy to write, easy to share, version-controlled with your code.


๐Ÿค” What Problem Does Skillbolt Solve?

Every time you use an AI coding assistant, you repeat the same instructions โ€” "follow conventional commits", "use our code style", "check for security issues"...

Your AI forgets. Every. Single. Time.

Skillbolt fixes this by turning your instructions into reusable Skills โ€” and then goes further with LLM-powered discovery and intelligent execution:


๐ŸŽฏ Create

Author skills once as portable markdown files. Works with Claude Code, Cursor, Codex, and more.

๐Ÿง  Discover

LLM-powered capability tree + intelligent search finds the right skills for any task automatically.

๐Ÿš€ Execute

Auto-generated DAG plans orchestrate multi-skill workflows with parallel execution and cost tracking.


โœจ Features

Skill lifecycle

  • โšก CLI-first workflow โ€” create, validate, package, and publish Skills
  • ๐Ÿงฌ Skill distillation โ€” extract reusable Skills from agent conversations
  • ๐Ÿ“ฆ Modular packages โ€” use the full stack or only what you need

Discovery & routing

  • ๐ŸŒณ Capability taxonomy โ€” organize hundreds of Skills into a navigable tree
  • ๐Ÿ” Intelligent retrieval โ€” fast matching with pruning + ranking across tree levels

Orchestration & visibility

  • ๐Ÿ“Š DAG planning โ€” compose Skills into parallelizable execution plans
  • ๐Ÿ–ฅ๏ธ Web dashboard โ€” run status, logs, and DAG viewer in real time
  • ๐Ÿพ OpenClaw sync โ€” share Skills across multi-channel agent surfaces

๐Ÿš€ Quick Start

1. Install

npm install -g @skillbolt/cli
Other package managers
pnpm add -g @skillbolt/cli    # pnpm
npx @skillbolt/cli --help      # npx (no install)

2. Configure

Set your LLM provider so Skillbolt can power intelligent features:

export LLM_API_KEY=sk-...                  # Your OpenAI or Anthropic key
export LLM_PROVIDER=openai                 # "openai" | "anthropic"
Optional: project-level config

Create .skillboltrc.json in your project root:

{
  "llm": { "provider": "openai", "model": "gpt-4o-mini" }
}

See Configuration Guide for all options.

3. Create Your First Skill

skill init my-skill --template standard --platform claude-code

4. Discover & Install Skills

skill search git                           # Browse marketplace
skill install github:skillbolt/git-master  # Install from GitHub

5. Validate

skill lint ./my-skill --fix

๐Ÿ“š Documentation

๐Ÿ“– Browse Full Documentation โ€” All guides, references, and architecture docs on GitHub

Getting Started

  • Installation Guide โ€” Prerequisites, setup & your first Skillbolt project
  • SKILL.md Format โ€” Skill file specification โ€” triggers, workflows, parameters & metadata
  • Command Reference โ€” Complete documentation for all 20+ CLI commands
  • Configuration โ€” Environment variables, .skillboltrc.json & LLM provider settings

Core Concepts

  • Runtime Intelligence โ€” Capability trees, intelligent search, DAG orchestration & visual dashboard
  • Capability Trees โ€” LLM-powered classification organizes hundreds of skills into navigable hierarchies
  • Intelligent Search โ€” Multi-level tree traversal with automatic pruning finds the best skills for any task
  • DAG Orchestration โ€” Compose skills into parallelizable execution plans from natural language descriptions
  • Skill Distillation โ€” Extract reusable skills from real AI conversation history

Architecture & Integration

  • API Reference โ€” Programmatic usage for building custom integrations and pipelines
  • Package Architecture โ€” 17 modular packages โ€” use the full CLI or pick individual components
  • OpenClaw Integration โ€” Sync and share skills across 13+ messaging channels via the OpenClaw gateway
  • Cross-Platform Support โ€” Write once, run on Claude Code, Cursor, Codex CLI, Continue & more

Development

  • Contributing โ€” Development setup, build instructions, testing & PR workflow
  • GitHub Issues โ€” Bug reports, feature requests & roadmap discussions
  • Discord Community โ€” Get help, share skills & connect with other developers

About

A universal skill ecosystem for AI agents.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published