Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

init

verified

Initialize .saga/ directory structure for SAGA epic/story workflow

View on GitHub

Marketplace

saga

Roeia1/SAGA

Plugin

core

Repository

Roeia1/SAGA
7stars

plugin/skills/init/SKILL.md

Last Verified

February 4, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/Roeia1/SAGA/blob/main/plugin/skills/init/SKILL.md -a claude-code --skill init

Installation paths:

Claude
.claude/skills/init/
Powered by add-skill CLI

Instructions

# Initialize SAGA

Initialize the `.saga/` directory structure for epic/story workflow management.

## Tasks

| Subject | Description | Active Form | Blocked By | Blocks |
|---------|-------------|-------------|------------|--------|
| Check existing .saga | Check if `.saga/` already exists using `ls .saga/ 2>/dev/null`. If it exists, report to user: "SAGA is already initialized in this project. The .saga/ directory exists with:" followed by listing contents. Then stop - do not reinitialize. If it doesn't exist, proceed to create structure. | Checking existing structure | - | Create directory structure |
| Create directory structure | Create the SAGA directory structure using Bash: `mkdir -p .saga/epics .saga/archive .saga/worktrees`. This creates: (1) `.saga/epics/` - for epic definition files, (2) `.saga/archive/` - for completed/archived stories, (3) `.saga/worktrees/` - for git worktree isolation during story execution. | Creating directories | Check existing .saga | Update gitignore |
| Update gitignore | Check if `.gitignore` exists and if it already contains `.saga/worktrees/`. Use `grep -q '.saga/worktrees/' .gitignore 2>/dev/null` to check. If pattern NOT found: append the worktrees pattern to `.gitignore` using Edit tool. Add a newline, then the comment `# SAGA worktrees (git worktree isolation for stories)`, then `.saga/worktrees/` on the next line. If `.gitignore` doesn't exist, create it with just the comment and pattern. If pattern already exists, skip this step. | Updating .gitignore | Create directory structure | Report completion |
| Report completion | Report success to the user with the following message: "SAGA initialized successfully!" followed by "Created directory structure:" with bullet points for `.saga/epics/` (epic definitions), `.saga/archive/` (completed stories), `.saga/worktrees/` (worktree isolation, gitignored). Then show "Next steps:" section. | Reporting completion | Update gitignore | - |

## Completion Message

After initializati

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2858 chars