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.