DavidCho1999/archaiflow-skills / bundles/construction-admin/skills/drawing-set-bookmarker
drawing-set-bookmarker
VerifiedThis skill should be used when the user has a multi-sheet architectural drawing-set PDF (typically 50–300 sheets) with no bookmarks or a flat/incorrect bookmark tree, and wants a properly bookmarked PDF plus a CSV sheet index. Trigger on "bookmark this drawing set", "add bookmarks to this PDF", "tabulate sheets", "make a sheet index", or a pasted path to a multi-sheet drawing PDF. Reads each page's title block via vision, extracts sheet number/name/discipline, groups by discipline per US National CAD Standard, and writes the bookmarked PDF + index to `docs/drawing-sets/`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.3 KB |
| assets/drawing-sets-index-template.md | markdown | 164 B |
| assets/index-template.csv | other | 64 B |
| references/bookmark_grouping_strategies.md | markdown | 3.5 KB |
| references/ncs_sheet_numbering.md | markdown | 4.3 KB |
| references/titleblock_locations.md | markdown | 4.0 KB |
| scripts/append_to_index.py | script | 1.4 KB |
| scripts/apply_bookmarks.py | script | 4.2 KB |
| scripts/init_workspace.py | script | 1.9 KB |
references/bookmark_grouping_strategies.md
View on GitHub# Bookmark Grouping Strategies
The bookmark tree is the navigation contract for the bookmarked PDF. The tree's top level should match how the user expects to look up a sheet. There are three workable strategies; the default is **discipline-grouped**.
## Strategy 1: Discipline-grouped (DEFAULT)
Top level groups sheets by US NCS Level-1 discipline letter. Within each discipline, sheets are sorted by sheet number (sheet-type digit ascending, then sequence).
```
General (G)
├── G-001 — COVER SHEET
├── G-002 — DRAWING INDEX
└── G-003 — ABBREVIATIONS & SYMBOLS
Architectural (A)
├── A-001 — GENERAL NOTES
├── A-101 — FIRST FLOOR PLAN
├── A-102 — SECOND FLOOR PLAN
├── A-201 — NORTH ELEVATION
├── A-301 — BUILDING SECTION A
└── A-501 — WALL DETAILS
Structural (S)
├── S-001 — GENERAL NOTES
├── S-101 — FOUNDATION PLAN
└── ...
Mechanical (M)
└── ...
```
When to use: **always, unless the user explicitly asks otherwise**. This is what every NA office expects when opening a CD set in Bluebeam or Adobe.
## Strategy 2: Sheet-type-grouped
Top level groups by sheet-type digit (Plans / Elevations / Sections / Details / Schedules), with discipline as a sub-group.
```
Plans (1)
├── A-101 — FIRST FLOOR PLAN
├── A-102 — SECOND FLOOR PLAN
├── S-101 — FOUNDATION PLAN
└── M-101 — FIRST FLOOR MECH PLAN
Elevations (2)
├── A-201 — NORTH ELEVATION
└── A-202 — SOUTH ELEVATION
Sections (3)
├── A-301 — BUILDING SECTION A
└── ...
```
When to use: QC review, where the reviewer wants to compare all plans across disciplines side-by-side, or all sections together. Less natural for daily lookup.
## Strategy 3: Flat-by-number
No grouping — every sheet is a top-level bookmark in sheet-number order.
```
G-001 — COVER SHEET
A-001 — GENERAL NOTES
A-101 — FIRST FLOOR PLAN
A-102 — SECOND FLOOR PLAN
A-201 — NORTH ELEVATION
S-001 — GENERAL NOTES
S-101 — FOUNDATION PLAN
```
When to use: very small sets (< 20 sheets) or single-discipline sets where grouping adds no value.
## Special cases
### Phase mixing
If the input set contains multiple phases (e.g. an addendum bound with the original IFC set), add a top-level group **above** discipline:
```
IFC (issued 2026-03-15)
└── Architectural
└── A-101 — FIRST FLOOR PLAN
ASI #03 (issued 2026-04-22)
└── Architectural
└── A-101A — FIRST FLOOR PLAN — REVISED PARTITION
```
### Unknown sheets
Sheets where the title block could not be read get a separate top-level group `UNKNOWN` so the user can find them quickly to verify manually:
```
Architectural (A)
└── ...
UNKNOWN
├── UNKNOWN-47 — page 47
└── UNKNOWN-83 — page 83
```
Do not bury unknowns inside a discipline group based on guessing — leave them visibly flagged.
### Collision-suffixed sheets
`-rev2` / `-rev3` suffixed sheets sort within their parent discipline group, immediately after the unsuffixed sheet:
```
Architectural (A)
├── A-101 — FIRST FLOOR PLAN (page 12)
└── A-101-rev2 — FIRST FLOOR PLAN (page 213, addendum copy)
```
## Bookmark label format
Each leaf bookmark label uses this format:
```
<sheet_number> — <sheet_name>
```
The em-dash (`—`, U+2014) separator is consistent across NA practice; do not use a hyphen-minus. If `sheet_name` is empty (rare), use just the sheet number.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |