| name | init-workspace |
| description | Initialize a cogni-works workspace with shared foundation for marketplace plugins. Use this skill whenever someone asks to create, set up, scaffold, or initialize a workspace — including phrases like "set up my workplace", "get started with cogni", "create a new project workspace", or any mention of workspace initialization. Also trigger when someone runs a fresh plugin install and needs the shared foundation that plugins depend on. |
| version | 0.2.0 |
Init Workspace
A cogni-works workspace is the shared foundation that all marketplace plugins depend on. It centralizes environment configuration, theme storage, and plugin registration so that plugins can find each other and share resources. Without a workspace, plugins operate in isolation and can't resolve paths or discover themes.
Before You Start
Run the dependency checker — it returns JSON so you can parse the result and tell the user exactly what's missing:
bash ${CLAUDE_PLUGIN_ROOT}/scripts/check-dependencies.sh
Required: jq, python3, bash 3.2+. If required dependencies are missing, show the user what to install before continuing. Optional dependencies (curl, git, bc) are fine to skip.
Initialization Flow
1. Where and Whether
Ask the user where to create the workspace. Default to the current working directory.
If .workspace-config.json already exists at the target, this workspace was already initialized. Suggest update-workspace instead — re-initializing would overwrite their configuration.
2. Discover Plugins
Scan the marketplace cache for installed cogni-* plugins:
bash ${CLAUDE_PLUGIN_ROOT}/scripts/discover-plugins.sh
The script returns JSON with each plugin's name, version, path, and computed environment variable names. Present the list to the user so they can confirm, add, or remove plugins before proceeding. This matters because the plugin list determines which environment variables get generated — missing a plugin here means it won't be wired up.
3. Gather Preferences
Use AskUserQuestion to collect:
- Language — EN or DE. This controls which behavioral output-style anchors get installed, affecting how Claude communicates in this workspace.
- Plugin confirmation — Show discovered plugins, let the user adjust.
- Tool integrations — Obsidian, VS Code, other. This gets stored in the config so tool-specific plugins know what to set up later.
4. Generate the Workspace
This is the core step. Run the settings generator with the confirmed inputs:
bash ${CLAUDE_PLUGIN_ROOT}/scripts/generate-settings.sh \
--target "${TARGET_DIR}" \
--language "${LANGUAGE}" \
--plugins "${PLUGIN_LIST_JSON}"
The script creates three files:
.claude/settings.local.json — Environment variables that Claude Code auto-injects. This is the single source of truth for plugin paths..workspace-env.sh — Same variables exported for non-Claude contexts (Obsidian Terminal, VS Code tasks, CI/CD)..workspace-config.json — Workspace metadata (version, language, plugin list, timestamps).
It also creates data directories for each registered plugin under the workspace root.
Pass the plugins argument as either a JSON string or a path to a JSON file containing the plugin array from the discovery step.
5. Install Output Styles and Theme Template
Copy the language-appropriate output-style file. These files contain behavioral anchors that shape Claude's communication patterns in this workspace:
cp "${CLAUDE_PLUGIN_ROOT}/assets/output-styles/workspace-${LANGUAGE}.md" \
"${TARGET_DIR}/.claude/output-styles/"
Create the output-styles directory first if needed. Then copy the theme template:
cp -r "${CLAUDE_PLUGIN_ROOT}/themes/_template/" \
"${TARGET_DIR}/cogni-workspace/themes/_template/"
The template gives users a starting point for creating custom themes that visual plugins consume.
6. Mention Tool-Specific Setup
If the user indicated they use Obsidian or VS Code and relevant plugins are installed (cogni-obsidian, etc.), let them know those plugins have their own setup steps they can run separately. Don't call other plugins' scripts — each plugin manages its own setup.
7. Summarize
Show what was created in a compact format:
- Workspace path
- Registered plugins with their environment variable names
- Language setting
- Next steps: install themes, configure tool integrations, explore plugin capabilities
Error Handling
If any script returns "success": false in its JSON output, read the data.error field and relay it to the user. Don't continue past a failed step — the workspace would be in an incomplete state.
If generate-settings.sh fails partway through, clean up by removing any partially created files before reporting the error.
