tighten

Rewrites drafted text denser by cutting structural padding while preserving every fact.

1|1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/nearmap/shipyard --skill tighten-nearmap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tighten
Source: https://github.com/nearmap/shipyard/tree/main/skills/tighten
Command: npx skills add https://github.com/nearmap/shipyard --skill tighten-nearmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Drafted text — console updates, plan sign-off sections, PR descriptions, agent dispatch briefs — accumulates structural bloat like pipeline narration, restated findings, and duplicated rationale that buries what the reader actually needs to act on. ## Core Features & Use Cases - Destination-aware rewriting: Routes the edit by where the text is going — a console turn, a plan sign-off half, an issue body or PR description, a plan's machine half, or an agent brief — since each destination bloats differently. - Measured cut patterns: Applies a catalog of empirically derived bloat patterns (pipeline-internal narration, restatement, provenance clauses, traced counterfactuals) rather than style intuition or word-count targets. - Anchor protection: Guarantees no file path, symbol, SHA, obligation, invariant, or acceptance criterion leaves the text unless a cut pattern explicitly names it as removable. - Use Case: Before posting a 4,000-word PR description, run this pass to cut per-review-round narration and diff-redundant walkthroughs down to the findings a reviewer must still weigh. ## Quick Start Tighten this drafted PR description before I post it, cutting padding without losing any fact.

Frequently Asked Questions about tighten

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I tighten a PR description before posting it?▼

Hand the draft to the tighten skill with its destination named. It cuts pipeline narration, detail the diff already carries, and revision-history leftovers while keeping every finding a reviewer must still weigh.

How does text tightening differ from grammar or style checking?▼

This pass cuts structures, never adjectives — it targets duplicated facts, restated rationale, and narration of internal machinery rather than word choice. It was derived from measuring real corpora, which showed sentence-level filler was absent.

Can I use it on short messages or chat replies?▼

No. Text under 200 characters is never touched, since the measured console corpus showed all removable volume sat in turns of 1,500 characters or more. Short text was already correct.

Does tightening ever remove file paths, SHAs, or acceptance criteria?▼

Never by default. A hard protection rule bars any path, symbol, config key, SHA, obligation, invariant, or acceptance criterion from leaving the text unless the specific cut pattern being applied names it as removable.

Is there a target length or percentage the rewrite must hit?▼

No budget, threshold, or quota governs the pass. The cut-pattern list is the whole instrument — when nothing on it is present in the text, nothing changes.