ywc-agent-toolkit

ywc-agent-toolkit

A collection of skills for Claude Code and Codex that automates the full development workflow — from planning and spec writing to code generation, review, and release.

한국어 | 中文 | 日本語 | Español

Supported Tools

Tool	Skills	Custom Agents	Install path
Claude Code	41	12	~/.claude/skills/, ~/.claude/agents/
Codex	41	7	~/.codex/skills/, ~/.codex/agents/

Prerequisites

Plugin marketplace and Codex plugin installation have no prerequisites — the tool handles everything automatically.

For the bash script fallback, the following must be installed before running install.sh:

Tool	Required for	Install
git	Cloning the repository	Pre-installed on most systems
bash ≥ 3.2	Running install.sh	Pre-installed on macOS / Linux
jq	Hook registration	brew install jq / apt-get install jq

At skill runtime (not required for installation):

Tool	Used by	Install
python3 ≥ 3.9	Skill runtime helpers: ywc-parallel-executor, ywc-finish-branch, ywc-merge-dependabot; Claude Code hooks require Python ≥ 3.11	Pre-installed on macOS 12.3+; brew install python3
gh CLI	PR-based and GitHub release skills/modes: ywc-handle-pr-reviews, ywc-spec-writer --from-pr/--from-prs, ywc-release-pr-list, ywc-create-pr, ywc-finish-branch PR mode, ywc-merge-dependabot, ywc-sequential-executor/ywc-parallel-executor, ywc-gen-testcase	brew install gh / cli.github.com

---

Installation

Via Claude Code plugin marketplace (recommended)

# Add as a marketplace source (one-time setup)
/plugin marketplace add yongwoon/ywc-agent-toolkit

After running the command, open the Plugin UI (Marketplaces tab) and install ywc-agent-toolkit from there. Skills and Claude Code agents are installed automatically — no cloning or bash required.

Via Codex CLI plugin directory

This repository follows the same multi-harness packaging pattern used by projects such as Superpowers: Claude Code metadata lives under .claude-plugin/, while Codex metadata lives under .codex-plugin/. The Codex source of truth is codex/skills. The repo-scoped Codex marketplace catalog at .agents/plugins/marketplace.json exposes a generated plugin package at plugins/ywc-agent-toolkit, whose skills/ directory is produced from codex/skills by bash scripts/sync-codex-plugin.sh and checked by bash scripts/validate.sh.

This makes ywc-agent-toolkit installable from Codex after adding this repository as a plugin marketplace source, but does not mean it is listed in the official OpenAI-curated marketplace.

Add this repository as a Codex plugin marketplace source:

codex plugin marketplace add yongwoon/ywc-agent-toolkit

If the marketplace was already added, refresh its Git snapshot first:

codex plugin marketplace upgrade ywc-agent-toolkit

Then install directly from the configured marketplace:

codex plugin add ywc-agent-toolkit@ywc-agent-toolkit

Or open the plugin directory:

codex
/plugins

Inside the interactive Codex session, choose the YWC Agent Toolkit marketplace tab, search for ywc-agent-toolkit, then choose Install plugin.

Via Codex App Plugins sidebar

In the Codex App, open Plugins from the sidebar, choose the YWC Agent Toolkit source, search or browse for ywc-agent-toolkit, confirm the plugin source is yongwoon/ywc-agent-toolkit, then install it from the plugin details view.

If marketplace source installation is unavailable in your environment, use the bash fallback below.

Maintainer workflow for Codex skills

Edit Codex skills in codex/skills. Do not edit plugins/ywc-agent-toolkit/skills as the primary source; it is the generated marketplace package used by codex plugin add.

Install repository Git hooks once so Codex marketplace packaging stays in sync automatically:

bash scripts/install-git-hooks.sh

With the hooks installed, commits that stage codex/skills changes run bash scripts/sync-codex-plugin.sh, stage the generated plugins/ywc-agent-toolkit package, and then run bash scripts/validate.sh. Pushes that include Codex skill or package changes also run the stale-package check and validation.

If hooks are not installed, run the same commands manually before committing:

bash scripts/sync-codex-plugin.sh
bash scripts/validate.sh