ronnasayd/aipp/consolidate-markdown
Claude Code and agent skill by ronnasayd/aipp
- community
Checking that the SKILL.md file is still in the repository.
Consolidate several unstructured Markdown files with overlapping or conflicting information into one organized document, without losing data and with every divergence made explicit. Use when user says 'consolidar arquivos markdown', 'juntar essas notas', 'merge these md files', 'unify these docs', 'notas duplicadas/divergentes', or has multiple .md notes (Obsidian, Notion exports, scattered docs) covering the same topics with inconsistent details, even if they don't say 'consolidate'.
Install
npx vskill@latest install ronnasayd/aipp/consolidate-markdownSKILL.md
The same SKILL.md was published earlier as ronnasayd/aipp/consolidate-markdown.
Consolidate Markdown
Merge messy .md files into one coherent document. Rule: no info lost, no conflict silently resolved. Keep source traceability until the final step — it's what makes divergences resolvable. Never edit originals.
Ask (AskUserQuestion) only what can't be inferred: files/glob, output path (default consolidado.md beside sources), output language, keep/drop frontmatter.
Steps
| # | Step | Action | Gate | |
|---|---|---|---|---|
| 1 | Prepare | UTF-8 + LF (file -i, iconv -f <enc> -t utf-8, sed -i 's/\r$//'). Frontmatter keep/drop per user; if kept, move date/tags into origin header | work on copy; accents intact | |
| 2 | Concatenate | Oldest first (frontmatter date or mtime) so contradictions read as updates; origin header per file (snippet below); exclude output file from glob | draft with # Origem: <file> per block | |
| 3 | Unify | Read full draft → propose 5–12 macro-themes (confirm if split non-obvious) → move blocks under themes, keep wording, tag <!-- src: file.md --> → mark conflicts (template below) | every block under a theme; every conflict marked | |
| 4 | Refine | Resolve per table below; dedupe; one H1; consistent lists/tables; working links. Strip src comments and # Origem only after user approves | unresolved → final ## Pendências | |
| 5 | Verify | Each source's distinct facts appear in output or Pendências; grep (rg -c) unusual terms/numbers/names per source | report: files merged, themes, dupes collapsed, divergences found/resolved/pending |
Conflict handling
| Case | Action | |
|---|---|---|
| Same fact, same value | collapse to one line, list all sources | |
| Same fact, different wording | not a conflict — merge | |
| Different values | mark divergence; resolve by newer date, more authoritative source, or user decision | |
| Resolved | record chosen value + why; keep rejected value as one-line note if it could matter | |
| Unresolvable | leave in ## Pendências | |
| >10 divergences | also list in reply grouped by theme for one-pass decision |
Output
Final .md: TOC, themed sections, Pendências; short summary to user.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/consolidate-markdown/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ronnasayd/aipp/consolidate-markdown)