init

Create the .saga/ directory layout for epic and story workflows.

13|1|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/Roeia1/SAGA --skill init-roeia1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/Roeia1/SAGA/tree/main/plugin/skills/init
Command: npx skills add https://github.com/Roeia1/SAGA --skill init-roeia1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the scaffolding of the SAGA workspace by initializing the .saga/ directory with a standard layout for epic and story workflow management.

Core Features & Use Cases

  • Creates the standard SAGA directories: .saga/epics, .saga/stories, .saga/archive, and .saga/worktrees.
  • Updates .gitignore to exclude git worktrees, keeping the repository clean.
  • Idempotent: detects an existing structure and reports status without reinitializing.

Quick Start

Run the init operation to scaffold the SAGA .saga/ directory structure in your project.

Frequently Asked Questions about init

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

FAQPage Schema
How do I scaffold a SAGA workspace directory for epic and story workflow?

To scaffold a SAGA workspace, run the init operation to create the .saga/ directory structure with epics, stories, archive, and worktrees folders for managing your project workflow.

What is the standard directory layout for a SAGA project workspace?

The standard SAGA workspace layout consists of the .saga/ directory containing four subfolders: epics, stories, archive, and worktrees, which organize project workflow management files.

How do I ensure git ignores worktrees in my SAGA project repository?

To ensure git ignores worktrees, the init skill automatically updates your .gitignore file to safely exclude the .saga/worktrees directory, keeping your repository clean.

Can I reinitialize the .saga directory if it already exists?

Yes, you can safely reinitialize the .saga directory because the operation is idempotent; it detects existing folder structures and reports status without overwriting or reinitializing.

Do I need Bash to set up the SAGA workspace folders?

Yes, you need Bash and standard filesystem utilities to create directories, check existing structures, and update .gitignore safely when setting up the SAGA workspace folders.

When should I initialize the .saga workspace in my project?

You should initialize the .saga workspace at the start of new projects to set up the standardized directory layout required for managing epics, stories, and archives.