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/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-requirements
tools
VerifiedTrustedCommunity
Consolidate CONTEXT.md (or legacy REQUIREMENTS.md): remove duplicates, outdated items, tighten language. Use when: "consolidate requirements", "clean up requirements", "consolidate context", "simplify context".
1SKILL.mdUpdated May 19, 2026