Does this work on Windows?

Yes, the skill automatically detects if you are on Windows and configures the environment to use PowerShell scripts instead of standard shell scripts.

What tools are required for this skill to work?

You need to have Git, spec-kit (specify), and beads (bd) installed on your system. The skill will check for these prerequisites before proceeding.

What is the purpose of CLAUDE.md in this setup?

CLAUDE.md acts as a central instruction file for Claude Code, utilizing the beads workflow to provide domain-specific guidance and project-wide context.

Will it overwrite my existing CLAUDE.md file?

No. If a CLAUDE.md file is detected, the skill will stop and ask for your permission to overwrite, rename, or skip the step.

Can I prevent the skill from automatically committing changes?

Yes, you can use the --no-commit argument to initialize the repository without being prompted to create a git commit.

SpecBeads Repository Initializer

Name: SpecBeads Repository Initializer
Author: lumberbarons

bylumberbarons

0•

Developer Tools

Initializes git repositories with spec-kit and beads configuration to optimize them for Claude Code workflows.

The SpecBeads Repository Initializer streamlines the setup process for developers looking to leverage spec-kit and beads within their AI-assisted development environment. This skill automates prerequisite verification, handles cross-platform shell script configuration for macOS, Linux, and Windows, and manages the creation of the CLAUDE.md workflow file. It ensures that your project is correctly structured for AI agent interactions, allowing for more precise instruction following and standardized development patterns.

Key Features

01Automated validation of Git, spec-kit, and beads environments

02Platform-aware initialization for shell (sh) or PowerShell (ps) scripts

03Interactive CLAUDE.md setup and overwrite protection

04Integrated Git commit automation for configuration changes

050 GitHub stars

06Zero-config setup for the beads workflow instruction system

Use Cases

01Quickly configuring existing projects to support the specify/beads workflow

02Standardizing AI interaction patterns across a multi-repo engineering team

03Bootstrapping a new repository for AI-augmented development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lumberbarons/lumber-mart init

For use in Claude.ai and ChatGPT

Download Skill