ronnasayd/aipp/compress-skill

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.

Compresses a verbose SKILL.md into a short, scannable core file by moving prose into tables, mermaid flowcharts, and reference files — without losing technical substance. Use when a SKILL.md has grown long (200+ lines of numbered prose, repeated Notes sections, verbatim templates inline) and the user asks to make it 'shorter but still effective', 'more direct', 'use tables/lists/graphs', 'split into reference files', or 'compress this skill'.

Install

npx vskill@latest install ronnasayd/aipp/compress-skill

SKILL.md

The same SKILL.md was published earlier as ronnasayd/aipp/compress-skill.

Compress Skill

Shrinks an existing SKILL.md into a short, decision-critical core, relocating dense/large/redundant content into reference files. Preserves every rule, threshold, and edge case — nothing is lost, only relocated or deleted if truly redundant.

Steps

#StepActionOutput / Gate
1Read targetRead the full SKILL.mdinventory of sections: steps, branching logic, tables, verbatim templates, Notes/recap
2Read existing refsRead every file already linked from the skill (references/*.md or similar)flag any that describe a stale/older mechanism than the current main file — these must be rewritten, not just kept
3Classify contentSee classification table beloweach section tagged: table / flowchart / extract-to-ref / delete
4Design ref file setOne file per template category; one file for detailed mechanism/flowchart; keep existing example/troubleshooting files (rewrite if stale per step 2)file list finalized before writing
5Write reference filesWrite tool, refs firstmain file's pointers can be one line each since detail lives here
6Rewrite main SKILL.mdSee rewrite checklist belowshort core file + "Reference files" map at the end
7Verify nothing lostDiff old content section-by-section against new tables/refsevery rule/threshold/edge case appears somewhere in the new set
8ReportState size delta + what moved wheree.g. "298 → 55 lines; templates → agent-prompts.md, flowchart → orchestrator-model.md, stale example rewritten"

Classification table (Step 3)

Content shapeTreatment
Linear numbered steps with input/outputtable: step, input, output/gate
Branching logic (if/else, retry/skip/abort)table (condition → action); use mermaid flowchart instead if branches loop/cycle
Verbatim templates (agent prompts, code payloads)extract to dedicated reference file, one-line pointer left in main file
Notes/recap section restating the bodydelete — redundant content has zero compression floor, don't summarize it, remove it
Wordy prose inside an already-tabular celltrim in place — see wording-tightening pass below; no restructure needed

Wording-tightening pass (already-tabular content)

When a table/section already exists but cells are verbose, tighten wording without dropping substance:

  • Drop filler: "in order to" → "to", "make sure to" → drop, "you should" → drop, restated rationale already implied by a command.
  • Cut connective throat-clearing ("Also actually open...", "Note that...") — keep the instruction, drop the preamble.
  • Shorten to fragments: commands, thresholds, flags, and named tools stay verbatim; surrounding prose becomes clipped phrases.
  • Collapse repeated qualifiers ("don't X, and don't Y, and don't Z" → "don't X/Y/Z" or a short list).
  • Keep every number, flag, command, filename, and named exception — only the connective tissue is cut.
  • Apply per-cell, not per-file: a cell can be tightened even when the surrounding table structure is otherwise left alone.

Rewrite checklist (Step 6)

  • Keep frontmatter (name, description, metadata) unchanged unless scope changed — bump version if content meaningfully changed.
  • Open with 2-3 sentences: who drives what, the one non-obvious rule (a gate, a threshold, an ownership boundary).
  • Replace numbered prose steps with the Step 1 table's output.
  • Replace branching prose with condition→action tables or a flowchart.
  • Replace verbatim templates with one-line pointers to extracted files.
  • Delete sections that only recap content already covered elsewhere.
  • End with "Reference files" list — one line per file, stating what it contains.

Reusable heuristic

Compress only what is dense and unique. Delete what is redundant. Relocate what is large and copy-paste (templates). Keep in the main file only what is decision-critical and short (tables, gates, thresholds).

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/compress-skill/badge)](https://verified-skill.com/skills/ronnasayd/aipp/compress-skill)

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