| name | mcs-report |
| description | Use this skill to generate an export from agentspec.json without running a build. Produces a single self-contained HTML file with three tabs: Brief (design state), Evaluations (test sets and results), and How-To Guide (step-by-step MCS build instructions). Use when the user wants a summary, status update, or shareable document. |
MCS Report Generator
Generate a combined HTML export from agentspec.json at any project stage. Read-only — never modifies agentspec.json.
Input
/mcs-report {projectId} {agentId}
Reads from: Build-Guides/{projectId}/agents/{agentId}/agentspec.json — read-only, never modifies
Writes to: Build-Guides/{projectId}/agents/{agentId}/export.html
Step 1: Load and Validate agentspec.json
Read agentspec.json. If missing → STOP: "No agentspec.json found. Run /mcs-research first."
Check completeness — minimum required: business, agent, capabilities (at least 1). If missing → WARN (don't stop): "Some sections will be incomplete — {field} is empty."
Step 2: Generate HTML Export
Generate the self-contained HTML export by calling the server-side renderer:
node -e "
const path = require('path');
const { renderReport } = require('./app/lib/report');
const briefPath = path.resolve('Build-Guides/{projectId}/agents/{agentId}/agentspec.json');
const outPath = path.resolve('Build-Guides/{projectId}/agents/{agentId}/export.html');
renderReport(briefPath).then(html => {
require('fs').writeFileSync(outPath, html);
console.log('Export written:', outPath, '(' + (html.length / 1024).toFixed(1) + ' KB)');
}).catch(err => console.error('Export generation failed:', err.message));
"
The export is a single self-contained .html file with:
