wheel-init

Scaffold the wheel runtime with workflows and hook configuration.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill wheel-init
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wheel-init
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-wheel/skills/wheel-init
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill wheel-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize wheel within a repository to bootstrap runtime support, workflows, and hook integration, enabling consistent automation without manual setup.

Core Features & Use Cases

  • Creates .wheel/ runtime state directory and workflows/ directory with an example workflow.
  • Merges wheel hook configuration into .claude/settings.json and ensures idempotent operation even when run multiple times.
  • Provides commands to init and update, allowing re-synchronization after plugin updates.

Quick Start

Run the wheel init script to scaffold the wheel runtime and hook configuration in the current repository.

Frequently Asked Questions about wheel-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up wheel hooks and workflows in my repository?▼

To set up wheel hooks, run the wheel init script to scaffold a .wheel/ runtime state directory, a workflows/ directory with an example, and merge hook configuration into .claude/settings.json.

Do I need Node.js installed to initialize the wheel runtime?▼

Yes, Node.js is required to initialize the wheel runtime because the init and update scripts need a Node.js environment to execute and scaffold the repository structure.

What happens if I run the wheel init command multiple times?▼

Running the wheel init command multiple times is safe because the operation is idempotent, ensuring the .wheel/ directory and hook configuration merge without duplicating or corrupting existing setup.

How do I resynchronize wheel hook configuration after a plugin update?▼

To resynchronize wheel hook configuration after a plugin update, run the update command provided by the init script to re-merge settings into .claude/settings.json and refresh the runtime state.

Can I use wheel to bootstrap runtime automation without manual setup?▼

Yes, wheel bootstraps runtime support by automatically creating the .wheel/ state directory, workflows/ directory, and merging hook configuration into .claude/settings.json to enable consistent automation without manual setup.

Does the wheel init script require the wheel plugin to be installed first?▼

Yes, the wheel plugin must be installed before running the init script, as the script depends on the plugin to scaffold the wheel runtime and merge hook configuration into the repository.