Skip to content
codemerxPublic

About

Teams AI skills manager supporting sharing and permissions

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Guild Book logo: a closed book with a ribbon and two linked rings on its cover

Guild Book

One library of AI skills for your whole team, in every AI tool.
Keep your team's skills and instructions in git. The app links them into Claude Code, Codex, Cursor and more.

License: Apache NON-AI 2.0 Platforms: macOS, Windows, Linux Status: first release

A short demo: one library of skills, linked into Claude Code and Codex, and the plan the app shows before it changes anything.

Why

Every AI coding tool reads skills from its own folder. A team that shares skills ends up copying files by hand, and the copies drift apart. A skill that one person improves never reaches the others.

Guild Book fixes this. Your team keeps its skills (SKILL.md) and instructions (AGENTS.md) in one git repository, the library. The app brings the library to each computer and links it into the folders that your AI tools read. When someone improves a skill, everyone gets it with one pull.

Why the name? A guild keeps what it knows about its craft in one shared book. Guild Book does the same for the AI skills of your team.

What it does

  • One library, every tool. Skills and instructions live in one place. The app links them into each tool's own folder with symbolic links, so there are no copies to keep in sync.
  • Your git, your files. GitHub, GitLab, Gitea or any git server, over HTTPS or SSH. The files stay in open formats (Agent Skills and AGENTS.md). There is no cloud service to sign up for, and no lock-in.
  • A git client made for skills. See what changed, commit, pull, push, branch, stash and resolve conflicts side by side. Nothing changes on your computer until you confirm a preview.
  • Edit and import. A form for the name, description and tags, a rich text editor, and the raw file when you want it. Bring skills from an old repo, a folder or a zip, and review each one before it is added.
  • Skills where you need them. Make a skill available everywhere, or only in the code repos that need it, with tags and lasting rules. One overview shows where every skill goes.
  • Shared instructions. A company's AGENTS.md reaches each tool's global instructions. Your own text is never touched.
  • Made for teams. Roles follow your git host. Open a change request when the main branch is protected, sign commits where the host requires it, welcome new people with an invite link, and join as many libraries as you need.
  • Safe by design. The app never overwrites your own files. It asks first when a name is taken, scans what you push for secrets, reads only the folders you give it, and sends no telemetry. "Needs attention" and the Doctor explain every problem in plain words.

See it work

Joining a library from GitHub: paste the address, approve a short code in the browser, choose the folder and the tools, and finish.
Join a library from GitHub. Paste the address. Approve a short code in your browser. The app asks for no password and no ID.

An AI tool improves a skill. The app shows the change, the person commits it and pushes it.
Share a change. An AI tool improves a skill. You review the change, commit and push.
Two people changed the same line. The app shows both versions and the person decides.
Resolve a conflict. Two people changed the same line. The app shows both versions.
Adding code repos, accepting a tag suggestion and reading the overview.
Skills in your repos. Tag a skill, and it goes only into the repos that need it.
The Needs attention page: a taken name, with the choices the person has.
Never overwritten. If a name is taken, the skill waits and you decide.
More pictures
Every skill and the AI tools that it is linked into.
Skills. Where each skill is linked on this computer.
The overview: every skill, and where it is available.
Overview. Every skill, and where it is available.
The skill editor with its details form.
Editor. A form for the details, and a rich editor for the text.
The Changes page with a diff and a commit message.
Changes. See exactly what changed before you commit.
The Tools page: the AI tools found on this computer, and where the links go.
Tools. The AI tools found on this computer, and where the links go.
The Instructions page: a company's instructions and the tools that get them.
Instructions. A company's rules, and the tools that get them.

How it works

  Your team's git repository           Guild Book                Your AI tools
  ┌────────────────────────┐        ┌───────────────┐        ┌───────────────────────────┐
  │ skills/acme-review/    │  pull  │ keeps a clone │  links │ ~/.claude/skills/         │
  │ skills/acme-deploy/    │ ─────▶ │ shows changes │ ─────▶ │ ~/.agents/skills/         │
  │ AGENTS.md              │ ◀───── │ asks first    │        │ your code repos           │
  └────────────────────────┘  push  └───────────────┘        └───────────────────────────┘
  1. Join. Open your team's invite link, or paste the git address of the library. Choose your tools and your code repos. The app shows a summary of every change before it makes any.
  2. Use. Each skill appears in the folders your AI tools read. The app checks the server for new changes every three minutes.
  3. Improve. Edit a skill, in the app or through an AI tool. Review the change, commit and push. Your team pulls it.

Works with

Claude Code · Codex · Cursor · GitHub Copilot CLI · Gemini CLI · OpenCode · Goose · Amp · Roo Code · Factory (Droid) · Kimi Code · Cline · Kilo Code · Kiro · Qwen Code · Windsurf (instructions only)

The folders come from each tool's documentation. The list is a catalog, and you can add any other agent as a custom tool. Help wanted: the Doctor shows "Not verified" for a tool until someone has tested it end to end. Claude Code is tested so far. Open an issue when you test another tool.

Install

There are no installers yet. Build the app from source. You need Node 24 and pnpm 12.

corepack enable pnpm
pnpm install
pnpm build:prod # the app for your system, in apps/desktop/release/
pnpm dev        # a development build, in a fresh and separate folder

Privacy

The app reads only the folders you give it: the library, your tools' folders and your code repos. It sends no telemetry. The daily update check asks GitHub for two small files: the update feed and the tool catalog. Like every browser request, it holds the app's name and version, your system type and your language, and GitHub sees your IP address. It holds no ID, no name and no data from your library. A problem report is saved only when you choose, and you read the whole text first. It has no file contents and no secrets.

Status

This is the first public version (0.1). The app is tested on macOS (Apple silicon) and Linux (arm64). It has not run on a real Windows machine yet. Please open an issue when something is wrong.

Contributing

Issues and pull requests are welcome. Good first areas: testing more AI tools and testing on Windows.

License

Guild Book is licensed under the Apache NON-AI License, Version 2.0. It is the Apache License 2.0 with one added condition: you may not use the software to create an AI training dataset, or in any way that contributes to the training or development of an AI model or algorithm, unless the contributor gives you written permission.

Files from other projects keep their own licenses. See NOTICE.

Built with Electron, React, TypeScript and dugite (git).

About

Teams AI skills manager supporting sharing and permissions

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages