sg-setup

Copy super-gsd hook and skill files into the current project workspace.

2|Updated May 15, 2026
One-click install
npx skills add https://github.com/gyuha/super-gsd --skill sg-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sg-setup
Source: https://github.com/gyuha/super-gsd/tree/main/.agents/skills/sg-setup
Command: npx skills add https://github.com/gyuha/super-gsd --skill sg-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Projects that use super-gsd can fail or become inconsistent when the required hook and skill files are not copied into the local workspace, especially in-session setups for Codex/Gemini where a CLI installer cannot be run.

Core Features & Use Cases

  • Automated in-session installation: Copies the required super-gsd hook files and the relevant /.agents/skills/ skill stubs into the current project root using AI Read/Write tools.
  • Environment-aware configuration: Detects Codex vs Gemini context and optionally includes .gemini/settings.json (or includes it explicitly with --gemini).
  • Safe conflict handling: Skips existing files by default and overwrites only when --force is provided.

Use case: You start a new repository session in Codex/Gemini and want super-gsd commands (e.g., sg-start, sg-plan, sg-execute) to work immediately without running npx or any external Node tooling, even if some files already exist.

Quick Start

Copy the super-gsd setup files into your current project by running sg-setup in your Codex/Gemini session, optionally adding --gemini to also install Gemini settings and --force to overwrite existing files.

Frequently Asked Questions about sg-setup

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

FAQPage Schema
How do I install super-gsd hooks without running Node or CLI tools?

Installing super-gsd hooks without Node or CLI execution is done by running sg-setup in your Codex or Gemini session, which copies hook and skill files into the workspace using AI Read/Write tooling.

How do I set up super-gsd commands in a Gemini or Codex project session?

Setting up super-gsd commands in a Gemini or Codex session involves running sg-setup, which detects the environment and optionally includes .gemini/settings.json when the --gemini flag is applied.

Do I need Node or npm installed to set up super-gsd orchestration files?

No, you do not need Node or npm installed to set up super-gsd orchestration files. sg-setup handles in-session installation by copying files via AI Read/Write tools without external Node tooling.

What happens if super-gsd hook files already exist in my project workspace?

If super-gsd hook files already exist in your project workspace, sg-setup skips them by default to ensure conflict-safe writes, and overwrites existing files only when the --force flag is provided.

Why are my super-gsd commands like sg-start and sg-plan not working in my session?

Super-gsd commands like sg-start and sg-plan may not work if required hook and skill files are missing from the local workspace, which sg-setup resolves by copying them into the project root.