setup

Configure Claude Code permissions and initialize workflow directories.

1|1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/zb-ss/claude-plugin-workflow --skill setup-zb-ss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/zb-ss/claude-plugin-workflow/tree/main/skills/setup
Command: npx skills add https://github.com/zb-ss/claude-plugin-workflow --skill setup-zb-ss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you set up the Claude Code workflow plugin by creating required state directories and updating Claude Code permissions so workflows can read/write planning and memory files without constant prompts.

Core Features & Use Cases

  • Workflow directory initialization: Creates the needed ~/.claude-workflows/* and ~/.claude/skills/* folder structure (including .gitkeep files) before any checks.
  • Settings and permission diagnostics: Inspects global and project settings JSON files to verify additionalDirectories and path-scoped allow rules for Edit/Write.
  • Actionable readiness report: Produces a clear status summary showing what exists, what permissions are missing, and what to change to fix workflow permission issues.

Quick Start

Ask Claude to run /workflow:setup to create the required directories and validate your Claude Code permissions.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I fix Claude Code workflow permission prompts for reading and writing state files?

Fix Claude Code permission prompts by validating global and project-level JSON settings files to verify additionalDirectories and path-scoped Edit/Write allow rules. This ensures workflows can read and write planning and memory files without constant manual approval requests.

What directories need to be initialized for Claude Code workflows to prevent read/write failures?

Required directories for Claude Code workflows include the ~/.claude-workflows/* and ~/.claude/skills/* folder structures. Initializing these paths with .gitkeep files prevents workflow state read/write failures during plugin execution.

How does Claude Code settings JSON validation work for troubleshooting workflow permissions?

Claude Code settings JSON validation inspects global and project configuration files to check additionalDirectories and path-scoped allow rules for Edit and Write operations. It produces an actionable readiness report showing existing permissions, missing rules, and required changes.

Can I use Claude Code swarm-mode features without environment variable checks?

Claude Code swarm-mode features rely on optional environment-variable checks during setup. Running directory initialization without these checks creates the base folder structure, but swarm-mode features may not activate properly without validating the required environment variables.

Why is my Claude Code workflow failing to write org-mode plans and memory files?

Claude Code workflow failures writing org-mode plans occur when required state directories are missing or path-scoped Edit/Write allow rules are absent in settings JSON. Running a setup diagnostic validates these paths and permissions to restore file writing capability.