MartinoPolo/mpx-parse-spec
skills/deprecated/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/mp-skill-audit
development
VerifiedTrustedCommunity
Audit all active skills for consistency, convention drift, and common issues. Auto-fixes where possible, reports remaining issues. Use when: "audit skills", "skill audit", "check skills", "lint skills"
1SKILL.mdUpdated May 19, 2026
MartinoPolo/mp-ship
testing
VerifiedTrustedCommunity
Ship finished work: sync base, commit, push, PR, wait for CI green, merge. Use when: "ship it", "ship and merge", "ship this"
1SKILL.mdUpdated May 19, 2026
MartinoPolo/mp-harvest-decisions
development
VerifiedTrustedCommunity
Scan recent Claude Code sessions for grilling/design discussions, extract decisions, and update CONTEXT.md + DECISIONS.md. Use when: "harvest decisions", "extract decisions from sessions", "update docs from sessions", "sync decisions"
1SKILL.mdUpdated May 19, 2026
MartinoPolo/mp-consolidate-context
tools
VerifiedTrustedCommunity
Consolidate CONTEXT.md: remove duplicates, outdated items, tighten language. Use when: "consolidate context", "clean up context", "simplify context", "consolidate requirements"
1SKILL.mdUpdated May 19, 2026