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.