| name | mcs-init |
| description | Use this skill to start a new MCS agent project. Creates the folder structure in Build-Guides/, copies template files, and detects the intake path (SDR documents, wizard, or manual). Use when the user says 'new project', 'start a build', or provides intake documents. |
MCS Project Initializer
Create a new project folder and detect the intake path.
Input
Provide project name:
Process
Step 1: Create Project Folder
Build-Guides/[ProjectName]/
Step 2: Detect Intake Path
Check what's already in the folder:
Path A: SDR files found (.docx, .md, .pdf files that look like customer docs)
Found SDR files in Build-Guides/[ProjectName]/:
- [list files]
Next step: Run `/mcs-research ProjectName` to identify agents and research components
If .docx files exist, convert them to .md using pandoc:
pandoc "file.docx" -t gfm -o "file.md"
Note: pandoc is typically at %LOCALAPPDATA%\Pandoc\pandoc.exe — resolve via where pandoc or gcm pandoc.
Path B: No SDR files, start from scratch
No template needed — /mcs-research will create agentspec.json during Phase A (agent identification).
Guide the user to describe the agent or upload docs, then run research.
Step 3: Guide User
If SDR files detected:
## Project Initialized: [ProjectName]
**Location:** Build-Guides/[ProjectName]/
**SDR Files Found:**
- [list of converted .md files]
**Workflow:**
1. (Optional) Run `/mcs-context [CustomerName]` → Pull M365 history via WorkIQ
2. Click **Research** or run `/mcs-research [ProjectName]` → Read docs, identify agents, research components, enrich agentspec.json + generate evals
3. Click **Build** or run `/mcs-build [ProjectName] [agentId]` → Build in MCS
4. Click **Evaluate** or run `/mcs-eval [ProjectName] [agentId]` → Run tests
If starting from scratch:
## Project Initialized: [ProjectName]
**Location:** Build-Guides/[ProjectName]/
**Files Created:**
- (agentspec.json will be created when you run /mcs-research)
**Workflow:**
1. (Recommended) Run `/mcs-context [CustomerName]` → Pull M365 history via WorkIQ
2. Click **Research** or run `/mcs-research [ProjectName]` → Read docs, identify agents, research components, enrich agentspec.json + generate evals
3. Click **Build** or run `/mcs-build [ProjectName] [agentId]` → Build in MCS
4. Click **Evaluate** or run `/mcs-eval [ProjectName] [agentId]` → Run tests
Output
Creates project folder, detects intake path, and guides user to next step.
