Claude Skill

debloat-respect-richness

Use when a user asks to tighten verbose-but-correct prose without a full rewrite. Cuts in place to load-bearing density, preserving every load-bearing claim.

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download outlinedriven-outline-driven-development-.devin_skills_debloat-respect-richness-b0e8ce8.zip · 1 KB
Part of outlinedriven/outline-driven-development — 145 skills

Install

skills CLI npx skills add https://github.com/OutlineDriven/outline-driven-development/tree/main/.devin/skills/debloat-respect-richness
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install outlinedriven-outline-driven-development@llmmart
Git git clone https://github.com/OutlineDriven/outline-driven-development.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole outlinedriven/outline-driven-development collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Debloat respect richness

Contract

Field Bound contract
Trigger User asks to tighten verbose-but-correct prose without a full rewrite
Authority Reversible local: writes only the named artifact, cutting words in place; rollback is version control. No remote mutation.
Side effect Local write to the target artifact only; no re-derivation, no move to another home
Done Every load-bearing claim present before remains after; the result reads as intentionally terse, not amputated; genuine duplication or drift is handed off instead of force-compressed

Inputs

  • Required: the target artifact, a file path or pasted prose that is correct and current but has grown verbose or patched-over.
  • Optional: a note flagging which sections are human-facing teaching or orienting prose whose accessibility earns its length.

Procedure

  1. Pin the artifact and read it end to end. Record one line per section stating the load-bearing content that must survive the pass. Done when: every section has a one-line load-bearing-content record.
  2. Distinguish bloat from content. Bloat is padding that adds length without meaning: a qualifier or parenthetical the sentence works without, a fused sentence carrying three ideas, an enumeration where a rule and short list would do, a point restated nearby, or litigation history where the rule alone suffices. Done when: bloat is distinguished from load-bearing content in every section.
  3. Compress in place: cut the padding, split the fused sentence or drop its dead clause, collapse the wall, keep a repeated point once. Move nothing to another artifact and re-derive nothing. Done when: padding is cut in place with nothing moved or re-derived.
  4. Preserve every load-bearing claim, a rule, fact, constraint, or example that carries weight. If cutting a word would lose one, keep the word. Done when: every load-bearing claim present before remains after the pass.
  5. Respect intended richness: human-facing prose meant to teach or orient (a quickstart, a worked example) earns its length. Compress the bloat, not the accessibility. Done when: human-facing teaching prose is preserved at its earned length.
  6. When the bloat is really duplication across artifacts, or the content has drifted stale, stop and name it: hand duplication to the appropriate deduplication work and drift to the appropriate rewrite work. This skill only tightens; it does not dedup or rewrite. Done when: duplication or drift is named and handed off, or no misclassification is found.
  7. Re-read cold and cut again; the first pass always leaves some. Done when: a cold re-read finds no remaining bloat.

Failure and recovery

  • Empty-pass: a pass that finds nothing genuinely bloated changes nothing. Report that the artifact is already at load-bearing density.
  • Claim-loss: if a cut would drop a load-bearing claim, restore the word and record the near-miss. The done predicate forbids claim loss.
  • Misclassified scope: if what looked like bloat is duplication across artifacts or stale content, do not force-compress it. Stop, name the class (duplication or drift), and hand it off. Tightened sections stand; report the misclassified sections as unchanged with the handoff note.
  • Edit safety: assert each edit target exists before mutating; report a MISS rather than a silent no-op. On a MISS, abort the pass and report the missing target.
  • Rollback: edits are local and reversible; a failed or aborted pass restores the unverified sections to their pre-pass state.

Output

The target artifact with words cut in place to load-bearing density, plus a report listing sections tightened, load-bearing claims confirmed, unchanged sections, and any duplication or drift handoff.

Files (outline-driven-development)
  • agents
    • openai.yaml 159 B
      interface:
        display_name: "Debloat Respect Richness"
        short_description: "Use when a user asks to tighten verbose-but-correct prose without a full rewrite."
      
  • SKILL.md 3.9 KB
    ---
    name: debloat-respect-richness
    description: 'Use when a user asks to tighten verbose-but-correct prose without a full rewrite. Cuts in place to load-bearing density, preserving every load-bearing claim.'
    ---
    
    # Debloat respect richness
    
    ## Contract
    
    | Field | Bound contract |
    |---|---|
    | Trigger | User asks to tighten verbose-but-correct prose without a full rewrite |
    | Authority | Reversible local: writes only the named artifact, cutting words in place; rollback is version control. No remote mutation. |
    | Side effect | Local write to the target artifact only; no re-derivation, no move to another home |
    | Done | Every load-bearing claim present before remains after; the result reads as intentionally terse, not amputated; genuine duplication or drift is handed off instead of force-compressed |
    
    ## Inputs
    
    - Required: the target artifact, a file path or pasted prose that is correct and current but has grown verbose or patched-over.
    - Optional: a note flagging which sections are human-facing teaching or orienting prose whose accessibility earns its length.
    
    ## Procedure
    
    1. Pin the artifact and read it end to end. Record one line per section stating the load-bearing content that must survive the pass. Done when: every section has a one-line load-bearing-content record.
    2. Distinguish bloat from content. Bloat is padding that adds length without meaning: a qualifier or parenthetical the sentence works without, a fused sentence carrying three ideas, an enumeration where a rule and short list would do, a point restated nearby, or litigation history where the rule alone suffices. Done when: bloat is distinguished from load-bearing content in every section.
    3. Compress in place: cut the padding, split the fused sentence or drop its dead clause, collapse the wall, keep a repeated point once. Move nothing to another artifact and re-derive nothing. Done when: padding is cut in place with nothing moved or re-derived.
    4. Preserve every load-bearing claim, a rule, fact, constraint, or example that carries weight. If cutting a word would lose one, keep the word. Done when: every load-bearing claim present before remains after the pass.
    5. Respect intended richness: human-facing prose meant to teach or orient (a quickstart, a worked example) earns its length. Compress the bloat, not the accessibility. Done when: human-facing teaching prose is preserved at its earned length.
    6. When the bloat is really duplication across artifacts, or the content has drifted stale, stop and name it: hand duplication to the appropriate deduplication work and drift to the appropriate rewrite work. This skill only tightens; it does not dedup or rewrite. Done when: duplication or drift is named and handed off, or no misclassification is found.
    7. Re-read cold and cut again; the first pass always leaves some. Done when: a cold re-read finds no remaining bloat.
    
    ## Failure and recovery
    - Empty-pass: a pass that finds nothing genuinely bloated changes nothing. Report that the artifact is already at load-bearing density.
    - Claim-loss: if a cut would drop a load-bearing claim, restore the word and record the near-miss. The done predicate forbids claim loss.
    - Misclassified scope: if what looked like bloat is duplication across artifacts or stale content, do not force-compress it. Stop, name the class (duplication or drift), and hand it off. Tightened sections stand; report the misclassified sections as unchanged with the handoff note.
    - Edit safety: assert each edit target exists before mutating; report a MISS rather than a silent no-op. On a MISS, abort the pass and report the missing target.
    - Rollback: edits are local and reversible; a failed or aborted pass restores the unverified sections to their pre-pass state.
    
    ## Output
    The target artifact with words cut in place to load-bearing density, plus a report listing sections tightened, load-bearing claims confirmed, unchanged sections, and any duplication or drift handoff.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.

Related