К основному содержанию
плагин CX Codex

spellbook-skills — плагин для Claude Code: что делает и как установить

Плагин spellbook-skills для Claude Code и Codex объединяет 10 скиллов и хук контекста для работы с git worktree, ревью, коммитами и PR.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install spellbook-skills@awesome-codex-plugins
Открыть на GitHub

Что делает spellbook-skills

Плагин объединяет повседневные сценарии разработки в отдельные команды с префиксом /spellbook-skills:. Внутри собраны скиллы для изоляции задач через git worktree с проверкой сборки без запуска тестов, оформление атомарных коммитов по правилам Conventional Commits и публикация пулл-реквестов в GitHub или GitLab.

Отдельные модули закрывают архитектурные задачи: цикл TDD по Кенту Беку, правила DDD для Java и Spring Boot, синхронизацию спецификаций с YApi через Python-скрипты и аудит инструкций AGENTS.md. Встроенный хук Project Context Hook автоматически передаёт правила из каталога .project_context/ в сессии и субагенты.

Для работы плагина в Claude Code требуется версия от 1.0.33, а при разборе комментариев в GitLab понадобится установленная консольная утилита glab.

Какие задачи решает

  • создавать изолированные git worktree под задачи без прогона тестов
  • генерировать атомарные коммиты по стандарту Conventional Commits
  • разбирать комментарии к Merge Request в GitLab через утилиту glab
  • проектировать слои и доменные модели для сервисов на Java и Spring Boot

Примеры запросов агенту

  • /spellbook-skills:using-git-worktrees-lite
  • /spellbook-skills:git-commit
  • /spellbook-skills:reviewing-gitlab-mr-comments

Как установить spellbook-skills

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install spellbook-skills@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о spellbook-skills

Как установить spellbook-skills в Claude Code?

Выполните в консоли Claude Code по очереди две команды: сначала /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install spellbook-skills@awesome-codex-plugins.

Что делает плагин spellbook-skills?

Он добавляет 10 готовых инженерных скиллов для управления ветками, TDD, генерации коммитов и PR, а также хук для передачи проектного контекста агенту.

Требуется ли Python для работы компонентов плагина?

Установщику ролей агентов для Codex Python не нужен — он работает через shell или PowerShell. Но скилл yapi-skill вызывает Python-скрипты для синхронизации OpenAPI-спецификаций.

Исходный текст

spellbook-skills · MIT
# Spellbook Skills

<p align="center">
  <img src="./assets/banner.png" alt="Spellbook Skills - reusable skills, hooks, TDD workflows, and reviewer agents for daily engineering workflows" width="100%">
</p>

<p align="center">
  <a href="./LICENSE"><img alt="License MIT" src="https://img.shields.io/badge/license-MIT-c99a43"></a>
  <img alt="Claude Code plugin" src="https://img.shields.io/badge/Claude%20Code-plugin-c65c54">
  <img alt="Codex plugin" src="https://img.shields.io/badge/Codex-plugin-16a394">
  <img alt="GitHub Copilot CLI plugin" src="https://img.shields.io/badge/GitHub%20Copilot%20CLI-plugin-5578ff">
  <img alt="Skills 10" src="https://img.shields.io/badge/skills-10-111820">
</p>

Personal skills library for daily workflows, packaged as Claude Code, GitHub Copilot CLI, and Codex plugins.

[中文说明](./README.zh-CN.md)

## Overview

Spellbook Skills is a collection of agent skills for daily development workflows — covering test-driven development, git worktrees, code review, API querying, DDD architecture guidance, and more. It also ships a **Project Context Hook** that injects framework-agnostic project-memory conventions into the agent at session and subagent start (see the [Project Context Hook](#project-context-hook) section below).

<p align="center">
  <img src="./assets/workflow.png" alt="Spellbook Skills workflow coverage across TDD loops, git flow, review loops, YApi docs, Java DDD, Project Context Hook, and AGENTS.md" width="100%">
</p>

## Requirements

- Claude Code v1.0.33+
- GitHub Copilot CLI for Copilot plugin, skill, and agent usage
- Codex CLI for Codex plugin and Codex agent role usage

## Install For Claude Code

Interactive Claude Code commands:

```
/plugin marketplace add yyykf/spellbook-skills
/plugin install spellbook-skills@spellbook-marketplace
/reload-plugins
```

Shell commands:

```bash
claude plugin marketplace add yyykf/spellbook-skills
claude plugin install spellbook-skills@spellbook-marketplace --scope user
```

The marketplace name is `spellbook-marketplace`, as declared by `.claude-plugin/marketplace.json`.

## Install For GitHub Copilot CLI

GitHub Copilot CLI can install the same remote marketplace and uses the Claude-compatible `.claude-plugin/plugin.json`, including both `skills/` and `agents/`.

```bash
copilot plugin marketplace add yyykf/spellbook-skills
copilot plugin install spellbook-skills@spellbook-marketplace
```

To update later:

```bash
copilot plugin marketplace update spellbook-marketplace
copilot plugin update spellbook-skills@spellbook-marketplace
```

The plugin provides the shared skills plus the reviewer agents declared in `.claude-plugin/plugin.json`.

## Install For Codex

Install the Codex plugin marketplace and plugin:

```bash
codex plugin marketplace add yyykf/spellbook-skills
codex plugin add spellbook-skills@spellbook-marketplace
```

Codex loads this plugin's skills through the plugin system, but custom reviewer agents must be installed separately as Codex agent role TOML files.
The installer uses only shell/PowerShell plus `curl` or `Invoke-WebRequest`; no Python runtime is required.

Project-scoped install, recommended for a single repository:

```bash
script="$(mktemp)"
trap 'rm -f "$script"' EXIT
curl -fsSLo "$script" https://raw.githubusercontent.com/yyykf/spellbook-skills/main/scripts/install-codex-agents.sh
bash "$script"
```

User-scoped install, available across repositories:

```bash
script="$(mktemp)"
trap 'rm -f "$script"' EXIT
curl -fsSLo "$script" https://raw.githubusercontent.com/yyykf/spellbook-skills/main/scripts/install-codex-agents.sh
bash "$script" --scope user
```

From a local checkout:

```bash
./scripts/install-codex-agents.sh --scope project
```

Windows PowerShell:

```powershell
$script = Join-Path $env:TEMP "install-codex-agents.ps1"
Invoke-WebRequest https://raw.githubusercontent.com/yyykf/spellbook-skills/main/scripts/install-codex-agents.ps1 -OutFile $script
powershell -NoProfile -ExecutionPolicy Bypass -File $script -Scope project
```

From a local checkout on Windows, `scripts/install-codex-agents.cmd` and `scripts/install-codex-agents.bat` are thin PowerShell wrappers.

The installer writes namespaced Codex roles under `agents/spellbook`:

- Project scope: `./.codex/agents/spellbook/*.toml`
- User scope: `${CODEX_HOME:-$HOME/.codex}/agents/spellbook/*.toml`

It does not overwrite existing files unless `--force` or `-Force` is provided.

## Usage

After installation, skills are namespaced by the plugin name:

```
/spellbook-skills:<skill-name>
```

## Skills

| Skill | Description |
| --- | --- |
| `using-git-worktrees-lite` | Create a worktree from the current branch with build/compile verification only (no tests) |
| `finishing-a-development-branch-lite` | Use build/compile verification as the completion gate, then merge/PR/keep/discard and clean up the worktree |
| `reviewing-gitlab-mr-comments` | Review GitLab MR comments via glab, summarize feedback, and propose a checklist or plan before execution |
| `yapi-skill` | Read and write YApi without running an MCP server: search interfaces, fetch interface details, and sync (upsert) one interface's docs from an OpenAPI contract via Python scripts (dry-run by default) |
| `simplify` | Review changed code for reuse, quality, efficiency, and altitude (root-cause depth) with four parallel review passes, then fix issues found. Codex uses the optional namespaced reviewer agents installed above. |
| `ddd-best-practices` | DDD architecture best practices for Java/Spring Boot — layering decisions, domain modeling, code templates, test strategy, review checklists, and MVC-to-DDD migration |
| `test-driven-development` | Red-green-refactor TDD discipline with Kent Beck's Tidy First (structural vs behavioral changes) and a Canon test list; language-agnostic core, with per-language notes for Java/TS/Python/Go/Rust |
| `git-commit` | Prepare Git commits from the real diff: read repo rules first, choose atomic splits, run lightweight checks, and generate Conventional Commit messages. Emoji is opt-in via `--emoji` after `type(scope):` |
| `git-merge-request` | One-shot commit + push + create merge request, supporting both GitHub Pull Requests and GitLab Merge Requests with auto-detected platform and repo-template-aware descriptions |
| `agents-md-improver` | Maintain concise AGENTS.md-based project instructions: audit current guidance, capture session learnings, and migrate useful CLAUDE.md rules into shared agent instructions |

## Project Context Hook

An **optional** SessionStart/SubagentStart hook that injects framework-agnostic `.project_context/` "project memory" conventions into the agent at the start of every main session and subagent. It is an enhancement — not a required step for using the plugin skills.

- **Claude Code**: works automatically once the plugin is enabled, including subagent starts — nothing to install.
- **Codex 0.137.0+**: auto-loads this plugin's `hooks/hooks.json` once the plugin is enabled, including subagent starts. Run `/hooks` once in Codex to trust it.
- **Copilot / older Codex fallback**: the installer defaults to Copilot personal instructions only; older Codex releases, or setups that explicitly want `~/.codex/hooks.json`, should opt into the fallback target. No clone required:

  ```bash
  script="$(mktemp)"
  trap 'rm -f "$script"' EXIT
  curl -fsSLo "$script" https://raw.githubusercontent.com/yyykf/spellbook-skills/main/scripts/install-project-context-hook.sh
  bash "$script" install                                      # Copilot (default)
  bash "$script" install --target auto                        # auto-detect older Codex fallback
  bash "$script" install --target codex-fallback              # older Codex fallback
  ```

  On Windows, use the `install-project-context-hook.ps1` installer instead (see the guide below). From a local checkout you can run `python3 hooks/install.py install`; for older Codex fallback you can first try `python3 hooks/install.py install --target auto`, or use `--target codex-fallback` when confirmed. For Codex fallback installs, start Codex afterward and run `/hooks` once to trust the hook.

See [docs/project-context-hook.md](./docs/project-context-hook.md) for the full guide — install / uninstall, per-platform differences, and design notes.

## Roadmap

- Add more workflow skills as they mature

## License

MIT. See [LICENSE](./LICENSE).

## Contributing

Issues and PRs are welcome. Keep changes small and focused.

## Acknowledgments

- This repository is adapted from [superpowers](https://github.com/obra/superpowers). Thanks to the original project for the skill framework and workflow design.
- The `ddd-best-practices` skill draws on ideas and practices from [xfg-ddd-skills](https://github.com/fuzhengwei/xfg-ddd-skills). Thanks for the inspiration.
- The `agents-md-improver` skill is inspired by Anthropic's [claude-md-management](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-md-management), adapted for AGENTS.md-compatible coding agents.
- The `test-driven-development` skill combines [superpowers](https://github.com/obra/superpowers)' TDD skill with Kent Beck's *Tidy First* and *Canon TDD* (from his *Augmented Coding: Beyond the Vibes* and *Canon TDD* posts). Thanks to both.

© code4j · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Git и GitHub» →
git-worktrees bobmatnyc Скилл git-worktrees для Claude Code помогает агенту изолировать ветки с помощью рабочих деревьев Git. Позволяет одновременно тестировать фичи, срочные хотфиксы и цепочки пулреквестов. CX Codex +1 368установок git-advanced-workflows Seth Hobson Скилл git-advanced-workflows для Claude Code правит историю Git, переносит коммиты, ищет источник ошибки и восстанавливает потерянные ветки. Охватывает сложное ветвление и подготовку PR. CX Codex +1 19 356установок context-mode-ops mksglu Скилл context-mode-ops для Claude Code запускает 10–20 параллельных субагентов для работы с GitHub-репозиторием. Включается при триаже issues, ревью PR и выпуске версий. CX Codex +1 1 700установок git-workflow-and-versioning addyosmani Скилл git-workflow-and-versioning, который наводит порядок в git-процессе: атомарные коммиты, короткоживущие ветки, сообщения, объясняющие зачем, а не что. Включается при любом изменении кода, которое агент готовит к коммиту. CX Codex +1 75 700установок agent-teams alinaqi Скилл agent-teams организует разработку через команду ИИ-агентов и обязательный TDD-конвейер. Подходит для проектов, где нужны проверки кода, безопасности и pull request. CX Codex +1 300установок workspace-isolation qodex-ai Скилл workspace-isolation для Claude Code создаёт отдельные Git worktree для параллельной работы с ветками. Изолирует изменения друг от друга. CX Codex +1 130установок

Из того же набора391

Весь набор →
board Плагин board даёт агенту терминальную доску для заметок, чек-листов и канбана. Всё лежит в обычных Markdown-файлах, которые вы открываете сами. CX Codex ★ 1 596звёзд репо steinwall Плагин steinwall для Claude Code и Codex задаёт лимиты расходов, останавливает опасные команды и проверяет расширения перед установкой. CX Codex ★ 1 596звёзд репо stark stark направляет агента через проектирование интерфейса до написания кода: от пользовательского потока и платформенных правил до проверки готового экрана. Подходит для новых интерфейсов и аудита существующих. CX Codex ★ 1 596звёзд репо stacked-prs Плагин stacked-prs делит большую ветку на несколько небольших PR, протаскивает правки из ревью по всей цепочке и мержит их по порядку зависимостей. CX Codex ★ 1 596звёзд репо spec-superflow Плагин spec-superflow ведёт задачу от уточнения области до проверенного результата через direct или planned workflow. Подходит для изменений, где нужны план, ревью и восстановление состояния. CX Codex ★ 1 596звёзд репо spec-driven Плагин spec-driven ведёт фичу через три фазы: требования в нотации EARS, дизайн и список задач. Дальше реализацию выполняет агент. CX Codex ★ 1 596звёзд репо sno-station-standalone Плагин sno-station-standalone для Claude Code и Codex проводит ревью кода, аудит требований и пишет тесты. Работает локально без аккаунтов, хуков и сторонних программ. CX Codex ★ 1 596звёзд репо skill-sync-publisher Плагин skill-sync-publisher для Claude Code и Codex проверяет локальный пакет SKILL.md и синхронизирует его с GitHub и каталогами навыков. Публикует одну версию в нескольких реестрах. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой