construct-workspace-validate

Validates workspace file formats, connection consistency, and orphan references via the CONSTRUCT MCP server.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/mabstruct/construct --skill construct-workspace-validate-mabstruct
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: construct-workspace-validate
Source: https://github.com/mabstruct/construct/tree/main/CONSTRUCT-CLAUDE-impl/claude/skills/construct-workspace-validate
Command: npx skills add https://github.com/mabstruct/construct --skill construct-workspace-validate-mabstruct

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Knowledge workspaces accumulate broken references, malformed files, and orphaned connections over time. This Skill audits an existing CONSTRUCT workspace for integrity issues and produces a structured report of errors and warnings so problems can be fixed before they corrupt downstream knowledge work. ## Core Features & Use Cases - Post-write audit: Checks files already persisted on disk for cross-file consistency, governance compliance, and graph integrity via the MCP construct_validate tool. - Structured reporting: Formats results into a validation report separating errors from warnings, with an overall PASS/FAIL status. - Clear boundary with pre-write validation: Complements the validate_*_write() helpers that reject invalid payloads before they land on disk. - Use Case: After a large curation session, ask the agent to validate the workspace; it calls the MCP tool, lists every broken connection and malformed file, and recommends fixes. ## Quick Start Start the CONSTRUCT MCP server with construct mcp &, then ask the agent to validate the workspace and audit its integrity.

Frequently Asked Questions about construct-workspace-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a CONSTRUCT workspace for integrity issues?▼

Start the MCP server with `construct mcp &`, then ask the agent to validate the workspace. The skill calls the construct_validate MCP tool with the workspace path and returns a report listing errors and warnings with a PASS or FAIL status.

What does the workspace validation check?▼

It checks file formats, connection consistency, orphan references, cross-file consistency, governance compliance, and graph integrity. The checks run as a post-write audit on files already persisted to disk.

What is the difference between pre-write rejection and post-write audit?▼

Pre-write rejection uses validate_*_write() helpers to block invalid payloads before they reach disk. Post-write audit, performed by this skill, examines existing workspace files for cross-file consistency and graph integrity via the MCP construct_validate tool.

Why does workspace validation fail to run?▼

The most common cause is the CONSTRUCT MCP server not running. Start it in the background with `construct mcp &` so the construct_validate tool is exposed, then retry the validation request.

Can workspace validation fix the errors it finds?▼

No, it only detects and reports errors and warnings with actionable recommendations. Repairing malformed files or broken connections is a separate step performed by the user or other curation workflows.