spellbook-skills

Spellbook Skills

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

中文说明

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 start (see the Project Context Hook section below).

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:

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/.

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

To update later:

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:

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:

curl -fsSL https://raw.githubusercontent.com/yyykf/spellbook-skills/main/scripts/install-codex-agents.sh | bash

User-scoped install, available across repositories:

curl -fsSL https://raw.githubusercontent.com/yyykf/spellbook-skills/main/scripts/install-codex-agents.sh | bash -s -- --scope user

From a local checkout:

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

Windows 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