Skip to content

itamaker/skillforge

Repository files navigation

skillforge

All Contributors

skillforge is a Go CLI for drafting and scaffolding OpenClaw-ready skills from briefs, tool catalogs, and JSON specs.

It helps agent teams standardize skill packaging and bootstrap new skills without building a separate internal generator service.

skillforge social preview

Support

Buy Me A Coffee

Quickstart

Install

brew install itamaker/tap/skillforge
You can also download binaries from GitHub Releases.

Current release archives:

  • macOS (Apple Silicon/arm64): skillforge_0.2.0_darwin_arm64.tar.gz
  • macOS (Intel/x86_64): skillforge_0.2.0_darwin_amd64.tar.gz
  • Linux (arm64): skillforge_0.2.0_linux_arm64.tar.gz
  • Linux (x86_64): skillforge_0.2.0_linux_amd64.tar.gz

Each archive contains a single executable: skillforge.

First Run

Run:

skillforge

This launches the interactive Bubble Tea terminal UI.

You can still use the direct command form:

skillforge init -spec examples/skill.json -out /tmp/research-skill

Or draft a richer spec from a short brief plus a tool catalog:

skillforge draft -brief examples/brief.md -catalog examples/tools.json -out /tmp/research-skill.json

The generated directory includes:

  • SKILL.md
  • manifest.json
  • bin/README.md
  • examples/usage.md

Requirements

  • Go 1.22+

Run

go run .

Or run the non-interactive command directly:

go run . init -spec examples/skill.json -out /tmp/research-skill

Use -force if you want to overwrite an existing output directory.

Generate a spec first:

go run . draft -brief examples/brief.md -catalog examples/tools.json

Build From Source

make build
go build -o dist/skillforge .

What It Does

  1. Loads a compact JSON skill spec.
  2. Validates required fields such as name, description, and tools.
  3. Can draft a richer spec from a natural-language brief by retrieving relevant tools from a local catalog.
  4. Generates a portable skill folder with workflow, constraints, checks, docs, and manifest files.
  5. Produces output that can be moved into OpenClaw-style agent workspaces.

Notes

  • Use examples/skill.json as a starting point for new skill definitions.
  • Maintainer release steps live in PUBLISHING.md.

Contributors ✨

Zhaoyang Jia
Zhaoyang Jia

License

MIT

About

Draft and scaffold OpenClaw-ready skills from briefs, tool catalogs, and JSON specs.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors