MartinoPolo/mp-consolidate-context
skills/mp-consolidate-context/SKILL.md
Consolidate CONTEXT.md: remove duplicates, outdated items, tighten language. Use when: "consolidate context", "clean up context", "simplify context", "consolidate requirements"
$ install --global
skillsauthnpx skillsauth add MartinoPolo/mpx-claude-code mp-consolidate-contextInstall 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: May 19, 2026, 7:57 AM165.0s1 file scanned
SKILL.md
- name:
- mp-consolidate-context
- description:
- Consolidate CONTEXT.md: remove duplicates, outdated items, tighten language. Use when: "consolidate context", "clean up context", "simplify context", "consolidate requirements"
- argument-hint:
- [path to CONTEXT.md]
- disable-model-invocation:
- true
- allowed-tools:
- Read, Write, Edit, Glob, Grep
- author:
- MartinoPolo
- version:
- 2.0
- category:
- utility
Consolidate .mpx/CONTEXT.md into a concise, future-proof reference. Preserve all important detail while removing noise.
See skills/shared/DOCUMENTATION_STRATEGY.md for format details.
Input Resolution
- If
$ARGUMENTSis a file path, use that file. - Otherwise, use
.mpx/CONTEXT.md. - If not found, ask the user for the path.
Process
Step 1: Read & Analyze
Read the full file. Scan for each issue type and build a findings list:
| Issue Type | What to Look For | |---|---| | Duplicates | Terms or features covering the same concept (keep the most current/complete version) | | Superseded | Content explicitly marked as superseded, replaced, or overridden by newer entries | | Negative framing | "must not", "cannot", "never" — convert to positive imperative | | Non-content noise | Implementation notes, deviation notes, historical provenance, issue-tracking meta, "Plan vN" / date labels | | Outdated | Struck-through items, removed parameters still referenced, resolved issue references | | Inconsistencies | Conflicting definitions or specifications | | Bloated definitions | Domain Language definitions exceeding one sentence | | Misplaced content | Architectural decisions that belong in DECISIONS.md, implementation details that belong in PRDs |
Step 2: Rewrite
Apply all changes directly — do not ask for confirmation. Produce the consolidated file:
- § Domain Language: one sentence max per definition, definition-list format (
**Term** — Definition.) - § Core Features: index only (name + status + PRD#), no implementation details
- § Key Constraints: concise bullets
- § Flagged Ambiguities: resolved term conflicts with rationale
- Target 250–300 lines total
Content rules:
- Remove implementation/deviation notes (belong in PRs or commit messages)
- Fix inconsistent values (use the most recent/authoritative source)
- Merge sections that were split by version history into unified topics
- Keep full technical detail where it matters: formulas, ranges, defaults
- Move any settled architectural decisions to DECISIONS.md instead
Step 3: Write Result
Write the consolidated file to the original path (overwrite). Git history preserves the original.
Report
After writing, summarize:
- Line count: original vs. consolidated (and lines saved)
- Items removed, merged, or rewritten (counts)
- Inconsistencies fixed
- Items moved to DECISIONS.md (if any)
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