/setup

Full system setup and configuration for OptimalOS.

170 stars

byMiosa-osa

View on GitHub Installation ↓

Best use case

/setup is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Full system setup and configuration for OptimalOS.

Teams using /setup should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/setup/SKILL.md --create-dirs "https://raw.githubusercontent.com/Miosa-osa/canopy/main/operations/cognitive-os/skills/setup/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/setup/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How /setup Compares

Feature / Agent	/setup	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Full system setup and configuration for OptimalOS.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# /setup

Full system setup and configuration for OptimalOS.

## What It Does
Initializes or reconfigures the OptimalOS system:
1. Verifies engine compilation and database
2. Runs full reindex of all markdown files
3. Validates topology.yaml configuration
4. Checks all 12 node folders exist with context.md
5. Verifies rhythm/ folder structure
6. Runs health diagnostics
7. Reports system status

## Usage
```
/setup                          # Full system setup
/setup --reindex                # Reindex only
/setup --validate               # Validate only (no changes)
```

## Engine Commands Used
```bash
cd engine && mix compile --force
cd engine && mix optimal.index
cd engine && mix optimal.stats
cd engine && mix optimal.health
cd engine && mix optimal.l0
```

## When to Use
- First time setup
- After major file reorganization
- After engine code changes
- When system feels broken

## Command