mixseek-skills_skill

Overview

This skill initializes a MixSeek workspace by creating the recommended directory structure and guiding the user to set the MIXSEEK_WORKSPACE environment variable. It prepares folders for agent/team configs, evaluators, judgments, presets, logs, and optional templates so you can start new MixSeek projects quickly. The process is safe for existing directories and avoids overwriting files.

How this skill works

The skill inspects the provided workspace path or reads MIXSEEK_WORKSPACE if set, then creates the required directory tree (configs/agents, configs/evaluators, configs/judgment, configs/presets, logs, templates). It can run an initialization script or perform manual mkdir operations. After creation it prints what was added and suggests how to persist the MIXSEEK_WORKSPACE environment variable.

When to use it

• Setting up a new MixSeek project workspace
• Onboarding a team with a shared config layout
• Preparing a local directory to store agents, evaluators, and presets
• Recovering a missing or incomplete MixSeek directory structure
• Converting an existing project directory into a MixSeek workspace

Best practices

• Confirm workspace path before running initialization; prefer using MIXSEEK_WORKSPACE env var
• Run with a user account that has write permission to the target directory
• Allow the tool to skip already-existing directories to avoid overwriting files
• Add export MIXSEEK_WORKSPACE=/path/to/workspace to your shell profile (.bashrc/.zshrc) for persistence
• Keep presets and templates under version control to share across the team

Example use cases

• New project: initialize workspace in current project directory and copy default presets
• Team setup: create shared configs/agents and configs/evaluators for collaborative testing
• Migration: convert an existing repo directory into a MixSeek workspace without altering existing files
• CI preparation: use the script in CI to ensure logs/ and configs/ directories exist before runs