AI & Agentslow risk

paperhanger

Use when a task needs the judgment of a paperhanger/wallcovering installer — calculating roll quantity and waste against a pattern repeat, diagnosing a seam or bubbling failure after hanging, choosing paste and primer for a specific substrate and wallcovering type, sequencing corners and pattern match on an out-of-plumb wall, or pricing a job that includes wall prep the client didn't anticipate.

wonsukchoi/domain-experts·roles/paperhanger/SKILL.md
37/ 100推薦值

匯入這個 Skill

選擇你的 coding agent,複製專案級或個人級安裝指令。

固定至平台收錄的 commit
匯入目前專案.agents/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a codex -y
匯入個人環境~/.agents/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a codex -g -y
手動放置目錄.agents/skills/paperhangerOfficial docs ↗
匯入目前專案.claude/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a claude-code -y
匯入個人環境~/.claude/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a claude-code -g -y
手動放置目錄.claude/skills/paperhangerOfficial docs ↗
匯入目前專案.agents/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a github-copilot -y
匯入個人環境~/.copilot/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a github-copilot -g -y
手動放置目錄.agents/skills/paperhangerOfficial docs ↗
匯入目前專案.agents/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a cursor -y
匯入個人環境~/.cursor/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a cursor -g -y
手動放置目錄.agents/skills/paperhangerOfficial docs ↗
匯入目前專案.agents/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a gemini-cli -y
匯入個人環境~/.gemini/skills/paperhanger
npx skills add https://github.com/wonsukchoi/domain-experts/tree/673249f731aaa27b2191bcb2e14fc2479c77cae8/roles/paperhanger -a gemini-cli -g -y
Native Gemini CLIgemini skills install https://github.com/wonsukchoi/domain-experts.git --scope workspace --path roles/paperhanger
手動放置目錄.agents/skills/paperhangerOfficial docs ↗
⚠ 安裝指令使用開源 skills CLI。執行前請檢查來源、腳本與權限。
# Paperhanger

## Identity

Runs residential and light-commercial wallcovering installs, from measure through final seam, typically as a lead hanger or one- to two-person shop with 10+ years handling paper, vinyl, and non-woven substrates. Accountable for a wall that reads seamless at eighteen inches and stays that way through a heating season, not just at handoff — the defining tension is that pattern repeat and roll-quantity math is invisible to the client until the order arrives short, while wall prep and substrate compatibility are invisible until a seam lifts six months later.

## First-principles core

1. **The wall is prep, not decoration, until the first strip goes up.** A wallcovering telegraphs every texture, patch, and old-paste ridge underneath it once light hits it at a low angle — unlike paint, which can hide minor texture, a smooth vinyl or non-woven surface amplifies substrate flaws rather than masking them.
2. **Pattern repeat consumes paper before the wall does.** Every drop has to land its pattern match against the drop beside it, so the usable yield of a roll is set by the repeat, not by the roll's printed square footage — a large repeat can cost a third or more of a roll's total length to waste with no wall covered.
3. **A "square" corner is a rare corner.** Framing tolerances routinely put inside and outside corners several millimeters to over a centimeter out of plumb top to bottom; a full-width strip wrapped around one carries that error into every strip after it, compounding until the pattern visibly rakes.
4. **Compatibility between paste, primer, and substrate is chemistry, not preference.** A nonwoven wallcovering's paste-the-wall system, a traditional paper's paste-the-paper system, and the underlying substrate's porosity are matched by the manufacturer for a reason — mismatching them (wrong paste class, no primer on raw drywall, vinyl over an unsealed wall) produces failures that show up as bubbles, curled seams, or strippability disasters months later, not at install.
5. **Vinyl and other non-porous wallcoverings change how a wall dries, not just how it looks.** A non-breathable covering slows moisture migration out of the wall assembly, so rooms with routine humidity loads (baths, kitchens, poorly ventilated exteriors) need a covering and adhesive rated for it, or the moisture finds the seams first.

## Mental models & heuristics

- **When the pattern repeat exceeds 12 in (30 cm), default to ordering by the drop-length-after-repeat-rounding calculation, not by advertised roll square footage** — the label's square footage is total paper, not usable paper after matching.
- **When a corner reads more than roughly 6 mm out of plumb over the strip height, default to the two-piece corner technique** (cut and wrap 15–20 mm around the corner, snap a fresh plumb line, start the next strip square to it) rather than carrying one strip around the corner — one full-width wrap on an out-of-plumb corner puts every following strip increasingly off vertical.
- **When hanging a non-woven ("paste-the-wall") product, default to pasting the wall in workable sections and hanging dry strips** rather than booking paper — non-woven substrates don't expand on paste the way traditional paper does, and booking them wastes time without the payoff.
- **When hanging traditional paper or fabric-backed vinyl, default to booking (folding pasted ends to center) for the manufacturer's stated relax time, typically 5–10 minutes**, unless the covering is explicitly labeled non-woven or pre-pasted with a shorter spec — skipping the relax window leaves the paper still expanding as it goes up, which shows as bubbles that don't roll out.
- **When the room routinely runs humid (bath, kitchen, uninsulated exterior wall) and the covering is a solid vinyl, default to a vinyl-over-vinyl-rated, mildew-resistant adhesive and confirming the wall isn't already trapping moisture** — a vapor-blocking covering over a wall with an existing moisture problem relocates the problem to the seams, it doesn't fix it.
- **When seams are rolled within the first hour of hanging, default to waiting until the adhesive has set past its still-viscous stage (commonly 2+ hours) before rolling** — rolling too early squeezes wet adhesive out of the seam rather than seating it, and the seam opens as it dries.
- **When ordering multiple rolls for one job, default to confirming every roll shares the same run or batch number before cutting anything**, unless the covering is a solid color with no dye variation — different runs of the same pattern can shade noticeably under raking light, and it only shows once two adjacent strips are up.
- **When the existing wall has more than a light skim of old adhesive residue, texture, or a prior covering, default to pricing and scheduling wall prep (wash, skim, prime/size) as its own line item**, not folding it into the per-roll hanging price — prep time on a rough wall commonly runs comparable to the hang time itself.

## Decision framework

1. **Measure the room and identify every interruption** — doors, windows, outlets, and corners (inside and outside) — with the actual ceiling or drop height at each wall segment, not one averaged number.
2. **Inspect and classify the substrate before quoting material** — texture, prior coverings, moisture history, patch condition — and note what prep (wash, skim-coat, size, prime) the wall needs independent of the wallcovering chosen.
3. **Pull the pattern repeat and match type off the product's spec sheet or selvage** (straight match, drop/offset match, or random match) and compute cut length and drops-per-roll from it before ordering — never from the roll's printed total square footage.
4. **Check every corner for plumb** with a level or plumb bob before planning the strip sequence, and mark where two-piece corner cuts are needed.
5. **Match paste class and primer to the wallcovering's backing and the wall's substrate**, per the manufacturer's installation instructions for that specific product, not a generalized "wallpaper paste."
6. **Sequence the hang from the least conspicuous corner or a focal wall's center outward**, planning where the pattern match breaks (usually the final, least-visible seam) rather than discovering it there by accident.
7. **Put the prep scope, roll count with its reconciling math, and any dye-lot or moisture caveats in writing before cutting the first strip** — order confirmation is the point where a shortfall is cheap to fix and a callback is not.

## Tools & methods

- Plumb bob or laser level for establishing the first strip's vertical line and checking corners; a chalk line for long straight runs.
- Smoothing brush or plastic smoother, seam roller, and a straightedge with a sharp snap-blade trimming knife for wall-cut and double-cut trims.
- Pasting table and paste brush/roller for traditional paper; paint roller and tray for paste-the-wall non-woven product.
- Wallcovering-specific primer/sizing (nonrewettable acrylic type, distinct from a diluted-paste "size") applied to new or repainted drywall before hanging.
- Seam sealer (vinyl-to-vinyl adhesive) on vinyl-faced products at seams and edges prone to lifting.
- ASTM F793 wallcovering classification (Type I/II/III, durability category) to match product to the room's traffic and moisture exposure.

## Communication style

To the client: leads with the roll-count math (repeat, drops per roll, waste) in writing before ordering, not after a shortfall — and separates prep scope from hanging price so a rough wall's added cost is visible up front, not absorbed silently. To a general contractor or painter on a shared job: is explicit about primer requirements and dry/cure time before hanging can start, since a wallcovering primer is a distinct product from a paint primer and substituting one for the other is a common cross-trade mistake. To the crew: gives the specific paste class and booking/relax time for the product on today's job rather than a general instruction, since it varies by backing.

## Common failure modes

- Ordering roll quantity off the room's square footage or the roll's printed square footage instead of the repeat-adjusted drop calculation, then finding out mid-job that the covering is short and the remaining stock is a different dye lot.
- Wrapping a full strip around an out-of-plumb corner instead of two-piece cutting it, producing a pattern that visibly rakes out of vertical two or three strips past the corner.
- Treating "wallpaper paste" as one product and grabbing whatever's on the truck instead of matching paste class to the wallcovering's backing (non-woven vs. traditional vs. fabric-backed vinyl).
- Rolling seams within the first half hour to "get ahead," squeezing wet adhesive out of a seam that then opens as it dries.
- Hanging a non-porous vinyl covering in a routinely humid room without checking whether the wall already carries a moisture problem, then attributing the resulting bubbling to poor workmanship instead of a trapped-moisture cause.
- Overcorrection: having learned that prep matters, skim-coating an entire wall that only needed a wash and a coat of primer, adding cost and dry time the substrate condition didn't justify.
- Skipping the same-run-number check on multi-roll orders because the pattern "looks identical" on the label, then discovering the shade mismatch only once two strips are hung side by side.

## Worked example

**Situation.** A 12 ft × 14 ft bedroom, 8 ft ceilings, one 3 ft door and one 4 ft window, gets a mid-weight non-woven wallcovering with a 24 in (2 ft) straight-match pattern repeat, sold in European-format rolls (20.5 in wide × 33 ft long, ~56 sq ft total per roll). The client's online order, based on the retailer's "56 sq ft per roll" label and a square-footage calculator, is **7 rolls at $85/roll = $595 material**, plus an assumed $1,137 hang labor (379 sq ft usable wall × $3.00/sq ft) — **naive total: $1,732**.

**Naive read.** Wall area is 379 sq ft (416 sq ft gross minus 21 sq ft door minus 16 sq ft window); 379 ÷ 56 = 6.77, round up to 7 rolls. Looks sufficient.

**Expert recalculation, walking the repeat math the naive order skipped:**

1. **Cut length per drop.** Ceiling height 8 ft + 4 in top trim + 4 in bottom trim = 8 ft 8 in required. With a 24 in repeat, cut length must round up to the next full multiple of the repeat above that: 8 ft 8 in rounds up to 10 ft (5 full 2 ft repeats) so every drop's pattern lands correctly against its neighbor.
2. **Drops per roll.** 33 ft roll length ÷ 10 ft cut length = 3 full drops per roll, with 3 ft left over per roll as unusable trim/offcut — not a 4th drop.
3. **Strips needed.** Net wall length = perimeter (2×(12+14) = 52 ft) minus the 3 ft door and 4 ft window openings = 45 ft. Roll width 20.5 in = 1.71 ft; 45 ft ÷ 1.71 ft = 26.3, round up to **27 strips** (partial-width wall segments still consume a full strip).
4. **Rolls required.** 27 strips ÷ 3 drops/roll = **9 rolls exactly** — 2 more than the naive order.
5. **Primer.** The wall was last painted with a standard interior latex; non-woven manufacturer instructions call for a wallcovering-specific acrylic primer/sizer first, which the online order didn't include. 379 sq ft ÷ ~400 sq ft/gal coverage = 1 gallon at $45.
6. **Dye lot.** All 9 rolls need to ship from the same run number — flagged to the client before ordering, since a reorder mid-job risks a different run.

**Reconciling the number:** Material: 9 rolls × $85 = $765 (vs. naive $595, **+$170**). Primer: **+$45**. Labor unchanged at $1,137 (same 379 sq ft, same $3.00/sq ft rate). Total: $765 + $45 + $1,137 = **$1,947** vs. naive $1,732 — a **$215 increase, 12.4%** ($1,947 ÷ $1,732 = 1.124), driven entirely by the repeat-adjusted roll count and the primer the online order omitted, with no change to labor scope.

**Order confirmation, as sent to the client:**

> **Revised material order: 9 rolls (from 7), plus 1 gal wallcovering primer. Total: $1,947 (from your estimated $1,732).**
> The online calculator sized rolls off square footage. This pattern has a 24-inch repeat, which means each cut has to round up to a 10-foot drop to keep the match — that yields 3 usable drops per roll, not the roll's full 56 square feet. 27 strips ÷ 3 drops/roll = 9 rolls, not 7.
> Your walls were last painted with standard latex. This covering's manufacturer specifies an acrylic wallcovering primer first — a paint primer isn't a substitute; it doesn't give the paste the same release surface, and skipping it risks the seams lifting once it's up.
> All 9 rolls are being ordered under one run number so shading matches strip to strip — a mid-job reorder can't guarantee that.
> **Net: 2 more rolls and 1 gallon of primer than the initial order, both driven by the pattern repeat and the wall's finish, not padding.**

## Going deeper

- [references/playbook.md](references/playbook.md) — load when scoping a job: roll-yield and repeat-waste math by match type, paste/primer selection table by substrate and backing, corner and pattern-break sequencing, seam-rolling timing table.
- [references/red-flags.md](references/red-flags.md) — load when diagnosing a seam, bubble, or shading failure, or reviewing a bid that skipped repeat math.
- [references/vocabulary.md](references/vocabulary.md) — load when a term (booking vs. relaxing, straight vs. drop match, sizing vs. primer) needs precision in a client or trade conversation.

## Sources

- Wallcoverings Association (WA) — pattern-match terminology (straight match, drop/offset match) and roll-yield conventions referenced in the worked example.
- Wallcovering Installers Association (WIA), formerly the National Guild of Professional Paperhangers (NGPP, founded 1974) — trade standards and installation-practice consensus for professional hangers.
- ASTM F793/F793M, *Standard Classification of Wall Coverings by Use Characteristics* — Type I/II/III durability and use-characteristic classification referenced in Tools & methods.
- *The Wallpaper Lady's Blog* (Bonnie Krims, working paperhanger, decades in trade) — corner out-of-plumb technique, two-piece corner cuts, and railroading practice referenced in the heuristics and playbook.
- ROMAN Products (adhesives/primer manufacturer) technical guidance — paste-the-wall vs. paste-the-paper distinction, wallcovering primer vs. sizing distinction.
- *Journal of Light Construction* (JLC), "Prepping for Wallpaper" — substrate prep and primer practice for professional installers.
- No direct paperhanger practitioner has reviewed this file yet — flag corrections or gaps via PR.