ronnasayd/aipp/consolidate-markdown

Claude Code and agent skill by ronnasayd/aipp

Trust tier 3
  • community
Source check pending

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-markdown

SKILL.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

#StepActionGate
1PrepareUTF-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 headerwork on copy; accents intact
2ConcatenateOldest first (frontmatter date or mtime) so contradictions read as updates; origin header per file (snippet below); exclude output file from globdraft with # Origem: <file> per block
3UnifyRead 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
4RefineResolve per table below; dedupe; one H1; consistent lists/tables; working links. Strip src comments and # Origem only after user approvesunresolved → final ## Pendências
5VerifyEach source's distinct facts appear in output or Pendências; grep (rg -c) unusual terms/numbers/names per sourcereport: files merged, themes, dupes collapsed, divergences found/resolved/pending
bash
out=consolidado_rascunho.md; : > "$out"
for f in *.md; do printf '\n\n# Origem: %s\n\n' "$f" >> "$out"; cat "$f" >> "$out"; done
markdown
> ⚠️ **Divergência:** prazo do projeto
>
> - `notas_v1.md`: 30 dias
> - `reuniao_03.md`: 45 dias
>
> **Decisão:** _pendente_

Conflict handling

CaseAction
Same fact, same valuecollapse to one line, list all sources
Same fact, different wordingnot a conflict — merge
Different valuesmark divergence; resolve by newer date, more authoritative source, or user decision
Resolvedrecord chosen value + why; keep rejected value as one-line note if it could matter
Unresolvableleave in ## Pendências
>10 divergencesalso 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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ronnasayd/aipp/consolidate-markdown/badge)](https://verified-skill.com/skills/ronnasayd/aipp/consolidate-markdown)

Something wrong with this skill or its page? Tell us.