bootstrap

Bootstraps a new software project from scratch: copies template files, sets up README, initializes git, optionally creates a GitHub repo, then guides through idea refinement, design, spec, and full implementation planning.

Highlights

• One command, full setup — template copy, README, git init, and an optional GitHub remote (public or private) all happen before any design discussion starts
• Bundled, editable template — every new project is seeded from the template/ folder shipped with this skill; customize it once and every future /bootstrap picks up the change
• Guided design session — asks one question at a time to refine a raw idea into a concrete spec, rather than demanding a fully-formed plan up front
• Implementation-ready output — produces a detailed, phased plan in docs/plans/ plus a concise PHASES_SUMMARY.md, written for an engineer with zero context on the codebase
• Idea provenance tracked — every "Next Steps" enhancement idea in the generated plan is tagged [Keith's idea] or [Claude's idea], so it's clear whose thinking drove which direction

Usage

Invoke /bootstrap from a fresh project directory. It walks through:

1. Copies everything from the bundled template/ folder (next to SKILL.md) into the current directory and updates the project name throughout
2. Asks whether to create a GitHub remote, and if so, public or private (defaults: yes / private)
3. Asks what you're building, then generates a starter README.md (Description, Installation, Usage, License placeholders)
4. Initializes git, ensures .envrc is gitignored, commits, and pushes to the remote if one was requested
5. Enters a design session — one question at a time — until the idea is well-defined
6. Writes a full phased implementation plan to docs/plans/, plus a PHASES_SUMMARY.md quick-reference

Run /bootstrap --help (or just ask how to use it) for an in-chat explanation of the above, including where the bundled template lives.

Customizing the template

Every project bootstrapped with this skill is seeded from a single shared template/ folder bundled alongside SKILL.md (e.g. ~/.claude/skills/bootstrap/template/ in Claude Code). To change what new projects start with, edit, add, or remove files directly inside that template/ folder — there's no per-project override. Common additions: a house-style CLAUDE.md/AGENTS.md, default .claude/commands/, testing guidelines, or boilerplate config.

Installation

From the mackayi marketplace (recommended)

/plugin marketplace add keithmackay/mackayi
/plugin install bootstrap@mackayi

Claude Code

cp -r ~/.claude/skills/bootstrap/ ~/.claude/skills/bootstrap/

Already installed if this file is at ~/.claude/skills/bootstrap/. Invoke with /bootstrap.

Codex

Add an entry to your marketplace JSON (~/.agents/plugins/marketplace.json, create if absent):

{
  "name": "personal",
  "interface": { "displayName": "Personal Plugins" },
  "plugins": [
    {
      "name": "bootstrap",
      "source": { "source": "local", "path": "/path/to/bootstrap/" },
      "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
      "category": "Productivity"
    }
  ]
}

Antigravity

No special files needed — the root SKILL.md is natively compatible.

Global install (all workspaces):

cp -r /path/to/bootstrap/ ~/.gemini/antigravity/skills/bootstrap/

Workspace install (current project only):

cp -r /path/to/bootstrap/ .agents/skills/bootstrap/

Gemini CLI

Gemini CLI installs extensions from GitHub:

gemini extensions install https://github.com/<owner>/bootstrap

The skill is auto-discovered from GEMINI.md after installation.

Note: Gemini CLI requires the skill to be in a public GitHub repository. Local-only install is not directly supported.

Compatibility

Feature	Claude Code	Codex	Antigravity	Gemini CLI
Core skill	✅	✅	✅	✅
gh repo create (requires gh CLI)	✅	✅	✅	✅
Planning mode (EnterPlanMode)	✅	❌	❌	❌

Legend: ✅ Supported · ❌ Not supported

Platform Limitations (Codex, Antigravity, Gemini CLI)

EnterPlanMode is a Claude Code-specific tool. On other platforms, the agent will proceed with the design session inline rather than entering a distinct planning mode.

Contributing

This is a personal skill, but improvements are welcome — fork, branch, and open a pull request.

Changelog

See CHANGELOG.md for release history.

License

MIT

References

• Claude Code Skills: https://code.claude.com/docs/en/skills
• Codex Plugins: https://developers.openai.com/codex/plugins/build
• Antigravity Skills: https://antigravity.google/docs/skills
• Gemini CLI Extensions: https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md
• Agent Skills open standard: https://agentskills.io/home