claude-os/templates

Claude OS Templates

This directory contains all template files used when initializing a new project with Claude OS.

Directory Structure

templates/
├── commands/           # Slash command templates (symlinked to projects)
├── skills/             # Skill templates (symlinked to projects)
├── agents/             # Agent templates (project-specific)
├── project-files/      # Files created during project init
│   ├── CLAUDE.md.template
│   ├── .claude-os/
│   │   ├── config.json.template
│   │   ├── hooks.json.template
│   │   └── .gitignore
│   └── README.md
└── README.md          # This file

Template Variables

Templates use {{VARIABLE}} syntax for placeholders that get replaced during project initialization:

Common Variables

• {{PROJECT_NAME}} - Project name (e.g., "my-app")
• {{PROJECT_DESCRIPTION}} - Brief project description
• {{TECH_STACK}} - Technology stack (e.g., "Ruby on Rails, MySQL")
• {{DATABASE}} - Database system (e.g., "PostgreSQL", "MySQL")
• {{DEV_ENVIRONMENT}} - Dev environment (e.g., "Docker", "Local")
• {{CLAUDE_OS_URL}} - Claude OS server URL (default: http://localhost:8051)
• {{DOCS_PATHS}} - JSON array of documentation paths
• {{CREATED_AT}} - ISO timestamp of creation
• {{PROJECT_SPECIFIC_CONTENT}} - Custom project content
• {{DEVELOPMENT_GUIDELINES}} - Project-specific guidelines
• {{COMMON_TASKS}} - Common development tasks
• {{BUSINESS_RULES}} - Key business rules

How Templates Are Used

When running /claude-os-init:

1. Commands & Skills - Symlinked from templates/commands/ and templates/skills/ to project's .claude/ directory
2. Project Files - Copied from templates/project-files/ with variables replaced
3. Knowledge Bases - Created via API with project-specific names
4. MCP Configuration - Updated in ~/.claude/mcp-servers/ with new project

Adding New Templates

New Command Template

1. Create file in templates/commands/my-command.md
2. Add command logic
3. Will be automatically available after /claude-os-init

New Skill Template

1. Create directory in templates/skills/my-skill/
2. Add SKILL.md and any scripts
3. Will be automatically available after /claude-os-init

Updating CLAUDE.md Template

Edit templates/project-files/CLAUDE.md.template to add:

• New sections
• Updated workflow instructions
• Additional context

Changes will apply to NEW projects only. Existing projects keep their CLAUDE.md unchanged.

Consolidation Scripts

See the cli/ directory in this repository for scripts to:

• Move commands from ~/.claude/commands/ to templates/commands/
• Move skills from ~/.claude/skills/ to templates/skills/
• Update existing projects to use templates

For Coworkers

When you clone Claude OS and run ./install.sh, these templates are:

1. Registered with your Claude CLI
2. Available for new project initialization
3. Ready to use with /claude-os-init

Then cd to any project and run /claude-os-init to connect it to Claude OS!