MartinoPolo/mpx-parse-spec
deprecated/skills/mpx-parse-spec/SKILL.md
Parse .mpx/SPEC.md by spawning mpx-spec-analyzer. Regenerates ROADMAP.md and phase CHECKLIST.md files.
$ install --global
skillsauthnpx skillsauth add MartinoPolo/mpx-claude-code mpx-parse-specInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 10:22 AM7.6s1 file scanned
SKILL.md
- name:
- mpx-parse-spec
- description:
- Parse .mpx/SPEC.md by spawning mpx-spec-analyzer. Regenerates ROADMAP.md and phase CHECKLIST.md files.
- disable-model-invocation:
- false
- allowed-tools:
- Read, Write, Bash, Task, AskUserQuestion
- author:
- MartinoPolo
- version:
- 0.1
- category:
- project-management
Parse Specification
Wrapper skill for specification parsing. It validates .mpx/SPEC.md, then delegates decomposition to mpx-spec-analyzer.
Iron Law
DOCUMENTATION ONLY. Creates/updates .mpx/ files only. Never modifies source code.
Prerequisites
.mpx/SPEC.mdmust exist
SPEC.md remains the project-level source of truth for requirements for the entire project lifecycle. ROADMAP.md and phase CHECKLIST.md files are execution tracking artifacts derived from SPEC.md.
Workflow
Step 1: Validate SPEC.md
- Read
.mpx/SPEC.md - Ensure it contains requirements as checkbox items (
- [ ]/- [x]) - If malformed or ambiguous, ask user what to fix before parsing
Step 2: Spawn Spec Analyzer
Always call the dedicated analyzer agent:
Use Task tool:
subagent_type: "mpx-spec-analyzer"
prompt: "Read .mpx/SPEC.md and regenerate .mpx/ROADMAP.md and .mpx/phases/*/CHECKLIST.md. Treat SPEC as source of truth. Skip [x] requirements as already implemented, but retain them as dependency/context when needed. If any requirement is ambiguous, ask clarifying questions before finalizing output. Preserve all requirement detail (constraints and edge cases) in phase specs/tasks without losing information."
Step 3: Report
Return concise status:
Specification Parsed via Agent!
Files Updated:
- .mpx/ROADMAP.md
- .mpx/phases/.../CHECKLIST.md
Skipped as Implemented:
- [requirements marked [x]]
Next:
- Review `.mpx/ROADMAP.md` and phase checklists
- Run `/mp-execute mpx`
Error Handling
- No SPEC.md: "No specification found. Run
/mpx-add-requirementsfirst." - Malformed SPEC.md: ask user to clarify/fix ambiguous lines
- Analyzer failure: report error and keep
SPEC.mduntouched
Notes
- This skill is intentionally thin; logic lives in
mpx-spec-analyzer - Use
/mpx-add-requirementsfor interactive requirement collection/updates - Use this skill when users edited
SPEC.mdmanually and want a fresh parse
Related Skills
MartinoPolo/mpx-show-project-status
tools
VerifiedTrustedCommunity
Show current project progress. Displays phase status and next steps. Use when: "show status", "project progress", "what's done"
1SKILL.mdUpdated Jul 28, 2026
MartinoPolo/mpx-setup
data-ai
VerifiedTrustedCommunity
Unified project setup. Auto-detects state and orchestrates mpx skills/agents for init, conversion, or restructure.
1SKILL.mdUpdated Jul 28, 2026
MartinoPolo/mpx-report-issue-or-bug
testing
VerifiedTrustedCommunity
Track bugs/issues in .mpx/ phase system. Parses reports, finds related phases, adds fix tasks or creates bugfix phases. Use when: "track this bug", "add issue to project", "log this bug", "add bug to checklist"
1SKILL.mdUpdated Jul 28, 2026
MartinoPolo/mpx-project-workflow
development
VerifiedTrustedCommunity
Project workflow guidance for spec-driven development. Background knowledge auto-loaded when relevant.
1SKILL.mdUpdated Jul 28, 2026